@preset.nz/ux-kit 0.0.0-stage → 0.1.1

package/src/components/select.tsx

@@ -0,0 +1,189 @@
+"use client"
+
+import { Select as SelectPrimitive } from "@base-ui/react/select"
+import { CaretDownIcon, CaretUpIcon, CheckIcon } from "@phosphor-icons/react"
+import type * as React from "react"
+import { cn } from "../lib/utils"
+
+const Select = SelectPrimitive.Root
+
+function SelectGroup({ className, ...props }: SelectPrimitive.Group.Props) {
+  return (
+    <SelectPrimitive.Group
+      data-slot="select-group"
+      className={cn("scroll-my-1", className)}
+      {...props}
+    />
+  )
+}
+
+function SelectValue({ className, ...props }: SelectPrimitive.Value.Props) {
+  return (
+    <SelectPrimitive.Value
+      data-slot="select-value"
+      className={cn("flex flex-1 text-left", className)}
+      {...props}
+    />
+  )
+}
+
+function SelectTrigger({
+  className,
+  size = "default",
+  children,
+  ...props
+}: SelectPrimitive.Trigger.Props & {
+  size?: "sm" | "default"
+}) {
+  return (
+    <SelectPrimitive.Trigger
+      data-slot="select-trigger"
+      data-size={size}
+      className={cn(
+        "flex w-fit items-center justify-between gap-1.5 rounded-none border border-input bg-transparent py-2 pr-2 pl-2.5 text-xs whitespace-nowrap transition-colors outline-none select-none focus-visible:border-ring focus-visible:ring-1 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-1 aria-invalid:ring-destructive/20 data-placeholder:text-muted-foreground data-[size=default]:h-8 data-[size=sm]:h-7 data-[size=sm]:rounded-none *:data-[slot=select-value]:line-clamp-1 *:data-[slot=select-value]:flex *:data-[slot=select-value]:items-center *:data-[slot=select-value]:gap-1.5 dark:bg-input/30 dark:hover:bg-input/50 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className,
+      )}
+      {...props}
+    >
+      {children}
+      <SelectPrimitive.Icon
+        render={<CaretDownIcon className="pointer-events-none size-4 text-muted-foreground" />}
+      />
+    </SelectPrimitive.Trigger>
+  )
+}
+
+function SelectContent({
+  className,
+  children,
+  side = "bottom",
+  sideOffset = 4,
+  align = "center",
+  alignOffset = 0,
+  alignItemWithTrigger = true,
+  ...props
+}: SelectPrimitive.Popup.Props &
+  Pick<
+    SelectPrimitive.Positioner.Props,
+    "align" | "alignOffset" | "side" | "sideOffset" | "alignItemWithTrigger"
+  >) {
+  return (
+    <SelectPrimitive.Portal>
+      <SelectPrimitive.Positioner
+        side={side}
+        sideOffset={sideOffset}
+        align={align}
+        alignOffset={alignOffset}
+        alignItemWithTrigger={alignItemWithTrigger}
+        className="isolate z-50"
+      >
+        <SelectPrimitive.Popup
+          data-slot="select-content"
+          data-align-trigger={alignItemWithTrigger}
+          className={cn(
+            "relative isolate z-50 max-h-(--available-height) w-(--anchor-width) min-w-36 origin-(--transform-origin) overflow-x-hidden overflow-y-auto rounded-none bg-popover text-popover-foreground shadow-md ring-1 ring-foreground/10 duration-100 data-[align-trigger=true]:animate-none data-[side=bottom]:slide-in-from-top-2 data-[side=inline-end]:slide-in-from-left-2 data-[side=inline-start]:slide-in-from-right-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 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
+            className,
+          )}
+          {...props}
+        >
+          <SelectScrollUpButton />
+          <SelectPrimitive.List>{children}</SelectPrimitive.List>
+          <SelectScrollDownButton />
+        </SelectPrimitive.Popup>
+      </SelectPrimitive.Positioner>
+    </SelectPrimitive.Portal>
+  )
+}
+
+function SelectLabel({ className, ...props }: SelectPrimitive.GroupLabel.Props) {
+  return (
+    <SelectPrimitive.GroupLabel
+      data-slot="select-label"
+      className={cn("px-2 py-2 text-xs text-muted-foreground", className)}
+      {...props}
+    />
+  )
+}
+
+function SelectItem({ className, children, ...props }: SelectPrimitive.Item.Props) {
+  return (
+    <SelectPrimitive.Item
+      data-slot="select-item"
+      className={cn(
+        "relative flex w-full cursor-default items-center gap-2 rounded-none py-2 pr-8 pl-2 text-xs outline-hidden select-none focus:bg-accent focus:text-accent-foreground not-data-[variant=destructive]:focus:**:text-accent-foreground data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 *:[span]:last:flex *:[span]:last:items-center *:[span]:last:gap-2",
+        className,
+      )}
+      {...props}
+    >
+      <SelectPrimitive.ItemText className="flex flex-1 shrink-0 gap-2 whitespace-nowrap">
+        {children}
+      </SelectPrimitive.ItemText>
+      <SelectPrimitive.ItemIndicator
+        render={
+          <span className="pointer-events-none absolute right-2 flex size-4 items-center justify-center" />
+        }
+      >
+        <CheckIcon className="pointer-events-none" />
+      </SelectPrimitive.ItemIndicator>
+    </SelectPrimitive.Item>
+  )
+}
+
+function SelectSeparator({ className, ...props }: SelectPrimitive.Separator.Props) {
+  return (
+    <SelectPrimitive.Separator
+      data-slot="select-separator"
+      className={cn("pointer-events-none -mx-1 h-px bg-border", className)}
+      {...props}
+    />
+  )
+}
+
+function SelectScrollUpButton({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.ScrollUpArrow>) {
+  return (
+    <SelectPrimitive.ScrollUpArrow
+      data-slot="select-scroll-up-button"
+      className={cn(
+        "top-0 z-10 flex w-full cursor-default items-center justify-center bg-popover py-1 [&_svg:not([class*='size-'])]:size-4",
+        className,
+      )}
+      {...props}
+    >
+      <CaretUpIcon />
+    </SelectPrimitive.ScrollUpArrow>
+  )
+}
+
+function SelectScrollDownButton({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.ScrollDownArrow>) {
+  return (
+    <SelectPrimitive.ScrollDownArrow
+      data-slot="select-scroll-down-button"
+      className={cn(
+        "bottom-0 z-10 flex w-full cursor-default items-center justify-center bg-popover py-1 [&_svg:not([class*='size-'])]:size-4",
+        className,
+      )}
+      {...props}
+    >
+      <CaretDownIcon />
+    </SelectPrimitive.ScrollDownArrow>
+  )
+}
+
+export {
+  Select,
+  SelectContent,
+  SelectGroup,
+  SelectItem,
+  SelectLabel,
+  SelectScrollDownButton,
+  SelectScrollUpButton,
+  SelectSeparator,
+  SelectTrigger,
+  SelectValue,
+}

package/src/components/separator.tsx

@@ -0,0 +1,21 @@
+"use client"
+
+import { Separator as SeparatorPrimitive } from "@base-ui/react/separator"
+
+import { cn } from "../lib/utils"
+
+function Separator({ className, orientation = "horizontal", ...props }: SeparatorPrimitive.Props) {
+  return (
+    <SeparatorPrimitive
+      data-slot="separator"
+      orientation={orientation}
+      className={cn(
+        "shrink-0 bg-border data-horizontal:h-px data-horizontal:w-full data-vertical:w-px data-vertical:self-stretch",
+        className,
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Separator }

package/src/components/sheet.tsx

@@ -0,0 +1,132 @@
+import { Dialog as SheetPrimitive } from "@base-ui/react/dialog"
+import { XIcon } from "@phosphor-icons/react"
+import type * as React from "react"
+
+import { cn } from "../lib/utils"
+import { Button } from "./button"
+
+// A sheet is a dialog docked to one edge. Built on Base UI's Dialog.
+function Sheet({ ...props }: SheetPrimitive.Root.Props) {
+  return <SheetPrimitive.Root data-slot="sheet" {...props} />
+}
+
+function SheetTrigger({ ...props }: SheetPrimitive.Trigger.Props) {
+  return <SheetPrimitive.Trigger data-slot="sheet-trigger" {...props} />
+}
+
+function SheetClose({ ...props }: SheetPrimitive.Close.Props) {
+  return <SheetPrimitive.Close data-slot="sheet-close" {...props} />
+}
+
+function SheetPortal({ ...props }: SheetPrimitive.Portal.Props) {
+  return <SheetPrimitive.Portal data-slot="sheet-portal" {...props} />
+}
+
+function SheetOverlay({ className, ...props }: SheetPrimitive.Backdrop.Props) {
+  return (
+    <SheetPrimitive.Backdrop
+      data-slot="sheet-overlay"
+      className={cn(
+        "fixed inset-0 z-50 bg-foreground/40 data-open:animate-in data-open:fade-in-0 data-closed:animate-out data-closed:fade-out-0",
+        className,
+      )}
+      {...props}
+    />
+  )
+}
+
+function SheetContent({
+  className,
+  children,
+  side = "right",
+  showCloseButton = true,
+  ...props
+}: SheetPrimitive.Popup.Props & {
+  side?: "top" | "right" | "bottom" | "left"
+  showCloseButton?: boolean
+}) {
+  return (
+    <SheetPortal>
+      <SheetOverlay />
+      <SheetPrimitive.Popup
+        data-slot="sheet-content"
+        data-side={side}
+        className={cn(
+          "fixed z-50 flex flex-col gap-4 bg-background shadow-lg outline-none transition ease-in-out data-open:animate-in data-closed:animate-out data-closed:duration-300 data-open:duration-500",
+          side === "right" &&
+            "inset-y-0 right-0 h-full w-3/4 border-l data-closed:slide-out-to-right data-open:slide-in-from-right sm:max-w-sm",
+          side === "left" &&
+            "inset-y-0 left-0 h-full w-3/4 border-r data-closed:slide-out-to-left data-open:slide-in-from-left sm:max-w-sm",
+          side === "top" &&
+            "inset-x-0 top-0 h-auto border-b data-closed:slide-out-to-top data-open:slide-in-from-top",
+          side === "bottom" &&
+            "inset-x-0 bottom-0 h-auto border-t data-closed:slide-out-to-bottom data-open:slide-in-from-bottom",
+          className,
+        )}
+        {...props}
+      >
+        {children}
+        {showCloseButton && (
+          <SheetPrimitive.Close
+            data-slot="sheet-close"
+            render={<Button variant="ghost" className="absolute top-3 right-3" size="icon-sm" />}
+          >
+            <XIcon />
+            <span className="sr-only">Close</span>
+          </SheetPrimitive.Close>
+        )}
+      </SheetPrimitive.Popup>
+    </SheetPortal>
+  )
+}
+
+function SheetHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="sheet-header"
+      className={cn("flex flex-col gap-1.5 p-4", className)}
+      {...props}
+    />
+  )
+}
+
+function SheetFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="sheet-footer"
+      className={cn("mt-auto flex flex-col gap-2 p-4", className)}
+      {...props}
+    />
+  )
+}
+
+function SheetTitle({ className, ...props }: SheetPrimitive.Title.Props) {
+  return (
+    <SheetPrimitive.Title
+      data-slot="sheet-title"
+      className={cn("font-semibold text-foreground", className)}
+      {...props}
+    />
+  )
+}
+
+function SheetDescription({ className, ...props }: SheetPrimitive.Description.Props) {
+  return (
+    <SheetPrimitive.Description
+      data-slot="sheet-description"
+      className={cn("text-sm text-muted-foreground", className)}
+      {...props}
+    />
+  )
+}
+
+export {
+  Sheet,
+  SheetClose,
+  SheetContent,
+  SheetDescription,
+  SheetFooter,
+  SheetHeader,
+  SheetTitle,
+  SheetTrigger,
+}

package/src/components/side-panel.tsx

@@ -0,0 +1,189 @@
+import type * as React from "react"
+
+import { cn } from "../lib/utils"
+import { buttonVariants } from "./button"
+import { Tooltip, TooltipContent, TooltipTrigger } from "./tooltip"
+
+// SidePanel: a docked panel with a collapsed icon rail and a drag-to-resize
+// edge (ux-patterns.md, "Side panels"). Props only: the app owns `open` and
+// `width`, so it can persist them and toggle from the menu, the toolbar or a
+// shortcut. Collapsed, the panel leaves a narrow rail with one icon that
+// reopens it. The drag uses pointer capture, so the edge never drifts from
+// the cursor; arrow keys on the focused edge resize too.
+
+/** Keeps a width inside [min, max]; a corrupt stored value falls back to `min`. */
+function clampWidth(width: number, min: number, max: number): number {
+  if (!Number.isFinite(width)) return min
+  return Math.min(max, Math.max(min, width))
+}
+
+interface SidePanelProps extends Omit<React.ComponentProps<"aside">, "title"> {
+  /** Which window edge the panel docks to. The resize handle sits on the inner edge. */
+  side: "left" | "right"
+  open: boolean
+  onOpenChange: (open: boolean) => void
+  /** Width in px while open. */
+  width: number
+  onWidthChange: (width: number) => void
+  minWidth?: number
+  maxWidth?: number
+  /** Names the panel in the rail tooltip and for assistive tech. */
+  title: string
+  /** The rail's icon. */
+  icon: React.ReactNode
+  /** Shown in the rail tooltip, in platform notation ("⌥⌘S"). */
+  shortcut?: string
+}
+
+function SidePanel({
+  side,
+  open,
+  onOpenChange,
+  width,
+  onWidthChange,
+  minWidth = 180,
+  maxWidth = 480,
+  title,
+  icon,
+  shortcut,
+  className,
+  children,
+  ...props
+}: SidePanelProps) {
+  const border = side === "left" ? "border-r" : "border-l"
+
+  if (!open) {
+    return (
+      <aside
+        data-slot="side-panel"
+        data-state="closed"
+        aria-label={title}
+        className={cn(
+          "flex w-10 shrink-0 flex-col items-center bg-sidebar py-2 text-sidebar-foreground",
+          border,
+          "border-sidebar-border",
+          className,
+        )}
+        {...props}
+      >
+        <Tooltip>
+          <TooltipTrigger
+            render={
+              <button
+                type="button"
+                aria-label={`Show ${title}`}
+                onClick={() => onOpenChange(true)}
+                className={buttonVariants({ variant: "ghost", size: "icon" })}
+              />
+            }
+          >
+            {icon}
+          </TooltipTrigger>
+          <TooltipContent side={side === "left" ? "right" : "left"}>
+            <span>Show {title}</span>
+            {shortcut ? (
+              <kbd
+                data-slot="kbd"
+                className="rounded-sm bg-background/20 px-1 font-sans text-[11px]"
+              >
+                {shortcut}
+              </kbd>
+            ) : null}
+          </TooltipContent>
+        </Tooltip>
+      </aside>
+    )
+  }
+
+  const startDrag = (e: React.PointerEvent<HTMLDivElement>) => {
+    e.preventDefault()
+    const el = e.currentTarget
+    el.setPointerCapture(e.pointerId)
+    const startX = e.clientX
+    const startWidth = width
+    const sign = side === "left" ? 1 : -1
+    const move = (ev: PointerEvent) =>
+      onWidthChange(clampWidth(startWidth + sign * (ev.clientX - startX), minWidth, maxWidth))
+    const end = () => {
+      el.removeEventListener("pointermove", move)
+      el.removeEventListener("pointerup", end)
+      el.removeEventListener("pointercancel", end)
+    }
+    el.addEventListener("pointermove", move)
+    el.addEventListener("pointerup", end)
+    el.addEventListener("pointercancel", end)
+  }
+
+  const onKey = (e: React.KeyboardEvent) => {
+    const grow = side === "left" ? "ArrowRight" : "ArrowLeft"
+    const shrink = side === "left" ? "ArrowLeft" : "ArrowRight"
+    if (e.key !== grow && e.key !== shrink) return
+    e.preventDefault()
+    onWidthChange(clampWidth(width + (e.key === grow ? 16 : -16), minWidth, maxWidth))
+  }
+
+  const w = clampWidth(width, minWidth, maxWidth)
+  return (
+    <aside
+      data-slot="side-panel"
+      data-state="open"
+      aria-label={title}
+      style={{ width: w }}
+      className={cn(
+        "relative flex shrink-0 flex-col overflow-hidden bg-sidebar text-sidebar-foreground",
+        border,
+        "border-sidebar-border",
+        className,
+      )}
+      {...props}
+    >
+      {children}
+      {/* biome-ignore lint/a11y/useSemanticElements: a focusable, keyboard-operable splitter (WAI-ARIA window splitter); <hr> is not focusable */}
+      <div
+        role="separator"
+        aria-orientation="vertical"
+        aria-label={`Resize ${title}`}
+        aria-valuenow={w}
+        aria-valuemin={minWidth}
+        aria-valuemax={maxWidth}
+        tabIndex={0}
+        onPointerDown={startDrag}
+        onKeyDown={onKey}
+        className={cn(
+          "absolute inset-y-0 z-10 w-1 cursor-col-resize touch-none hover:bg-primary/30 focus-visible:bg-primary/40 focus-visible:outline-none",
+          side === "left" ? "right-0" : "left-0",
+        )}
+      />
+    </aside>
+  )
+}
+
+/** A panel's title row; put the panel's own actions in `children`. */
+function SidePanelHeader({ className, children, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="side-panel-header"
+      className={cn(
+        "flex h-9 shrink-0 items-center gap-2 border-b border-sidebar-border px-3 text-xs font-medium uppercase tracking-wide text-muted-foreground",
+        className,
+      )}
+      {...props}
+    >
+      {children}
+    </div>
+  )
+}
+
+/** The scrolling body under the header. */
+function SidePanelContent({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="side-panel-content"
+      className={cn("min-h-0 flex-1 overflow-auto", className)}
+      {...props}
+    />
+  )
+}
+
+export type { SidePanelProps }
+export { clampWidth, SidePanel, SidePanelContent, SidePanelHeader }