@titan-design/react-ui 0.1.0 → 0.1.1

package/src/components/ui/toast/Toast.test.tsx

@@ -0,0 +1,207 @@
+import { describe, it, expect, vi } from 'vitest'
+import { render, screen, fireEvent, act } from '@testing-library/react'
+import { axe } from 'jest-axe'
+import { Toast, ToastProvider, useToast } from './Toast'
+
+describe('Toast (standalone)', () => {
+  it('renders with title', () => {
+    render(<Toast title="Success!" />)
+    expect(screen.getByText('Success!')).toBeInTheDocument()
+  })
+
+  it('renders with description', () => {
+    render(<Toast title="Saved" description="Your changes have been saved." />)
+    expect(screen.getByText('Your changes have been saved.')).toBeInTheDocument()
+  })
+
+  it('renders without description', () => {
+    render(<Toast title="Done" />)
+    expect(screen.getByText('Done')).toBeInTheDocument()
+    expect(screen.queryByText('Your changes')).not.toBeInTheDocument()
+  })
+
+  describe('statuses', () => {
+    const statuses = ['success', 'error', 'warning', 'info'] as const
+    statuses.forEach((status) => {
+      it(`renders with status ${status}`, () => {
+        render(<Toast title={`${status} toast`} status={status} />)
+        expect(screen.getByText(`${status} toast`)).toBeInTheDocument()
+      })
+    })
+  })
+
+  it('renders with default info status', () => {
+    render(<Toast title="Info toast" />)
+    expect(screen.getByRole('alert')).toBeInTheDocument()
+  })
+
+  describe('icon visibility', () => {
+    it('shows icon by default', () => {
+      render(<Toast title="Test" status="success" />)
+      // The checkmark icon is rendered
+      expect(screen.getByRole('alert')).toBeInTheDocument()
+    })
+
+    it('hides icon when showIcon is false', () => {
+      render(<Toast title="Test" showIcon={false} />)
+      expect(screen.getByText('Test')).toBeInTheDocument()
+    })
+  })
+
+  describe('close button', () => {
+    it('does not show close button by default', () => {
+      render(<Toast title="Test" />)
+      expect(screen.queryByLabelText('Close toast')).not.toBeInTheDocument()
+    })
+
+    it('shows close button when isClosable and onClose are provided', () => {
+      const onClose = vi.fn()
+      render(<Toast title="Test" isClosable onClose={onClose} />)
+      expect(screen.getByLabelText('Close toast')).toBeInTheDocument()
+    })
+
+    it('calls onClose when close button is pressed', () => {
+      const onClose = vi.fn()
+      render(<Toast title="Test" isClosable onClose={onClose} />)
+
+      fireEvent.click(screen.getByLabelText('Close toast'))
+      expect(onClose).toHaveBeenCalledTimes(1)
+    })
+  })
+
+  describe('accessibility', () => {
+    it('has no accessibility violations', async () => {
+      const { container } = render(
+        <Toast title="Accessible toast" description="Description text" status="success" />
+      )
+      const results = await axe(container)
+      expect(results).toHaveNoViolations()
+    })
+
+    it('has alert role', () => {
+      render(<Toast title="Alert" />)
+      expect(screen.getByRole('alert')).toBeInTheDocument()
+    })
+  })
+})
+
+describe('ToastProvider', () => {
+  function TestConsumer() {
+    const { addToast, removeAllToasts } = useToast()
+    return (
+      <div>
+        <button
+          onClick={() =>
+            addToast({ title: 'New Toast', status: 'success' })
+          }
+        >
+          Add Toast
+        </button>
+        <button onClick={removeAllToasts}>Clear All</button>
+      </div>
+    )
+  }
+
+  it('renders children', () => {
+    render(
+      <ToastProvider>
+        <div>App Content</div>
+      </ToastProvider>
+    )
+    expect(screen.getByText('App Content')).toBeInTheDocument()
+  })
+
+  it('adds a toast via useToast hook', () => {
+    render(
+      <ToastProvider>
+        <TestConsumer />
+      </ToastProvider>
+    )
+
+    fireEvent.click(screen.getByText('Add Toast'))
+    expect(screen.getByText('New Toast')).toBeInTheDocument()
+  })
+
+  it('removes all toasts', () => {
+    render(
+      <ToastProvider>
+        <TestConsumer />
+      </ToastProvider>
+    )
+
+    fireEvent.click(screen.getByText('Add Toast'))
+    expect(screen.getByText('New Toast')).toBeInTheDocument()
+
+    fireEvent.click(screen.getByText('Clear All'))
+    expect(screen.queryByText('New Toast')).not.toBeInTheDocument()
+  })
+
+  it('respects maxToasts limit', () => {
+    render(
+      <ToastProvider maxToasts={2}>
+        <TestConsumer />
+      </ToastProvider>
+    )
+
+    fireEvent.click(screen.getByText('Add Toast'))
+    fireEvent.click(screen.getByText('Add Toast'))
+    fireEvent.click(screen.getByText('Add Toast'))
+
+    // Only 2 should be visible
+    const toasts = screen.getAllByText('New Toast')
+    expect(toasts.length).toBeLessThanOrEqual(2)
+  })
+
+  it('auto-dismisses toasts after duration', () => {
+    vi.useFakeTimers()
+
+    render(
+      <ToastProvider defaultDuration={3000}>
+        <TestConsumer />
+      </ToastProvider>
+    )
+
+    fireEvent.click(screen.getByText('Add Toast'))
+    expect(screen.getByText('New Toast')).toBeInTheDocument()
+
+    act(() => {
+      vi.advanceTimersByTime(3000)
+    })
+
+    expect(screen.queryByText('New Toast')).not.toBeInTheDocument()
+
+    vi.useRealTimers()
+  })
+
+  it('throws when useToast is used outside ToastProvider', () => {
+    function BadConsumer() {
+      useToast()
+      return null
+    }
+
+    expect(() => render(<BadConsumer />)).toThrow(
+      'useToast must be used within a ToastProvider'
+    )
+  })
+
+  describe('positions', () => {
+    const positions = [
+      'top',
+      'top-right',
+      'top-left',
+      'bottom',
+      'bottom-right',
+      'bottom-left',
+    ] as const
+    positions.forEach((position) => {
+      it(`renders with position ${position}`, () => {
+        render(
+          <ToastProvider position={position}>
+            <div>Content</div>
+          </ToastProvider>
+        )
+        expect(screen.getByText('Content')).toBeInTheDocument()
+      })
+    })
+  })
+})

package/src/components/ui/toast/Toast.tsx

@@ -0,0 +1,327 @@
+import React, { createContext, useContext, useState, useCallback, useEffect } from 'react'
+import { View, Text, Pressable, type ViewProps } from 'react-native'
+import { cn } from '../../../utils/cn'
+
+export type ToastStatus = 'success' | 'error' | 'warning' | 'info'
+export type ToastPosition = 'top' | 'top-right' | 'top-left' | 'bottom' | 'bottom-right' | 'bottom-left'
+
+export interface ToastConfig {
+  /** Unique ID for the toast */
+  id: string
+  /** Title text */
+  title: string
+  /** Description text */
+  description?: string
+  /** Status/type of the toast */
+  status?: ToastStatus
+  /** Duration in milliseconds (0 = no auto-dismiss) */
+  duration?: number
+  /** Whether the toast can be dismissed */
+  isClosable?: boolean
+  /** Callback when toast is closed */
+  onClose?: () => void
+}
+
+interface ToastContextType {
+  toasts: ToastConfig[]
+  addToast: (config: Omit<ToastConfig, 'id'>) => string
+  removeToast: (id: string) => void
+  removeAllToasts: () => void
+}
+
+const ToastContext = createContext<ToastContextType | null>(null)
+
+let toastIdCounter = 0
+
+export interface ToastProviderProps {
+  /** Position of toasts on screen */
+  position?: ToastPosition
+  /** Default duration for toasts */
+  defaultDuration?: number
+  /** Maximum number of visible toasts */
+  maxToasts?: number
+  children?: React.ReactNode
+}
+
+const positionStyles: Record<ToastPosition, string> = {
+  'top': 'top-4 left-1/2 -translate-x-1/2',
+  'top-right': 'top-4 right-4',
+  'top-left': 'top-4 left-4',
+  'bottom': 'bottom-4 left-1/2 -translate-x-1/2',
+  'bottom-right': 'bottom-4 right-4',
+  'bottom-left': 'bottom-4 left-4',
+}
+
+/**
+ * Provider component for the toast notification system.
+ *
+ * @example
+ * // Wrap your app with ToastProvider
+ * <ToastProvider position="top-right">
+ *   <App />
+ * </ToastProvider>
+ *
+ * // Then use the useToast hook in any component
+ * const { addToast } = useToast()
+ * addToast({ title: 'Success!', status: 'success' })
+ */
+export function ToastProvider({
+  position = 'top-right',
+  defaultDuration = 5000,
+  maxToasts = 5,
+  children,
+}: ToastProviderProps) {
+  const [toasts, setToasts] = useState<ToastConfig[]>([])
+
+  const addToast = useCallback((config: Omit<ToastConfig, 'id'>) => {
+    const id = `toast-${++toastIdCounter}`
+    const newToast: ToastConfig = {
+      id,
+      duration: defaultDuration,
+      isClosable: true,
+      status: 'info',
+      ...config,
+    }
+
+    setToasts((prev) => {
+      const updated = [newToast, ...prev]
+      return updated.slice(0, maxToasts)
+    })
+
+    return id
+  }, [defaultDuration, maxToasts])
+
+  const removeToast = useCallback((id: string) => {
+    setToasts((prev) => prev.filter((t) => t.id !== id))
+  }, [])
+
+  const removeAllToasts = useCallback(() => {
+    setToasts([])
+  }, [])
+
+  return (
+    <ToastContext.Provider value={{ toasts, addToast, removeToast, removeAllToasts }}>
+      {children}
+      {/* Toast Container */}
+      <View
+        className={cn(
+          'fixed z-[9999] flex flex-col gap-2',
+          positionStyles[position]
+        )}
+        pointerEvents="box-none"
+      >
+        {toasts.map((toast) => (
+          <ToastItem
+            key={toast.id}
+            {...toast}
+            onClose={() => {
+              removeToast(toast.id)
+              toast.onClose?.()
+            }}
+          />
+        ))}
+      </View>
+    </ToastContext.Provider>
+  )
+}
+
+/**
+ * Hook to access toast functions.
+ *
+ * @example
+ * const { addToast, removeAllToasts } = useToast()
+ *
+ * // Show a success toast
+ * addToast({
+ *   title: 'Saved!',
+ *   description: 'Your changes have been saved.',
+ *   status: 'success'
+ * })
+ */
+export function useToast() {
+  const context = useContext(ToastContext)
+  if (!context) {
+    throw new Error('useToast must be used within a ToastProvider')
+  }
+  return context
+}
+
+interface ToastItemProps extends ToastConfig {
+  onClose: () => void
+}
+
+const statusStyles: Record<ToastStatus, { bg: string; border: string; icon: string }> = {
+  success: {
+    bg: 'bg-status-success/10',
+    border: 'border-status-success',
+    icon: '✓',
+  },
+  error: {
+    bg: 'bg-status-error/10',
+    border: 'border-status-error',
+    icon: '✕',
+  },
+  warning: {
+    bg: 'bg-status-warning/10',
+    border: 'border-status-warning',
+    icon: '⚠',
+  },
+  info: {
+    bg: 'bg-status-info/10',
+    border: 'border-status-info',
+    icon: 'ℹ',
+  },
+}
+
+const iconColors: Record<ToastStatus, string> = {
+  success: 'text-status-success',
+  error: 'text-status-error',
+  warning: 'text-status-warning',
+  info: 'text-status-info',
+}
+
+function ToastItem({
+  id,
+  title,
+  description,
+  status = 'info',
+  duration = 5000,
+  isClosable = true,
+  onClose,
+}: ToastItemProps) {
+  const { bg, border, icon } = statusStyles[status]
+
+  // Auto-dismiss
+  useEffect(() => {
+    if (duration > 0) {
+      const timer = setTimeout(onClose, duration)
+      return () => clearTimeout(timer)
+    }
+  }, [duration, onClose])
+
+  return (
+    <View
+      className={cn(
+        'min-w-[280px] max-w-[400px] rounded-lg border-l-4 shadow-lg',
+        'bg-surface-elevated',
+        border
+      )}
+      accessibilityRole="alert"
+    >
+      <View className={cn('flex-row items-start p-3', bg)}>
+        {/* Icon */}
+        <View className={cn('w-6 h-6 items-center justify-center mr-3')}>
+          <Text className={cn('text-lg', iconColors[status])}>{icon}</Text>
+        </View>
+
+        {/* Content */}
+        <View className="flex-1">
+          <Text className="text-sm font-semibold text-text-primary">
+            {title}
+          </Text>
+          {description && (
+            <Text className="text-sm text-text-secondary mt-0.5">
+              {description}
+            </Text>
+          )}
+        </View>
+
+        {/* Close button */}
+        {isClosable && (
+          <Pressable
+            onPress={onClose}
+            className="p-1 -m-1 rounded web:hover:bg-interactive-hover"
+            accessibilityLabel="Close toast"
+          >
+            <Text className="text-text-tertiary text-lg">×</Text>
+          </Pressable>
+        )}
+      </View>
+    </View>
+  )
+}
+
+export interface ToastProps extends ViewProps {
+  /** Title text */
+  title: string
+  /** Description text */
+  description?: string
+  /** Status/type of the toast */
+  status?: ToastStatus
+  /** Whether to show the icon */
+  showIcon?: boolean
+  /** Whether the toast can be dismissed */
+  isClosable?: boolean
+  /** Callback when close button is clicked */
+  onClose?: () => void
+  /** Additional className */
+  className?: string
+}
+
+/**
+ * Standalone Toast component (for static rendering without provider).
+ *
+ * @example
+ * <Toast
+ *   title="Success!"
+ *   description="Your changes have been saved."
+ *   status="success"
+ * />
+ */
+export function Toast({
+  title,
+  description,
+  status = 'info',
+  showIcon = true,
+  isClosable = false,
+  onClose,
+  className,
+  ...props
+}: ToastProps) {
+  const { bg, border, icon } = statusStyles[status]
+
+  return (
+    <View
+      className={cn(
+        'min-w-[280px] max-w-[400px] rounded-lg border-l-4 shadow-lg',
+        'bg-surface-elevated',
+        border,
+        className
+      )}
+      accessibilityRole="alert"
+      {...props}
+    >
+      <View className={cn('flex-row items-start p-3', bg)}>
+        {/* Icon */}
+        {showIcon && (
+          <View className="w-6 h-6 items-center justify-center mr-3">
+            <Text className={cn('text-lg', iconColors[status])}>{icon}</Text>
+          </View>
+        )}
+
+        {/* Content */}
+        <View className="flex-1">
+          <Text className="text-sm font-semibold text-text-primary">
+            {title}
+          </Text>
+          {description && (
+            <Text className="text-sm text-text-secondary mt-0.5">
+              {description}
+            </Text>
+          )}
+        </View>
+
+        {/* Close button */}
+        {isClosable && onClose && (
+          <Pressable
+            onPress={onClose}
+            className="p-1 -m-1 rounded web:hover:bg-interactive-hover"
+            accessibilityLabel="Close toast"
+          >
+            <Text className="text-text-tertiary text-lg">×</Text>
+          </Pressable>
+        )}
+      </View>
+    </View>
+  )
+}

package/src/components/ui/toast/index.ts

@@ -0,0 +1,8 @@
+export { Toast, ToastProvider, useToast } from './Toast'
+export type {
+  ToastProps,
+  ToastProviderProps,
+  ToastConfig,
+  ToastStatus,
+  ToastPosition,
+} from './Toast'