@mikenotthepope/substrateui 0.1.3 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.2.1
+
+### Patch Changes
+
+- [#3](https://github.com/MikeNotThePope/substrateui/pull/3) [`1b21d12`](https://github.com/MikeNotThePope/substrateui/commit/1b21d126f9626c34285247613c9eb1e296c05b70) Thanks [@MikeNotThePope](https://github.com/MikeNotThePope)! - Fix the Spinner so its motion is visible in light mode. The arc (top border)
+  previously used a dark plum on a prominent medium-gray track, so it blended in
+  and the ring looked static. A dedicated, per-mode `--spinner-track` token now
+  gives light mode a subtle light-gray track for the arc to stand out against;
+  dark mode is unchanged.
+
+## 0.2.0
+
+### Minor Changes
+
+- [`af7c703`](https://github.com/MikeNotThePope/substrateui/commit/af7c703f53384e6252f9710c3e3762244189c496) Thanks [@MikeNotThePope](https://github.com/MikeNotThePope)! - Export `sidebarMenuButtonVariants` from the Sidebar component. Its JSDoc already documented "use with `cn(sidebarMenuButtonVariants({...}))` for non-button elements" (e.g. a Next.js `Link`), but the variant was never exported. This makes the documented usage possible, matching the existing `buttonVariants` export convention.
+
 All notable changes to SubstrateUI will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
@@ -8,6 +24,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.0] - 2026-04-04
 
 ### Added
+
 - Initial release
 - 75 UI components built on Radix UI primitives
 - 3-layer OKLCH color token system (raw palette → semantic → Tailwind utilities)

package/README.md

@@ -139,7 +139,7 @@ Every component ships with accessible defaults. For guidance on specific compone
 
 ## Storybook
 
-Contributors can browse components in isolation, flip between light/dark themes, swap `ltr`/`rtl` direction, and switch the semantic palette (Plum / Forest) from the toolbar.
+Contributors can browse components in isolation, flip between light/dark themes, swap `ltr`/`rtl` direction, and switch the semantic palette from the toolbar.
 
 ```bash
 bun run storybook        # dev server on http://localhost:6006

package/dist/{chunk-IRBORST3.js → chunk-GK4MVBBR.js}

@@ -3,6 +3,7 @@ import { __objRest, __spreadValues, cn } from './chunk-IQWAGBDM.js';
 import { jsx } from 'react/jsx-runtime';
 import { Slot } from '@radix-ui/react-slot';
 import * as TabsPrimitive from '@radix-ui/react-tabs';
+import * as React from 'react';
 
 function Card(_a) {
   var _b = _a, {
@@ -253,6 +254,16 @@ function TabsContent(_a) {
   );
 }
 
-export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Center, Stack, Tabs, TabsContent, TabsList, TabsTrigger };
-//# sourceMappingURL=chunk-IRBORST3.js.map
-//# sourceMappingURL=chunk-IRBORST3.js.map
+// src/lib/resolve-labels.ts
+function resolveLabels(defaults, context, prop) {
+  if (!context && !prop) return defaults;
+  return __spreadValues(__spreadValues(__spreadValues({}, defaults), context), prop);
+}
+var LabelsContext = React.createContext({});
+function useLabels() {
+  return React.useContext(LabelsContext);
+}
+
+export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Center, Stack, Tabs, TabsContent, TabsList, TabsTrigger, resolveLabels, useLabels };
+//# sourceMappingURL=chunk-GK4MVBBR.js.map
+//# sourceMappingURL=chunk-GK4MVBBR.js.map

package/dist/chunk-GK4MVBBR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/ui/card.tsx","../src/components/ui/center.tsx","../src/components/ui/stack.tsx","../src/components/ui/tabs.tsx","../src/lib/resolve-labels.ts","../src/components/providers/labels-provider.tsx"],"names":["jsx","Slot"],"mappings":"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","file":"chunk-GK4MVBBR.js","sourcesContent":["import * as React from \"react\"\n\nimport { cn } from \"@/lib/utils\"\n\n/**\n * Bordered container for grouping related content.\n *\n * @example\n * <Card><CardHeader><CardTitle>Title</CardTitle></CardHeader><CardContent>Body</CardContent></Card>\n *\n * @prop interactive - Adds hover and click styles when true\n */\nfunction Card({\n  className,\n  interactive = false,\n  ref,\n  ...props\n}: React.ComponentPropsWithRef<\"div\"> & { interactive?: boolean }) {\n  return (\n    <div\n      ref={ref}\n      data-slot=\"card\"\n      className={cn(\n        \"rounded-lg border-2 bg-card text-card-foreground shadow-sm\",\n        interactive &&\n          \"cursor-pointer hover:border-ring hover:shadow-md transition-all active:translate-y-[1.5px]\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\n/** Top section of a Card containing the title and description. */\nfunction CardHeader({\n  className,\n  ref,\n  ...props\n}: React.ComponentPropsWithRef<\"div\">) {\n  return (\n    <div\n      ref={ref}\n      data-slot=\"card-header\"\n      className={cn(\"flex flex-col space-y-1.5 p-6\", className)}\n      {...props}\n    />\n  )\n}\n\n/** Primary heading inside a CardHeader. */\nfunction CardTitle({\n  className,\n  ref,\n  ...props\n}: React.ComponentPropsWithRef<\"div\">) {\n  return (\n    <div\n      ref={ref}\n      data-slot=\"card-title\"\n      className={cn(\n        \"text-2xl font-semibold leading-none tracking-tight\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\n/** Secondary description text inside a CardHeader. */\nfunction CardDescription({\n  className,\n  ref,\n  ...props\n}: React.ComponentPropsWithRef<\"div\">) {\n  return (\n    <div\n      ref={ref}\n      data-slot=\"card-description\"\n      className={cn(\"text-sm text-muted-foreground\", className)}\n      {...props}\n    />\n  )\n}\n\n/** Main body area of a Card. */\nfunction CardContent({\n  className,\n  ref,\n  ...props\n}: React.ComponentPropsWithRef<\"div\">) {\n  return (\n    <div\n      ref={ref}\n      data-slot=\"card-content\"\n      className={cn(\"p-6 pt-0\", className)}\n      {...props}\n    />\n  )\n}\n\n/** Bottom section of a Card, typically for actions. */\nfunction CardFooter({\n  className,\n  ref,\n  ...props\n}: React.ComponentPropsWithRef<\"div\">) {\n  return (\n    <div\n      ref={ref}\n      data-slot=\"card-footer\"\n      className={cn(\"flex items-center p-6 pt-0\", className)}\n      {...props}\n    />\n  )\n}\n\nexport { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent }\n","import * as React from \"react\"\nimport { Slot } from \"@radix-ui/react-slot\"\n\nimport { cn } from \"@/lib/utils\"\n\nconst maxMap = {\n  sm: \"max-w-screen-sm\",\n  md: \"max-w-screen-md\",\n  lg: \"max-w-screen-lg\",\n  xl: \"max-w-screen-xl\",\n  \"2xl\": \"max-w-screen-2xl\",\n  full: \"max-w-full\",\n} as const\n\ntype Max = keyof typeof maxMap\n\n/** Props accepted by the Center component. */\ninterface CenterProps extends React.ComponentPropsWithRef<\"div\"> {\n  max?: Max\n  padding?: boolean\n  asChild?: boolean\n}\n\n/**\n * Horizontally centers its content with a configurable max-width and optional padding.\n *\n * @example\n * <Center max=\"lg\" padding>Content</Center>\n *\n * @prop max - Max-width breakpoint: \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\" | \"full\"\n * @prop padding - Adds responsive horizontal padding when true\n * @prop asChild - Merge props onto child element instead of rendering a div\n */\nfunction Center({\n  max = \"2xl\",\n  padding = true,\n  asChild = false,\n  className,\n  ref,\n  ...props\n}: CenterProps) {\n  const Comp = asChild ? Slot : \"div\"\n  return (\n    <Comp\n      data-slot=\"center\"\n      className={cn(\n        \"mx-auto w-full\",\n        maxMap[max],\n        padding && \"px-4 sm:px-6 lg:px-8\",\n        className,\n      )}\n      ref={ref}\n      {...props}\n    />\n  )\n}\n\nexport { Center, type CenterProps }\n","import * as React from \"react\"\nimport { Slot } from \"@radix-ui/react-slot\"\n\nimport { cn } from \"@/lib/utils\"\n\nconst gapMap = {\n  none: \"gap-0\",\n  xs: \"gap-1\",\n  sm: \"gap-2\",\n  md: \"gap-4\",\n  lg: \"gap-6\",\n  xl: \"gap-8\",\n  \"2xl\": \"gap-12\",\n} as const\n\nconst alignMap = {\n  start: \"items-start\",\n  center: \"items-center\",\n  end: \"items-end\",\n  stretch: \"items-stretch\",\n} as const\n\ntype Gap = keyof typeof gapMap\ntype Align = keyof typeof alignMap\n\ninterface StackProps extends React.ComponentPropsWithRef<\"div\"> {\n  gap?: Gap\n  align?: Align\n  asChild?: boolean\n}\n\n/**\n * A vertical flex container with configurable gap and alignment.\n *\n * @example\n * <Stack gap=\"lg\" align=\"center\">\n *   <div>Item 1</div>\n *   <div>Item 2</div>\n * </Stack>\n *\n * @prop gap - The spacing between children (none, xs, sm, md, lg, xl, 2xl).\n * @prop align - Cross-axis alignment of children.\n * @prop asChild - Merge props onto the child element instead of rendering a div.\n */\nfunction Stack({\n  gap = \"md\",\n  align = \"stretch\",\n  asChild = false,\n  className,\n  ref,\n  ...props\n}: StackProps) {\n  const Comp = asChild ? Slot : \"div\"\n  return (\n    <Comp\n      data-slot=\"stack\"\n      className={cn(\"flex flex-col\", gapMap[gap], alignMap[align], className)}\n      ref={ref}\n      {...props}\n    />\n  )\n}\n\nexport { Stack, type StackProps }\n","\"use client\"\n\nimport * as React from \"react\"\nimport * as TabsPrimitive from \"@radix-ui/react-tabs\"\n\nimport { cn } from \"@/lib/utils\"\n\n/** Root container for a tabbed interface built on Radix Tabs.\n *\n * @example\n * <Tabs defaultValue=\"tab1\"><TabsList><TabsTrigger value=\"tab1\">Tab</TabsTrigger></TabsList><TabsContent value=\"tab1\">Content</TabsContent></Tabs>\n */\nconst Tabs = TabsPrimitive.Root\n\n/** Horizontal container for tab triggers with a sunken background. */\nfunction TabsList({\n  className,\n  ref,\n  ...props\n}: React.ComponentPropsWithRef<typeof TabsPrimitive.List>) {\n  return (\n    <TabsPrimitive.List\n      ref={ref}\n      data-slot=\"tabs-list\"\n      className={cn(\n        \"inline-flex h-10 items-center justify-center rounded-lg bg-surface-sunken border-2 p-1 text-muted-foreground\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\n/** Individual tab button that activates its associated content panel. */\nfunction TabsTrigger({\n  className,\n  ref,\n  ...props\n}: React.ComponentPropsWithRef<typeof TabsPrimitive.Trigger>) {\n  return (\n    <TabsPrimitive.Trigger\n      ref={ref}\n      data-slot=\"tabs-trigger\"\n      className={cn(\n        \"inline-flex items-center justify-center whitespace-nowrap rounded-md px-3 py-1.5 text-sm font-medium ring-offset-background transition-all active:translate-y-[1.5px] transition-transform focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 data-[state=active]:bg-background data-[state=active]:text-foreground data-[state=active]:shadow-sm\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\n/** Content panel displayed when its matching tab trigger is active. */\nfunction TabsContent({\n  className,\n  ref,\n  ...props\n}: React.ComponentPropsWithRef<typeof TabsPrimitive.Content>) {\n  return (\n    <TabsPrimitive.Content\n      ref={ref}\n      data-slot=\"tabs-content\"\n      className={cn(\n        \"mt-2 ring-offset-background focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\nexport { Tabs, TabsList, TabsTrigger, TabsContent }\n","/**\n * Merges label overrides into a defaults object.\n *\n * Resolution order (last wins): defaults → context → prop.\n * All three layers share the same shape, but only `defaults` is required\n * to be complete — context and prop are partial overrides.\n */\nexport function resolveLabels<T extends object>(\n  defaults: T,\n  context?: Partial<NoInfer<T>>,\n  prop?: Partial<NoInfer<T>>,\n): T {\n  if (!context && !prop) return defaults\n  return { ...defaults, ...context, ...prop } as T\n}\n","\"use client\"\n\nimport * as React from \"react\"\n\nimport type { BreadcrumbLabels } from \"@/components/ui/breadcrumb\"\nimport type { CarouselLabels } from \"@/components/ui/carousel\"\nimport type { ComboboxLabels } from \"@/components/ui/combobox\"\nimport type { DataTableLabels } from \"@/components/ui/data-table\"\nimport type { DatePickerLabels } from \"@/components/ui/date-picker\"\nimport type { DialogLabels } from \"@/components/ui/dialog\"\nimport type { PaginationLabels } from \"@/components/ui/pagination\"\nimport type { SearchFieldLabels } from \"@/components/ui/search-field\"\nimport type { SheetLabels } from \"@/components/ui/sheet\"\nimport type { SidebarLabels } from \"@/components/ui/sidebar\"\nimport type { SpinnerLabels } from \"@/components/ui/spinner\"\nimport type { DirectionToggleLabels } from \"@/components/direction-toggle\"\nimport type { SiteHeaderLabels } from \"@/components/site-header\"\nimport type { SiteHeaderNavLabels } from \"@/components/site-header-nav\"\nimport type { SitePreferencesLabels } from \"@/components/site-preferences\"\nimport type { StatCardLabels } from \"@/components/stat-card\"\nimport type { ThemePickerLabels } from \"@/components/theme-picker\"\nimport type { ThemeToggleLabels } from \"@/components/theme-toggle\"\n\n/** All translatable strings for SubstrateUI components, keyed by component. */\ninterface SubstrateUILabels {\n  breadcrumb?: Partial<BreadcrumbLabels>\n  carousel?: Partial<CarouselLabels>\n  combobox?: Partial<ComboboxLabels>\n  dataTable?: Partial<DataTableLabels>\n  datePicker?: Partial<DatePickerLabels>\n  dialog?: Partial<DialogLabels>\n  pagination?: Partial<PaginationLabels>\n  searchField?: Partial<SearchFieldLabels>\n  sheet?: Partial<SheetLabels>\n  sidebar?: Partial<SidebarLabels>\n  spinner?: Partial<SpinnerLabels>\n  directionToggle?: Partial<DirectionToggleLabels>\n  siteHeader?: Partial<SiteHeaderLabels>\n  siteHeaderNav?: Partial<SiteHeaderNavLabels>\n  sitePreferences?: Partial<SitePreferencesLabels>\n  statCard?: Partial<StatCardLabels>\n  themePicker?: Partial<ThemePickerLabels>\n  themeToggle?: Partial<ThemeToggleLabels>\n}\n\nconst LabelsContext = React.createContext<SubstrateUILabels>({})\n\n/**\n * Provides translated labels to all SubstrateUI components.\n *\n * Wrap your app (or a subtree) in this provider to set translations once\n * rather than passing `labels` to every component instance. Per-instance\n * `labels` props still override the provider value.\n *\n * @example\n * <LabelsProvider labels={{ dialog: { close: \"Fermer\" }, spinner: { loading: \"Chargement…\" } }}>\n *   <App />\n * </LabelsProvider>\n */\nfunction LabelsProvider({\n  labels,\n  children,\n}: {\n  labels: SubstrateUILabels\n  children: React.ReactNode\n}) {\n  return (\n    <LabelsContext.Provider value={labels}>{children}</LabelsContext.Provider>\n  )\n}\n\n/** Read the current labels context. Used internally by SubstrateUI components. */\nfunction useLabels() {\n  return React.useContext(LabelsContext)\n}\n\nexport { LabelsProvider, useLabels, type SubstrateUILabels }\n"]}

package/dist/index.d.ts

@@ -129,14 +129,20 @@ interface BadgeProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProp
  */
 declare function Badge({ className, variant, ...props }: BadgeProps): react_jsx_runtime.JSX.Element;
 
+/** Translatable strings used by Breadcrumb. All keys have English defaults. */
+interface BreadcrumbLabels {
+    breadcrumb?: string;
+    more?: string;
+}
 /**
  * Navigation component showing the user's location in a page hierarchy.
  *
  * @example
  * <Breadcrumb><BreadcrumbList><BreadcrumbItem><BreadcrumbLink href="/">Home</BreadcrumbLink></BreadcrumbItem></BreadcrumbList></Breadcrumb>
  */
-declare function Breadcrumb({ ref, ...props }: React$1.ComponentPropsWithRef<"nav"> & {
+declare function Breadcrumb({ ref, "aria-label": ariaLabel, labels: labelsProp, ...props }: React$1.ComponentPropsWithRef<"nav"> & {
     separator?: React$1.ReactNode;
+    labels?: BreadcrumbLabels;
 }): react_jsx_runtime.JSX.Element;
 /** Ordered list container for breadcrumb items. */
 declare function BreadcrumbList({ className, ref, ...props }: React$1.ComponentPropsWithRef<"ol">): react_jsx_runtime.JSX.Element;
@@ -151,7 +157,11 @@ declare function BreadcrumbPage({ className, ref, ...props }: React$1.ComponentP
 /** Visual divider between breadcrumb items; defaults to a chevron icon. */
 declare function BreadcrumbSeparator({ children, className, ...props }: React$1.ComponentProps<"li">): react_jsx_runtime.JSX.Element;
 /** Ellipsis indicator used when breadcrumb items are collapsed. */
-declare function BreadcrumbEllipsis({ className, ...props }: React$1.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+declare function BreadcrumbEllipsis({ className, label, labels: labelsProp, ...props }: React$1.ComponentProps<"span"> & {
+    /** Screen-reader text for the ellipsis. @default "More" */
+    label?: string;
+    labels?: BreadcrumbLabels;
+}): react_jsx_runtime.JSX.Element;
 
 /** Button style variants (variant + size). Use with cn(buttonVariants({...})) for non-button elements. */
 declare const buttonVariants: (props?: ({
@@ -218,6 +228,11 @@ declare function CardContent({ className, ref, ...props }: React$1.ComponentProp
 /** Bottom section of a Card, typically for actions. */
 declare function CardFooter({ className, ref, ...props }: React$1.ComponentPropsWithRef<"div">): react_jsx_runtime.JSX.Element;
 
+/** Translatable strings used by Carousel navigation buttons. All keys have English defaults. */
+interface CarouselLabels {
+    previousSlide?: string;
+    nextSlide?: string;
+}
 /** Handle returned by Embla Carousel for programmatic control. */
 type CarouselApi = UseEmblaCarouselType[1];
 type UseCarouselParameters = Parameters<typeof useEmblaCarousel>;
@@ -243,9 +258,13 @@ declare function CarouselContent({ className, ref, ...props }: React$1.Component
 /** Individual slide within CarouselContent. */
 declare function CarouselItem({ className, ref, ...props }: React$1.ComponentPropsWithRef<"div">): react_jsx_runtime.JSX.Element;
 /** Button that scrolls the carousel to the previous slide. */
-declare function CarouselPrevious({ className, variant, size, ref, ...props }: React$1.ComponentPropsWithRef<typeof Button>): react_jsx_runtime.JSX.Element;
+declare function CarouselPrevious({ className, variant, size, labels: labelsProp, ref, ...props }: React$1.ComponentPropsWithRef<typeof Button> & {
+    labels?: CarouselLabels;
+}): react_jsx_runtime.JSX.Element;
 /** Button that scrolls the carousel to the next slide. */
-declare function CarouselNext({ className, variant, size, ref, ...props }: React$1.ComponentPropsWithRef<typeof Button>): react_jsx_runtime.JSX.Element;
+declare function CarouselNext({ className, variant, size, labels: labelsProp, ref, ...props }: React$1.ComponentPropsWithRef<typeof Button> & {
+    labels?: CarouselLabels;
+}): react_jsx_runtime.JSX.Element;
 
 declare const maxMap: {
     readonly sm: "max-w-screen-sm";
@@ -392,11 +411,21 @@ interface ComboboxOption {
     value: string;
     label: string;
 }
+/** Translatable strings used by Combobox. All keys have English defaults. */
+interface ComboboxLabels {
+    placeholder?: string;
+    searchPlaceholder?: string;
+    noResults?: string;
+}
 interface ComboboxBaseProps {
     options: ComboboxOption[];
+    /** @deprecated Use `labels.placeholder` instead. */
     placeholder?: string;
+    /** @deprecated Use `labels.searchPlaceholder` instead. */
     searchPlaceholder?: string;
+    /** @deprecated Use `labels.noResults` instead. */
     emptyMessage?: string;
+    labels?: ComboboxLabels;
     className?: string;
     disabled?: boolean;
 }
@@ -421,7 +450,7 @@ type ComboboxProps = ComboboxSingleProps | ComboboxMultipleProps;
  * @prop multiple - Enable multi-select mode when true
  * @prop placeholder - Text shown when no value is selected
  */
-declare function Combobox({ options, placeholder, searchPlaceholder, emptyMessage, className, disabled, ...props }: ComboboxProps): react_jsx_runtime.JSX.Element;
+declare function Combobox({ options, placeholder, searchPlaceholder, emptyMessage, labels: labelsProp, className, disabled, ...props }: ComboboxProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Command palette container with built-in search and keyboard navigation.
@@ -484,9 +513,25 @@ declare function ContextMenuSeparator({ className, ref, ...props }: React$1.Comp
 /** Keyboard shortcut hint displayed alongside a context menu item. */
 declare function ContextMenuShortcut({ className, ...props }: React$1.HTMLAttributes<HTMLSpanElement>): react_jsx_runtime.JSX.Element;
 
+/** Translatable strings used by DataTable sub-components. All keys have English defaults. */
+interface DataTableLabels {
+    previous?: string;
+    next?: string;
+    noResults?: string;
+    view?: string;
+    toggleColumns?: string;
+    selectAll?: string;
+    selectRow?: string;
+    rowsSelected?: (selected: number, total: number) => string;
+    pageOf?: (page: number, total: number) => string;
+    sortedAscending?: (title: string) => string;
+    sortedDescending?: (title: string) => string;
+    notSorted?: (title: string) => string;
+}
 interface DataTableColumnHeaderProps<TData, TValue> extends React$1.HTMLAttributes<HTMLDivElement> {
     column: _tanstack_react_table.Column<TData, TValue>;
     title: string;
+    labels?: DataTableLabels;
 }
 /**
  * Sortable column header button that toggles sort direction on click.
@@ -497,9 +542,10 @@ interface DataTableColumnHeaderProps<TData, TValue> extends React$1.HTMLAttribut
  * @prop column - TanStack Table column instance
  * @prop title - Display text for the header
  */
-declare function DataTableColumnHeader<TData, TValue>({ column, title, className, }: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime.JSX.Element;
+declare function DataTableColumnHeader<TData, TValue>({ column, title, className, labels: labelsProp, }: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime.JSX.Element;
 interface DataTableViewOptionsProps<TData> {
     table: _tanstack_react_table.Table<TData>;
+    labels?: DataTableLabels;
 }
 /**
  * Dropdown menu for toggling column visibility in a data table.
@@ -509,9 +555,10 @@ interface DataTableViewOptionsProps<TData> {
  *
  * @prop table - TanStack Table instance
  */
-declare function DataTableViewOptions<TData>({ table, }: DataTableViewOptionsProps<TData>): react_jsx_runtime.JSX.Element;
+declare function DataTableViewOptions<TData>({ table, labels: labelsProp, }: DataTableViewOptionsProps<TData>): react_jsx_runtime.JSX.Element;
 interface DataTablePaginationProps<TData> {
     table: _tanstack_react_table.Table<TData>;
+    labels?: DataTableLabels;
 }
 /**
  * Pagination controls displaying row selection count and page navigation.
@@ -521,7 +568,7 @@ interface DataTablePaginationProps<TData> {
  *
  * @prop table - TanStack Table instance
  */
-declare function DataTablePagination<TData>({ table, }: DataTablePaginationProps<TData>): react_jsx_runtime.JSX.Element;
+declare function DataTablePagination<TData>({ table, labels: labelsProp, }: DataTablePaginationProps<TData>): react_jsx_runtime.JSX.Element;
 interface DataTableToolbarProps {
     children?: React$1.ReactNode;
     className?: string;
@@ -539,12 +586,14 @@ declare function DataTableToolbar({ children, className }: DataTableToolbarProps
  * @example
  * const columns = [createSelectColumn<MyData>(), ...otherColumns]
  */
-declare function createSelectColumn<TData>(): ColumnDef<TData>;
+declare function createSelectColumn<TData>(labels?: DataTableLabels): ColumnDef<TData>;
 interface DataTableProps<TData, TValue> {
     columns: ColumnDef<TData, TValue>[];
     data: TData[];
     className?: string;
     toolbar?: React$1.ReactNode;
+    /** Translatable strings for all DataTable sub-components. */
+    labels?: DataTableLabels;
 }
 /**
  * Full-featured data table with sorting, filtering, pagination, and row selection.
@@ -556,12 +605,22 @@ interface DataTableProps<TData, TValue> {
  * @prop data - Array of row data
  * @prop toolbar - Optional toolbar rendered above the table
  */
-declare function DataTable<TData, TValue>({ columns, data, className, toolbar, }: DataTableProps<TData, TValue>): react_jsx_runtime.JSX.Element;
+declare function DataTable<TData, TValue>({ columns, data, className, toolbar, labels: labelsProp, }: DataTableProps<TData, TValue>): react_jsx_runtime.JSX.Element;
 
+/** Translatable strings used by DatePicker / DateRangePicker. All keys have English defaults. */
+interface DatePickerLabels {
+    placeholder?: string;
+    rangePlaceholder?: string;
+    locale?: string;
+    formatDate?: (date: Date) => string;
+    formatDateShort?: (date: Date) => string;
+}
 interface DatePickerProps {
     date?: Date;
     onDateChange?: (date: Date | undefined) => void;
+    /** @deprecated Use `labels.placeholder` instead. */
     placeholder?: string;
+    labels?: DatePickerLabels;
     className?: string;
     disabled?: boolean;
 }
@@ -575,11 +634,13 @@ interface DatePickerProps {
  * @prop onDateChange - Callback when a date is selected
  * @prop placeholder - Text shown when no date is selected
  */
-declare function DatePicker({ date, onDateChange, placeholder, className, disabled, }: DatePickerProps): react_jsx_runtime.JSX.Element;
+declare function DatePicker({ date, onDateChange, placeholder, labels: labelsProp, className, disabled, }: DatePickerProps): react_jsx_runtime.JSX.Element;
 interface DateRangePickerProps {
     dateRange?: DateRange;
     onDateRangeChange?: (range: DateRange | undefined) => void;
+    /** @deprecated Use `labels.rangePlaceholder` instead. */
     placeholder?: string;
+    labels?: DatePickerLabels;
     className?: string;
     disabled?: boolean;
 }
@@ -593,8 +654,12 @@ interface DateRangePickerProps {
  * @prop onDateRangeChange - Callback when the range changes
  * @prop placeholder - Text shown when no range is selected
  */
-declare function DateRangePicker({ dateRange, onDateRangeChange, placeholder, className, disabled, }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
+declare function DateRangePicker({ dateRange, onDateRangeChange, placeholder, labels: labelsProp, className, disabled, }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
 
+/** Translatable strings used by Dialog. All keys have English defaults. */
+interface DialogLabels {
+    close?: string;
+}
 /** Root dialog component that manages open/close state. */
 declare const Dialog: React$1.FC<DialogPrimitive.DialogProps>;
 /** Button or element that opens the dialog when clicked. */
@@ -614,7 +679,9 @@ declare function DialogOverlay({ className, ref, ...props }: React$1.ComponentPr
  *   <DialogContent><DialogHeader><DialogTitle>Title</DialogTitle></DialogHeader></DialogContent>
  * </Dialog>
  */
-declare function DialogContent({ className, children, ref, ...props }: React$1.ComponentPropsWithRef<typeof DialogPrimitive.Content>): react_jsx_runtime.JSX.Element;
+declare function DialogContent({ className, children, labels: labelsProp, ref, ...props }: React$1.ComponentPropsWithRef<typeof DialogPrimitive.Content> & {
+    labels?: DialogLabels;
+}): react_jsx_runtime.JSX.Element;
 /** Container for dialog title and description at the top of the dialog. */
 declare function DialogHeader({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
 /** Container for action buttons at the bottom of the dialog. */
@@ -1091,6 +1158,13 @@ declare function NavigationMenuViewport({ className, ref, ...props }: React$1.Co
 /** Animated arrow indicator that tracks the active navigation menu item. */
 declare function NavigationMenuIndicator({ className, ref, ...props }: React$1.ComponentPropsWithRef<typeof NavigationMenuPrimitive.Indicator>): react_jsx_runtime.JSX.Element;
 
+/** Translatable strings used by Pagination. All keys have English defaults. */
+interface PaginationLabels {
+    pagination?: string;
+    previous?: string;
+    next?: string;
+    morePages?: string;
+}
 /**
  * Navigation container for paginated content.
  *
@@ -1103,7 +1177,9 @@ declare function NavigationMenuIndicator({ className, ref, ...props }: React$1.C
  *   </PaginationContent>
  * </Pagination>
  */
-declare function Pagination({ className, ...props }: React$1.ComponentProps<"nav">): react_jsx_runtime.JSX.Element;
+declare function Pagination({ className, "aria-label": ariaLabel, labels: labelsProp, ...props }: React$1.ComponentProps<"nav"> & {
+    labels?: PaginationLabels;
+}): react_jsx_runtime.JSX.Element;
 /** Flex row container for pagination items. */
 declare function PaginationContent({ className, ref, ...props }: React$1.ComponentPropsWithRef<"ul">): react_jsx_runtime.JSX.Element;
 /** List item wrapper for a single pagination element. */
@@ -1119,11 +1195,23 @@ type PaginationLinkProps = {
  */
 declare function PaginationLink({ className, isActive, size, ...props }: PaginationLinkProps): react_jsx_runtime.JSX.Element;
 /** "Previous" pagination link with a left chevron icon. */
-declare function PaginationPrevious({ className, ...props }: React$1.ComponentProps<typeof PaginationLink>): react_jsx_runtime.JSX.Element;
+declare function PaginationPrevious({ className, label, labels: labelsProp, ...props }: React$1.ComponentProps<typeof PaginationLink> & {
+    /** Visible text label. @default "Previous" */
+    label?: string;
+    labels?: PaginationLabels;
+}): react_jsx_runtime.JSX.Element;
 /** "Next" pagination link with a right chevron icon. */
-declare function PaginationNext({ className, ...props }: React$1.ComponentProps<typeof PaginationLink>): react_jsx_runtime.JSX.Element;
+declare function PaginationNext({ className, label, labels: labelsProp, ...props }: React$1.ComponentProps<typeof PaginationLink> & {
+    /** Visible text label. @default "Next" */
+    label?: string;
+    labels?: PaginationLabels;
+}): react_jsx_runtime.JSX.Element;
 /** Ellipsis indicator representing omitted page numbers. */
-declare function PaginationEllipsis({ className, ...props }: React$1.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+declare function PaginationEllipsis({ className, label, labels: labelsProp, ...props }: React$1.ComponentProps<"span"> & {
+    /** Screen-reader text for the ellipsis. @default "More pages" */
+    label?: string;
+    labels?: PaginationLabels;
+}): react_jsx_runtime.JSX.Element;
 
 /** Root popover component that manages open/close state. */
 declare const Popover: React$1.FC<PopoverPrimitive.PopoverProps>;
@@ -1200,6 +1288,11 @@ declare function ScrollArea({ className, children, ref, ...props }: React$1.Comp
 /** A styled scrollbar track and thumb, used internally by ScrollArea. */
 declare function ScrollBar({ className, orientation, ref, ...props }: React$1.ComponentPropsWithRef<typeof ScrollAreaPrimitive.ScrollAreaScrollbar>): react_jsx_runtime.JSX.Element;
 
+/** Translatable strings used by SearchField. All keys have English defaults. */
+interface SearchFieldLabels {
+    placeholder?: string;
+    clearSearch?: string;
+}
 /** Props for the SearchField component. */
 interface SearchFieldProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange"> {
     placeholder?: string;
@@ -1207,6 +1300,9 @@ interface SearchFieldProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>,
     value: string;
     onChange: (value: string) => void;
     onClear?: () => void;
+    /** Accessible label for the clear button. @default "Clear search" */
+    clearLabel?: string;
+    labels?: SearchFieldLabels;
 }
 /**
  * A search input with a search icon, clearable value, and optional keyboard shortcut hint.
@@ -1219,7 +1315,7 @@ interface SearchFieldProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>,
  * @prop shortcut - Optional keyboard shortcut label displayed when empty.
  * @prop onClear - Optional callback fired when the clear button is clicked.
  */
-declare function SearchField({ placeholder, shortcut, value, onChange, onClear, className, ...props }: SearchFieldProps): react_jsx_runtime.JSX.Element;
+declare function SearchField({ placeholder, shortcut, value, onChange, onClear, clearLabel, labels: labelsProp, className, ...props }: SearchFieldProps): react_jsx_runtime.JSX.Element;
 
 /** Root component that manages select state and context. */
 declare const Select: React$1.FC<SelectPrimitive.SelectProps>;
@@ -1260,6 +1356,10 @@ declare function SelectSeparator({ className, ref, ...props }: React$1.Component
  */
 declare function Separator({ className, orientation, decorative, ref, ...props }: React$1.ComponentPropsWithRef<typeof SeparatorPrimitive.Root>): react_jsx_runtime.JSX.Element;
 
+/** Translatable strings used by Sheet. All keys have English defaults. */
+interface SheetLabels {
+    close?: string;
+}
 /** Root component that manages sheet open/closed state. */
 declare const Sheet: React$1.FC<DialogPrimitive.DialogProps>;
 /** A button or element that opens the sheet when clicked. */
@@ -1287,7 +1387,9 @@ interface SheetContentProps extends React$1.ComponentPropsWithRef<typeof DialogP
  *
  * @prop side - Which edge the sheet slides in from (top, bottom, left, right).
  */
-declare function SheetContent({ side, className, children, ref, ...props }: SheetContentProps): react_jsx_runtime.JSX.Element;
+declare function SheetContent({ side, className, children, labels: labelsProp, ref, ...props }: SheetContentProps & {
+    labels?: SheetLabels;
+}): react_jsx_runtime.JSX.Element;
 /** A layout container for the sheet's title and description at the top. */
 declare function SheetHeader({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
 /** A layout container for action buttons at the bottom of the sheet. */
@@ -1310,6 +1412,12 @@ declare const TooltipTrigger: React$1.ForwardRefExoticComponent<TooltipPrimitive
  */
 declare function TooltipContent({ className, sideOffset, ref, ...props }: React$1.ComponentPropsWithRef<typeof TooltipPrimitive.Content>): react_jsx_runtime.JSX.Element;
 
+/** Translatable strings used by Sidebar. All keys have English defaults. */
+interface SidebarLabels {
+    toggleSidebar?: string;
+    mobileTitle?: string;
+    mobileDescription?: string;
+}
 type SidebarContextProps = {
     state: "expanded" | "collapsed";
     open: boolean;
@@ -1342,15 +1450,28 @@ declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange: se
  * @prop variant - Visual variant (sidebar, floating, inset).
  * @prop collapsible - Collapse behavior (offcanvas, icon, none).
  */
-declare function Sidebar({ side, variant, collapsible, className, children, ref, ...props }: React$1.ComponentPropsWithRef<"div"> & {
+declare function Sidebar({ side, variant, collapsible, className, children, mobileTitle, mobileDescription, labels: labelsProp, ref, ...props }: React$1.ComponentPropsWithRef<"div"> & {
     side?: "left" | "right";
     variant?: "sidebar" | "floating" | "inset";
     collapsible?: "offcanvas" | "icon" | "none";
+    /** Screen-reader title for the mobile sheet. @default "Sidebar" */
+    mobileTitle?: string;
+    /** Screen-reader description for the mobile sheet. @default "Displays the mobile sidebar." */
+    mobileDescription?: string;
+    labels?: SidebarLabels;
 }): react_jsx_runtime.JSX.Element;
 /** A button that toggles the sidebar open/closed state. */
-declare function SidebarTrigger({ className, onClick, ref, ...props }: React$1.ComponentPropsWithRef<typeof Button>): react_jsx_runtime.JSX.Element;
+declare function SidebarTrigger({ className, onClick, label, labels: labelsProp, ref, ...props }: React$1.ComponentPropsWithRef<typeof Button> & {
+    /** Screen-reader label for the trigger button. @default "Toggle Sidebar" */
+    label?: string;
+    labels?: SidebarLabels;
+}): react_jsx_runtime.JSX.Element;
 /** A thin interactive rail at the sidebar edge for toggling via click or drag. */
-declare function SidebarRail({ className, ref, ...props }: React$1.ComponentPropsWithRef<"button">): react_jsx_runtime.JSX.Element;
+declare function SidebarRail({ className, label, labels: labelsProp, ref, ...props }: React$1.ComponentPropsWithRef<"button"> & {
+    /** Accessible label for the rail. @default "Toggle Sidebar" */
+    label?: string;
+    labels?: SidebarLabels;
+}): react_jsx_runtime.JSX.Element;
 /** The main content area adjacent to the sidebar. */
 declare function SidebarInset({ className, ref, ...props }: React$1.ComponentPropsWithRef<"main">): react_jsx_runtime.JSX.Element;
 /** A styled text input for use within the sidebar. */
@@ -1469,6 +1590,10 @@ interface SpacerProps extends React$1.ComponentPropsWithRef<"div"> {
  */
 declare function Spacer({ size, axis, className, style, ...props }: SpacerProps): react_jsx_runtime.JSX.Element;
 
+/** Translatable strings used by Spinner. All keys have English defaults. */
+interface SpinnerLabels {
+    loading?: string;
+}
 /** Spinner size variants. Use with cn(spinnerVariants({...})) for non-spinner elements. */
 declare const spinnerVariants: (props?: ({
     size?: "default" | "sm" | "lg" | null | undefined;
@@ -1481,7 +1606,9 @@ declare const spinnerVariants: (props?: ({
  *
  * @prop size - The spinner diameter (sm, default, lg).
  */
-declare function Spinner({ className, size, ...props }: React$1.HTMLAttributes<HTMLDivElement> & VariantProps<typeof spinnerVariants>): react_jsx_runtime.JSX.Element;
+declare function Spinner({ className, size, labels: labelsProp, ...props }: React$1.HTMLAttributes<HTMLDivElement> & VariantProps<typeof spinnerVariants> & {
+    labels?: SpinnerLabels;
+}): react_jsx_runtime.JSX.Element;
 
 declare const gapMap: {
     readonly none: "gap-0";
@@ -1606,4 +1733,4 @@ declare function Code({ className, ...props }: React$1.HTMLAttributes<HTMLElemen
 /** Inline monospace span without background styling. */
 declare function Mono({ className, ...props }: React$1.HTMLAttributes<HTMLSpanElement>): react_jsx_runtime.JSX.Element;
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AspectRatio, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, type ButtonProps, Calendar, CalendarDayButton, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, Center, type CenterProps, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, Checkbox, Cluster, type ClusterProps, Code, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, type ComboboxOption, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DataTable, DataTableColumnHeader, DataTablePagination, DataTableToolbar, DataTableViewOptions, DatePicker, DateRangePicker, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type Direction, DirectionProvider, Divider, type DividerProps, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyAction, EmptyDescription, EmptyIcon, EmptyTitle, Field, FieldError, FieldHint, FieldLabel, Fieldset, Form, FormActions, FormActionsPrimary, FormActionsSecondary, FormSection, FormSectionContent, FormSectionDescription, FormSectionHeader, FormSectionTitle, Grid, type GridProps, H1, H2, H3, H4, HoverCard, HoverCardContent, HoverCardTrigger, Input, InputGroup, InputGroupPrefix, InputGroupSuffix, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, Item, ItemIcon, ItemLabel, Kbd, Label, Large, Lead, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, Mono, Muted, NativeSelect, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, P, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverContent, PopoverTrigger, Progress, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollBar, SearchField, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, Small, Spacer, type SpacerProps, Spinner, Stack, type StackProps, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Textarea, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, badgeVariants, buttonVariants, createSelectColumn, nativeSelectVariants, navigationMenuTriggerStyle, spinnerVariants, toggleVariants, useDirection, useFieldContext, useSidebar };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AspectRatio, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, type BreadcrumbLabels, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, type ButtonProps, Calendar, CalendarDayButton, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselItem, type CarouselLabels, CarouselNext, CarouselPrevious, Center, type CenterProps, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, Checkbox, Cluster, type ClusterProps, Code, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, type ComboboxLabels, type ComboboxOption, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DataTable, DataTableColumnHeader, type DataTableLabels, DataTablePagination, DataTableToolbar, DataTableViewOptions, DatePicker, type DatePickerLabels, DateRangePicker, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, type DialogLabels, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type Direction, DirectionProvider, Divider, type DividerProps, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyAction, EmptyDescription, EmptyIcon, EmptyTitle, Field, FieldError, FieldHint, FieldLabel, Fieldset, Form, FormActions, FormActionsPrimary, FormActionsSecondary, FormSection, FormSectionContent, FormSectionDescription, FormSectionHeader, FormSectionTitle, Grid, type GridProps, H1, H2, H3, H4, HoverCard, HoverCardContent, HoverCardTrigger, Input, InputGroup, InputGroupPrefix, InputGroupSuffix, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, Item, ItemIcon, ItemLabel, Kbd, Label, Large, Lead, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, Mono, Muted, NativeSelect, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, P, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, type PaginationLabels, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverContent, PopoverTrigger, Progress, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollBar, SearchField, type SearchFieldLabels, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, type SheetLabels, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, type SidebarLabels, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, Small, Spacer, type SpacerProps, Spinner, type SpinnerLabels, Stack, type StackProps, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Textarea, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, badgeVariants, buttonVariants, createSelectColumn, nativeSelectVariants, navigationMenuTriggerStyle, sidebarMenuButtonVariants, spinnerVariants, toggleVariants, useDirection, useFieldContext, useSidebar };