@chesapeake/stack 0.1.0

package/components/ui/select.tsx

@@ -0,0 +1,306 @@
+// Copyright 2026 Chesapeake Computing
+// SPDX-License-Identifier: Apache-2.0
+
+import * as React from "react";
+import * as SelectPrimitive from "@radix-ui/react-select";
+import { CheckIcon, ChevronDownIcon, ChevronUpIcon } from "lucide-react";
+
+import { cn } from "../../lib/utils";
+
+/**
+ * Root component for the Select dropdown.
+ * Manages the open/closed state and selected value.
+ *
+ * @example
+ * ```tsx
+ * <Select>
+ *   <SelectTrigger className="w-[180px]">
+ *     <SelectValue placeholder="Select a fruit" />
+ *   </SelectTrigger>
+ *   <SelectContent>
+ *     <SelectItem value="apple">Apple</SelectItem>
+ *     <SelectItem value="banana">Banana</SelectItem>
+ *     <SelectItem value="orange">Orange</SelectItem>
+ *   </SelectContent>
+ * </Select>
+ * ```
+ */
+function Select({
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Root>) {
+  return <SelectPrimitive.Root data-slot="select" {...props} />;
+}
+
+/**
+ * Group component for organizing select items.
+ * Used with SelectLabel to create labeled groups.
+ *
+ * @example
+ * ```tsx
+ * <SelectContent>
+ *   <SelectGroup>
+ *     <SelectLabel>Fruits</SelectLabel>
+ *     <SelectItem value="apple">Apple</SelectItem>
+ *     <SelectItem value="banana">Banana</SelectItem>
+ *   </SelectGroup>
+ * </SelectContent>
+ * ```
+ */
+function SelectGroup({
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Group>) {
+  return <SelectPrimitive.Group data-slot="select-group" {...props} />;
+}
+
+/**
+ * Displays the currently selected value or placeholder.
+ *
+ * @example
+ * ```tsx
+ * <SelectValue placeholder="Select an option" />
+ * ```
+ */
+function SelectValue({
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Value>) {
+  return <SelectPrimitive.Value data-slot="select-value" {...props} />;
+}
+
+/**
+ * Trigger button that opens the select dropdown.
+ * Contains the SelectValue and dropdown arrow.
+ *
+ * @example
+ * ```tsx
+ * <SelectTrigger className="w-[200px]">
+ *   <SelectValue placeholder="Choose..." />
+ * </SelectTrigger>
+ *
+ * // Small size
+ * <SelectTrigger size="sm">
+ *   <SelectValue placeholder="Small" />
+ * </SelectTrigger>
+ * ```
+ */
+function SelectTrigger({
+  className,
+  size = "default",
+  children,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Trigger> & {
+  size?: "sm" | "default";
+  className?: string;
+}) {
+  return (
+    <SelectPrimitive.Trigger
+      data-slot="select-trigger"
+      data-size={size}
+      className={cn(
+        "border-input data-[placeholder]:text-muted-foreground [&_svg:not([class*='text-'])]:text-muted-foreground 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:bg-input/30 dark:hover:bg-input/50 flex w-fit items-center justify-between gap-2 rounded-md border bg-transparent px-3 py-2 text-sm whitespace-nowrap shadow-xs transition-[color,box-shadow] outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 data-[size=default]:h-9 data-[size=sm]:h-8 *:data-[slot=select-value]:line-clamp-1 *:data-[slot=select-value]:flex *:data-[slot=select-value]:items-center *:data-[slot=select-value]:gap-2 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <SelectPrimitive.Icon asChild>
+        <ChevronDownIcon className="size-4 opacity-50" />
+      </SelectPrimitive.Icon>
+    </SelectPrimitive.Trigger>
+  );
+}
+
+/**
+ * Content container for the select dropdown.
+ * Displays when the select is open.
+ *
+ * @example
+ * ```tsx
+ * <SelectContent>
+ *   <SelectItem value="1">Option 1</SelectItem>
+ *   <SelectItem value="2">Option 2</SelectItem>
+ * </SelectContent>
+ *
+ * // Position as popper
+ * <SelectContent position="popper">
+ *   <SelectItem value="1">Option 1</SelectItem>
+ * </SelectContent>
+ * ```
+ */
+function SelectContent({
+  className,
+  children,
+  position = "item-aligned",
+  align = "center",
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Content> & {
+  className?: string;
+}) {
+  return (
+    <SelectPrimitive.Portal>
+      <SelectPrimitive.Content
+        data-slot="select-content"
+        className={cn(
+          "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=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 relative z-50 max-h-(--radix-select-content-available-height) min-w-[8rem] origin-(--radix-select-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-md border shadow-md",
+          position === "popper" &&
+            "data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 data-[side=right]:translate-x-1 data-[side=top]:-translate-y-1",
+          className
+        )}
+        position={position}
+        align={align}
+        {...props}
+      >
+        <SelectScrollUpButton />
+        <SelectPrimitive.Viewport
+          className={cn(
+            "p-1",
+            position === "popper" &&
+              "h-[var(--radix-select-trigger-height)] w-full min-w-[var(--radix-select-trigger-width)] scroll-my-1"
+          )}
+        >
+          {children}
+        </SelectPrimitive.Viewport>
+        <SelectScrollDownButton />
+      </SelectPrimitive.Content>
+    </SelectPrimitive.Portal>
+  );
+}
+
+/**
+ * Label for a group of select items.
+ *
+ * @example
+ * ```tsx
+ * <SelectGroup>
+ *   <SelectLabel>Fruits</SelectLabel>
+ *   <SelectItem value="apple">Apple</SelectItem>
+ * </SelectGroup>
+ * ```
+ */
+function SelectLabel({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Label> & {
+  className?: string;
+}) {
+  return (
+    <SelectPrimitive.Label
+      data-slot="select-label"
+      className={cn("text-muted-foreground px-2 py-1.5 text-xs", className)}
+      {...props}
+    />
+  );
+}
+
+/**
+ * Individual selectable item within the dropdown.
+ *
+ * @example
+ * ```tsx
+ * <SelectItem value="apple">Apple</SelectItem>
+ * ```
+ */
+function SelectItem({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Item> & {
+  className?: string;
+}) {
+  return (
+    <SelectPrimitive.Item
+      data-slot="select-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground [&_svg:not([class*='text-'])]:text-muted-foreground relative flex w-full cursor-default items-center gap-2 rounded-sm py-1.5 pr-8 pl-2 text-sm outline-hidden select-none 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}
+    >
+      <span
+        data-slot="select-item-indicator"
+        className="absolute right-2 flex size-3.5 items-center justify-center"
+      >
+        <SelectPrimitive.ItemIndicator>
+          <CheckIcon className="size-4" />
+        </SelectPrimitive.ItemIndicator>
+      </span>
+      <SelectPrimitive.ItemText>{children}</SelectPrimitive.ItemText>
+    </SelectPrimitive.Item>
+  );
+}
+
+/**
+ * Visual separator between groups of items.
+ */
+function SelectSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Separator> & {
+  className?: string;
+}) {
+  return (
+    <SelectPrimitive.Separator
+      data-slot="select-separator"
+      className={cn("bg-border pointer-events-none -mx-1 my-1 h-px", className)}
+      {...props}
+    />
+  );
+}
+
+/**
+ * Scroll up button displayed when content overflows.
+ */
+function SelectScrollUpButton({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.ScrollUpButton> & {
+  className?: string;
+}) {
+  return (
+    <SelectPrimitive.ScrollUpButton
+      data-slot="select-scroll-up-button"
+      className={cn(
+        "flex cursor-default items-center justify-center py-1",
+        className
+      )}
+      {...props}
+    >
+      <ChevronUpIcon className="size-4" />
+    </SelectPrimitive.ScrollUpButton>
+  );
+}
+
+/**
+ * Scroll down button displayed when content overflows.
+ */
+function SelectScrollDownButton({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.ScrollDownButton> & {
+  className?: string;
+}) {
+  return (
+    <SelectPrimitive.ScrollDownButton
+      data-slot="select-scroll-down-button"
+      className={cn(
+        "flex cursor-default items-center justify-center py-1",
+        className
+      )}
+      {...props}
+    >
+      <ChevronDownIcon className="size-4" />
+    </SelectPrimitive.ScrollDownButton>
+  );
+}
+
+export {
+  Select,
+  SelectContent,
+  SelectGroup,
+  SelectItem,
+  SelectLabel,
+  SelectScrollDownButton,
+  SelectScrollUpButton,
+  SelectSeparator,
+  SelectTrigger,
+  SelectValue,
+};

package/components/ui/separator.tsx

@@ -0,0 +1,50 @@
+// Copyright 2026 Chesapeake Computing
+// SPDX-License-Identifier: Apache-2.0
+
+import * as React from "react";
+import * as SeparatorPrimitive from "@radix-ui/react-separator";
+
+import { cn } from "../../lib/utils";
+
+/**
+ * A visual separator component for dividing content.
+ *
+ * Can be rendered horizontally or vertically and is decorative by default
+ * (hidden from screen readers). Built on Radix UI's Separator primitive.
+ *
+ * @example
+ * ```tsx
+ * // Horizontal separator (default)
+ * <Separator />
+ *
+ * // Vertical separator
+ * <Separator orientation="vertical" />
+ *
+ * // With custom styling
+ * <Separator className="my-4" />
+ *
+ * // Non-decorative (accessible to screen readers)
+ * <Separator decorative={false} />
+ * ```
+ */
+function Separator({
+  className,
+  orientation,
+  decorative,
+  ...props
+}: React.ComponentProps<typeof SeparatorPrimitive.Root>) {
+  return (
+    <SeparatorPrimitive.Root
+      data-slot="separator"
+      decorative={decorative}
+      orientation={orientation}
+      className={cn(
+        "bg-border shrink-0 data-[orientation=horizontal]:h-px data-[orientation=horizontal]:w-full data-[orientation=vertical]:h-full data-[orientation=vertical]:w-px",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export { Separator };

package/components/ui/sonner-api.ts

@@ -0,0 +1,8 @@
+// Copyright 2026 Chesapeake Computing
+// SPDX-License-Identifier: Apache-2.0
+
+import * as React from "react";
+import { Toaster as Sonner } from "sonner";
+
+export { toast } from "sonner";
+export type ToasterProps = React.ComponentProps<typeof Sonner>;

package/components/ui/sonner.tsx

@@ -0,0 +1,69 @@
+// Copyright 2026 Chesapeake Computing
+// SPDX-License-Identifier: Apache-2.0
+
+/** @jsxImportSource react */
+
+import { Toaster as Sonner } from "sonner";
+
+import type { ToasterProps } from "./sonner-api.ts";
+
+/**
+ * Toast notification component for displaying temporary messages.
+ *
+ * Built on top of Sonner for a polished toast experience.
+ * Positioned in the top-right corner by default.
+ *
+ * @example
+ * ```tsx
+ * // Add Toaster to your app root
+ * function App() {
+ *   return (
+ *     <>
+ *       <YourApp />
+ *       <Toaster />
+ *     </>
+ *   );
+ * }
+ *
+ * // Show toast anywhere in your app
+ * import { toast } from "sonner";
+ *
+ * toast.success("Operation successful!");
+ * toast.error("Something went wrong");
+ * toast.info("New update available");
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Custom toast with action
+ * toast("Event has been created", {
+ *   description: "Sunday, December 03, 2023 at 9:00 AM",
+ *   action: {
+ *     label: "Undo",
+ *     onClick: () => console.log("Undo"),
+ *   },
+ * });
+ * ```
+ */
+function Toaster(props: ToasterProps) {
+  return (
+    <Sonner
+      position="top-right"
+      className="toaster group"
+      toastOptions={{
+        classNames: {
+          toast:
+            "group toast group-[.toaster]:bg-background group-[.toaster]:text-foreground group-[.toaster]:border-border group-[.toaster]:shadow-lg",
+          description: "group-[.toast]:text-muted-foreground",
+          actionButton:
+            "group-[.toast]:bg-primary group-[.toast]:text-primary-foreground",
+          cancelButton:
+            "group-[.toast]:bg-muted group-[.toast]:text-muted-foreground",
+        },
+      }}
+      {...props}
+    />
+  );
+}
+
+export { Toaster };

package/components/ui/textarea.tsx

@@ -0,0 +1,53 @@
+// Copyright 2026 Chesapeake Computing
+// SPDX-License-Identifier: Apache-2.0
+
+import React from "react";
+
+import { cn } from "../../lib/utils";
+
+/**
+ * Textarea component for multi-line text input.
+ *
+ * Provides consistent styling with focus states, disabled states, and error states.
+ * Automatically adjusts height based on content when used with appropriate CSS.
+ *
+ * @example
+ * ```tsx
+ * // Basic textarea
+ * <Textarea placeholder="Enter your message..." />
+ *
+ * // With rows
+ * <Textarea rows={5} placeholder="Longer message..." />
+ *
+ * // With label
+ * <div>
+ *   <Label htmlFor="description">Description</Label>
+ *   <Textarea id="description" />
+ * </div>
+ *
+ * // Disabled
+ * <Textarea disabled placeholder="Disabled textarea" />
+ *
+ * // With error state
+ * <Textarea aria-invalid="true" />
+ * ```
+ */
+const Textarea = React.forwardRef<
+  HTMLTextAreaElement,
+  React.ComponentPropsWithoutRef<"textarea">
+>(({ className, ...props }, ref) => {
+  return (
+    <textarea
+      ref={ref}
+      data-slot="textarea"
+      className={cn(
+        "border-input placeholder:text-muted-foreground 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:bg-input/30 flex field-sizing-content min-h-16 w-full rounded-md border bg-transparent px-3 py-2 text-base shadow-xs transition-[color,box-shadow] outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+        className
+      )}
+      {...props}
+    />
+  );
+});
+Textarea.displayName = "Textarea";
+
+export { Textarea };

package/components/ui/tooltip.tsx

@@ -0,0 +1,125 @@
+// Copyright 2026 Chesapeake Computing
+// SPDX-License-Identifier: Apache-2.0
+
+import * as React from "react";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+
+import { cn } from "../../lib/utils";
+
+/**
+ * TooltipProvider component. Must wrap all Tooltip components.
+ * Provides the context for tooltip components.
+ *
+ * @example
+ * ```tsx
+ * <TooltipProvider>
+ *   <App />
+ * </TooltipProvider>
+ * ```
+ */
+interface TooltipProviderProps {
+  delayDuration?: number;
+  children: React.ReactNode;
+}
+
+function TooltipProvider({
+  delayDuration = 300,
+  ...props
+}: TooltipProviderProps) {
+  return <TooltipPrimitive.Provider delayDuration={delayDuration} {...props} />;
+}
+
+/**
+ * Tooltip component root. Provides the context for tooltip components.
+ * Built on top of Radix UI Tooltip primitives for accessibility.
+ *
+ * @example
+ * ```tsx
+ * import { Tooltip, TooltipTrigger, TooltipContent } from "@shared/components/ui/tooltip"
+ * import { Button } from "@shared/components/ui/button"
+ *
+ * function MyTooltip() {
+ *   return (
+ *     <Tooltip>
+ *       <TooltipTrigger asChild>
+ *         <Button>Hover me</Button>
+ *       </TooltipTrigger>
+ *       <TooltipContent>
+ *         <p>This is a tooltip</p>
+ *       </TooltipContent>
+ *     </Tooltip>
+ *   )
+ * }
+ * ```
+ */
+function Tooltip({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Root>) {
+  return <TooltipPrimitive.Root {...props} />;
+}
+
+/**
+ * TooltipTrigger component. Wraps the element that shows the tooltip on hover.
+ */
+function TooltipTrigger({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {
+  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />;
+}
+
+/**
+ * TooltipPortal component. Portals the tooltip content outside the DOM hierarchy.
+ */
+function TooltipPortal({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Portal>) {
+  return <TooltipPrimitive.Portal data-slot="tooltip-portal" {...props} />;
+}
+
+/**
+ * TooltipContent component. The main content container for the tooltip.
+ * Includes the portal by default.
+ *
+ * @example
+ * ```tsx
+ * <Tooltip>
+ *   <TooltipTrigger>Hover me</TooltipTrigger>
+ *   <TooltipContent>
+ *     <p>Tooltip text</p>
+ *   </TooltipContent>
+ * </Tooltip>
+ * ```
+ */
+interface TooltipContentProps {
+  className?: string;
+  sideOffset?: number;
+  children?: React.ReactNode;
+}
+
+function TooltipContent({
+  className,
+  sideOffset = 4,
+  ...props
+}: TooltipContentProps) {
+  return (
+    <TooltipPortal>
+      <TooltipPrimitive.Content
+        data-slot="tooltip-content"
+        sideOffset={sideOffset}
+        className={cn(
+          "z-50 overflow-hidden rounded-md border bg-popover px-3 py-1.5 text-sm text-popover-foreground shadow-md animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=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",
+          className ?? ""
+        )}
+        {...props}
+      />
+    </TooltipPortal>
+  );
+}
+
+export {
+  Tooltip,
+  TooltipProvider,
+  TooltipTrigger,
+  TooltipContent,
+  TooltipPortal,
+};