@minidev.fun/ui 1.0.1

package/src/components/ui/modal.tsx

@@ -0,0 +1,186 @@
+import * as React from "react";
+import { Dialog as DialogPrimitive } from "@base-ui/react/dialog";
+
+import { cn } from "@/lib/utils";
+import { Button } from "@/components/ui/button";
+
+type ModalProps = DialogPrimitive.Root.Props;
+
+/** Root container for modal dialog. Manages open state and accessibility. */
+function Modal({ ...props }: ModalProps) {
+  return <DialogPrimitive.Root data-slot="modal" {...props} />;
+}
+
+type ModalTriggerProps = DialogPrimitive.Trigger.Props;
+
+/** Button that opens the modal. Use `render` prop to customize. */
+function ModalTrigger({ ...props }: ModalTriggerProps) {
+  return <DialogPrimitive.Trigger data-slot="modal-trigger" {...props} />;
+}
+
+type ModalPortalProps = DialogPrimitive.Portal.Props;
+
+/** Portal container for modal content and overlay. */
+function ModalPortal({ ...props }: ModalPortalProps) {
+  return <DialogPrimitive.Portal data-slot="modal-portal" {...props} />;
+}
+
+type ModalOverlayProps = DialogPrimitive.Backdrop.Props;
+
+/** Semi-transparent backdrop overlay with frosted glass effect. */
+function ModalOverlay({ className, ...props }: ModalOverlayProps) {
+  return (
+    <DialogPrimitive.Backdrop
+      data-slot="modal-overlay"
+      className={cn(
+        "fixed inset-0 z-50 bg-black/10 supports-backdrop-filter:backdrop-blur-xs isolate",
+        "data-open:animate-in data-closed:animate-out",
+        "data-open:fade-in-0 data-closed:fade-out-0 duration-100",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+type ModalContentProps = DialogPrimitive.Popup.Props & {
+  /** Modal size variant. @default "default" */
+  size?: "default" | "sm" | "lg";
+};
+
+/**
+ * Modal content with automatic portal and backdrop.
+ * Centered, animated popup with size variants.
+ */
+function ModalContent({
+  className,
+  size = "default",
+  ...props
+}: ModalContentProps) {
+  return (
+    <ModalPortal>
+      <ModalOverlay />
+      <DialogPrimitive.Popup
+        data-slot="modal-content"
+        data-size={size}
+        className={cn(
+          "fixed top-1/2 left-1/2 z-50 grid w-full -translate-x-1/2 -translate-y-1/2",
+          "gap-6 rounded-6xl p-6 outline-none",
+          "bg-popover text-popover-foreground ring-1 ring-border",
+          "data-open:animate-in data-closed:animate-out",
+          "data-open:fade-in-0 data-closed:fade-out-0",
+          "data-open:zoom-in-95 data-closed:zoom-out-95 duration-100",
+          "data-[size=sm]:max-w-sm",
+          "data-[size=default]:max-w-lg",
+          "data-[size=lg]:max-w-2xl",
+          className,
+        )}
+        {...props}
+      />
+    </ModalPortal>
+  );
+}
+
+type ModalHeaderProps = React.ComponentProps<"div">;
+
+/** Header section for title and description. */
+function ModalHeader({ className, ...props }: ModalHeaderProps) {
+  return (
+    <div
+      data-slot="modal-header"
+      className={cn("grid gap-1.5 text-left", className)}
+      {...props}
+    />
+  );
+}
+
+type ModalFooterProps = React.ComponentProps<"div">;
+
+/** Footer section for action buttons. */
+function ModalFooter({ className, ...props }: ModalFooterProps) {
+  return (
+    <div
+      data-slot="modal-footer"
+      className={cn(
+        "flex flex-col-reverse gap-2 sm:flex-row sm:justify-end",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+type ModalTitleProps = React.ComponentProps<typeof DialogPrimitive.Title>;
+
+/** Modal title. Automatically announced by screen readers. */
+function ModalTitle({ className, ...props }: ModalTitleProps) {
+  return (
+    <DialogPrimitive.Title
+      data-slot="modal-title"
+      className={cn("text-lg font-medium", className)}
+      {...props}
+    />
+  );
+}
+
+type ModalDescriptionProps = React.ComponentProps<
+  typeof DialogPrimitive.Description
+>;
+
+/** Modal description text. Supports links with automatic styling. */
+function ModalDescription({ className, ...props }: ModalDescriptionProps) {
+  return (
+    <DialogPrimitive.Description
+      data-slot="modal-description"
+      className={cn(
+        "text-sm text-muted-foreground text-balance md:text-pretty",
+        "*:[a]:underline *:[a]:underline-offset-3 *:[a]:hover:text-foreground",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+type ModalCloseProps = DialogPrimitive.Close.Props &
+  Pick<React.ComponentProps<typeof Button>, "variant" | "size">;
+
+/** Button that closes the modal. Defaults to outline variant. */
+function ModalClose({
+  className,
+  variant = "outline",
+  size = "default",
+  ...props
+}: ModalCloseProps) {
+  return (
+    <DialogPrimitive.Close
+      data-slot="modal-close"
+      className={cn(className)}
+      render={<Button variant={variant} size={size} />}
+      {...props}
+    />
+  );
+}
+
+export {
+  Modal,
+  ModalTrigger,
+  ModalPortal,
+  ModalOverlay,
+  ModalContent,
+  ModalHeader,
+  ModalFooter,
+  ModalTitle,
+  ModalDescription,
+  ModalClose,
+  type ModalProps,
+  type ModalTriggerProps,
+  type ModalPortalProps,
+  type ModalOverlayProps,
+  type ModalContentProps,
+  type ModalHeaderProps,
+  type ModalFooterProps,
+  type ModalTitleProps,
+  type ModalDescriptionProps,
+  type ModalCloseProps,
+};

package/src/components/ui/navigation-menu.tsx

@@ -0,0 +1,219 @@
+import { NavigationMenu as NavigationMenuPrimitive } from "@base-ui/react/navigation-menu";
+import { cva } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+import { ChevronDownIcon } from "lucide-react";
+
+type NavigationMenuProps = NavigationMenuPrimitive.Root.Props;
+
+/**
+ * Root container for horizontal navigation with mega menu support.
+ * Manages active state and provides keyboard navigation.
+ */
+function NavigationMenu({
+  className,
+  children,
+  ...props
+}: NavigationMenuProps) {
+  return (
+    <NavigationMenuPrimitive.Root
+      data-slot="navigation-menu"
+      className={cn(
+        "max-w-max group/navigation-menu relative flex max-w-max flex-1 items-center justify-center",
+        className,
+      )}
+      {...props}
+    >
+      {children}
+      <NavigationMenuPositioner />
+    </NavigationMenuPrimitive.Root>
+  );
+}
+
+type NavigationMenuListProps = NavigationMenuPrimitive.List.Props;
+
+/**
+ * Container for navigation menu items. Renders as a horizontal list.
+ */
+function NavigationMenuList({ className, ...props }: NavigationMenuListProps) {
+  return (
+    <NavigationMenuPrimitive.List
+      data-slot="navigation-menu-list"
+      className={cn(
+        "gap-0 group flex flex-1 list-none items-center justify-center",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+type NavigationMenuItemProps = NavigationMenuPrimitive.Item.Props;
+
+/**
+ * Individual navigation item. Can contain a Link or Trigger + Content.
+ * Use `value` prop to identify the item for controlled state.
+ */
+function NavigationMenuItem({ className, ...props }: NavigationMenuItemProps) {
+  return (
+    <NavigationMenuPrimitive.Item
+      data-slot="navigation-menu-item"
+      className={cn("relative", className)}
+      {...props}
+    />
+  );
+}
+
+const navigationMenuTriggerStyle = cva(
+  "bg-background hover:bg-muted focus:bg-muted data-open:hover:bg-muted data-open:focus:bg-muted data-open:bg-muted/50 focus-visible:ring-ring/50 data-popup-open:bg-muted/50 data-popup-open:hover:bg-muted rounded-full px-4 py-2 text-sm font-medium transition-all focus-visible:ring-[3px] focus-visible:outline-1 disabled:opacity-50 group/navigation-menu-trigger inline-flex h-9 w-max items-center justify-center disabled:pointer-events-none outline-none",
+);
+
+type NavigationMenuTriggerProps = NavigationMenuPrimitive.Trigger.Props;
+
+/**
+ * Button that opens the associated NavigationMenuContent panel.
+ * Automatically includes a rotating chevron icon.
+ */
+function NavigationMenuTrigger({
+  className,
+  children,
+  ...props
+}: NavigationMenuTriggerProps) {
+  return (
+    <NavigationMenuPrimitive.Trigger
+      data-slot="navigation-menu-trigger"
+      className={cn(navigationMenuTriggerStyle(), "group", className)}
+      {...props}
+    >
+      {children}{" "}
+      <ChevronDownIcon
+        className="relative top-[1px] ml-1 size-3 transition duration-300 group-data-open/navigation-menu-trigger:rotate-180 group-data-popup-open/navigation-menu-trigger:rotate-180"
+        aria-hidden="true"
+      />
+    </NavigationMenuPrimitive.Trigger>
+  );
+}
+
+type NavigationMenuContentProps = NavigationMenuPrimitive.Content.Props;
+
+/**
+ * Content panel for mega menus. Opened by NavigationMenuTrigger.
+ * Automatically renders in a positioned popup with smooth transitions.
+ */
+function NavigationMenuContent({
+  className,
+  ...props
+}: NavigationMenuContentProps) {
+  return (
+    <NavigationMenuPrimitive.Content
+      data-slot="navigation-menu-content"
+      className={cn(
+        "data-[motion^=from-]:animate-in data-[motion^=to-]:animate-out data-[motion^=from-]:fade-in data-[motion^=to-]:fade-out data-[motion=from-end]:slide-in-from-right-52 data-[motion=from-start]:slide-in-from-left-52 data-[motion=to-end]:slide-out-to-right-52 data-[motion=to-start]:slide-out-to-left-52 group-data-[viewport=false]/navigation-menu:bg-popover group-data-[viewport=false]/navigation-menu:text-popover-foreground group-data-[viewport=false]/navigation-menu:data-open:animate-in group-data-[viewport=false]/navigation-menu:data-closed:animate-out group-data-[viewport=false]/navigation-menu:data-closed:zoom-out-95 group-data-[viewport=false]/navigation-menu:data-open:zoom-in-95 group-data-[viewport=false]/navigation-menu:data-open:fade-in-0 group-data-[viewport=false]/navigation-menu:data-closed:fade-out-0 group-data-[viewport=false]/navigation-menu:ring-foreground/10 p-2 pr-2.5 ease-[cubic-bezier(0.22,1,0.36,1)] group-data-[viewport=false]/navigation-menu:rounded-md group-data-[viewport=false]/navigation-menu:shadow group-data-[viewport=false]/navigation-menu:ring-1 group-data-[viewport=false]/navigation-menu:duration-300 h-full w-auto **:data-[slot=navigation-menu-link]:focus:ring-0 **:data-[slot=navigation-menu-link]:focus:outline-none",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+type NavigationMenuPositionerProps = NavigationMenuPrimitive.Positioner.Props;
+
+/**
+ * Portal container for positioning content panels.
+ * Automatically included in NavigationMenu - do not use directly.
+ * @internal
+ */
+function NavigationMenuPositioner({
+  className,
+  side = "bottom",
+  sideOffset = 8,
+  align = "start",
+  alignOffset = 0,
+  ...props
+}: NavigationMenuPositionerProps) {
+  return (
+    <NavigationMenuPrimitive.Portal>
+      <NavigationMenuPrimitive.Positioner
+        side={side}
+        sideOffset={sideOffset}
+        align={align}
+        alignOffset={alignOffset}
+        className={cn(
+          "transition-[top,left,right,bottom] duration-300 ease-[cubic-bezier(0.22,1,0.36,1)] data-[side=bottom]:before:top-[-10px] data-[side=bottom]:before:right-0 data-[side=bottom]:before:left-0 isolate z-50 h-[var(--positioner-height)] w-[var(--positioner-width)] max-w-[var(--available-width)] data-[instant]:transition-none",
+          className,
+        )}
+        {...props}
+      >
+        <NavigationMenuPrimitive.Popup
+          data-slot="navigation-menu-popup"
+          className="bg-popover text-popover-foreground ring-foreground/10 rounded-5xl shadow ring-1 transition-all ease-[cubic-bezier(0.22,1,0.36,1)] outline-none data-[ending-style]:scale-90 data-[ending-style]:opacity-0 data-[ending-style]:duration-150 data-[starting-style]:scale-90 data-[starting-style]:opacity-0 xs:w-(--popup-width) relative h-(--popup-height) w-(--popup-width) origin-(--transform-origin)"
+        >
+          <NavigationMenuPrimitive.Viewport className="relative size-full overflow-hidden" />
+        </NavigationMenuPrimitive.Popup>
+      </NavigationMenuPrimitive.Positioner>
+    </NavigationMenuPrimitive.Portal>
+  );
+}
+
+type NavigationMenuLinkProps = NavigationMenuPrimitive.Link.Props;
+
+/**
+ * Navigation link for direct navigation items or links within content panels.
+ * Use `active` prop to highlight the current page.
+ */
+function NavigationMenuLink({ className, ...props }: NavigationMenuLinkProps) {
+  return (
+    <NavigationMenuPrimitive.Link
+      data-slot="navigation-menu-link"
+      className={cn(
+        "data-[active=true]:focus:bg-muted data-[active=true]:hover:bg-muted data-[active=true]:bg-muted/50 focus-visible:ring-ring/50 hover:bg-muted focus:bg-muted flex items-center gap-1.5 rounded-full p-2 text-sm transition-all outline-none focus-visible:ring-[3px] focus-visible:outline-1 [&_svg:not([class*='size-'])]:size-4",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+type NavigationMenuIndicatorProps = NavigationMenuPrimitive.Icon.Props;
+
+/**
+ * Visual indicator (arrow) that shows which item is active.
+ * Optional - not commonly used in modern designs.
+ */
+function NavigationMenuIndicator({
+  className,
+  ...props
+}: NavigationMenuIndicatorProps) {
+  return (
+    <NavigationMenuPrimitive.Icon
+      data-slot="navigation-menu-indicator"
+      className={cn(
+        "data-[state=visible]:animate-in data-[state=hidden]:animate-out data-[state=hidden]:fade-out data-[state=visible]:fade-in top-full z-[1] flex h-1.5 items-end justify-center overflow-hidden",
+        className,
+      )}
+      {...props}
+    >
+      <div className="bg-border rounded-tl-sm shadow-md relative top-[60%] h-2 w-2 rotate-45" />
+    </NavigationMenuPrimitive.Icon>
+  );
+}
+
+export {
+  NavigationMenu,
+  NavigationMenuContent,
+  NavigationMenuIndicator,
+  NavigationMenuItem,
+  NavigationMenuLink,
+  NavigationMenuList,
+  NavigationMenuTrigger,
+  navigationMenuTriggerStyle,
+  NavigationMenuPositioner,
+  type NavigationMenuProps,
+  type NavigationMenuContentProps,
+  type NavigationMenuIndicatorProps,
+  type NavigationMenuItemProps,
+  type NavigationMenuLinkProps,
+  type NavigationMenuListProps,
+  type NavigationMenuTriggerProps,
+  type NavigationMenuPositionerProps,
+};

package/src/components/ui/pagination.tsx

@@ -0,0 +1,158 @@
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+import { Button } from "@/components/ui/button";
+import {
+  ChevronLeftIcon,
+  ChevronRightIcon,
+  MoreHorizontalIcon,
+} from "lucide-react";
+
+type PaginationProps = React.ComponentProps<"nav">;
+
+/**
+ * Root pagination navigation container.
+ */
+function Pagination({ className, ...props }: PaginationProps) {
+  return (
+    <nav
+      role="navigation"
+      aria-label="pagination"
+      data-slot="pagination"
+      className={cn("mx-auto flex w-full justify-center", className)}
+      {...props}
+    />
+  );
+}
+
+type PaginationContentProps = React.ComponentProps<"ul">;
+
+/**
+ * Container for pagination items. Renders as a flex list.
+ */
+function PaginationContent({ className, ...props }: PaginationContentProps) {
+  return (
+    <ul
+      data-slot="pagination-content"
+      className={cn("gap-1 flex items-center", className)}
+      {...props}
+    />
+  );
+}
+
+type PaginationItemProps = React.ComponentProps<"li">;
+
+/**
+ * Wrapper for individual pagination elements (links, ellipsis, controls).
+ */
+function PaginationItem({ ...props }: PaginationItemProps) {
+  return <li data-slot="pagination-item" {...props} />;
+}
+
+type PaginationLinkProps = {
+  /** Whether this page link is the current active page. */
+  isActive?: boolean;
+} & Pick<React.ComponentProps<typeof Button>, "size"> &
+  React.ComponentProps<"a">;
+
+/**
+ * Clickable page number link. Use `isActive` to highlight the current page.
+ */
+function PaginationLink({
+  className,
+  isActive,
+  size = "icon",
+  ...props
+}: PaginationLinkProps) {
+  return (
+    <Button
+      variant={isActive ? "primary" : "ghost"}
+      size={size}
+      className={cn("rounded-lg", className)}
+      nativeButton={false}
+      render={
+        <a
+          aria-current={isActive ? "page" : undefined}
+          data-slot="pagination-link"
+          data-active={isActive}
+          {...props}
+        />
+      }
+    />
+  );
+}
+
+type PaginationPreviousProps = React.ComponentProps<typeof PaginationLink>;
+
+/**
+ * Previous page button with chevron icon and "Previous" text (hidden on mobile).
+ */
+function PaginationPrevious({ className, ...props }: PaginationPreviousProps) {
+  return (
+    <PaginationLink
+      aria-label="Go to previous page"
+      size="default"
+      className={cn("pl-2!", className)}
+      {...props}
+    >
+      <ChevronLeftIcon data-icon="inline-start" />
+    </PaginationLink>
+  );
+}
+
+type PaginationNextProps = React.ComponentProps<typeof PaginationLink>;
+
+/**
+ * Next page button with chevron icon and "Next" text (hidden on mobile).
+ */
+function PaginationNext({ className, ...props }: PaginationNextProps) {
+  return (
+    <PaginationLink
+      aria-label="Go to next page"
+      size="default"
+      className={cn("pr-2!", className)}
+      {...props}
+    >
+      <ChevronRightIcon data-icon="inline-end" />
+    </PaginationLink>
+  );
+}
+
+type PaginationEllipsisProps = React.ComponentProps<"span">;
+
+/**
+ * Ellipsis indicator for skipped pages. Use between page numbers to show truncated ranges.
+ */
+function PaginationEllipsis({ className, ...props }: PaginationEllipsisProps) {
+  return (
+    <span
+      aria-hidden
+      data-slot="pagination-ellipsis"
+      className={cn(
+        "size-9 items-center justify-center [&_svg:not([class*='size-'])]:size-4 flex items-center justify-center",
+        className,
+      )}
+      {...props}
+    >
+      <MoreHorizontalIcon />
+      <span className="sr-only">More pages</span>
+    </span>
+  );
+}
+
+export {
+  Pagination,
+  PaginationContent,
+  PaginationEllipsis,
+  PaginationItem,
+  PaginationLink,
+  PaginationNext,
+  PaginationPrevious,
+  type PaginationProps,
+  type PaginationContentProps,
+  type PaginationItemProps,
+  type PaginationLinkProps,
+  type PaginationPreviousProps,
+  type PaginationNextProps,
+  type PaginationEllipsisProps,
+};

package/src/components/ui/popover.tsx

@@ -0,0 +1,129 @@
+import * as React from "react";
+import { Popover as PopoverPrimitive } from "@base-ui/react/popover";
+
+import { cn } from "@/lib/utils";
+
+type PopoverProps = PopoverPrimitive.Root.Props;
+
+/**
+ * Popover root component. Groups all parts of the popover and manages open state.
+ * Use with `open`/`onOpenChange` for controlled state, or `defaultOpen` for uncontrolled.
+ */
+function Popover({ ...props }: PopoverProps) {
+  return <PopoverPrimitive.Root data-slot="popover" {...props} />;
+}
+
+type PopoverTriggerProps = PopoverPrimitive.Trigger.Props;
+
+/**
+ * Button that opens the popover. Use `render` prop to customize the trigger element.
+ */
+function PopoverTrigger({ ...props }: PopoverTriggerProps) {
+  return <PopoverPrimitive.Trigger data-slot="popover-trigger" {...props} />;
+}
+
+type PopoverContentProps = PopoverPrimitive.Popup.Props &
+  Pick<
+    PopoverPrimitive.Positioner.Props,
+    "align" | "alignOffset" | "side" | "sideOffset"
+  >;
+
+/**
+ * Popover content with automatic portal and positioning.
+ * Animates in/out with fade and zoom effects. Default width is w-72 (18rem).
+ *
+ * @param align - Horizontal alignment relative to trigger. @default "center"
+ * @param alignOffset - Offset in pixels along alignment axis. @default 0
+ * @param side - Which side of trigger to display on. @default "bottom"
+ * @param sideOffset - Distance in pixels from trigger. @default 4
+ */
+function PopoverContent({
+  className,
+  align = "center",
+  alignOffset = 0,
+  side = "bottom",
+  sideOffset = 4,
+  ...props
+}: PopoverContentProps) {
+  return (
+    <PopoverPrimitive.Portal>
+      <PopoverPrimitive.Positioner
+        align={align}
+        alignOffset={alignOffset}
+        side={side}
+        sideOffset={sideOffset}
+        className="isolate z-50"
+      >
+        <PopoverPrimitive.Popup
+          data-slot="popover-content"
+          className={cn(
+            "bg-popover text-popover-foreground data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-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 ring-foreground/10 flex flex-col gap-4 rounded-5xl p-4 lg:p-6 text-sm shadow-md ring-1 duration-100 z-50 w-72 origin-(--transform-origin) outline-hidden",
+            className,
+          )}
+          {...props}
+        />
+      </PopoverPrimitive.Positioner>
+    </PopoverPrimitive.Portal>
+  );
+}
+
+type PopoverHeaderProps = React.ComponentProps<"div">;
+
+/**
+ * Optional header wrapper for PopoverTitle and PopoverDescription.
+ * Provides consistent spacing between title and description.
+ */
+function PopoverHeader({ className, ...props }: PopoverHeaderProps) {
+  return (
+    <div
+      data-slot="popover-header"
+      className={cn("flex flex-col gap-1 text-sm", className)}
+      {...props}
+    />
+  );
+}
+
+type PopoverTitleProps = PopoverPrimitive.Title.Props;
+
+/**
+ * Heading that labels the popover. Renders an h2 element with proper ARIA attributes.
+ */
+function PopoverTitle({ className, ...props }: PopoverTitleProps) {
+  return (
+    <PopoverPrimitive.Title
+      data-slot="popover-title"
+      className={cn("font-medium", className)}
+      {...props}
+    />
+  );
+}
+
+type PopoverDescriptionProps = PopoverPrimitive.Description.Props;
+
+/**
+ * Optional description text for the popover. Styled with muted foreground color.
+ */
+function PopoverDescription({ className, ...props }: PopoverDescriptionProps) {
+  return (
+    <PopoverPrimitive.Description
+      data-slot="popover-description"
+      className={cn("text-muted-foreground", className)}
+      {...props}
+    />
+  );
+}
+
+export {
+  Popover,
+  PopoverContent,
+  PopoverDescription,
+  PopoverHeader,
+  PopoverTitle,
+  PopoverTrigger,
+  type PopoverProps,
+  type PopoverContentProps,
+  type PopoverDescriptionProps,
+  type PopoverHeaderProps,
+  type PopoverTitleProps,
+  type PopoverTriggerProps,
+};