@chesapeake/stack 0.1.0

package/components/ui/dropdown-menu.tsx

@@ -0,0 +1,260 @@
+// Copyright 2026 Chesapeake Computing
+// SPDX-License-Identifier: Apache-2.0
+
+"use client";
+
+import React from "react";
+import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
+import { CheckIcon, ChevronRightIcon, CircleIcon } from "lucide-react";
+
+import { cn } from "../../lib/utils";
+
+function DropdownMenu({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Root>) {
+  return <DropdownMenuPrimitive.Root data-slot="dropdown-menu" {...props} />;
+}
+
+function DropdownMenuPortal({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Portal>) {
+  return (
+    <DropdownMenuPrimitive.Portal data-slot="dropdown-menu-portal" {...props} />
+  );
+}
+
+function DropdownMenuTrigger({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Trigger>) {
+  return (
+    <DropdownMenuPrimitive.Trigger
+      data-slot="dropdown-menu-trigger"
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuContent({
+  className,
+  sideOffset,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Content>) {
+  return (
+    <DropdownMenuPrimitive.Portal>
+      <DropdownMenuPrimitive.Content
+        data-slot="dropdown-menu-content"
+        sideOffset={sideOffset}
+        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 z-50 max-h-(--radix-dropdown-menu-content-available-height) min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-md border p-1 shadow-md",
+          className
+        )}
+        {...props}
+      />
+    </DropdownMenuPrimitive.Portal>
+  );
+}
+
+function DropdownMenuGroup({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Group>) {
+  return (
+    <DropdownMenuPrimitive.Group data-slot="dropdown-menu-group" {...props} />
+  );
+}
+
+function DropdownMenuItem({
+  className,
+  inset,
+  variant,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Item> & {
+  inset?: boolean;
+  variant?: "default" | "destructive";
+}) {
+  return (
+    <DropdownMenuPrimitive.Item
+      data-slot="dropdown-menu-item"
+      data-inset={inset}
+      data-variant={variant}
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 dark:data-[variant=destructive]:focus:bg-destructive/20 data-[variant=destructive]:focus:text-destructive data-[variant=destructive]:*:[svg]:!text-destructive [&_svg:not([class*='text-'])]:text-muted-foreground relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuCheckboxItem({
+  className,
+  children,
+  checked,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.CheckboxItem>) {
+  return (
+    <DropdownMenuPrimitive.CheckboxItem
+      data-slot="dropdown-menu-checkbox-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-sm py-1.5 pr-2 pl-8 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",
+        className
+      )}
+      checked={checked}
+      {...props}
+    >
+      <span className="pointer-events-none absolute left-2 flex size-3.5 items-center justify-center">
+        <DropdownMenuPrimitive.ItemIndicator>
+          <CheckIcon className="size-4" />
+        </DropdownMenuPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </DropdownMenuPrimitive.CheckboxItem>
+  );
+}
+
+function DropdownMenuRadioGroup({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.RadioGroup>) {
+  return (
+    <DropdownMenuPrimitive.RadioGroup
+      data-slot="dropdown-menu-radio-group"
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuRadioItem({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.RadioItem>) {
+  return (
+    <DropdownMenuPrimitive.RadioItem
+      data-slot="dropdown-menu-radio-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-sm py-1.5 pr-2 pl-8 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",
+        className
+      )}
+      {...props}
+    >
+      <span className="pointer-events-none absolute left-2 flex size-3.5 items-center justify-center">
+        <DropdownMenuPrimitive.ItemIndicator>
+          <CircleIcon className="size-2 fill-current" />
+        </DropdownMenuPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </DropdownMenuPrimitive.RadioItem>
+  );
+}
+
+function DropdownMenuLabel({
+  className,
+  inset,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Label> & {
+  inset?: boolean;
+}) {
+  return (
+    <DropdownMenuPrimitive.Label
+      data-slot="dropdown-menu-label"
+      data-inset={inset}
+      className={cn(
+        "px-2 py-1.5 text-sm font-medium data-[inset]:pl-8",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Separator>) {
+  return (
+    <DropdownMenuPrimitive.Separator
+      data-slot="dropdown-menu-separator"
+      className={cn("bg-border -mx-1 my-1 h-px", className)}
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuShortcut({
+  className,
+  ...props
+}: React.ComponentPropsWithoutRef<"span">) {
+  return (
+    <span
+      data-slot="dropdown-menu-shortcut"
+      className={cn(
+        "text-muted-foreground ml-auto text-xs tracking-widest",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuSub({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Sub>) {
+  return <DropdownMenuPrimitive.Sub data-slot="dropdown-menu-sub" {...props} />;
+}
+
+function DropdownMenuSubTrigger({
+  className,
+  inset,
+  children,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.SubTrigger> & {
+  inset?: boolean;
+}) {
+  return (
+    <DropdownMenuPrimitive.SubTrigger
+      data-slot="dropdown-menu-sub-trigger"
+      data-inset={inset}
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground [&_svg:not([class*='text-'])]:text-muted-foreground flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <ChevronRightIcon className="ml-auto size-4" />
+    </DropdownMenuPrimitive.SubTrigger>
+  );
+}
+
+function DropdownMenuSubContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.SubContent>) {
+  return (
+    <DropdownMenuPrimitive.SubContent
+      data-slot="dropdown-menu-sub-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 z-50 min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-hidden rounded-md border p-1 shadow-lg",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export {
+  DropdownMenu,
+  DropdownMenuCheckboxItem,
+  DropdownMenuContent,
+  DropdownMenuGroup,
+  DropdownMenuItem,
+  DropdownMenuLabel,
+  DropdownMenuPortal,
+  DropdownMenuRadioGroup,
+  DropdownMenuRadioItem,
+  DropdownMenuSeparator,
+  DropdownMenuShortcut,
+  DropdownMenuSub,
+  DropdownMenuSubContent,
+  DropdownMenuSubTrigger,
+  DropdownMenuTrigger,
+};

package/components/ui/index.ts

@@ -0,0 +1,86 @@
+// Copyright 2026 Chesapeake Computing
+// SPDX-License-Identifier: Apache-2.0
+
+// UI Components - shadcn/ui primitives and styled components
+export { Avatar, AvatarFallback, AvatarImage } from "./avatar.tsx";
+
+export { Badge } from "./badge.tsx";
+export type { BadgeProps } from "./badge.tsx";
+export { badgeVariants } from "./badgeVariants.ts";
+export type { BadgeVariantsProps } from "./badgeVariants.ts";
+
+export { Button } from "./button.tsx";
+export { buttonVariants } from "./buttonVariants.ts";
+export type { ButtonVariantsProps } from "./buttonVariants.ts";
+
+export { ButtonGroup } from "./button-group.tsx";
+export { buttonGroupVariants } from "./buttonGroupVariants.ts";
+
+export { Calendar } from "./calendar.tsx";
+
+export {
+  Card,
+  CardContent,
+  CardDescription,
+  CardFooter,
+  CardHeader,
+  CardTitle,
+} from "./card.tsx";
+
+export {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+  DialogTrigger,
+} from "./dialog.tsx";
+
+export {
+  Drawer,
+  DrawerContent,
+  DrawerDescription,
+  DrawerFooter,
+  DrawerHeader,
+  DrawerTitle,
+  DrawerTrigger,
+} from "./drawer.tsx";
+
+export {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuLabel,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+} from "./dropdown-menu.tsx";
+
+export { Input } from "./input.tsx";
+
+export { Label } from "./label.tsx";
+
+export { LocationInput } from "./location-input.tsx";
+
+export { Popover, PopoverContent, PopoverTrigger } from "./popover.tsx";
+
+export {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "./select.tsx";
+
+export { Separator } from "./separator.tsx";
+
+export { Toaster } from "./sonner.tsx";
+
+export { Textarea } from "./textarea.tsx";
+
+export {
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from "./tooltip.tsx";

package/components/ui/input.tsx

@@ -0,0 +1,59 @@
+// Copyright 2026 Chesapeake Computing
+// SPDX-License-Identifier: Apache-2.0
+
+import React from "react";
+
+import { cn } from "../../lib/utils";
+
+/**
+ * Input component for text entry.
+ *
+ * Supports all standard HTML input types and provides consistent styling
+ * with focus states, disabled states, and error states.
+ * Forwards ref to the underlying native input.
+ *
+ * @example
+ * ```tsx
+ * // Basic text input
+ * <Input type="text" placeholder="Enter your name" />
+ *
+ * // Email input
+ * <Input type="email" placeholder="email@example.com" />
+ *
+ * // Password input
+ * <Input type="password" placeholder="Enter password" />
+ *
+ * // With error state
+ * <Input aria-invalid="true" placeholder="Invalid input" />
+ *
+ * // Disabled input
+ * <Input disabled placeholder="Disabled input" />
+ *
+ * // With label
+ * <div>
+ *   <Label htmlFor="email">Email</Label>
+ *   <Input id="email" type="email" />
+ * </div>
+ * ```
+ */
+const Input = React.forwardRef<
+  HTMLInputElement,
+  React.ComponentPropsWithoutRef<"input">
+>(function Input({ className, type, ...props }, ref) {
+  return (
+    <input
+      ref={ref}
+      type={type}
+      data-slot="input"
+      className={cn(
+        "file:text-foreground placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground dark:bg-input/30 border-input h-9 w-full min-w-0 rounded-md border bg-transparent px-3 py-1 text-base shadow-xs transition-[color,box-shadow] outline-none file:inline-flex file:h-7 file:border-0 file:bg-transparent file:text-sm file:font-medium disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+        "focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
+        "aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+        className
+      )}
+      {...props}
+    />
+  );
+});
+
+export { Input };

package/components/ui/label.tsx

@@ -0,0 +1,47 @@
+// Copyright 2026 Chesapeake Computing
+// SPDX-License-Identifier: Apache-2.0
+
+import * as React from "react";
+import * as LabelPrimitive from "@radix-ui/react-label";
+
+import { cn } from "../../lib/utils";
+
+/**
+ * Label component for form elements.
+ *
+ * Built on top of Radix UI's Label primitive for accessibility.
+ * Provides proper association with form controls and disabled state handling.
+ *
+ * @example
+ * ```tsx
+ * // Basic label
+ * <Label htmlFor="email">Email Address</Label>
+ * <Input id="email" type="email" />
+ *
+ * // With required indicator
+ * <Label htmlFor="name">
+ *   Name <span className="text-red-500">*</span>
+ * </Label>
+ *
+ * // Associated with disabled input
+ * <Label htmlFor="disabled">Disabled Field</Label>
+ * <Input id="disabled" disabled />
+ * ```
+ */
+function Label({
+  className,
+  ...props
+}: React.ComponentProps<typeof LabelPrimitive.Root>) {
+  return (
+    <LabelPrimitive.Root
+      data-slot="label"
+      className={cn(
+        "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export { Label };

package/components/ui/location-input.md

@@ -0,0 +1,194 @@
+# LocationInput Component
+
+A reusable React component that provides Google Maps autocomplete functionality
+for location lookup services.
+
+## Features
+
+- **Google Maps Autocomplete**: Real-time location suggestions as you type
+- **Keyboard Navigation**: Use arrow keys to navigate through suggestions
+- **Debounced Search**: Configurable debounce to prevent excessive API calls
+- **Loading States**: Visual loading indicator during API requests
+- **Accessible**: Full keyboard support and ARIA-compliant
+- **Customizable**: Styling and behavior can be customized via props
+- **TypeScript Support**: Full type safety with TypeScript definitions
+
+## Prerequisites
+
+1. **Google Maps API Key**: You need a valid Google Maps API key with the Places
+   API enabled
+2. **API Key Setup**: Enable the following APIs in your Google Cloud Console:
+   - Places API
+   - Maps JavaScript API
+
+## Installation
+
+The component is already included in your project at
+`src/components/ui/location-input.tsx`.
+
+## Usage
+
+### Basic Usage
+
+```tsx
+import {
+  LocationInput,
+  LocationSuggestion,
+} from "./components/ui/location-input";
+
+function MyComponent() {
+  const handleLocationSelect = (location: LocationSuggestion) => {
+    console.log("Selected location:", location);
+  };
+
+  return (
+    <LocationInput
+      apiKey="YOUR_GOOGLE_MAPS_API_KEY"
+      onLocationSelect={handleLocationSelect}
+      placeholder="Search for a location..."
+    />
+  );
+}
+```
+
+### Advanced Usage
+
+```tsx
+import {
+  LocationInput,
+  LocationSuggestion,
+} from "./components/ui/location-input";
+
+function MyComponent() {
+  const [selectedLocation, setSelectedLocation] = useState<
+    LocationSuggestion | null
+  >(null);
+
+  const handleLocationSelect = (location: LocationSuggestion) => {
+    setSelectedLocation(location);
+    // You can now use the location data for your application
+    console.log("Place ID:", location.place_id);
+    console.log("Description:", location.description);
+  };
+
+  const handleInputChange = (value: string) => {
+    // Handle input changes (e.g., for form validation)
+    console.log("Input value:", value);
+  };
+
+  return (
+    <LocationInput
+      apiKey="YOUR_GOOGLE_MAPS_API_KEY"
+      onLocationSelect={handleLocationSelect}
+      onInputChange={handleInputChange}
+      placeholder="Enter your location..."
+      debounceMs={500} // Custom debounce time
+      className="w-full max-w-md"
+      suggestionsClassName="custom-suggestions"
+    />
+  );
+}
+```
+
+## Props
+
+### LocationInputProps
+
+| Prop                   | Type                                     | Default                      | Description                              |
+| ---------------------- | ---------------------------------------- | ---------------------------- | ---------------------------------------- |
+| `apiKey`               | `string`                                 | -                            | **Required**. Your Google Maps API key   |
+| `onLocationSelect`     | `(location: LocationSuggestion) => void` | -                            | Callback when a location is selected     |
+| `onInputChange`        | `(value: string) => void`                | -                            | Callback when input value changes        |
+| `placeholder`          | `string`                                 | `"Search for a location..."` | Input placeholder text                   |
+| `className`            | `string`                                 | -                            | CSS classes for the input container      |
+| `suggestionsClassName` | `string`                                 | -                            | CSS classes for the suggestions dropdown |
+| `debounceMs`           | `number`                                 | `300`                        | Debounce time in milliseconds            |
+| `...props`             | `HTMLInputElement`                       | -                            | All standard HTML input props            |
+
+### LocationSuggestion Interface
+
+```typescript
+interface LocationSuggestion {
+  place_id: string;
+  description: string;
+  structured_formatting: {
+    main_text: string;
+    secondary_text: string;
+  };
+}
+```
+
+## Keyboard Navigation
+
+- **Arrow Down**: Navigate to next suggestion
+- **Arrow Up**: Navigate to previous suggestion
+- **Enter**: Select the currently highlighted suggestion
+- **Escape**: Close the suggestions dropdown
+
+## Styling
+
+The component uses Tailwind CSS classes and follows your existing design system.
+You can customize the appearance by:
+
+1. **Container Styling**: Use the `className` prop to style the input container
+2. **Suggestions Styling**: Use the `suggestionsClassName` prop to style the
+   dropdown
+3. **CSS Customization**: Override the default classes in your CSS
+
+## API Key Security
+
+**Important**: Never expose your API key in client-side code for production
+applications. Consider:
+
+1. **Environment Variables**: Store the API key in environment variables
+2. **Backend Proxy**: Create a backend endpoint that proxies requests to Google
+   Maps API
+3. **API Key Restrictions**: Set up proper restrictions in Google Cloud Console
+
+### Environment Variable Example
+
+```tsx
+<LocationInput
+  apiKey={import.meta.env.VITE_GOOGLE_MAPS_API_KEY}
+  onLocationSelect={handleLocationSelect}
+/>;
+```
+
+## Error Handling
+
+The component includes built-in error handling for:
+
+- Network errors
+- API quota exceeded
+- Invalid API key
+- No results found
+
+Errors are logged to the console and the suggestions list will be empty.
+
+## Performance Considerations
+
+- **Debouncing**: Default 300ms debounce prevents excessive API calls
+- **Lazy Loading**: Google Maps API is only loaded when needed
+- **Memory Management**: Proper cleanup of timeouts and event listeners
+
+## Browser Support
+
+- Modern browsers with ES6+ support
+- Requires internet connection for Google Maps API
+
+## Troubleshooting
+
+### Common Issues
+
+1. **No suggestions appearing**: Check your API key and ensure Places API is
+   enabled
+2. **CORS errors**: Ensure your API key has proper domain restrictions
+3. **Quota exceeded**: Check your Google Cloud Console for usage limits
+
+### Debug Mode
+
+Enable browser developer tools to see detailed error messages and API responses.
+
+## Example Implementation
+
+See `src/components/LocationInputExample.tsx` for a complete working example.