@minidev.fun/ui 1.0.1

package/src/components/ui/table.tsx

@@ -0,0 +1,167 @@
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+type TableProps = React.ComponentProps<"table">;
+
+/**
+ * Root table component with automatic horizontal scrolling container.
+ * Wraps standard HTML table element with responsive overflow behavior.
+ */
+function Table({ className, ...props }: TableProps) {
+  return (
+    <div
+      data-slot="table-container"
+      className="relative w-full p-8 overflow-x-auto"
+    >
+      <table
+        data-slot="table"
+        className={cn("w-full caption-bottom text-sm", className)}
+        {...props}
+      />
+    </div>
+  );
+}
+
+type TableHeaderProps = React.ComponentProps<"thead">;
+
+/**
+ * Table header section for column headings.
+ * Use with TableHead for individual header cells.
+ */
+function TableHeader({ className, ...props }: TableHeaderProps) {
+  return (
+    <thead
+      data-slot="table-header"
+      className={cn("[&_tr]:border-b", className)}
+      {...props}
+    />
+  );
+}
+
+type TableBodyProps = React.ComponentProps<"tbody">;
+
+/**
+ * Table body section for data rows.
+ * Use with TableRow and TableCell for row content.
+ */
+function TableBody({ className, ...props }: TableBodyProps) {
+  return (
+    <tbody
+      data-slot="table-body"
+      className={cn("[&_tr:last-child]:border-0", className)}
+      {...props}
+    />
+  );
+}
+
+type TableFooterProps = React.ComponentProps<"tfoot">;
+
+/**
+ * Table footer section for summary rows.
+ * Typically used for totals or aggregated data.
+ */
+function TableFooter({ className, ...props }: TableFooterProps) {
+  return (
+    <tfoot
+      data-slot="table-footer"
+      className={cn(
+        "bg-muted/50 border-t font-medium [&>tr]:last:border-b-0",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+type TableRowProps = React.ComponentProps<"tr">;
+
+/**
+ * Table row with hover and selection states.
+ * Add `data-state="selected"` attribute to highlight row.
+ */
+function TableRow({ className, ...props }: TableRowProps) {
+  return (
+    <tr
+      data-slot="table-row"
+      className={cn(
+        "hover:bg-muted/50 data-[state=selected]:bg-muted h-10 border-b transition-colors",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+type TableHeadProps = React.ComponentProps<"th">;
+
+/**
+ * Table header cell for column titles.
+ * Use within TableHeader > TableRow.
+ */
+function TableHead({ className, ...props }: TableHeadProps) {
+  return (
+    <th
+      data-slot="table-head"
+      className={cn(
+        "text-foreground h-10 px-2 text-left align-middle font-medium whitespace-nowrap [&:has([role=checkbox])]:pr-0",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+type TableCellProps = React.ComponentProps<"td">;
+
+/**
+ * Table data cell for row content.
+ * Use within TableBody > TableRow.
+ */
+function TableCell({ className, ...props }: TableCellProps) {
+  return (
+    <td
+      data-slot="table-cell"
+      className={cn(
+        "p-2 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+type TableCaptionProps = React.ComponentProps<"caption">;
+
+/**
+ * Table caption for accessibility and description.
+ * Rendered below the table by default.
+ */
+function TableCaption({ className, ...props }: TableCaptionProps) {
+  return (
+    <caption
+      data-slot="table-caption"
+      className={cn("text-muted-foreground mt-4 pt-2 text-sm", className)}
+      {...props}
+    />
+  );
+}
+
+export {
+  Table,
+  TableHeader,
+  TableBody,
+  TableFooter,
+  TableHead,
+  TableRow,
+  TableCell,
+  TableCaption,
+  type TableProps,
+  type TableHeaderProps,
+  type TableBodyProps,
+  type TableFooterProps,
+  type TableHeadProps,
+  type TableRowProps,
+  type TableCellProps,
+  type TableCaptionProps,
+};

package/src/components/ui/tabs.tsx

@@ -0,0 +1,115 @@
+"use client";
+
+import { Tabs as TabsPrimitive } from "@base-ui/react/tabs";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+
+type TabsProps = TabsPrimitive.Root.Props;
+
+/**
+ * Root container for tabs component that manages tab state and orientation.
+ * Supports both controlled and uncontrolled usage with horizontal or vertical layout.
+ */
+function Tabs({ className, orientation = "horizontal", ...props }: TabsProps) {
+  return (
+    <TabsPrimitive.Root
+      data-slot="tabs"
+      data-orientation={orientation}
+      className={cn(
+        "gap-2 group/tabs flex data-[orientation=horizontal]:flex-col",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+const tabsListVariants = cva(
+  "rounded-full p-[4px] group-data-horizontal/tabs:h-9 data-[variant=line]:rounded-md group/tabs-list text-muted-foreground inline-flex w-fit items-center justify-center group-data-[orientation=vertical]/tabs:h-fit group-data-[orientation=vertical]/tabs:flex-col",
+  {
+    variants: {
+      variant: {
+        default: "bg-muted",
+        line: "gap-1 bg-transparent",
+      },
+    },
+    compoundVariants: [
+      {
+        class:
+          "group-data-[orientation=vertical]/tabs:rounded-4xl group-data-[orientation=vertical]/tabs:p-1.5",
+      },
+    ],
+    defaultVariants: {
+      variant: "default",
+    },
+  },
+);
+
+type TabsListProps = TabsPrimitive.List.Props &
+  VariantProps<typeof tabsListVariants>;
+
+/**
+ * Container for tab triggers with two visual variants.
+ * @param variant - Visual style: "default" (background highlight) or "line" (underline indicator). @default "default"
+ */
+function TabsList({ className, variant = "default", ...props }: TabsListProps) {
+  return (
+    <TabsPrimitive.List
+      data-slot="tabs-list"
+      data-variant={variant}
+      className={cn(tabsListVariants({ variant }), className)}
+      {...props}
+    />
+  );
+}
+
+type TabsTriggerProps = TabsPrimitive.Tab.Props;
+
+/**
+ * Individual tab button that activates the corresponding panel.
+ * Supports icons, badges, and disabled state. Active tab has visual highlight or underline based on variant.
+ */
+function TabsTrigger({ className, ...props }: TabsTriggerProps) {
+  return (
+    <TabsPrimitive.Tab
+      data-slot="tabs-trigger"
+      className={cn(
+        "gap-1.5 rounded-full border border-transparent px-3 py-2 text-sm font-medium group-data-[variant=default]/tabs-list:data-active:shadow-sm group-data-[variant=line]/tabs-list:data-active:shadow-none [&_svg:not([class*='size-'])]:size-4 focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:outline-ring text-foreground/60 hover:text-foreground dark:text-muted-foreground dark:hover:text-foreground relative inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center whitespace-nowrap transition-all group-data-[orientation=vertical]/tabs:w-full group-data-[orientation=vertical]/tabs:justify-start focus-visible:ring-[3px] focus-visible:outline-1 data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0",
+        "group-data-[variant=line]/tabs-list:bg-transparent group-data-[variant=line]/tabs-list:data-active:bg-transparent dark:group-data-[variant=line]/tabs-list:data-active:border-transparent dark:group-data-[variant=line]/tabs-list:data-active:bg-transparent",
+        "data-active:bg-background dark:data-active:text-foreground dark:data-active:border-input dark:data-active:bg-input/30 data-active:text-foreground",
+        "after:bg-foreground after:absolute after:opacity-0 after:transition-opacity group-data-[orientation=horizontal]/tabs:after:inset-x-0 group-data-[orientation=horizontal]/tabs:after:bottom-[-5px] group-data-[orientation=horizontal]/tabs:after:h-0.5 group-data-[orientation=vertical]/tabs:after:inset-y-0 group-data-[orientation=vertical]/tabs:after:-right-1 group-data-[orientation=vertical]/tabs:after:w-0.5 group-data-[variant=line]/tabs-list:data-active:after:opacity-100",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+type TabsContentProps = TabsPrimitive.Panel.Props;
+
+/**
+ * Content panel that displays when its corresponding tab is active.
+ * Automatically hidden/shown based on active tab value.
+ */
+function TabsContent({ className, ...props }: TabsContentProps) {
+  return (
+    <TabsPrimitive.Panel
+      data-slot="tabs-content"
+      className={cn("text-sm flex-1 outline-none", className)}
+      {...props}
+    />
+  );
+}
+
+export {
+  Tabs,
+  TabsList,
+  TabsTrigger,
+  TabsContent,
+  tabsListVariants,
+  type TabsProps,
+  type TabsListProps,
+  type TabsTriggerProps,
+  type TabsContentProps,
+};

package/src/components/ui/textarea.tsx

@@ -0,0 +1,33 @@
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+type TextareaProps = React.ComponentProps<"textarea">;
+
+/**
+ * Multi-line text input with auto-grow behavior and validation states.
+ *
+ * Features:
+ * - Auto-grows vertically with content (field-sizing-content)
+ * - Error state via aria-invalid
+ * - Supports all native textarea props (rows, disabled, etc.)
+ *
+ * @example
+ * ```tsx
+ * <Textarea placeholder="Enter description..." rows={4} />
+ * ```
+ */
+function Textarea({ className, ...props }: TextareaProps) {
+  return (
+    <textarea
+      data-slot="textarea"
+      className={cn(
+        "border-input dark:bg-input/30 focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive dark:aria-invalid:border-destructive/50 rounded-3xl border bg-transparent px-3 py-2.5 text-base shadow-xs transition-[color,box-shadow] focus-visible:ring-[3px] aria-invalid:ring-[3px] md:text-sm placeholder:text-muted-foreground flex field-sizing-content min-h-16 w-full outline-none disabled:cursor-not-allowed disabled:opacity-50",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+export { Textarea, type TextareaProps };

package/src/components/ui/toast.tsx

@@ -0,0 +1,69 @@
+import * as React from "react";
+import { XIcon, CheckCircle2, AlertCircle, Info, Loader2 } from "lucide-react";
+import { cn } from "@/lib/utils";
+
+export type ToastVariant =
+  | "default"
+  | "success"
+  | "destructive"
+  | "info"
+  | "loading";
+
+interface ToastProps extends React.HTMLAttributes<HTMLDivElement> {
+  title?: string;
+  description?: string;
+  variant?: ToastVariant;
+  onClose?: () => void;
+}
+
+const variantIcons = {
+  default: null,
+  success: <CheckCircle2 className="size-5 text-success" />,
+  destructive: <AlertCircle className="size-5 text-destructive" />,
+  info: <Info className="size-5 text-info" />,
+  loading: <Loader2 className="size-5 animate-spin text-muted-foreground" />,
+};
+
+function Toast({
+  title,
+  description,
+  variant = "default",
+  className,
+  onClose,
+  children,
+  ...props
+}: ToastProps) {
+  return (
+    <div
+      data-slot="toast"
+      data-variant={variant}
+      className={cn(
+        "group pointer-events-auto relative flex w-full items-center justify-between space-x-4 overflow-hidden rounded-4.5xl border p-5 pr-8 transition-all",
+        "bg-card/20 border-border",
+        className,
+      )}
+      {...props}
+    >
+      <div className="flex gap-3">
+        {variantIcons[variant]}
+        <div className="grid gap-1">
+          {title && <div className="text-sm font-semibold">{title}</div>}
+          {description && (
+            <div className="text-xs opacity-90 text-muted-foreground">
+              {description}
+            </div>
+          )}
+          {children}
+        </div>
+      </div>
+      <button
+        onClick={onClose}
+        className="absolute right-3 top-2 p-1 text-foreground/50 opacity-0 transition-opacity hover:text-foreground group-hover:opacity-100"
+      >
+        <XIcon className="size-4" />
+      </button>
+    </div>
+  );
+}
+
+export { Toast, type ToastProps };

package/src/components/ui/toggle-group.tsx

@@ -0,0 +1,112 @@
+"use client";
+
+import * as React from "react";
+import { Toggle as TogglePrimitive } from "@base-ui/react/toggle";
+import { ToggleGroup as ToggleGroupPrimitive } from "@base-ui/react/toggle-group";
+import { type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+import { toggleVariants } from "@/components/ui/toggle";
+
+const ToggleGroupContext = React.createContext<
+  VariantProps<typeof toggleVariants> & {
+    spacing?: number;
+    orientation?: "horizontal" | "vertical";
+  }
+>({
+  size: "default",
+  variant: "default",
+  spacing: 0,
+  orientation: "horizontal",
+});
+
+type ToggleGroupProps = ToggleGroupPrimitive.Props &
+  VariantProps<typeof toggleVariants> & {
+    /** Gap between items in spacing units. Set to 0 for joined buttons. @default 0 */
+    spacing?: number;
+    /** Layout direction of the toggle group. @default "horizontal" */
+    orientation?: "horizontal" | "vertical";
+  };
+
+/**
+ * Container for a group of toggle buttons that share state. Supports both single and multiple selection modes.
+ *
+ * By default, the toggle group allows multiple selection. Use `multiple={false}` for single selection.
+ * All items inherit variant and size from the group unless explicitly overridden.
+ */
+function ToggleGroup({
+  className,
+  variant,
+  size,
+  spacing = 0,
+  orientation = "horizontal",
+  children,
+  ...props
+}: ToggleGroupProps) {
+  return (
+    <ToggleGroupPrimitive
+      data-slot="toggle-group"
+      data-variant={variant}
+      data-size={size}
+      data-spacing={spacing}
+      data-orientation={orientation}
+      style={{ "--gap": spacing } as React.CSSProperties}
+      className={cn(
+        "rounded-full data-[spacing=0]:data-[variant=outline]:shadow-none group/toggle-group flex w-fit flex-row items-center gap-[--spacing(var(--gap))] data-[orientation=vertical]:flex-col data-[orientation=vertical]:items-stretch",
+        className,
+      )}
+      {...props}
+    >
+      <ToggleGroupContext.Provider
+        value={{ variant, size, spacing, orientation }}
+      >
+        {children}
+      </ToggleGroupContext.Provider>
+    </ToggleGroupPrimitive>
+  );
+}
+
+type ToggleGroupItemProps = TogglePrimitive.Props &
+  VariantProps<typeof toggleVariants>;
+
+/**
+ * Individual toggle button within a ToggleGroup. Inherits variant and size from parent group context.
+ *
+ * When spacing={0}, items are joined together with shared borders. Use `aria-label` for icon-only buttons.
+ */
+function ToggleGroupItem({
+  className,
+  children,
+  variant = "default",
+  size = "default",
+  ...props
+}: ToggleGroupItemProps) {
+  const context = React.useContext(ToggleGroupContext);
+
+  return (
+    <TogglePrimitive
+      data-slot="toggle-group-item"
+      data-variant={context.variant || variant}
+      data-size={context.size || size}
+      data-spacing={context.spacing}
+      className={cn(
+        "data-[state=on]:bg-muted group-data-[spacing=0]/toggle-group:rounded-full group-data-[spacing=0]/toggle-group:px-2 group-data-[spacing=0]/toggle-group:shadow-none group-data-horizontal/toggle-group:data-[spacing=0]:first:rounded-l-full group-data-vertical/toggle-group:data-[spacing=0]:first:rounded-t-full group-data-horizontal/toggle-group:data-[spacing=0]:last:rounded-r-full group-data-vertical/toggle-group:data-[spacing=0]:last:rounded-b-full shrink-0 focus:z-10 focus-visible:z-10 group-data-horizontal/toggle-group:data-[spacing=0]:data-[variant=outline]:border-l-0 group-data-vertical/toggle-group:data-[spacing=0]:data-[variant=outline]:border-t-0 group-data-horizontal/toggle-group:data-[spacing=0]:data-[variant=outline]:first:border-l group-data-vertical/toggle-group:data-[spacing=0]:data-[variant=outline]:first:border-t",
+        toggleVariants({
+          variant: context.variant || variant,
+          size: context.size || size,
+        }),
+        className,
+      )}
+      {...props}
+    >
+      {children}
+    </TogglePrimitive>
+  );
+}
+
+export {
+  ToggleGroup,
+  ToggleGroupItem,
+  type ToggleGroupProps,
+  type ToggleGroupItemProps,
+};

package/src/components/ui/toggle.tsx

@@ -0,0 +1,48 @@
+import { Toggle as TogglePrimitive } from "@base-ui/react/toggle";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+
+const toggleVariants = cva(
+  "hover:text-foreground aria-pressed:bg-muted focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive gap-1 rounded-full text-sm font-medium transition-[color,box-shadow] [&_svg:not([class*='size-'])]:size-4 group/toggle hover:bg-muted inline-flex items-center justify-center whitespace-nowrap outline-none focus-visible:ring-[3px] disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0",
+  {
+    variants: {
+      variant: {
+        default: "bg-transparent",
+        outline: "border-input hover:bg-muted border bg-transparent shadow-xs",
+      },
+      size: {
+        default: "h-9 min-w-9 px-2.5 py-0.5",
+        sm: "h-8 min-w-8 px-1.5",
+        lg: "h-10 min-w-10 px-3 py-1",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  },
+);
+
+type ToggleProps = TogglePrimitive.Props & VariantProps<typeof toggleVariants>;
+
+/**
+ * Two-state button that can be pressed (on) or unpressed (off).
+ * Supports icons, text, or both. Commonly used for formatting toolbars, view mode toggles, and preference switches.
+ */
+function Toggle({
+  className,
+  variant = "default",
+  size = "default",
+  ...props
+}: ToggleProps) {
+  return (
+    <TogglePrimitive
+      data-slot="toggle"
+      className={cn(toggleVariants({ variant, size, className }))}
+      {...props}
+    />
+  );
+}
+
+export { Toggle, toggleVariants, type ToggleProps };

package/src/components/ui/tooltip.tsx

@@ -0,0 +1,100 @@
+"use client";
+
+import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip";
+
+import { cn } from "@/lib/utils";
+
+type TooltipProviderProps = TooltipPrimitive.Provider.Props;
+
+/**
+ * Tooltip provider with configurable delay.
+ * Manages shared tooltip state across nested tooltips.
+ */
+function TooltipProvider({ delay = 0, ...props }: TooltipProviderProps) {
+  return (
+    <TooltipPrimitive.Provider
+      data-slot="tooltip-provider"
+      delay={delay}
+      {...props}
+    />
+  );
+}
+
+type TooltipProps = TooltipPrimitive.Root.Props;
+
+/**
+ * Tooltip root component. Displays contextual information on hover or focus.
+ * Automatically wraps in TooltipProvider for convenience.
+ */
+function Tooltip({ ...props }: TooltipProps) {
+  return (
+    <TooltipProvider>
+      <TooltipPrimitive.Root data-slot="tooltip" {...props} />
+    </TooltipProvider>
+  );
+}
+
+type TooltipTriggerProps = TooltipPrimitive.Trigger.Props;
+
+/**
+ * Trigger element that shows the tooltip on hover or focus.
+ * Use `render` prop to customize with any focusable element.
+ */
+function TooltipTrigger({ ...props }: TooltipTriggerProps) {
+  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />;
+}
+
+type TooltipContentProps = TooltipPrimitive.Popup.Props &
+  Pick<
+    TooltipPrimitive.Positioner.Props,
+    "align" | "alignOffset" | "side" | "sideOffset"
+  >;
+
+/**
+ * Tooltip content popup with automatic portal, positioning, and arrow.
+ * Includes smooth animations and collision detection.
+ */
+function TooltipContent({
+  className,
+  side = "top",
+  sideOffset = 4,
+  align = "center",
+  alignOffset = 0,
+  children,
+  ...props
+}: TooltipContentProps) {
+  return (
+    <TooltipPrimitive.Portal>
+      <TooltipPrimitive.Positioner
+        align={align}
+        alignOffset={alignOffset}
+        side={side}
+        sideOffset={sideOffset}
+        className="isolate z-50"
+      >
+        <TooltipPrimitive.Popup
+          data-slot="tooltip-content"
+          className={cn(
+            "data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 rounded-full px-3 py-1.5 text-xs bg-foreground text-background z-50 w-fit max-w-xs origin-(--transform-origin)",
+            className,
+          )}
+          {...props}
+        >
+          {children}
+          <TooltipPrimitive.Arrow className="size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground z-50 data-[side=bottom]:top-1 data-[side=left]:top-1/2! data-[side=left]:-right-1 data-[side=left]:-translate-y-1/2 data-[side=right]:top-1/2! data-[side=right]:-left-1 data-[side=right]:-translate-y-1/2 data-[side=top]:-bottom-2.5" />
+        </TooltipPrimitive.Popup>
+      </TooltipPrimitive.Positioner>
+    </TooltipPrimitive.Portal>
+  );
+}
+
+export {
+  Tooltip,
+  TooltipTrigger,
+  TooltipContent,
+  TooltipProvider,
+  type TooltipProps,
+  type TooltipTriggerProps,
+  type TooltipContentProps,
+  type TooltipProviderProps,
+};

package/src/hooks/use-mobile.ts

@@ -0,0 +1,37 @@
+import * as React from "react";
+
+const MOBILE_BREAKPOINT = 768;
+
+/**
+ * Detects mobile viewport using matchMedia.
+ * Returns `false` during SSR/hydration, then updates reactively on resize.
+ *
+ * @returns `true` when viewport width < 768px, `false` otherwise
+ *
+ * @example
+ * ```tsx
+ * import { useIsMobile } from "@minidev.fun/ui/hooks/use-mobile"
+ *
+ * function ResponsiveLayout() {
+ *   const isMobile = useIsMobile()
+ *   return isMobile ? <MobileNav /> : <DesktopNav />
+ * }
+ * ```
+ */
+export function useIsMobile() {
+  const [isMobile, setIsMobile] = React.useState<boolean | undefined>(
+    undefined,
+  );
+
+  React.useEffect(() => {
+    const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);
+    const onChange = () => {
+      setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
+    };
+    mql.addEventListener("change", onChange);
+    setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
+    return () => mql.removeEventListener("change", onChange);
+  }, []);
+
+  return !!isMobile;
+}