@daemoniorum/core

Core utilities, hooks, and types for Daemoniorum React applications.

Installation

npm install @daemoniorum/core
# or
pnpm add @daemoniorum/core

Features

Hooks

Timing & Performance

• useDebounce - Debounce a value
• useThrottle - Throttle a value
• usePolling - Execute async function at intervals
• useRetry / withRetry - Retry logic with exponential backoff

Storage

• useLocalStorage - Sync state with localStorage
• useSessionStorage - Sync state with sessionStorage

Responsive & Layout

• useMediaQuery - Track CSS media query matches
• useResponsive - Responsive breakpoint helpers
• useWindowSize - Track window dimensions

DOM & Interaction

• useOnClickOutside - Detect clicks outside element
• useKeyboardShortcuts - Handle keyboard shortcuts
• useSaveShortcut - Ctrl/Cmd+S handler
• useEscapeShortcut - Escape key handler

Focus & Accessibility

• useAutoFocus - Auto-focus element on mount
• useFocusReturn - Return focus when closing
• useFocusTrap - Trap focus in container
• useScreenReaderAnnounce - ARIA live announcements

SEO & Meta

• usePageMeta - Update page meta tags
• usePageTitle - Update document title

Utilities

Class Names

• cn - Merge Tailwind classes with clsx

Formatters

• formatCurrency - Format as currency
• formatNumber - Format with separators
• formatPercent - Format as percentage
• formatCompact - Compact notation (1K, 1M)
• formatBytes - Human-readable file sizes
• formatDate - Localized date formatting
• formatRelativeTime - Relative time (5 min ago)
• formatDuration - Duration formatting
• truncate - Truncate with ellipsis
• toTitleCase / toKebabCase / toCamelCase - String case conversion
• pluralize - Pluralize words

Validators

• isValidEmail - Email validation
• isValidUrl - URL validation
• isValidPhone - Phone number validation
• isValidHexColor - Hex color validation
• isValidCssSize - CSS size validation
• isEmpty - Check for empty values
• isValidNumber / isInRange - Number validation
• isValidLength - String length validation
• isValidUuid - UUID validation
• isValidDate / isFutureDate / isPastDate - Date validation

Error Handling

• parseApiError - Parse errors into standard format
• isHttpError / isNetworkError / isAuthError - Error type checks
• isRetryableError - Check if error is retryable

Accessibility

• checkContrast - WCAG contrast checking
• isLightColor - Determine if color is light
• getContrastingTextColor - Get contrasting text color
• validateColorAccessibility - Validate color scheme
• aria - ARIA attribute helpers

Types

Common TypeScript types including:

• AsyncState<T> - Async data state
• PaginatedResponse<T> - Paginated API response
• SelectOption<T> - Select/dropdown option
• Result<T, E> - Result type for error handling
• And many more...

Usage

import {
  useDebounce,
  useLocalStorage,
  useKeyboardShortcuts,
  cn,
  formatCurrency,
  isValidEmail,
  parseApiError,
} from '@daemoniorum/core'

// Debounce search input
const [search, setSearch] = useState('')
const debouncedSearch = useDebounce(search, 300)

// Persist theme preference
const [theme, setTheme] = useLocalStorage('theme', 'light')

// Handle keyboard shortcuts
useKeyboardShortcuts([
  { key: 'k', ctrl: true, handler: () => openSearch() },
  { key: 'Escape', handler: () => closeModal() },
])

// Merge Tailwind classes
<div className={cn('p-4', isActive && 'bg-blue-500')} />

// Format currency
formatCurrency(1234.56) // '$1,234.56'

// Validate email
if (!isValidEmail(email)) {
  setError('Invalid email')
}

// Parse API errors
try {
  await api.submit()
} catch (error) {
  const { message } = parseApiError(error)
  showToast(message)
}

License

MIT