@riktajs/react 0.10.3

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context/RouterContext.ts","../src/context/SsrContext.ts","../src/components/RiktaProvider.tsx","../src/hooks/useNavigation.ts","../src/components/Link.tsx","../src/hooks/useParams.ts","../src/hooks/useSearchParams.ts","../src/hooks/useLocation.ts","../src/hooks/useSsrData.ts","../src/hooks/useHydration.ts","../src/hooks/useFetch.ts","../src/hooks/useAction.ts"],"names":["createContext","useState","useCallback","useEffect","useMemo","jsx","useContext","useRef","actionResult"],"mappings":"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","file":"index.cjs","sourcesContent":["import { createContext } from 'react';\nimport type { RouterContextValue } from '../types.js';\n\n/**\n * Default router context value for when no provider is present\n */\nconst defaultRouterContext: RouterContextValue = {\n  pathname: '/',\n  search: '',\n  href: '/',\n  navigate: () => {\n    console.warn('[RiktaReact] Router context not initialized. Wrap your app with <RiktaProvider>');\n  },\n  params: {},\n  setParams: () => {},\n};\n\n/**\n * React context for router state\n * Provides navigation utilities and current location info\n */\nexport const RouterContext = createContext<RouterContextValue>(defaultRouterContext);\n\nRouterContext.displayName = 'RiktaRouterContext';\n","import { createContext } from 'react';\nimport type { SsrData } from '../types.js';\n\n/**\n * React context for SSR data\n * Holds the server-rendered data passed via window.__SSR_DATA__\n */\nexport const SsrContext = createContext<SsrData | null>(null);\n\nSsrContext.displayName = 'RiktaSsrContext';\n","import { useState, useCallback, useEffect, useMemo, type FC } from 'react';\nimport { RouterContext } from '../context/RouterContext.js';\nimport { SsrContext } from '../context/SsrContext.js';\nimport type { RiktaProviderProps, SsrData, NavigateOptions } from '../types.js';\n\n/**\n * Get current location from window or fallback for SSR\n */\nfunction getLocationInfo() {\n  if (typeof window === 'undefined') {\n    return { pathname: '/', search: '', href: '/' };\n  }\n  return {\n    pathname: window.location.pathname,\n    search: window.location.search.slice(1), // Remove leading ?\n    href: window.location.href,\n  };\n}\n\n/**\n * Get SSR data from window\n */\nfunction getSsrData(): SsrData | undefined {\n  if (typeof window === 'undefined') return undefined;\n  return window.__SSR_DATA__;\n}\n\n/**\n * RiktaProvider - Main provider component for Rikta React utilities\n * \n * Provides routing context, SSR data, and navigation utilities to the app.\n * \n * @example\n * ```tsx\n * // In entry-client.tsx\n * import { RiktaProvider } from '@riktajs/react';\n * \n * hydrateRoot(\n *   document.getElementById('root')!,\n *   <RiktaProvider>\n *     <App />\n *   </RiktaProvider>\n * );\n * ```\n */\nexport const RiktaProvider: FC<RiktaProviderProps> = ({\n  ssrData: initialSsrData,\n  initialParams = {},\n  children,\n}) => {\n  // Initialize SSR data from window or props\n  const [ssrData] = useState<SsrData | null>(() => {\n    return initialSsrData ?? getSsrData() ?? null;\n  });\n\n  // Initialize location state\n  const [location, setLocation] = useState(getLocationInfo);\n  \n  // Route params state\n  const [params, setParams] = useState<Record<string, string>>(initialParams);\n\n  /**\n   * Navigate to a new URL using History API\n   */\n  const navigate = useCallback((url: string, options: NavigateOptions = {}) => {\n    const { replace = false, scroll = true, state } = options;\n\n    if (typeof window === 'undefined') return;\n\n    // Handle full URLs vs relative paths\n    let targetUrl: URL;\n    try {\n      targetUrl = new URL(url, window.location.origin);\n    } catch {\n      console.error(`[RiktaReact] Invalid URL: ${url}`);\n      return;\n    }\n\n    // Only handle same-origin navigation\n    if (targetUrl.origin !== window.location.origin) {\n      window.location.href = url;\n      return;\n    }\n\n    // Update history\n    if (replace) {\n      window.history.replaceState(state ?? null, '', targetUrl.href);\n    } else {\n      window.history.pushState(state ?? null, '', targetUrl.href);\n    }\n\n    // Update location state\n    setLocation({\n      pathname: targetUrl.pathname,\n      search: targetUrl.search.slice(1),\n      href: targetUrl.href,\n    });\n\n    // Scroll to top if requested\n    if (scroll) {\n      window.scrollTo(0, 0);\n    }\n\n    // Dispatch popstate event for any other listeners\n    window.dispatchEvent(new PopStateEvent('popstate', { state }));\n  }, []);\n\n  // Listen for popstate (browser back/forward)\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n\n    const handlePopState = () => {\n      setLocation(getLocationInfo());\n    };\n\n    window.addEventListener('popstate', handlePopState);\n    return () => window.removeEventListener('popstate', handlePopState);\n  }, []);\n\n  // Memoize router context value\n  const routerValue = useMemo(() => ({\n    pathname: location.pathname,\n    search: location.search,\n    href: location.href,\n    navigate,\n    params,\n    setParams,\n  }), [location.pathname, location.search, location.href, navigate, params]);\n\n  return (\n    <SsrContext.Provider value={ssrData}>\n      <RouterContext.Provider value={routerValue}>\n        {children}\n      </RouterContext.Provider>\n    </SsrContext.Provider>\n  );\n};\n\nRiktaProvider.displayName = 'RiktaProvider';\n","import { useContext, useCallback } from 'react';\nimport { RouterContext } from '../context/RouterContext.js';\nimport type { NavigateOptions } from '../types.js';\n\n/**\n * Hook for programmatic navigation\n * \n * @returns Object with navigate function and current location info\n * \n * @example\n * ```tsx\n * import { useNavigation } from '@riktajs/react';\n * \n * function MyComponent() {\n *   const { navigate, pathname } = useNavigation();\n * \n *   const handleSubmit = async () => {\n *     await saveData();\n *     navigate('/success');\n *   };\n * \n *   return (\n *     <button onClick={handleSubmit}>\n *       Submit (current path: {pathname})\n *     </button>\n *   );\n * }\n * ```\n * \n * @example\n * ```tsx\n * // With options\n * const { navigate } = useNavigation();\n * \n * // Replace history entry (for redirects)\n * navigate('/login', { replace: true });\n * \n * // Don't scroll to top\n * navigate('/next', { scroll: false });\n * \n * // Pass state\n * navigate('/edit', { state: { from: 'list' } });\n * ```\n */\nexport function useNavigation() {\n  const context = useContext(RouterContext);\n\n  const navigate = useCallback(\n    (url: string, options?: NavigateOptions) => {\n      context.navigate(url, options);\n    },\n    [context.navigate]\n  );\n\n  return {\n    /** Navigate to a new URL */\n    navigate,\n    /** Current pathname */\n    pathname: context.pathname,\n    /** Current search string (without ?) */\n    search: context.search,\n    /** Full href */\n    href: context.href,\n  };\n}\n","import { useCallback, type FC, type MouseEvent } from 'react';\nimport { useNavigation } from '../hooks/useNavigation.js';\nimport type { LinkProps } from '../types.js';\n\n/**\n * Link component for client-side navigation\n * \n * Renders an anchor tag that uses the History API for navigation\n * instead of causing a full page reload.\n * \n * @example\n * ```tsx\n * import { Link } from '@riktajs/react';\n * \n * function Nav() {\n *   return (\n *     <nav>\n *       <Link href=\"/\">Home</Link>\n *       <Link href=\"/about\">About</Link>\n *       <Link href=\"/items/123\">Item 123</Link>\n *     </nav>\n *   );\n * }\n * ```\n * \n * @example\n * ```tsx\n * // With options\n * <Link href=\"/dashboard\" replace scroll={false}>\n *   Dashboard\n * </Link>\n * ```\n */\nexport const Link: FC<LinkProps> = ({\n  href,\n  replace = false,\n  scroll = true,\n  prefetch = false,\n  state,\n  children,\n  onClick,\n  ...restProps\n}) => {\n  const { navigate } = useNavigation();\n\n  const handleClick = useCallback(\n    (e: MouseEvent<HTMLAnchorElement>) => {\n      // Call user's onClick handler if provided\n      onClick?.(e);\n\n      // Don't handle if default was prevented\n      if (e.defaultPrevented) return;\n\n      // Don't handle modified clicks (open in new tab, etc.)\n      if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;\n\n      // Don't handle right clicks\n      if (e.button !== 0) return;\n\n      // Don't handle target=\"_blank\" etc.\n      const target = (e.currentTarget as HTMLAnchorElement).target;\n      if (target && target !== '_self') return;\n\n      // Don't handle external links\n      try {\n        const url = new URL(href, window.location.origin);\n        if (url.origin !== window.location.origin) return;\n      } catch {\n        return;\n      }\n\n      // Handle the navigation\n      e.preventDefault();\n      navigate(href, { replace, scroll, state });\n    },\n    [href, replace, scroll, state, navigate, onClick]\n  );\n\n  // Prefetch support could be added here in the future\n  // using <link rel=\"prefetch\"> or Intersection Observer\n\n  return (\n    <a href={href} onClick={handleClick} {...restProps}>\n      {children}\n    </a>\n  );\n};\n\nLink.displayName = 'Link';\n","import { useContext } from 'react';\nimport { RouterContext } from '../context/RouterContext.js';\n\n/**\n * Hook to access route parameters\n * \n * Route parameters are extracted from the URL path by the server\n * and passed via SSR data. They're stored in the RouterContext.\n * \n * @returns Object with route parameter values\n * \n * @example\n * ```tsx\n * // For route /item/:id\n * import { useParams } from '@riktajs/react';\n * \n * function ItemPage() {\n *   const { id } = useParams<{ id: string }>();\n *   \n *   return <h1>Item {id}</h1>;\n * }\n * ```\n * \n * @example\n * ```tsx\n * // Multiple params - /users/:userId/posts/:postId\n * function PostPage() {\n *   const { userId, postId } = useParams<{ userId: string; postId: string }>();\n *   \n *   return <h1>Post {postId} by User {userId}</h1>;\n * }\n * ```\n */\nexport function useParams<T extends Record<string, string> = Record<string, string>>(): T {\n  const context = useContext(RouterContext);\n  return context.params as T;\n}\n","import { useContext, useMemo } from 'react';\nimport { RouterContext } from '../context/RouterContext.js';\n\n/**\n * Hook to access and manipulate URL search parameters\n * \n * @returns Tuple of [URLSearchParams, setSearchParams function]\n * \n * @example\n * ```tsx\n * import { useSearchParams } from '@riktajs/react';\n * \n * function SearchPage() {\n *   const [searchParams, setSearchParams] = useSearchParams();\n *   const query = searchParams.get('q') ?? '';\n *   const page = parseInt(searchParams.get('page') ?? '1', 10);\n * \n *   const handleSearch = (newQuery: string) => {\n *     setSearchParams({ q: newQuery, page: '1' });\n *   };\n * \n *   const handleNextPage = () => {\n *     setSearchParams({ q: query, page: String(page + 1) });\n *   };\n * \n *   return (\n *     <div>\n *       <input \n *         value={query} \n *         onChange={(e) => handleSearch(e.target.value)} \n *       />\n *       <button onClick={handleNextPage}>Next Page</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useSearchParams(): [URLSearchParams, (params: Record<string, string> | URLSearchParams) => void] {\n  const context = useContext(RouterContext);\n\n  const searchParams = useMemo(() => {\n    return new URLSearchParams(context.search);\n  }, [context.search]);\n\n  const setSearchParams = useMemo(() => {\n    return (params: Record<string, string> | URLSearchParams) => {\n      const newParams = params instanceof URLSearchParams \n        ? params \n        : new URLSearchParams(params);\n      \n      const search = newParams.toString();\n      const newUrl = search \n        ? `${context.pathname}?${search}` \n        : context.pathname;\n      \n      context.navigate(newUrl, { scroll: false });\n    };\n  }, [context.pathname, context.navigate]);\n\n  return [searchParams, setSearchParams];\n}\n","import { useContext } from 'react';\nimport { RouterContext } from '../context/RouterContext.js';\n\n/**\n * Location object returned by useLocation\n */\nexport interface Location {\n  /** Current pathname (e.g., /items/123) */\n  pathname: string;\n  /** Current search string without ? (e.g., page=2&sort=asc) */\n  search: string;\n  /** Full href */\n  href: string;\n  /** Parsed search params */\n  searchParams: URLSearchParams;\n}\n\n/**\n * Hook to access current location information\n * \n * @returns Location object with pathname, search, href, and searchParams\n * \n * @example\n * ```tsx\n * import { useLocation } from '@riktajs/react';\n * \n * function Breadcrumbs() {\n *   const location = useLocation();\n *   \n *   return (\n *     <nav>\n *       Current path: {location.pathname}\n *       {location.search && <span>?{location.search}</span>}\n *     </nav>\n *   );\n * }\n * ```\n * \n * @example\n * ```tsx\n * // Access search params\n * function FilterDisplay() {\n *   const { searchParams } = useLocation();\n *   const filter = searchParams.get('filter');\n *   \n *   return filter ? <span>Filtered by: {filter}</span> : null;\n * }\n * ```\n */\nexport function useLocation(): Location {\n  const context = useContext(RouterContext);\n\n  return {\n    pathname: context.pathname,\n    search: context.search,\n    href: context.href,\n    searchParams: new URLSearchParams(context.search),\n  };\n}\n","import { useContext } from 'react';\nimport { SsrContext } from '../context/SsrContext.js';\nimport type { SsrData } from '../types.js';\n\n/**\n * Hook to access SSR data passed from server\n * \n * SSR data is passed via window.__SSR_DATA__ and contains\n * the initial data rendered on the server.\n * \n * @returns SSR data object or null if not available\n * \n * @example\n * ```tsx\n * import { useSsrData } from '@riktajs/react';\n * \n * interface PageData {\n *   title: string;\n *   items: Array<{ id: string; name: string }>;\n * }\n * \n * function ItemList() {\n *   const ssrData = useSsrData<PageData>();\n *   \n *   if (!ssrData) {\n *     return <div>Loading...</div>;\n *   }\n *   \n *   return (\n *     <div>\n *       <h1>{ssrData.data.title}</h1>\n *       <ul>\n *         {ssrData.data.items.map(item => (\n *           <li key={item.id}>{item.name}</li>\n *         ))}\n *       </ul>\n *     </div>\n *   );\n * }\n * ```\n * \n * @example\n * ```tsx\n * // Access just the data\n * function MyComponent() {\n *   const ssrData = useSsrData<{ user: User }>();\n *   const user = ssrData?.data.user;\n *   \n *   return user ? <UserProfile user={user} /> : <LoginPrompt />;\n * }\n * ```\n */\nexport function useSsrData<T = unknown>(): SsrData<T> | null {\n  const context = useContext(SsrContext);\n  return context as SsrData<T> | null;\n}\n","import { useState, useEffect } from 'react';\nimport type { HydrationState } from '../types.js';\n\n/**\n * Hook to track hydration state\n * \n * Useful for rendering different content during SSR vs after hydration,\n * or for avoiding hydration mismatches.\n * \n * @returns Hydration state object\n * \n * @example\n * ```tsx\n * import { useHydration } from '@riktajs/react';\n * \n * function TimeDisplay() {\n *   const { isHydrated, isServer } = useHydration();\n *   \n *   // On server and initial render, show static content\n *   // After hydration, show dynamic content\n *   if (!isHydrated) {\n *     return <span>Loading time...</span>;\n *   }\n *   \n *   return <span>{new Date().toLocaleTimeString()}</span>;\n * }\n * ```\n * \n * @example\n * ```tsx\n * // Avoid hydration mismatch with client-only content\n * function ClientOnlyComponent() {\n *   const { isHydrated } = useHydration();\n *   \n *   if (!isHydrated) {\n *     return null; // Or a placeholder\n *   }\n *   \n *   return <SomeClientOnlyLibrary />;\n * }\n * ```\n * \n * @example\n * ```tsx\n * // Conditional rendering based on environment\n * function DebugPanel() {\n *   const { isServer } = useHydration();\n *   \n *   // Never render on server, only after client hydration\n *   if (isServer) return null;\n *   \n *   return <DevTools />;\n * }\n * ```\n */\nexport function useHydration(): HydrationState {\n  const isServer = typeof window === 'undefined';\n  const [isHydrated, setIsHydrated] = useState(false);\n\n  useEffect(() => {\n    setIsHydrated(true);\n  }, []);\n\n  return {\n    isHydrated,\n    isServer,\n  };\n}\n","import { useState, useEffect, useCallback, useRef } from 'react';\nimport type { FetchState } from '../types.js';\n\n/**\n * Options for useFetch hook\n */\nexport interface UseFetchOptions extends Omit<RequestInit, 'body'> {\n  /** Skip initial fetch (useful for conditional fetching) */\n  skip?: boolean;\n  /** Dependencies that trigger refetch when changed */\n  deps?: unknown[];\n  /** Transform response before setting data */\n  transform?: (data: unknown) => unknown;\n}\n\n/**\n * Hook for data fetching with loading and error states\n * \n * @param url URL to fetch from\n * @param options Fetch options\n * @returns Fetch state with data, loading, error, and refetch function\n * \n * @example\n * ```tsx\n * import { useFetch } from '@riktajs/react';\n * \n * interface User {\n *   id: string;\n *   name: string;\n * }\n * \n * function UserProfile({ userId }: { userId: string }) {\n *   const { data, loading, error, refetch } = useFetch<User>(\n *     `/api/users/${userId}`\n *   );\n *   \n *   if (loading) return <Spinner />;\n *   if (error) return <Error message={error} />;\n *   if (!data) return null;\n *   \n *   return (\n *     <div>\n *       <h1>{data.name}</h1>\n *       <button onClick={refetch}>Refresh</button>\n *     </div>\n *   );\n * }\n * ```\n * \n * @example\n * ```tsx\n * // With options\n * const { data } = useFetch<Item[]>('/api/items', {\n *   headers: { 'Authorization': `Bearer ${token}` },\n *   deps: [token], // Refetch when token changes\n *   skip: !token,  // Don't fetch until we have a token\n * });\n * ```\n * \n * @example\n * ```tsx\n * // With transform\n * const { data } = useFetch<{ results: Item[] }>('/api/search', {\n *   transform: (res) => res.results, // Extract just the results array\n * });\n * ```\n */\nexport function useFetch<T = unknown>(\n  url: string,\n  options: UseFetchOptions = {}\n): FetchState<T> {\n  const { skip = false, deps = [], transform, ...fetchOptions } = options;\n  \n  const [state, setState] = useState<Omit<FetchState<T>, 'refetch'>>({\n    data: null,\n    loading: !skip,\n    error: null,\n  });\n\n  // Use ref to track if component is mounted\n  const mountedRef = useRef(true);\n  // Use ref to track current fetch to handle race conditions\n  const fetchIdRef = useRef(0);\n\n  const fetchData = useCallback(async () => {\n    if (skip) return;\n\n    const fetchId = ++fetchIdRef.current;\n    setState(prev => ({ ...prev, loading: true, error: null }));\n\n    try {\n      const response = await fetch(url, fetchOptions);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      let data = await response.json();\n\n      // Apply transform if provided\n      if (transform) {\n        data = transform(data);\n      }\n\n      // Only update state if this is still the current fetch and component is mounted\n      if (fetchId === fetchIdRef.current && mountedRef.current) {\n        setState({ data: data as T, loading: false, error: null });\n      }\n    } catch (err) {\n      if (fetchId === fetchIdRef.current && mountedRef.current) {\n        const message = err instanceof Error ? err.message : 'An error occurred';\n        setState({ data: null, loading: false, error: message });\n      }\n    }\n  }, [url, skip, JSON.stringify(fetchOptions), transform]);\n\n  // Fetch on mount and when dependencies change\n  useEffect(() => {\n    mountedRef.current = true;\n    fetchData();\n\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [fetchData, ...deps]);\n\n  const refetch = useCallback(async () => {\n    await fetchData();\n  }, [fetchData]);\n\n  return {\n    ...state,\n    refetch,\n  };\n}\n","import { useState, useCallback } from 'react';\nimport type { ActionResult, ActionState } from '../types.js';\n\n/**\n * Options for useAction hook\n */\nexport interface UseActionOptions<TResult = unknown> {\n  /** Callback on successful action */\n  onSuccess?: (result: TResult) => void;\n  /** Callback on action error */\n  onError?: (error: string) => void;\n  /** HTTP method to use */\n  method?: 'POST' | 'PUT' | 'PATCH' | 'DELETE';\n  /** Additional headers */\n  headers?: Record<string, string>;\n}\n\n/**\n * Hook for executing server actions (form submissions, mutations)\n * \n * @param url URL to send the action to\n * @param options Action options\n * @returns Action state with execute, pending, result, and reset\n * \n * @example\n * ```tsx\n * import { useAction } from '@riktajs/react';\n * \n * interface CreateItemInput {\n *   name: string;\n *   price: number;\n * }\n * \n * interface Item {\n *   id: string;\n *   name: string;\n *   price: number;\n * }\n * \n * function CreateItemForm() {\n *   const { execute, pending, result } = useAction<CreateItemInput, Item>(\n *     '/api/items',\n *     {\n *       onSuccess: (item) => {\n *         console.log('Created item:', item);\n *       },\n *     }\n *   );\n * \n *   const handleSubmit = async (e: FormEvent) => {\n *     e.preventDefault();\n *     const formData = new FormData(e.target as HTMLFormElement);\n *     await execute({\n *       name: formData.get('name') as string,\n *       price: Number(formData.get('price')),\n *     });\n *   };\n * \n *   return (\n *     <form onSubmit={handleSubmit}>\n *       <input name=\"name\" required />\n *       <input name=\"price\" type=\"number\" required />\n *       <button disabled={pending}>\n *         {pending ? 'Creating...' : 'Create Item'}\n *       </button>\n *       {result?.error && <p className=\"error\">{result.error}</p>}\n *       {result?.fieldErrors?.name && (\n *         <p className=\"error\">{result.fieldErrors.name[0]}</p>\n *       )}\n *     </form>\n *   );\n * }\n * ```\n * \n * @example\n * ```tsx\n * // DELETE action\n * const { execute, pending } = useAction<{ id: string }, void>(\n *   '/api/items',\n *   { method: 'DELETE' }\n * );\n * \n * const handleDelete = () => execute({ id: itemId });\n * ```\n */\nexport function useAction<TInput = unknown, TResult = unknown>(\n  url: string,\n  options: UseActionOptions<TResult> = {}\n): ActionState<TInput, TResult> {\n  const {\n    onSuccess,\n    onError,\n    method = 'POST',\n    headers: customHeaders = {},\n  } = options;\n\n  const [pending, setPending] = useState(false);\n  const [result, setResult] = useState<ActionResult<TResult> | null>(null);\n\n  const execute = useCallback(\n    async (input: TInput): Promise<ActionResult<TResult>> => {\n      setPending(true);\n      setResult(null);\n\n      try {\n        const response = await fetch(url, {\n          method,\n          headers: {\n            'Content-Type': 'application/json',\n            ...customHeaders,\n          },\n          body: JSON.stringify(input),\n        });\n\n        const data = await response.json();\n\n        if (!response.ok) {\n          // Handle error response\n          const actionResult: ActionResult<TResult> = {\n            success: false,\n            error: data.message || data.error || `HTTP ${response.status}`,\n            fieldErrors: data.fieldErrors,\n          };\n          setResult(actionResult);\n          onError?.(actionResult.error!);\n          return actionResult;\n        }\n\n        // Handle success response\n        const actionResult: ActionResult<TResult> = {\n          success: true,\n          data: data as TResult,\n        };\n        setResult(actionResult);\n        onSuccess?.(data as TResult);\n        return actionResult;\n      } catch (err) {\n        const message = err instanceof Error ? err.message : 'An error occurred';\n        const actionResult: ActionResult<TResult> = {\n          success: false,\n          error: message,\n        };\n        setResult(actionResult);\n        onError?.(message);\n        return actionResult;\n      } finally {\n        setPending(false);\n      }\n    },\n    [url, method, JSON.stringify(customHeaders), onSuccess, onError]\n  );\n\n  const reset = useCallback(() => {\n    setResult(null);\n  }, []);\n\n  return {\n    execute,\n    pending,\n    result,\n    reset,\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,609 @@
+import * as react from 'react';
+import { FC } from 'react';
+
+/**
+ * SSR data structure passed from server to client
+ * via window.__SSR_DATA__
+ */
+interface SsrData<T = unknown> {
+    /** Initial data rendered on server */
+    data: T;
+    /** Current URL path */
+    url: string;
+    /** HTTP status code */
+    status?: number;
+    /** Additional metadata */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Router context value interface
+ */
+interface RouterContextValue {
+    /** Current URL path */
+    pathname: string;
+    /** Current search params string (without ?) */
+    search: string;
+    /** Full URL */
+    href: string;
+    /** Navigate to a new URL */
+    navigate: (url: string, options?: NavigateOptions) => void;
+    /** Extracted route params (e.g., { id: '123' } for /item/:id) */
+    params: Record<string, string>;
+    /** Update route params (used internally by RiktaProvider) */
+    setParams: (params: Record<string, string>) => void;
+}
+/**
+ * Navigation options
+ */
+interface NavigateOptions {
+    /** Replace current history entry instead of pushing */
+    replace?: boolean;
+    /** Scroll to top after navigation */
+    scroll?: boolean;
+    /** Additional state to store in history */
+    state?: unknown;
+}
+/**
+ * Result type for server actions
+ */
+interface ActionResult<T = unknown> {
+    /** Whether the action was successful */
+    success: boolean;
+    /** Response data on success */
+    data?: T;
+    /** Error message on failure */
+    error?: string;
+    /** Field-specific validation errors */
+    fieldErrors?: Record<string, string[]>;
+}
+/**
+ * Fetch state for useFetch hook
+ */
+interface FetchState<T = unknown> {
+    /** Fetched data */
+    data: T | null;
+    /** Whether fetch is in progress */
+    loading: boolean;
+    /** Error message if fetch failed */
+    error: string | null;
+    /** Manually refetch data */
+    refetch: () => Promise<void>;
+}
+/**
+ * Action state for useAction hook
+ */
+interface ActionState<TInput = unknown, TResult = unknown> {
+    /** Execute the action */
+    execute: (input: TInput) => Promise<ActionResult<TResult>>;
+    /** Whether action is executing */
+    pending: boolean;
+    /** Last action result */
+    result: ActionResult<TResult> | null;
+    /** Reset action state */
+    reset: () => void;
+}
+/**
+ * Link component props
+ */
+interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {
+    /** Target URL */
+    href: string;
+    /** Replace history entry instead of push */
+    replace?: boolean;
+    /** Scroll to top after navigation */
+    scroll?: boolean;
+    /** Prefetch the linked page (future enhancement) */
+    prefetch?: boolean;
+    /** Additional state to pass to navigation */
+    state?: unknown;
+    /** Children elements */
+    children: React.ReactNode;
+}
+/**
+ * RiktaProvider props
+ */
+interface RiktaProviderProps {
+    /** Initial SSR data from server */
+    ssrData?: SsrData;
+    /** Initial route params extracted from URL */
+    initialParams?: Record<string, string>;
+    /** Children elements */
+    children: React.ReactNode;
+}
+/**
+ * Hydration state
+ */
+interface HydrationState {
+    /** Whether the app has hydrated on client */
+    isHydrated: boolean;
+    /** Whether currently running on server */
+    isServer: boolean;
+}
+declare global {
+    interface Window {
+        __SSR_DATA__?: SsrData;
+    }
+}
+
+/**
+ * React context for router state
+ * Provides navigation utilities and current location info
+ */
+declare const RouterContext: react.Context<RouterContextValue>;
+
+/**
+ * React context for SSR data
+ * Holds the server-rendered data passed via window.__SSR_DATA__
+ */
+declare const SsrContext: react.Context<SsrData<unknown> | null>;
+
+/**
+ * RiktaProvider - Main provider component for Rikta React utilities
+ *
+ * Provides routing context, SSR data, and navigation utilities to the app.
+ *
+ * @example
+ * ```tsx
+ * // In entry-client.tsx
+ * import { RiktaProvider } from '@riktajs/react';
+ *
+ * hydrateRoot(
+ *   document.getElementById('root')!,
+ *   <RiktaProvider>
+ *     <App />
+ *   </RiktaProvider>
+ * );
+ * ```
+ */
+declare const RiktaProvider: FC<RiktaProviderProps>;
+
+/**
+ * Link component for client-side navigation
+ *
+ * Renders an anchor tag that uses the History API for navigation
+ * instead of causing a full page reload.
+ *
+ * @example
+ * ```tsx
+ * import { Link } from '@riktajs/react';
+ *
+ * function Nav() {
+ *   return (
+ *     <nav>
+ *       <Link href="/">Home</Link>
+ *       <Link href="/about">About</Link>
+ *       <Link href="/items/123">Item 123</Link>
+ *     </nav>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With options
+ * <Link href="/dashboard" replace scroll={false}>
+ *   Dashboard
+ * </Link>
+ * ```
+ */
+declare const Link: FC<LinkProps>;
+
+/**
+ * Hook for programmatic navigation
+ *
+ * @returns Object with navigate function and current location info
+ *
+ * @example
+ * ```tsx
+ * import { useNavigation } from '@riktajs/react';
+ *
+ * function MyComponent() {
+ *   const { navigate, pathname } = useNavigation();
+ *
+ *   const handleSubmit = async () => {
+ *     await saveData();
+ *     navigate('/success');
+ *   };
+ *
+ *   return (
+ *     <button onClick={handleSubmit}>
+ *       Submit (current path: {pathname})
+ *     </button>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With options
+ * const { navigate } = useNavigation();
+ *
+ * // Replace history entry (for redirects)
+ * navigate('/login', { replace: true });
+ *
+ * // Don't scroll to top
+ * navigate('/next', { scroll: false });
+ *
+ * // Pass state
+ * navigate('/edit', { state: { from: 'list' } });
+ * ```
+ */
+declare function useNavigation(): {
+    /** Navigate to a new URL */
+    navigate: (url: string, options?: NavigateOptions) => void;
+    /** Current pathname */
+    pathname: string;
+    /** Current search string (without ?) */
+    search: string;
+    /** Full href */
+    href: string;
+};
+
+/**
+ * Hook to access route parameters
+ *
+ * Route parameters are extracted from the URL path by the server
+ * and passed via SSR data. They're stored in the RouterContext.
+ *
+ * @returns Object with route parameter values
+ *
+ * @example
+ * ```tsx
+ * // For route /item/:id
+ * import { useParams } from '@riktajs/react';
+ *
+ * function ItemPage() {
+ *   const { id } = useParams<{ id: string }>();
+ *
+ *   return <h1>Item {id}</h1>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Multiple params - /users/:userId/posts/:postId
+ * function PostPage() {
+ *   const { userId, postId } = useParams<{ userId: string; postId: string }>();
+ *
+ *   return <h1>Post {postId} by User {userId}</h1>;
+ * }
+ * ```
+ */
+declare function useParams<T extends Record<string, string> = Record<string, string>>(): T;
+
+/**
+ * Hook to access and manipulate URL search parameters
+ *
+ * @returns Tuple of [URLSearchParams, setSearchParams function]
+ *
+ * @example
+ * ```tsx
+ * import { useSearchParams } from '@riktajs/react';
+ *
+ * function SearchPage() {
+ *   const [searchParams, setSearchParams] = useSearchParams();
+ *   const query = searchParams.get('q') ?? '';
+ *   const page = parseInt(searchParams.get('page') ?? '1', 10);
+ *
+ *   const handleSearch = (newQuery: string) => {
+ *     setSearchParams({ q: newQuery, page: '1' });
+ *   };
+ *
+ *   const handleNextPage = () => {
+ *     setSearchParams({ q: query, page: String(page + 1) });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         value={query}
+ *         onChange={(e) => handleSearch(e.target.value)}
+ *       />
+ *       <button onClick={handleNextPage}>Next Page</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useSearchParams(): [URLSearchParams, (params: Record<string, string> | URLSearchParams) => void];
+
+/**
+ * Location object returned by useLocation
+ */
+interface Location {
+    /** Current pathname (e.g., /items/123) */
+    pathname: string;
+    /** Current search string without ? (e.g., page=2&sort=asc) */
+    search: string;
+    /** Full href */
+    href: string;
+    /** Parsed search params */
+    searchParams: URLSearchParams;
+}
+/**
+ * Hook to access current location information
+ *
+ * @returns Location object with pathname, search, href, and searchParams
+ *
+ * @example
+ * ```tsx
+ * import { useLocation } from '@riktajs/react';
+ *
+ * function Breadcrumbs() {
+ *   const location = useLocation();
+ *
+ *   return (
+ *     <nav>
+ *       Current path: {location.pathname}
+ *       {location.search && <span>?{location.search}</span>}
+ *     </nav>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Access search params
+ * function FilterDisplay() {
+ *   const { searchParams } = useLocation();
+ *   const filter = searchParams.get('filter');
+ *
+ *   return filter ? <span>Filtered by: {filter}</span> : null;
+ * }
+ * ```
+ */
+declare function useLocation(): Location;
+
+/**
+ * Hook to access SSR data passed from server
+ *
+ * SSR data is passed via window.__SSR_DATA__ and contains
+ * the initial data rendered on the server.
+ *
+ * @returns SSR data object or null if not available
+ *
+ * @example
+ * ```tsx
+ * import { useSsrData } from '@riktajs/react';
+ *
+ * interface PageData {
+ *   title: string;
+ *   items: Array<{ id: string; name: string }>;
+ * }
+ *
+ * function ItemList() {
+ *   const ssrData = useSsrData<PageData>();
+ *
+ *   if (!ssrData) {
+ *     return <div>Loading...</div>;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <h1>{ssrData.data.title}</h1>
+ *       <ul>
+ *         {ssrData.data.items.map(item => (
+ *           <li key={item.id}>{item.name}</li>
+ *         ))}
+ *       </ul>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Access just the data
+ * function MyComponent() {
+ *   const ssrData = useSsrData<{ user: User }>();
+ *   const user = ssrData?.data.user;
+ *
+ *   return user ? <UserProfile user={user} /> : <LoginPrompt />;
+ * }
+ * ```
+ */
+declare function useSsrData<T = unknown>(): SsrData<T> | null;
+
+/**
+ * Hook to track hydration state
+ *
+ * Useful for rendering different content during SSR vs after hydration,
+ * or for avoiding hydration mismatches.
+ *
+ * @returns Hydration state object
+ *
+ * @example
+ * ```tsx
+ * import { useHydration } from '@riktajs/react';
+ *
+ * function TimeDisplay() {
+ *   const { isHydrated, isServer } = useHydration();
+ *
+ *   // On server and initial render, show static content
+ *   // After hydration, show dynamic content
+ *   if (!isHydrated) {
+ *     return <span>Loading time...</span>;
+ *   }
+ *
+ *   return <span>{new Date().toLocaleTimeString()}</span>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Avoid hydration mismatch with client-only content
+ * function ClientOnlyComponent() {
+ *   const { isHydrated } = useHydration();
+ *
+ *   if (!isHydrated) {
+ *     return null; // Or a placeholder
+ *   }
+ *
+ *   return <SomeClientOnlyLibrary />;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Conditional rendering based on environment
+ * function DebugPanel() {
+ *   const { isServer } = useHydration();
+ *
+ *   // Never render on server, only after client hydration
+ *   if (isServer) return null;
+ *
+ *   return <DevTools />;
+ * }
+ * ```
+ */
+declare function useHydration(): HydrationState;
+
+/**
+ * Options for useFetch hook
+ */
+interface UseFetchOptions extends Omit<RequestInit, 'body'> {
+    /** Skip initial fetch (useful for conditional fetching) */
+    skip?: boolean;
+    /** Dependencies that trigger refetch when changed */
+    deps?: unknown[];
+    /** Transform response before setting data */
+    transform?: (data: unknown) => unknown;
+}
+/**
+ * Hook for data fetching with loading and error states
+ *
+ * @param url URL to fetch from
+ * @param options Fetch options
+ * @returns Fetch state with data, loading, error, and refetch function
+ *
+ * @example
+ * ```tsx
+ * import { useFetch } from '@riktajs/react';
+ *
+ * interface User {
+ *   id: string;
+ *   name: string;
+ * }
+ *
+ * function UserProfile({ userId }: { userId: string }) {
+ *   const { data, loading, error, refetch } = useFetch<User>(
+ *     `/api/users/${userId}`
+ *   );
+ *
+ *   if (loading) return <Spinner />;
+ *   if (error) return <Error message={error} />;
+ *   if (!data) return null;
+ *
+ *   return (
+ *     <div>
+ *       <h1>{data.name}</h1>
+ *       <button onClick={refetch}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With options
+ * const { data } = useFetch<Item[]>('/api/items', {
+ *   headers: { 'Authorization': `Bearer ${token}` },
+ *   deps: [token], // Refetch when token changes
+ *   skip: !token,  // Don't fetch until we have a token
+ * });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With transform
+ * const { data } = useFetch<{ results: Item[] }>('/api/search', {
+ *   transform: (res) => res.results, // Extract just the results array
+ * });
+ * ```
+ */
+declare function useFetch<T = unknown>(url: string, options?: UseFetchOptions): FetchState<T>;
+
+/**
+ * Options for useAction hook
+ */
+interface UseActionOptions<TResult = unknown> {
+    /** Callback on successful action */
+    onSuccess?: (result: TResult) => void;
+    /** Callback on action error */
+    onError?: (error: string) => void;
+    /** HTTP method to use */
+    method?: 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /** Additional headers */
+    headers?: Record<string, string>;
+}
+/**
+ * Hook for executing server actions (form submissions, mutations)
+ *
+ * @param url URL to send the action to
+ * @param options Action options
+ * @returns Action state with execute, pending, result, and reset
+ *
+ * @example
+ * ```tsx
+ * import { useAction } from '@riktajs/react';
+ *
+ * interface CreateItemInput {
+ *   name: string;
+ *   price: number;
+ * }
+ *
+ * interface Item {
+ *   id: string;
+ *   name: string;
+ *   price: number;
+ * }
+ *
+ * function CreateItemForm() {
+ *   const { execute, pending, result } = useAction<CreateItemInput, Item>(
+ *     '/api/items',
+ *     {
+ *       onSuccess: (item) => {
+ *         console.log('Created item:', item);
+ *       },
+ *     }
+ *   );
+ *
+ *   const handleSubmit = async (e: FormEvent) => {
+ *     e.preventDefault();
+ *     const formData = new FormData(e.target as HTMLFormElement);
+ *     await execute({
+ *       name: formData.get('name') as string,
+ *       price: Number(formData.get('price')),
+ *     });
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input name="name" required />
+ *       <input name="price" type="number" required />
+ *       <button disabled={pending}>
+ *         {pending ? 'Creating...' : 'Create Item'}
+ *       </button>
+ *       {result?.error && <p className="error">{result.error}</p>}
+ *       {result?.fieldErrors?.name && (
+ *         <p className="error">{result.fieldErrors.name[0]}</p>
+ *       )}
+ *     </form>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // DELETE action
+ * const { execute, pending } = useAction<{ id: string }, void>(
+ *   '/api/items',
+ *   { method: 'DELETE' }
+ * );
+ *
+ * const handleDelete = () => execute({ id: itemId });
+ * ```
+ */
+declare function useAction<TInput = unknown, TResult = unknown>(url: string, options?: UseActionOptions<TResult>): ActionState<TInput, TResult>;
+
+export { type ActionResult, type ActionState, type FetchState, type HydrationState, Link, type LinkProps, type Location, type NavigateOptions, RiktaProvider, type RiktaProviderProps, RouterContext, type RouterContextValue, SsrContext, type SsrData, type UseActionOptions, type UseFetchOptions, useAction, useFetch, useHydration, useLocation, useNavigation, useParams, useSearchParams, useSsrData };