# Vernmarck (@freshgemui/vernmarck) — Full Reference > Architectural, single-polarity monochrome design system built on 12-step Radix contrast math, strict semantic tokens, Ghost White / Sable polarity, and a calibrated density axis. - Documentation: https://vernmarck.freshgemui.com/ - Summary Index: https://vernmarck.freshgemui.com/llms.txt - Package: `@freshgemui/vernmarck` v0.1.0 (ESM + TypeScript declarations, `"use client"` enabled) - Peer Dependencies: `react` (`^18.0.0 || ^19.0.0`), `react-dom` (`^18.0.0 || ^19.0.0`), `tailwindcss` (`^4.0.0`) --- ## 1. Installation & Setup ```bash npm install @freshgemui/vernmarck ``` ### Tailwind v4 Setup (Recommended) In your application stylesheet: ```css @import "tailwindcss"; @import "@freshgemui/vernmarck/styles.css"; ``` `styles.css` imports `tokens/primitives.css`, `tokens/semantic.css`, configures `@custom-variant dark (&:where(.dark, .dark *));`, bridges all semantic tokens via `@theme inline`, and includes reduced-motion-safe keyframe animations (`animate-progress-indeterminate`, `animate-accordion-down`, `animate-accordion-up`). ### Standalone CSS Tokens (No Tailwind Required) If you only need the CSS custom properties without Tailwind CSS v4, import the token layers directly: ```css @import "@freshgemui/vernmarck/tokens/primitives.css"; @import "@freshgemui/vernmarck/tokens/semantic.css"; ``` > **Note:** The standalone token CSS files (`primitives.css` and `semantic.css`) work without Tailwind, while the React UI components require Tailwind CSS v4 (and `@freshgemui/vernmarck/styles.css`). ### Polarity & Density Attributes ```html ``` --- ## 2. Ghost White & Sable Tokens ### Primitive 12-Step Scales (`tokens/primitives.css`) #### Neutral Scale - **Ghost White** (`:root, .light`, `color-scheme: light`): `--neutral-1: #fafafc`, `--neutral-2: #f3f3f6`, `--neutral-3: #eaeaef`, `--neutral-4: #e1e1e8`, `--neutral-5: #d6d6e0`, `--neutral-6: #c8c8d4`, `--neutral-7: #b4b4c4`, `--neutral-8: #6d6d7e`, `--neutral-9: #141418`, `--neutral-10: #272730`, `--neutral-11: #5a5a68`, `--neutral-12: #111115` - **Sable** (`.dark`, `color-scheme: dark`): `--neutral-1: #0e0e11`, `--neutral-2: #16161a`, `--neutral-3: #1f1f25`, `--neutral-4: #24242b`, `--neutral-5: #2c2c35`, `--neutral-6: #353540`, `--neutral-7: #454554`, `--neutral-8: #6b6b7d`, `--neutral-9: #fafafc`, `--neutral-10: #e4e4ea`, `--neutral-11: #a3a3b2`, `--neutral-12: #f4f4f7` #### Functional Signal Scales (12-Step, Light & Dark) - `--info-1`..`--info-12` (Blue) - `--warning-1`..`--warning-12` (Orange) - `--destructive-1`..`--destructive-12` (Red) - `--success-1`..`--success-12` (Green) ### Semantic Tokens (`tokens/semantic.css`) - Surfaces & Ink: `--background` (`--neutral-1`), `--foreground` (`--neutral-12`), `--card` (`--neutral-2`), `--card-foreground` (`--neutral-12`), `--popover` (`--neutral-1` light / `--neutral-3` dark), `--popover-foreground` (`--neutral-12`) - Actions & Surfaces: `--primary` (`--neutral-9`), `--primary-hover` (`--neutral-10`), `--primary-foreground` (`--neutral-1`), `--secondary` (`--neutral-3`), `--secondary-hover` (`--neutral-4`), `--secondary-foreground` (`--neutral-12`), `--muted` (`--neutral-3`), `--muted-foreground` (`--neutral-11`), `--accent` (`--neutral-4`), `--accent-foreground` (`--neutral-12`) - Hairlines & Focus: `--border` (`--neutral-6`), `--input` (`--neutral-7`), `--ring` (`--neutral-8`) - Signals (`info`, `warning`, `destructive`, `success`): Each signal provides `--{signal}`, `--{signal}-hover`, `--{signal}-foreground`, `--{signal}-subtle`, `--{signal}-subtle-foreground`. --- ## 3. Calibrated Density Axis Applied via `data-density="default"` or `data-density="compact"` on `` or any subtree container: | CSS Variable | `default` | `compact` | |---|---|---| | `--density-control-h` | `2.25rem` (36px) | `1.75rem` (28px) | | `--density-control-h-sm` | `2rem` (32px) | `1.5rem` (24px) | | `--density-control-h-lg` | `2.5rem` (40px) | `2rem` (32px) | | `--density-control-px` | `1rem` | `0.75rem` | | `--density-control-px-sm` | `0.75rem` | `0.5rem` | | `--density-control-px-lg` | `1.5rem` | `1rem` | | `--density-input-px` | `0.75rem` | `0.625rem` | | `--density-control-py` | `0.5rem` | `0.25rem` | | `--density-gap` | `0.5rem` | `0.375rem` | | `--density-field-gap` | `0.375rem` | `0.25rem` | | `--density-section-gap` | `1.5rem` | `1rem` | | `--density-card-pad` | `1.25rem` | `0.875rem` | | `--density-switch-h` | `1.25rem` | `1rem` | | `--density-switch-w` | `2.25rem` | `1.75rem` | | `--density-switch-thumb` | `0.875rem` | `0.625rem` | | `--density-switch-translate` | `1rem` | `0.75rem` | --- ## 4. The 6 Foundations 1. **Scale & Density**: Dual-axis control sizing (`default` vs `compact`) driven by CSS custom properties rather than ad-hoc utility overrides. 2. **Color & Contrast**: Single-polarity monochrome (`Ghost White` <-> `Sable`) using Radix 12-step math; WCAG AA >= 4.5:1 text contrast on all semantic pairs. 3. **Typography**: `--font-sans` (`Geist`), `--font-mono` (`Geist Mono`), strict hierarchy, and `font-variant-numeric: tabular-nums` on `table`, `th`, and `td`. 4. **Spacing**: 4px base grid (`--space-1`..`--space-6`, `--space-8`, `--space-10`, `--space-12`, from `0.25rem` to `3rem`). 5. **Border Radius**: Architectural tight-to-medium scale (`--radius-none`: `0px`, `--radius-sm`: `0.25rem`, `--radius-md`: `0.375rem`, `--radius-lg`: `0.5rem`, `--radius-full`: `9999px`). 6. **Borders & Elevation**: 1px hairline `border` discipline over heavy shadows; clear surface hierarchy (`background` -> `card` -> `popover`). --- ## 5. All 29 Exported Primitives All primitives are exported from `@freshgemui/vernmarck`: ```ts import { Button, Input, Card } from "@freshgemui/vernmarck" ``` 1. **Accordion** (`Accordion`, `AccordionItem`, `AccordionTrigger`, `AccordionContent`) - `Accordion`: Radix `AccordionPrimitive.Root` (`type: "single" | "multiple"`, `collapsible`, `value`, `defaultValue`, `onValueChange`) - `AccordionTrigger`: `previewState?: "hover" | "focus"` 2. **Alert** (`Alert`, `AlertTitle`, `AlertDescription`, `alertVariants`) - `Alert`: `variant?: "default" | "info" | "warning" | "destructive" | "success"`, `dismissible?: boolean`, `onDismiss?: () => void` 3. **AlertDialog** (`AlertDialog`, `AlertDialogTrigger`, `AlertDialogPortal`, `AlertDialogOverlay`, `AlertDialogContent`, `AlertDialogHeader`, `AlertDialogFooter`, `AlertDialogTitle`, `AlertDialogDescription`, `AlertDialogAction`, `AlertDialogCancel`) - `AlertDialogContent`: `"data-density"?: Density` - `AlertDialogAction`: `variant?: "default" | "destructive"` 4. **Badge** (`Badge`, `badgeVariants`) - `Badge`: `variant?: "default" | "secondary" | "outline" | "info" | "warning" | "destructive" | "success"`, `size?: "default" | "sm"`, `dot?: boolean` 5. **Breadcrumb** (`Breadcrumb`, `BreadcrumbList`, `BreadcrumbItem`, `BreadcrumbLink`, `BreadcrumbPage`, `BreadcrumbSeparator`, `BreadcrumbEllipsis`) - `BreadcrumbLink`: `previewState?: "hover" | "focus"` 6. **Button** (`Button`, `buttonVariants`) - `Button`: `variant?: "default" | "secondary" | "outline" | "ghost" | "destructive"`, `size?: "default" | "sm" | "lg" | "icon"`, `loading?: boolean`, `disabledReason?: string`, `previewState?: "hover" | "focus"` 7. **Card** (`Card`, `CardHeader`, `CardTitle`, `CardDescription`, `CardAction`, `CardContent`, `CardFooter`, `cardVariants`) - `Card`: `variant?: "default" | "subtle" | "interactive"` 8. **Checkbox** (`Checkbox`) - `Checkbox`: `checked?: boolean | "indeterminate"`, `onCheckedChange?: (checked: boolean | "indeterminate") => void`, `validationState?: "default" | "error"`, `previewState?: "hover" | "focus"` (auto-wires `Field` context) 9. **Command** (`Command`, `CommandDialog`, `CommandInput`, `CommandList`, `CommandEmpty`, `CommandGroup`, `CommandSeparator`, `CommandItem`, `CommandShortcut`) - `CommandDialog`: `open?: boolean`, `onOpenChange?: (open: boolean) => void`, `title?: string`, `description?: string`, `enableShortcut?: boolean` 10. **DataTable** (`DataTable`, types `SortDirection`, `DataTableSortState`, `DataTableColumn`, `DataTableProps`) - `DataTable`: `data: TData[]`, `columns: DataTableColumn[]`, `getRowId?: (row: TData, index: number) => string`, `searchable?: boolean`, `searchPlaceholder?: string`, `searchValue?: string`, `onSearchChange?: (value: string) => void`, `searchFilterFn?: (row: TData, query: string) => boolean`, `selectable?: boolean`, `selectedRowIds?: string[]`, `onSelectedRowIdsChange?: (ids: string[]) => void`, `loading?: boolean`, `loadingRowCount?: number`, `emptyState?: React.ReactNode`, `emptyTitle?: string`, `emptyDescription?: string`, `initialSort?: DataTableSortState | null`, `toolbarActions?: React.ReactNode`, `caption?: string`, `onRowClick?: (row: TData) => void`, `className?: string` 11. **Dialog** (`Dialog`, `DialogTrigger`, `DialogPortal`, `DialogClose`, `DialogOverlay`, `DialogContent`, `DialogHeader`, `DialogFooter`, `DialogTitle`, `DialogDescription`) - `DialogContent`: `showCloseButton?: boolean`, `"data-density"?: Density` 12. **DropdownMenu** (`DropdownMenu`, `DropdownMenuTrigger`, `DropdownMenuGroup`, `DropdownMenuPortal`, `DropdownMenuSub`, `DropdownMenuRadioGroup`, `DropdownMenuSubTrigger`, `DropdownMenuSubContent`, `DropdownMenuContent`, `DropdownMenuItem`, `DropdownMenuCheckboxItem`, `DropdownMenuRadioItem`, `DropdownMenuLabel`, `DropdownMenuSeparator`, `DropdownMenuShortcut`) - `DropdownMenuContent`: `sideOffset?: number`, `"data-density"?: Density` - `DropdownMenuItem`: `inset?: boolean`, `variant?: "default" | "destructive"` - `DropdownMenuSubTrigger` / `DropdownMenuLabel`: `inset?: boolean` 13. **EmptyState** (`EmptyState`, `emptyStateVariants`) - `EmptyState`: `variant?: "default" | "subtle" | "info" | "warning" | "destructive" | "success"`, `size?: "sm" | "default" | "lg"`, `icon?: React.ReactNode`, `title: string`, `description?: string`, `action?: React.ReactNode`, `secondaryAction?: React.ReactNode` 14. **Field** (`Field`, `useFieldContext`) - `Field`: `label?: React.ReactNode`, `htmlFor?: string`, `required?: boolean`, `description?: React.ReactNode`, `error?: React.ReactNode`, `success?: React.ReactNode`, `disabled?: boolean`, `labelMeta?: React.ReactNode`, `group?: boolean` (provides `id`, `labelId`, `ariaDescribedBy`, `invalid`, `success`, `disabled` to nested controls) 15. **Input** (`Input`, `inputVariants`) - `Input`: `validationState?: "default" | "error" | "success"`, `previewState?: "focus" | "hover"` (auto-wires `Field` context) 16. **Popover** (`Popover`, `PopoverTrigger`, `PopoverAnchor`, `PopoverClose`, `PopoverContent`) - `PopoverContent`: `align?: "start" | "center" | "end"`, `sideOffset?: number`, `"data-density"?: Density` 17. **Progress** (`Progress`, `progressIndicatorVariants`, `progressTrackVariants`) - `Progress`: `value?: number`, `max?: number`, `variant?: "default" | "info" | "warning" | "destructive" | "success"`, `size?: "sm" | "default" | "lg"`, `indeterminate?: boolean`, `label?: string`, `showValue?: boolean` 18. **RadioGroup** (`RadioGroup`, `RadioGroupItem`) - `RadioGroup`: `validationState?: "default" | "error"` (auto-wires `Field` context) - `RadioGroupItem`: `validationState?: "default" | "error"`, `previewState?: "hover" | "focus"` 19. **Select** (`Select`, `SelectGroup`, `SelectValue`, `SelectTrigger`, `SelectScrollUpButton`, `SelectScrollDownButton`, `SelectContent`, `SelectLabel`, `SelectItem`, `SelectSeparator`) - `SelectTrigger`: `validationState?: "default" | "error" | "success"`, `previewState?: "hover" | "focus"` (auto-wires `Field` context) - `SelectContent`: `position?: "item-aligned" | "popper"`, `"data-density"?: Density` 20. **Separator** (`Separator`) - `Separator`: `orientation?: "horizontal" | "vertical"`, `decorative?: boolean` 21. **Sheet** (`Sheet`, `SheetTrigger`, `SheetClose`, `SheetPortal`, `SheetOverlay`, `SheetContent`, `SheetHeader`, `SheetFooter`, `SheetTitle`, `SheetDescription`, `sheetVariants`) - `SheetContent`: `side?: "top" | "bottom" | "left" | "right"`, `showCloseButton?: boolean`, `"data-density"?: Density` 22. **Skeleton** (`Skeleton`, `skeletonVariants`) - `Skeleton`: `variant?: "default" | "circular" | "text"`, `animated?: boolean` 23. **Slider** (`Slider`) - `Slider`: Radix `SliderPrimitive.Root` props + `validationState?: "default" | "error"`, `previewState?: "hover" | "focus"` (auto-wires `Field` context) 24. **Switch** (`Switch`) - `Switch`: `validationState?: "default" | "error"`, `previewState?: "hover" | "focus"` (auto-wires `Field` context) 25. **Tabs** (`Tabs`, `TabsList`, `TabsTrigger`, `TabsContent`) - `TabsList`: `variant?: "default" | "underline"` - `TabsTrigger`: `previewState?: "hover" | "focus"` 26. **Textarea** (`Textarea`, `textareaVariants`) - `Textarea`: `validationState?: "default" | "error" | "success"`, `previewState?: "focus" | "hover"` (auto-wires `Field` context) 27. **Toast** (`ToastProvider`, `useToast`, `ToastItem`, `Toaster`, `toastItemVariants`) - `ToastProvider`: `position?: ToastPosition`, `defaultDuration?: number`, `maxToasts?: number`, `renderToaster?: boolean` - `useToast()`: returns `{ toasts, toast, dismiss, dismissAll }` - `ToastOptions`: `title: string`, `description?: string`, `variant?: "default" | "info" | "warning" | "destructive" | "success"`, `duration?: number`, `action?: { label: string; onClick: () => void }` - `Toaster`: `position?: "bottom-right" | "top-right" | "bottom-left" | "top-left"`, `className?: string` 28. **ToggleGroup** (`ToggleGroup`, `ToggleGroupItem`, `toggleGroupItemVariants`) - `ToggleGroup`: `type: "single" | "multiple"`, `variant?: "default" | "outline"`, `size?: "default" | "sm" | "lg"` (auto-wires `Field` context) - `ToggleGroupItem`: `variant?: "default" | "outline"`, `size?: "default" | "sm" | "lg"`, `previewState?: "hover" | "focus"` 29. **Tooltip** (`TooltipProvider`, `Tooltip`, `TooltipTrigger`, `TooltipContent`) - `TooltipProvider`: `delayDuration?: number` - `TooltipContent`: `sideOffset?: number`, `"data-density"?: Density` ### Utility Export - `cn(...inputs: ClassValue[])`: Tailwind-aware class merger (`clsx` + `tailwind-merge`).