@jmruthers/pace-core 0.5.68 → 0.5.69

package/dist/chunk-ZPG4XPV5.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/useToast.ts","../src/components/PublicLayout/PublicErrorBoundary.tsx","../src/components/PublicLayout/PublicPageProvider.tsx","../src/hooks/useAppConfig.ts","../src/hooks/public/usePublicEventLogo.ts"],"sourcesContent":["\n/**\n * @file Toast hook for managing toast notifications\n * @package @jmruthers/pace-core\n * @module Hooks\n * @since 0.1.0\n */\n\nimport * as React from \"react\"\n\n/** Maximum number of toasts to show at once */\nconst TOAST_LIMIT = 5\n/** Delay before removing a dismissed toast */\nconst TOAST_REMOVE_DELAY = 1000\n\nexport interface ToastProps {\n  title?: React.ReactNode;\n  description?: React.ReactNode;\n  variant?: 'default' | 'destructive' | 'success';\n  duration?: number;\n  onClose?: () => void;\n  action?: React.ReactElement;\n}\n\n/**\n * Extended toast props with additional properties\n * @interface ToasterToast\n */\ntype ToasterToast = ToastProps & {\n  /** Unique identifier for the toast */\n  id: string\n  /** Optional title content */\n  title?: React.ReactNode\n  /** Optional description content */\n  description?: React.ReactNode\n  /** Optional action button */\n  action?: React.ReactElement\n  /** Open state */\n  open?: boolean\n  /** Open change handler */\n  onOpenChange?: (open: boolean) => void\n  /** Dismiss function */\n  dismiss?: () => void\n}\n\n/**\n * State interface for toast management\n */\ninterface State {\n  /** Array of active toasts */\n  toasts: ToasterToast[]\n}\n\n/** Map of toast IDs to their removal timeouts */\nconst toastTimeouts = new Map<string, ReturnType<typeof setTimeout>>()\n\n/** Current toast state */\nlet memoryState: State = {\n  toasts: [],\n}\n\n/** List of state change listeners */\nconst listeners: Array<(state: State) => void> = []\n\n/**\n * Reset the toast state and clear all timeouts\n */\nexport function reset() {\n  memoryState = { toasts: [] }\n  toastTimeouts.forEach((timeout) => clearTimeout(timeout))\n  toastTimeouts.clear()\n}\n\n/**\n * Dispatch a state change\n * @param action - Action to dispatch\n */\nfunction dispatch(action: {\n  type: \"ADD_TOAST\" | \"UPDATE_TOAST\" | \"DISMISS_TOAST\" | \"REMOVE_TOAST\"\n  toast?: ToasterToast\n  toastId?: string\n}) {\n  memoryState = reducer(memoryState, action)\n  listeners.forEach((listener) => {\n    listener(memoryState)\n  })\n}\n\n/**\n * Generate a unique ID for a toast\n * @returns Unique ID string\n */\nfunction genId() {\n  return Math.random().toString(36).substring(2, 9)\n}\n\n/**\n * Add a toast to the removal queue\n * @param toastId - ID of the toast to remove\n */\nconst addToRemoveQueue = (toastId: string) => {\n  if (toastTimeouts.has(toastId)) {\n    return\n  }\n\n  const timeout = setTimeout(() => {\n    toastTimeouts.delete(toastId)\n    dispatch({\n      type: \"REMOVE_TOAST\",\n      toastId: toastId,\n    })\n  }, TOAST_REMOVE_DELAY)\n\n  toastTimeouts.set(toastId, timeout)\n}\n\n/**\n * State reducer for toast management\n * @param state - Current state\n * @param action - Action to process\n * @returns New state\n */\nfunction reducer(state: State, action: {\n  type: \"ADD_TOAST\" | \"UPDATE_TOAST\" | \"DISMISS_TOAST\" | \"REMOVE_TOAST\"\n  toast?: ToasterToast\n  toastId?: string\n}): State {\n  switch (action.type) {\n    case \"ADD_TOAST\":\n      return {\n        ...state,\n        toasts: [action.toast!, ...state.toasts].slice(0, TOAST_LIMIT),\n      }\n\n    case \"UPDATE_TOAST\":\n      return {\n        ...state,\n        toasts: state.toasts.map((t) =>\n          t.id === action.toast?.id ? { ...t, ...action.toast } : t\n        ),\n      }\n\n    case \"DISMISS_TOAST\": {\n      const { toastId } = action\n\n      if (toastId) {\n        addToRemoveQueue(toastId)\n      }\n\n      return {\n        ...state,\n        toasts: state.toasts.map((t) =>\n          t.id === toastId || toastId === undefined\n            ? {\n                ...t,\n                open: false,\n              }\n            : t\n        ),\n      }\n    }\n\n    case \"REMOVE_TOAST\":\n      if (action.toastId === undefined) {\n        return {\n          ...state,\n          toasts: [],\n        }\n      }\n      return {\n        ...state,\n        toasts: state.toasts.filter((t) => t.id !== action.toastId),\n      }\n  }\n}\n\n/**\n * Toast configuration without ID\n */\ntype Toast = Omit<ToasterToast, \"id\">\n\n/**\n * Creates a new toast notification\n * @param props - Toast configuration\n * @returns Object with toast ID and control methods\n */\nfunction toast({ ...props }: Toast) {\n  const id = genId()\n\n  const update = (props: Partial<Omit<ToasterToast, \"id\">>) =>\n    dispatch({\n      type: \"UPDATE_TOAST\",\n      toast: { ...props, id },\n    })\n  const dismiss = () => dispatch({ type: \"DISMISS_TOAST\", toastId: id })\n\n  dispatch({\n    type: \"ADD_TOAST\",\n    toast: {\n      ...props,\n      id,\n      open: true,\n      dismiss,\n      onOpenChange: (open) => {\n        if (!open) dismiss()\n      },\n    },\n  })\n\n  return {\n    id: id,\n    dismiss,\n    update,\n  }\n}\n\n/**\n * Hook for managing toast notifications\n * @returns Object with toast state and control methods\n */\nfunction useToast() {\n  const [state, setState] = React.useState<State>(memoryState)\n\n  React.useEffect(() => {\n    listeners.push(setState)\n    return () => {\n      const index = listeners.indexOf(setState)\n      if (index > -1) {\n        listeners.splice(index, 1)\n      }\n    }\n  }, [state])\n\n  return {\n    ...state,\n    toast,\n    dismiss: (toastId?: string) => dispatch({ type: \"DISMISS_TOAST\", toastId }),\n  }\n}\n\nexport { useToast, toast }\nexport type { ToasterToast }\n","/**\n * @file Public Error Boundary Component\n * @package @jmruthers/pace-core\n * @module Components/PublicLayout\n * @since 1.0.0\n *\n * An error boundary component specifically designed for public pages.\n * Provides graceful error handling and recovery for public content.\n *\n * Features:\n * - Graceful error handling\n * - User-friendly error messages\n * - Recovery mechanisms\n * - Accessibility compliant\n * - TypeScript support\n *\n * @example\n * ```tsx\n * import { PublicErrorBoundary } from '@jmruthers/pace-core';\n *\n * function PublicEventPage() {\n *   return (\n *     <PublicErrorBoundary>\n *       <PublicPageContent />\n *     </PublicErrorBoundary>\n *   );\n * }\n * ```\n *\n * @accessibility\n * - WCAG 2.1 AA compliant\n * - Screen reader friendly error messages\n * - Keyboard accessible recovery actions\n * - High contrast support\n *\n * @dependencies\n * - React 18+ - Component framework\n * - Error boundary patterns\n * - Tailwind CSS - Styling\n */\n\nimport React, { Component, ErrorInfo, ReactNode } from 'react';\n\nexport interface PublicErrorBoundaryProps {\n  /** Child components to wrap */\n  children: ReactNode;\n  /** Custom error fallback component */\n  fallback?: React.ComponentType<PublicErrorBoundaryState>;\n  /** Custom CSS classes for error display */\n  className?: string;\n  /** Whether to show error details in development */\n  showErrorDetails?: boolean;\n  /** Custom error message */\n  customErrorMessage?: string;\n  /** Custom recovery action */\n  onRecover?: () => void;\n}\n\nexport interface PublicErrorBoundaryState {\n  /** Whether an error has occurred */\n  hasError: boolean;\n  /** The error that occurred */\n  error: Error | null;\n  /** Error information */\n  errorInfo: ErrorInfo | null;\n  /** Function to reset the error state */\n  resetError: () => void;\n}\n\n/**\n * Error boundary component for public pages\n * \n * This component catches JavaScript errors anywhere in the child component tree,\n * logs those errors, and displays a fallback UI instead of the component tree that crashed.\n * \n * @param props - Error boundary configuration\n * @returns React element with error boundary wrapper\n */\nexport class PublicErrorBoundary extends Component<PublicErrorBoundaryProps, PublicErrorBoundaryState> {\n  constructor(props: PublicErrorBoundaryProps) {\n    super(props);\n    this.state = {\n      hasError: false,\n      error: null,\n      errorInfo: null,\n      resetError: this.resetError.bind(this)\n    };\n  }\n\n  static getDerivedStateFromError(error: Error): Partial<PublicErrorBoundaryState> {\n    // Update state so the next render will show the fallback UI\n    return {\n      hasError: true,\n      error\n    };\n  }\n\n  componentDidCatch(error: Error, errorInfo: ErrorInfo) {\n    // Log the error to console in development\n    if (import.meta.env.MODE === 'development') {\n      console.error('PublicErrorBoundary caught an error:', error, errorInfo);\n    }\n\n    // Update state with error info\n    this.setState({\n      error,\n      errorInfo\n    });\n\n    // You can also log the error to an error reporting service here\n    // Example: logErrorToService(error, errorInfo);\n  }\n\n  resetError = () => {\n    this.setState({\n      hasError: false,\n      error: null,\n      errorInfo: null\n    });\n  };\n\n  render() {\n    if (this.state.hasError) {\n      // Custom fallback component\n      if (this.props.fallback) {\n        return <this.props.fallback {...this.state} />;\n      }\n\n      // Default error UI\n      return (\n        <div className={`min-h-screen bg-white flex items-center justify-center ${this.props.className || ''}`}>\n          <div className=\"max-w-md mx-auto text-center px-4\">\n            <div className=\"mb-6\">\n              <div className=\"mx-auto flex items-center justify-center h-12 w-12 rounded-full bg-red-100 mb-4\">\n                <svg\n                  className=\"h-6 w-6 text-red-600\"\n                  fill=\"none\"\n                  viewBox=\"0 0 24 24\"\n                  stroke=\"currentColor\"\n                >\n                  <path\n                    strokeLinecap=\"round\"\n                    strokeLinejoin=\"round\"\n                    strokeWidth={2}\n                    d=\"M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4c-.77-.833-1.964-.833-2.732 0L3.732 16.5c-.77.833.192 2.5 1.732 2.5z\"\n                  />\n                </svg>\n              </div>\n              <h1 className=\"text-2xl font-bold text-gray-900 mb-2\">\n                Something went wrong\n              </h1>\n              <p className=\"text-gray-600 mb-6\">\n                {this.props.customErrorMessage || \n                  'We encountered an error while loading this page. Please try again.'}\n              </p>\n            </div>\n\n            {/* Error details in development */}\n            {this.props.showErrorDetails && this.state.error && (\n              <div className=\"mb-6 p-4 bg-red-50 border border-red-200 rounded-md text-left\">\n                <h3 className=\"text-sm font-medium text-red-800 mb-2\">\n                  Error Details (Development Only)\n                </h3>\n                <pre className=\"text-xs text-red-700 whitespace-pre-wrap\">\n                  {this.state.error.toString()}\n                  {this.state.errorInfo?.componentStack}\n                </pre>\n              </div>\n            )}\n\n            {/* Recovery actions */}\n            <div className=\"space-y-3\">\n              <button\n                onClick={this.resetError}\n                className=\"w-full px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700 transition-colors focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2\"\n              >\n                Try Again\n              </button>\n              \n              <button\n                onClick={() => window.location.reload()}\n                className=\"w-full px-4 py-2 bg-gray-600 text-white rounded-md hover:bg-gray-700 transition-colors focus:outline-none focus:ring-2 focus:ring-gray-500 focus:ring-offset-2\"\n              >\n                Reload Page\n              </button>\n\n              {this.props.onRecover && (\n                <button\n                  onClick={this.props.onRecover}\n                  className=\"w-full px-4 py-2 bg-green-600 text-white rounded-md hover:bg-green-700 transition-colors focus:outline-none focus:ring-2 focus:ring-green-500 focus:ring-offset-2\"\n                >\n                  Alternative Action\n                </button>\n              )}\n            </div>\n\n            {/* Help text */}\n            <div className=\"mt-6 text-sm text-gray-500\">\n              <p>\n                If this problem persists, please contact support or try accessing the page later.\n              </p>\n            </div>\n          </div>\n        </div>\n      );\n    }\n\n    return this.props.children;\n  }\n}\n\n/**\n * Hook for accessing error boundary state\n * Useful for components that need to know if they're inside an error boundary\n */\nexport function useErrorBoundary() {\n  const [error, setError] = React.useState<Error | null>(null);\n\n  const resetError = React.useCallback(() => {\n    setError(null);\n  }, []);\n\n  const captureError = React.useCallback((error: Error) => {\n    setError(error);\n  }, []);\n\n  React.useEffect(() => {\n    if (error) {\n      throw error;\n    }\n  }, [error]);\n\n  return { captureError, resetError };\n}\n\n/**\n * Default error fallback component\n */\nexport function DefaultPublicErrorFallback({ \n  error, \n  resetError \n}: PublicErrorBoundaryState) {\n  return (\n    <div className=\"min-h-screen bg-white flex items-center justify-center\">\n      <div className=\"max-w-md mx-auto text-center px-4\">\n        <div className=\"mb-6\">\n          <div className=\"mx-auto flex items-center justify-center h-12 w-12 rounded-full bg-red-100 mb-4\">\n            <svg\n              className=\"h-6 w-6 text-red-600\"\n              fill=\"none\"\n              viewBox=\"0 0 24 24\"\n              stroke=\"currentColor\"\n            >\n              <path\n                strokeLinecap=\"round\"\n                strokeLinejoin=\"round\"\n                strokeWidth={2}\n                d=\"M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4c-.77-.833-1.964-.833-2.732 0L3.732 16.5c-.77.833.192 2.5 1.732 2.5z\"\n              />\n            </svg>\n          </div>\n          <h1 className=\"text-2xl font-bold text-gray-900 mb-2\">\n            Page Error\n          </h1>\n          <p className=\"text-gray-600 mb-6\">\n            We encountered an error while loading this page.\n          </p>\n        </div>\n\n        <button\n          onClick={resetError}\n          className=\"w-full px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700 transition-colors focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2\"\n        >\n          Try Again\n        </button>\n      </div>\n    </div>\n  );\n}\n","/**\n * @file Public Page Provider\n * @package @jmruthers/pace-core\n * @module Components/PublicLayout\n * @since 1.0.0\n *\n * A completely isolated provider for public pages that doesn't trigger\n * any authentication context. This ensures public pages work independently\n * of the main application's authentication system.\n *\n * Features:\n * - No authentication required\n * - No organisation context\n * - No event context\n * - Completely isolated from main app context\n * - Environment variable access for public data\n * - Error boundary integration\n *\n * @example\n * ```tsx\n * import { PublicPageProvider } from '@jmruthers/pace-core';\n * \n * function PublicApp() {\n *   return (\n *     <PublicPageProvider>\n *       <Routes>\n *         <Route path=\"/events/:eventCode/recipe-grid-report\" element={<PublicRecipePage />} />\n *       </Routes>\n *     </PublicPageProvider>\n *   );\n * }\n * ```\n */\n\nimport React, { createContext, useContext, ReactNode, useMemo } from 'react';\nimport { createClient } from '@supabase/supabase-js';\nimport type { Database } from '../../types/database';\nimport { PublicErrorBoundary } from './PublicErrorBoundary';\n\ninterface PublicPageContextType {\n  isPublicPage: true;\n  supabase: ReturnType<typeof createClient<Database>> | null;\n  environment: {\n    supabaseUrl: string | null;\n    supabaseKey: string | null;\n  };\n}\n\nconst PublicPageContext = createContext<PublicPageContextType | undefined>(undefined);\n\nexport interface PublicPageProviderProps {\n  children: ReactNode;\n}\n\n/**\n * Provider for public pages that completely isolates them from authentication context\n * \n * This provider:\n * - Does not initialize any authentication providers\n * - Provides environment variables for public data access\n * - Includes error boundary for graceful error handling\n * - Is completely separate from the main app context\n */\nexport function PublicPageProvider({ children }: PublicPageProviderProps) {\n  // Get environment variables for public data access\n  // Handle both Vite (import.meta.env) and Node.js (process.env) environments\n  const getEnvVar = (key: string): string | undefined => {\n    // Check Vite environment first (browser)\n    if (typeof import.meta !== 'undefined' && (import.meta as any).env) {\n      return (import.meta as any).env[key];\n    }\n    // Check Node.js environment (server-side)\n    if (typeof import.meta !== 'undefined' && import.meta.env) {\n      return import.meta.env[key];\n    }\n    return undefined;\n  };\n\n  const supabaseUrl = getEnvVar('VITE_SUPABASE_URL') || \n                     getEnvVar('NEXT_PUBLIC_SUPABASE_URL') || \n                     null;\n                     \n  const supabaseKey = getEnvVar('VITE_SUPABASE_ANON_KEY') || \n                     getEnvVar('NEXT_PUBLIC_SUPABASE_ANON_KEY') || \n                     null;\n\n  // Create Supabase client if environment variables are available\n  const supabase = useMemo(() => {\n    if (!supabaseUrl || !supabaseKey) {\n      console.warn('[PublicPageProvider] Missing Supabase environment variables. Please ensure VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY are set in your environment.');\n      return null;\n    }\n    return createClient<Database>(supabaseUrl, supabaseKey);\n  }, [supabaseUrl, supabaseKey]);\n\n  const contextValue: PublicPageContextType = {\n    isPublicPage: true,\n    supabase,\n    environment: {\n      supabaseUrl,\n      supabaseKey\n    }\n  };\n\n  return (\n    <PublicPageContext.Provider value={contextValue}>\n      <PublicErrorBoundary>\n        {children}\n      </PublicErrorBoundary>\n    </PublicPageContext.Provider>\n  );\n}\n\n/**\n * Hook to access public page context\n * \n * @returns Public page context with environment variables\n */\nexport function usePublicPageContext(): PublicPageContextType {\n  const context = useContext(PublicPageContext);\n  \n  if (!context) {\n    throw new Error('usePublicPageContext must be used within a PublicPageProvider');\n  }\n  \n  return context;\n}\n\n/**\n * Hook to check if we're in a public page context\n * \n * @returns True if we're in a public page context\n */\nexport function useIsPublicPage(): boolean {\n  const context = useContext(PublicPageContext);\n  return context !== undefined;\n}\n","/**\n * @file useAppConfig Hook\n * @package @jmruthers/pace-core\n * @module Hooks/useAppConfig\n * @since 0.4.0\n *\n * Hook for accessing app configuration like direct access support and event requirements.\n * This is a convenience hook that extracts app config from the UnifiedAuthProvider.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { supportsDirectAccess, requiresEvent, isLoading } = useAppConfig();\n *   \n *   if (isLoading) return <div>Loading...</div>;\n *   \n *   return (\n *     <div>\n *       {supportsDirectAccess && (\n *         <div>This app supports direct access!</div>\n *       )}\n *       {requiresEvent && (\n *         <EventSelector />\n *       )}\n *     </div>\n *   );\n * }\n * ```\n */\n\nimport { useMemo } from 'react';\nimport { useUnifiedAuth } from '../providers/UnifiedAuthProvider';\nimport { useIsPublicPage } from '../components/PublicLayout/PublicPageProvider';\n\nexport interface UseAppConfigReturn {\n  supportsDirectAccess: boolean;\n  requiresEvent: boolean;\n  isLoading: boolean;\n  appName: string;\n}\n\n/**\n * Hook to access app configuration\n * Works in both authenticated and public contexts\n * @returns App configuration and loading state\n */\nexport function useAppConfig(): UseAppConfigReturn {\n  // Check if we're in a public page context first\n  const isPublicPage = useIsPublicPage();\n  \n  if (isPublicPage) {\n    // For public pages, try to get app name from environment variables\n    const getAppName = (): string => {\n      // Check Vite environment first (browser)\n      if (typeof import.meta !== 'undefined' && (import.meta as any).env) {\n        return (import.meta as any).env.VITE_APP_NAME || \n               (import.meta as any).env.NEXT_PUBLIC_APP_NAME || \n               'PACE';\n      }\n      // Check Node.js environment (server-side)\n      if (typeof import.meta !== 'undefined' && import.meta.env) {\n        return import.meta.env.VITE_APP_NAME || \n               import.meta.env.NEXT_PUBLIC_APP_NAME || \n               'PACE';\n      }\n      return 'PACE';\n    };\n    \n    return useMemo(() => ({\n      supportsDirectAccess: false, // Public pages don't support direct access\n      requiresEvent: true, // Public pages always require an event\n      isLoading: false,\n      appName: getAppName()\n    }), []);\n  }\n  \n  // For authenticated pages, use UnifiedAuthProvider\n  try {\n    const { appConfig, appName } = useUnifiedAuth();\n    return useMemo(() => ({\n      supportsDirectAccess: !(appConfig?.requires_event ?? true),\n      requiresEvent: appConfig?.requires_event ?? true,\n      isLoading: appConfig === null,\n      appName\n    }), [appConfig?.requires_event, appName]);\n  } catch (error) {\n    // Fallback if UnifiedAuthProvider is not available\n    return useMemo(() => ({\n      supportsDirectAccess: false,\n      requiresEvent: true,\n      isLoading: false,\n      appName: 'PACE'\n    }), []);\n  }\n} ","/**\n * @file Public Event Logo Hook\n * @package @jmruthers/pace-core\n * @module Hooks/Public\n * @since 1.0.0\n *\n * A React hook for accessing public event logo URLs without authentication.\n * Provides logo URLs with fallback handling for public pages.\n *\n * Features:\n * - No authentication required\n * - Automatic fallback to event initials\n * - Caching for performance\n * - Error handling and loading states\n * - TypeScript support\n * - Image validation\n *\n * @example\n * ```tsx\n * import { usePublicEventLogo } from '@jmruthers/pace-core';\n *\n * function EventHeader() {\n *   const { logoUrl, fallbackText, isLoading, error } = usePublicEventLogo(\n *     eventId, \n *     eventName, \n *     organisationId\n *   );\n *\n *   if (isLoading) return <div>Loading logo...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       {logoUrl ? (\n *         <img src={logoUrl} alt={`${eventName} logo`} />\n *       ) : (\n *         <div className=\"logo-fallback\">{fallbackText}</div>\n *       )}\n *     </div>\n *   );\n * }\n * ```\n *\n * @accessibility\n * - No direct accessibility concerns (hook)\n * - Enables accessible logo display with proper alt text\n * - Supports screen reader friendly fallbacks\n *\n * @security\n * - Only returns public-safe logo URLs\n * - Validates image existence before returning URL\n * - No sensitive information exposed\n * - Rate limiting applied at storage level\n *\n * @performance\n * - Built-in caching with TTL\n * - Image validation and optimization\n * - Minimal re-renders with stable references\n * - Lazy loading support\n *\n * @dependencies\n * - React 18+ - Hooks and effects\n * - @supabase/supabase-js - Storage integration\n * - Event types - Type definitions\n */\n\nimport { useState, useEffect, useCallback, useMemo } from 'react';\nimport type { SupabaseClient } from '@supabase/supabase-js';\nimport type { Database } from '../../types/database';\n\n// Simple in-memory cache for public data\nconst publicDataCache = new Map<string, { data: any; timestamp: number; ttl: number }>();\n\nexport interface UsePublicEventLogoReturn {\n  /** The logo URL if available, null if not found or error */\n  logoUrl: string | null;\n  /** Fallback text (event initials) if no logo is available */\n  fallbackText: string;\n  /** Whether the logo is currently loading */\n  isLoading: boolean;\n  /** Any error that occurred during loading */\n  error: Error | null;\n  /** Function to manually refetch the logo */\n  refetch: () => Promise<void>;\n}\n\nexport interface UsePublicEventLogoOptions {\n  /** Cache TTL in milliseconds (default: 30 minutes) */\n  cacheTtl?: number;\n  /** Whether to enable caching (default: true) */\n  enableCache?: boolean;\n  /** Whether to validate image existence (default: true) */\n  validateImage?: boolean;\n  /** Custom fallback text generator */\n  generateFallbackText?: (eventName: string) => string;\n  /** Supabase client instance (required) */\n  supabase: SupabaseClient<Database>;\n}\n\n/**\n * Generate fallback text from event name (first letter of each word)\n */\nfunction defaultGenerateFallbackText(eventName: string): string {\n  if (!eventName) return 'EV';\n  \n  return eventName\n    .split(' ')\n    .map(word => word.charAt(0).toUpperCase())\n    .join('')\n    .substring(0, 3); // Max 3 characters\n}\n\n/**\n * Hook for accessing public event logo URLs\n * \n * This hook provides access to event logo URLs without requiring\n * authentication. It includes fallback handling and image validation.\n * \n * @param eventId - The event ID to fetch logo for\n * @param eventName - The event name for fallback text generation\n * @param organisationId - The organisation ID for storage path\n * @param options - Configuration options for caching and behavior\n * @returns Object containing logo URL, fallback text, loading state, error, and refetch function\n */\nexport function usePublicEventLogo(\n  eventId: string | undefined,\n  eventName: string | undefined,\n  organisationId: string | undefined,\n  options: UsePublicEventLogoOptions\n): UsePublicEventLogoReturn {\n  const {\n    cacheTtl = 30 * 60 * 1000, // 30 minutes\n    enableCache = true,\n    validateImage = true,\n    generateFallbackText = defaultGenerateFallbackText,\n    supabase\n  } = options;\n\n  const [logoUrl, setLogoUrl] = useState<string | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Generate fallback text\n  const fallbackText = useMemo(() => {\n    return eventName ? generateFallbackText(eventName) : 'EV';\n  }, [eventName, generateFallbackText]);\n\n  const fetchLogo = useCallback(async (): Promise<void> => {\n    if (!eventId || !organisationId || !supabase) {\n      setLogoUrl(null);\n      setIsLoading(false);\n      return;\n    }\n\n    // Validate UUID format for organisationId to prevent database errors\n    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n    if (!uuidRegex.test(organisationId)) {\n      console.warn('[usePublicEventLogo] Invalid organisationId format (not a valid UUID):', organisationId);\n      // Don't return early - let the database handle the validation\n      // This allows for more graceful error handling\n    }\n\n    // Check cache first\n    const cacheKey = `public_logo_${eventId}_${organisationId}`;\n    if (enableCache) {\n      const cached = publicDataCache.get(cacheKey);\n      if (cached && Date.now() - cached.timestamp < cached.ttl) {\n        setLogoUrl(cached.data);\n        setIsLoading(false);\n        setError(null);\n        return;\n      }\n    }\n\n    try {\n      setIsLoading(true);\n      setError(null);\n\n      // Call the public logo RPC function\n      const { data, error: rpcError } = await (supabase as any).rpc('get_public_event_logo', {\n        event_id_param: eventId,\n        organisation_id_param: organisationId\n      });\n\n      if (rpcError) {\n        throw new Error(rpcError.message || 'Failed to fetch logo');\n      }\n\n      if (!data || data.length === 0 || !data[0] || !data[0].logo_url) {\n        setLogoUrl(null);\n        return;\n      }\n\n      const logoUrl = data[0].logo_url;\n\n      // Validate image existence if requested\n      if (validateImage) {\n        try {\n          const response = await fetch(logoUrl, { method: 'HEAD' });\n          if (!response.ok) {\n            console.warn('[usePublicEventLogo] Logo URL not accessible:', logoUrl);\n            setLogoUrl(null);\n            return;\n          }\n        } catch (fetchError) {\n          console.warn('[usePublicEventLogo] Error validating logo URL:', fetchError);\n          setLogoUrl(null);\n          return;\n        }\n      }\n\n      setLogoUrl(logoUrl);\n\n      // Cache the result\n      if (enableCache) {\n        publicDataCache.set(cacheKey, {\n          data: logoUrl,\n          timestamp: Date.now(),\n          ttl: cacheTtl\n        });\n      }\n\n    } catch (err) {\n      console.error('[usePublicEventLogo] Error fetching logo:', err);\n      const error = err instanceof Error ? err : new Error('Unknown error occurred');\n      setError(error);\n      setLogoUrl(null);\n    } finally {\n      setIsLoading(false);\n    }\n  }, [eventId, organisationId, supabase, cacheTtl, enableCache, validateImage]);\n\n  // Fetch logo when parameters change\n  useEffect(() => {\n    if (eventId && organisationId) {\n      fetchLogo();\n    } else {\n      setLogoUrl(null);\n      setIsLoading(false);\n      setError(null);\n    }\n  }, [fetchLogo, eventId, organisationId]);\n\n  const refetch = useCallback(async (): Promise<void> => {\n    if (!eventId || !organisationId) return;\n    \n    // Clear cache for this logo\n    if (enableCache) {\n      const cacheKey = `public_logo_${eventId}_${organisationId}`;\n      publicDataCache.delete(cacheKey);\n    }\n    await fetchLogo();\n  }, [fetchLogo, eventId, organisationId, enableCache]);\n\n  return {\n    logoUrl,\n    fallbackText,\n    isLoading,\n    error,\n    refetch\n  };\n}\n\n/**\n * Clear all cached public logo data\n * Useful for testing or when you need to force refresh all data\n */\nexport function clearPublicLogoCache(): void {\n  for (const [key] of publicDataCache) {\n    if (key.startsWith('public_logo_')) {\n      publicDataCache.delete(key);\n    }\n  }\n}\n\n/**\n * Get cache statistics for debugging\n */\nexport function getPublicLogoCacheStats(): { size: number; keys: string[] } {\n  const keys = Array.from(publicDataCache.keys()).filter(key => key.startsWith('public_logo_'));\n  return {\n    size: keys.length,\n    keys\n  };\n}\n"],"mappings":"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","names":["props","React","error","jsx","useMemo","useMemo","useState","useEffect","useMemo","logoUrl","error"]}

package/dist/chunk-ZPK5656W.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/performanceBudgets.ts"],"sourcesContent":["\ninterface PerformanceBudget {\n  metric: string;\n  budget: number;\n  actual: number;\n  threshold: 'error' | 'warning' | 'info';\n}\n\ninterface PerformanceMetrics {\n  bundleSize: number;\n  chunkCount: number;\n  treeshakingEffectiveness: number;\n  dynamicImportUsage: number;\n}\n\ninterface MeasurementResult {\n  passed: boolean;\n  value: number;\n  threshold: number;\n}\n\n// Performance budget thresholds with index signature\nexport const PERFORMANCE_BUDGETS: { [key: string]: { threshold: number } } = {\n  COMPONENT_RENDER: { threshold: 50 },\n  BUNDLE_SIZE: { threshold: 150000 },\n  CHUNK_COUNT: { threshold: 10 },\n  TREESHAKING_SCORE: { threshold: 70 },\n  ERROR_BOUNDARY_TRIGGER: { threshold: 5 },\n  MEMORY_INCREASE: { threshold: 1000 },\n  LARGE_LIST_RENDER: { threshold: 500 },\n} as const;\n\nclass PerformanceBudgetMonitor {\n  private metrics: Map<string, number> = new Map();\n  private budgets: PerformanceBudget[] = [];\n\n  measure(metric: string, value: number, metadata?: Record<string, unknown>): MeasurementResult {\n    this.metrics.set(metric, value);\n    \n    // In production, this would send to a proper logging service\n    // For now, we'll log to console for testing purposes\n    if (import.meta.env.MODE === 'development' || import.meta.env.MODE === 'test') {\n      console.log('📊 Performance Metric: ' + metric + ' = ' + value, metadata);\n    }\n\n    // Get threshold for this metric\n    const budgetConfig = PERFORMANCE_BUDGETS[metric];\n    const threshold = budgetConfig?.threshold || 100;\n    const passed = value <= threshold;\n\n    return {\n      passed,\n      value,\n      threshold\n    };\n  }\n\n  setBudget(metric: string, budget: number, threshold: 'error' | 'warning' | 'info' = 'warning'): void {\n    const actual = this.metrics.get(metric) || 0;\n    this.budgets.push({ metric, budget, actual, threshold });\n  }\n\n  checkBudgets(): PerformanceBudget[] {\n    const violations: PerformanceBudget[] = [];\n    \n    for (const budget of this.budgets) {\n      const actual = this.metrics.get(budget.metric) || 0;\n      budget.actual = actual;\n      \n      if (actual > budget.budget) {\n        violations.push(budget);\n        \n        // In production, this would send to a proper logging service\n        // For now, we'll log to console for testing purposes\n        if (import.meta.env.MODE === 'development' || import.meta.env.MODE === 'test') {\n          if (budget.threshold === 'error') {\n            console.error('❌ Performance budget exceeded: ' + budget.metric + ' (' + actual + ' > ' + budget.budget + ')');\n          } else if (budget.threshold === 'warning') {\n            console.warn('⚠️ Performance budget exceeded: ' + budget.metric + ' (' + actual + ' > ' + budget.budget + ')');\n          } else {\n            console.info('ℹ️ Performance budget exceeded: ' + budget.metric + ' (' + actual + ' > ' + budget.budget + ')');\n          }\n        }\n      }\n    }\n    \n    return violations;\n  }\n\n  getMetrics(): PerformanceMetrics {\n    return {\n      bundleSize: this.metrics.get('BUNDLE_SIZE') || 0,\n      chunkCount: this.metrics.get('CHUNK_COUNT') || 0,\n      treeshakingEffectiveness: this.metrics.get('TREESHAKING_SCORE') || 0,\n      dynamicImportUsage: this.metrics.get('DYNAMIC_IMPORTS') || 0,\n    };\n  }\n\n  reset(): void {\n    this.metrics.clear();\n    this.budgets.length = 0;\n  }\n}\n\nexport const performanceBudgetMonitor = new PerformanceBudgetMonitor();\n\n// Set default performance budgets\nperformanceBudgetMonitor.setBudget('BUNDLE_SIZE', 150000, 'error'); // 150KB\nperformanceBudgetMonitor.setBudget('CHUNK_COUNT', 10, 'warning');\nperformanceBudgetMonitor.setBudget('TREESHAKING_SCORE', 70, 'warning');\nperformanceBudgetMonitor.setBudget('ERROR_BOUNDARY_TRIGGER', 5, 'error');\n"],"mappings":";AAsBO,IAAM,sBAAgE;AAAA,EAC3E,kBAAkB,EAAE,WAAW,GAAG;AAAA,EAClC,aAAa,EAAE,WAAW,KAAO;AAAA,EACjC,aAAa,EAAE,WAAW,GAAG;AAAA,EAC7B,mBAAmB,EAAE,WAAW,GAAG;AAAA,EACnC,wBAAwB,EAAE,WAAW,EAAE;AAAA,EACvC,iBAAiB,EAAE,WAAW,IAAK;AAAA,EACnC,mBAAmB,EAAE,WAAW,IAAI;AACtC;AAEA,IAAM,2BAAN,MAA+B;AAAA,EAA/B;AACE,SAAQ,UAA+B,oBAAI,IAAI;AAC/C,SAAQ,UAA+B,CAAC;AAAA;AAAA,EAExC,QAAQ,QAAgB,OAAe,UAAuD;AAC5F,SAAK,QAAQ,IAAI,QAAQ,KAAK;AAI9B,QAAI,YAAY,IAAI,SAAS,iBAAiB,YAAY,IAAI,SAAS,QAAQ;AAC7E,cAAQ,IAAI,mCAA4B,SAAS,QAAQ,OAAO,QAAQ;AAAA,IAC1E;AAGA,UAAM,eAAe,oBAAoB,MAAM;AAC/C,UAAM,YAAY,cAAc,aAAa;AAC7C,UAAM,SAAS,SAAS;AAExB,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,UAAU,QAAgB,QAAgB,YAA0C,WAAiB;AACnG,UAAM,SAAS,KAAK,QAAQ,IAAI,MAAM,KAAK;AAC3C,SAAK,QAAQ,KAAK,EAAE,QAAQ,QAAQ,QAAQ,UAAU,CAAC;AAAA,EACzD;AAAA,EAEA,eAAoC;AAClC,UAAM,aAAkC,CAAC;AAEzC,eAAW,UAAU,KAAK,SAAS;AACjC,YAAM,SAAS,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK;AAClD,aAAO,SAAS;AAEhB,UAAI,SAAS,OAAO,QAAQ;AAC1B,mBAAW,KAAK,MAAM;AAItB,YAAI,YAAY,IAAI,SAAS,iBAAiB,YAAY,IAAI,SAAS,QAAQ;AAC7E,cAAI,OAAO,cAAc,SAAS;AAChC,oBAAQ,MAAM,yCAAoC,OAAO,SAAS,OAAO,SAAS,QAAQ,OAAO,SAAS,GAAG;AAAA,UAC/G,WAAW,OAAO,cAAc,WAAW;AACzC,oBAAQ,KAAK,+CAAqC,OAAO,SAAS,OAAO,SAAS,QAAQ,OAAO,SAAS,GAAG;AAAA,UAC/G,OAAO;AACL,oBAAQ,KAAK,+CAAqC,OAAO,SAAS,OAAO,SAAS,QAAQ,OAAO,SAAS,GAAG;AAAA,UAC/G;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,aAAiC;AAC/B,WAAO;AAAA,MACL,YAAY,KAAK,QAAQ,IAAI,aAAa,KAAK;AAAA,MAC/C,YAAY,KAAK,QAAQ,IAAI,aAAa,KAAK;AAAA,MAC/C,0BAA0B,KAAK,QAAQ,IAAI,mBAAmB,KAAK;AAAA,MACnE,oBAAoB,KAAK,QAAQ,IAAI,iBAAiB,KAAK;AAAA,IAC7D;AAAA,EACF;AAAA,EAEA,QAAc;AACZ,SAAK,QAAQ,MAAM;AACnB,SAAK,QAAQ,SAAS;AAAA,EACxB;AACF;AAEO,IAAM,2BAA2B,IAAI,yBAAyB;AAGrE,yBAAyB,UAAU,eAAe,MAAQ,OAAO;AACjE,yBAAyB,UAAU,eAAe,IAAI,SAAS;AAC/D,yBAAyB,UAAU,qBAAqB,IAAI,SAAS;AACrE,yBAAyB,UAAU,0BAA0B,GAAG,OAAO;","names":[]}

package/docs/getting-started/installation.md

@@ -1,269 +0,0 @@
-# Complete Installation Guide
-
-This is the definitive guide for installing and configuring pace-core in your application. Follow these steps exactly to ensure proper styling and functionality.
-
-## 🚨 Critical Requirements
-
-**IMPORTANT**: Pace-core requires specific configuration to work properly. Without following these steps exactly, components will be unstyled and the UI will be severely compromised.
-
-## Step 1: Install Dependencies
-
-### Required Packages
-
-```bash
-# Install pace-core and all required peer dependencies
-npm install @jmruthers/pace-core @tanstack/react-table @radix-ui/react-checkbox @radix-ui/react-dialog @radix-ui/react-dropdown-menu @radix-ui/react-label @radix-ui/react-slot lucide-react class-variance-authority clsx tailwind-merge
-
-# Install Tailwind CSS v4 and Vite plugin (REQUIRED)
-npm install -D @tailwindcss/vite tailwindcss@^4.0.0
-```
-
-### Optional Packages (for full functionality)
-
-```bash
-# For authentication and database
-npm install @supabase/supabase-js
-
-# For routing
-npm install react-router-dom
-
-# For TypeScript support
-npm install -D @types/react @types/react-dom
-```
-
-## Step 2: Configure Vite with Tailwind v4
-
-**⚠️ CRITICAL**: This configuration is essential for pace-core components to be styled correctly.
-
-Create or update your `vite.config.ts`:
-
-```typescript
-// vite.config.ts
-import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-import tailwindcss from '@tailwindcss/vite'
-import path from 'path'
-
-export default defineConfig({
-  plugins: [
-    react(),
-    tailwindcss({
-      // CRITICAL: Include pace-core components for scanning
-      content: [
-        './src/**/*.{js,ts,jsx,tsx}',
-        './node_modules/@jmruthers/pace-core/**/*.{js,ts,jsx,tsx}'
-      ]
-    })
-  ],
-  resolve: {
-    alias: {
-      "@": path.resolve(__dirname, "./src"),
-    },
-  },
-  server: {
-    port: 3000,
-    open: true,
-  },
-  build: {
-    outDir: 'dist',
-    sourcemap: true,
-  },
-})
-```
-
-### Why This Configuration is Critical
-
-Pace-core components contain Tailwind classes that must be scanned during the build process. Without this configuration:
-
-- ❌ Component styles will be missing or broken
-- ❌ Colors, spacing, and typography won't work
-- ❌ The UI will be severely compromised
-- ❌ The entire point of using this UI library is undermined
-
-### Alternative Configuration (if needed)
-
-If you're still having issues with component scanning:
-
-```typescript
-// vite.config.ts
-import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-import tailwindcss from '@tailwindcss/vite'
-
-export default defineConfig({
-  plugins: [
-    react(),
-    tailwindcss({
-      content: {
-        files: [
-          './src/**/*.{js,ts,jsx,tsx}',
-          './node_modules/@jmruthers/pace-core/**/*.{js,ts,jsx,tsx}',
-          './node_modules/@jmruthers/pace-core/dist/**/*.{js,ts,jsx,tsx}'
-        ]
-      }
-    })
-  ],
-})
-```
-
-## Step 3: Import Core Styles
-
-**CRITICAL**: Import the CSS file in your main entry point:
-
-```tsx
-// src/main.tsx (or your app's entry point)
-import '@jmruthers/pace-core/src/styles/core.css';
-import React from 'react';
-import ReactDOM from 'react-dom/client';
-import App from './App';
-
-const root = ReactDOM.createRoot(document.getElementById('root') as HTMLElement);
-root.render(
-  <React.StrictMode>
-    <App />
-  </React.StrictMode>
-);
-```
-
-### What the CSS File Includes
-
-The `core.css` file provides:
-- Complete color palettes (main, secondary, accent)
-- Font definitions with system font fallbacks
-- Base element styles and resets
-- Tailwind v4 utility classes
-- Component styling foundation
-
-**Note on Fonts**: The CSS includes font definitions that fall back to system fonts. For custom fonts, you'll need to provide them separately in your consuming app.
-
-## Step 4: Verify Installation
-
-Create a test component to ensure everything works:
-
-```tsx
-// src/App.tsx
-import { Button, Card, Input } from '@jmruthers/pace-core';
-
-function App() {
-  return (
-    <div className="p-8 space-y-4">
-      <h1 className="text-2xl font-bold text-main-900">PACE Core Test</h1>
-      
-      <Card className="p-4">
-        <h2 className="text-lg font-semibold text-sec-800 mb-2">Components Test</h2>
-        <div className="space-y-2">
-          <Button variant="primary">Primary Button</Button>
-          <Button variant="secondary">Secondary Button</Button>
-          <Input placeholder="Test input field" />
-        </div>
-      </Card>
-    </div>
-  );
-}
-
-export default App;
-```
-
-### Expected Result
-
-You should see:
-- ✅ Properly styled components with PACE Core's design system
-- ✅ Colors working (text-main-900, bg-sec-500, etc.)
-- ✅ Typography and spacing applied correctly
-- ✅ Hover effects and transitions working
-
-## Step 5: Set Up Authentication (Optional)
-
-If you're using pace-core's authentication features:
-
-### Install Supabase
-
-```bash
-npm install @supabase/supabase-js
-```
-
-### Create Supabase Client
-
-```typescript
-// src/lib/supabase.ts
-import { createClient } from '@supabase/supabase-js'
-
-const supabaseUrl = process.env.REACT_APP_SUPABASE_URL!
-const supabaseAnonKey = process.env.REACT_APP_SUPABASE_ANON_KEY!
-
-export const supabase = createClient(supabaseUrl, supabaseAnonKey)
-```
-
-### Set Up Environment Variables
-
-Create `.env.local`:
-
-```bash
-REACT_APP_SUPABASE_URL=https://your-project.supabase.co
-REACT_APP_SUPABASE_ANON_KEY=your-anon-key-here
-```
-
-### Configure Providers
-
-```tsx
-// src/main.tsx
-import { UnifiedAuthProvider, OrganisationProvider, EventProvider } from '@jmruthers/pace-core';
-import { supabase } from './lib/supabase';
-
-ReactDOM.createRoot(document.getElementById('root')!).render(
-  <React.StrictMode>
-    <UnifiedAuthProvider supabaseClient={supabase} appName="your-app">
-      <OrganisationProvider>
-        <EventProvider>
-          <App />
-        </EventProvider>
-      </OrganisationProvider>
-    </UnifiedAuthProvider>
-  </React.StrictMode>
-);
-```
-
-## Troubleshooting
-
-### Common Issues
-
-1. **Components appear unstyled**
-   - Check that pace-core is included in your Vite content configuration
-   - Ensure the CSS file is imported
-   - Restart your dev server
-
-2. **Colors don't work**
-   - Verify the CSS file is imported
-   - Check that content scanning includes pace-core
-   - Ensure you're using Tailwind v4
-
-3. **Build errors about missing classes**
-   - Verify your content paths are correct
-   - Check that both source files and pace-core are included
-
-### Verification Checklist
-
-Before asking for help, verify:
-
-- [ ] CSS file is imported: `import '@jmruthers/pace-core/src/styles/core.css'`
-- [ ] Vite config includes pace-core in content scanning
-- [ ] Using Tailwind v4 (not v3)
-- [ ] Dev server restarted after config changes
-- [ ] All required peer dependencies installed
-- [ ] Test component renders with proper styling
-
-## Next Steps
-
-- [Quick Start Guide](./quick-start.md) - Build your first app
-- [Vite Configuration](../consuming-app-vite-config.md) - Detailed Vite setup
-- [Troubleshooting](../troubleshooting/styling-issues.md) - Fix common problems
-- [Component API](../api/README.md) - Explore all components
-
-## Need Help?
-
-If you're still having issues:
-
-1. Check the [Troubleshooting Guide](../troubleshooting/styling-issues.md)
-2. Verify your setup matches this guide exactly
-3. Test with a minimal example to isolate the issue
-4. Check your package versions for compatibility

package/src/__tests__/REBUILD_PLAN.md

@@ -1,223 +0,0 @@
-# 🚀 Test Suite Rebuild Plan
-
-## 📊 Current Status
-- ✅ **193 broken test files deleted**
-- ✅ **World-class test architecture created**
-- ✅ **Comprehensive utilities and helpers ready**
-- ✅ **Excellent examples and templates provided**
-- ✅ **Testing guidelines and guardrails established**
-
-## 🎯 Rebuild Strategy
-
-### Phase 1: Foundation (Week 1)
-**Priority: Critical Components**
-
-#### 1.1 Core UI Components
-- [ ] **Button** - Already completed ✅
-- [ ] **Input** - Form input component
-- [ ] **Card** - Content container
-- [ ] **Modal** - Overlay component
-- [ ] **LoadingSpinner** - Loading indicator
-
-#### 1.2 Essential Hooks
-- [ ] **useDebounce** - Input debouncing
-- [ ] **useLocalStorage** - Local storage management
-- [ ] **useToggle** - Boolean state management
-- [ ] **useAsync** - Async operation handling
-
-#### 1.3 Utility Functions
-- [ ] **formatDate** - Date formatting
-- [ ] **validateEmail** - Email validation
-- [ ] **generateId** - ID generation
-- [ ] **deepClone** - Object cloning
-
-### Phase 2: Business Logic (Week 2)
-**Priority: High-Value Components**
-
-#### 2.1 Authentication Components
-- [ ] **LoginForm** - User authentication
-- [ ] **UserMenu** - User profile menu
-- [ ] **AuthGuard** - Route protection
-- [ ] **PasswordReset** - Password recovery
-
-#### 2.2 Data Management
-- [ ] **DataTable** - Data display
-- [ ] **Pagination** - Data pagination
-- [ ] **Search** - Data filtering
-- [ ] **Export** - Data export
-
-#### 2.3 Business Hooks
-- [ ] **useAuth** - Authentication state
-- [ ] **useApi** - API calls
-- [ ] **usePermissions** - Access control
-- [ ] **useCache** - Data caching
-
-### Phase 3: Advanced Features (Week 3)
-**Priority: Complex Components**
-
-#### 3.1 Advanced UI Components
-- [ ] **DataTable** - Complex data display
-- [ ] **FormBuilder** - Dynamic forms
-- [ ] **FileUpload** - File handling
-- [ ] **RichTextEditor** - Text editing
-
-#### 3.2 Integration Components
-- [ ] **Dashboard** - Main dashboard
-- [ ] **Settings** - Configuration
-- [ ] **Reports** - Data visualization
-- [ ] **Notifications** - User alerts
-
-#### 3.3 Advanced Hooks
-- [ ] **useForm** - Form management
-- [ ] **usePagination** - Pagination logic
-- [ ] **useInfiniteScroll** - Infinite loading
-- [ ] **useWebSocket** - Real-time updates
-
-### Phase 4: Integration & E2E (Week 4)
-**Priority: End-to-End Testing**
-
-#### 4.1 Integration Tests
-- [ ] **User Authentication Flow**
-- [ ] **Data CRUD Operations**
-- [ ] **File Upload Process**
-- [ ] **Report Generation**
-
-#### 4.2 E2E Test Scenarios
-- [ ] **Complete User Journey**
-- [ ] **Admin Workflow**
-- [ ] **Error Handling**
-- [ ] **Performance Testing**
-
-## 📋 Implementation Guidelines
-
-### Test Creation Process
-1. **Identify Component Priority** - Use the phase-based approach
-2. **Copy Template** - Use provided templates
-3. **Write Tests** - Follow testing guidelines
-4. **Verify Coverage** - Ensure 80%+ coverage
-5. **Review & Refactor** - Code review and optimization
-
-### Quality Gates
-- ✅ **All tests pass** - No failing tests
-- ✅ **80%+ coverage** - Meet coverage thresholds
-- ✅ **Fast execution** - Tests run in <5 seconds
-- ✅ **Clear naming** - Descriptive test names
-- ✅ **No flaky tests** - Reliable test results
-
-### File Structure
-```
-src/__tests__/
-├── components/
-│   ├── Button.test.tsx ✅
-│   ├── Input.test.tsx
-│   ├── Card.test.tsx
-│   └── ...
-├── hooks/
-│   ├── useDebounce.test.ts
-│   ├── useLocalStorage.test.ts
-│   └── ...
-├── utils/
-│   ├── formatDate.test.ts
-│   ├── validateEmail.test.ts
-│   └── ...
-├── integration/
-│   ├── auth-flow.test.tsx
-│   ├── data-crud.test.tsx
-│   └── ...
-└── templates/
-    ├── component.test.template.tsx
-    ├── hook.test.template.ts
-    └── ...
-```
-
-## 🛠️ Development Workflow
-
-### Daily Process
-1. **Start with Template** - Copy appropriate template
-2. **Write Tests First** - TDD approach
-3. **Run Tests Frequently** - `npm test -- --watch`
-4. **Check Coverage** - `npm test -- --coverage`
-5. **Commit Often** - Small, focused commits
-
-### Weekly Review
-1. **Coverage Report** - Review coverage metrics
-2. **Test Performance** - Check execution time
-3. **Code Quality** - Review test quality
-4. **Plan Next Week** - Prioritize next components
-
-## 📊 Success Metrics
-
-### Week 1 Targets
-- [ ] 5 core components tested
-- [ ] 4 essential hooks tested
-- [ ] 4 utility functions tested
-- [ ] 80%+ coverage on tested components
-
-### Week 2 Targets
-- [ ] 4 authentication components tested
-- [ ] 4 data management components tested
-- [ ] 4 business hooks tested
-- [ ] 2 integration tests completed
-
-### Week 3 Targets
-- [ ] 4 advanced UI components tested
-- [ ] 4 integration components tested
-- [ ] 4 advanced hooks tested
-- [ ] Performance tests added
-
-### Week 4 Targets
-- [ ] 4 integration test suites completed
-- [ ] 4 E2E test scenarios completed
-- [ ] 90%+ overall coverage
-- [ ] All tests passing consistently
-
-## 🚨 Risk Mitigation
-
-### Common Pitfalls
-1. **Over-testing** - Focus on user behavior
-2. **Under-testing** - Ensure critical paths covered
-3. **Flaky tests** - Use proper async handling
-4. **Slow tests** - Optimize test performance
-
-### Solutions
-1. **Follow templates** - Use provided patterns
-2. **Review guidelines** - Check testing best practices
-3. **Use utilities** - Leverage test helpers
-4. **Monitor performance** - Track test execution time
-
-## 📚 Resources
-
-### Quick Reference
-- [Testing Guidelines](./TESTING_GUIDELINES.md)
-- [Component Template](./templates/component.test.template.tsx)
-- [Hook Template](./templates/hook.test.template.ts)
-- [Test Utilities](./helpers/test-utils.tsx)
-
-### Commands
-```bash
-# Run all tests
-npm test
-
-# Run specific component
-npm test -- Button.test.tsx
-
-# Run with coverage
-npm test -- --coverage
-
-# Run in watch mode
-npm test -- --watch
-```
-
-## 🎉 Expected Outcomes
-
-After 4 weeks, you'll have:
-- ✅ **Comprehensive test suite** - 50+ test files
-- ✅ **High code coverage** - 90%+ overall
-- ✅ **Fast test execution** - <10 seconds total
-- ✅ **Reliable tests** - No flaky tests
-- ✅ **Maintainable code** - Clear patterns and guidelines
-- ✅ **Developer confidence** - Safe refactoring and changes
-
----
-
-**Ready to start? Begin with Phase 1, Week 1, and work through the components systematically!** 🚀