@flexireact/core 3.0.4 → 4.1.0

package/dist/core/client/index.js

@@ -10,22 +10,19 @@ function hydrateIsland(islandId, Component, props) {
   if (element.hasAttribute("data-hydrated")) {
     return;
   }
-  try {
-    hydrateRoot(element, React.createElement(Component, props));
-    element.setAttribute("data-hydrated", "true");
-    element.dispatchEvent(new CustomEvent("flexi:hydrated", {
-      bubbles: true,
-      detail: { islandId, props }
-    }));
-  } catch (error) {
-    console.error(`Failed to hydrate island ${islandId}:`, error);
-    try {
-      createRoot(element).render(React.createElement(Component, props));
-      element.setAttribute("data-hydrated", "true");
-    } catch (fallbackError) {
-      console.error(`Fallback render also failed for ${islandId}:`, fallbackError);
+  hydrateRoot(element, React.createElement(Component, props), {
+    onRecoverableError: (error, errorInfo) => {
+      console.warn(`[FlexiReact] Hydration mismatch in ${islandId}:`, error);
+      if (process.env.NODE_ENV === "development") {
+        console.debug("Component stack:", errorInfo.componentStack);
+      }
     }
-  }
+  });
+  element.setAttribute("data-hydrated", "true");
+  element.dispatchEvent(new CustomEvent("flexi:hydrated", {
+    bubbles: true,
+    detail: { islandId, props }
+  }));
 }
 function hydrateApp(App, props = {}) {
   const root = document.getElementById("root");

package/dist/core/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../core/client/hydration.ts","../../../core/client/navigation.ts","../../../core/client/islands.ts","../../../core/client/Link.tsx"],"sourcesContent":["/**\r\n * FlexiReact Client Hydration\r\n * Handles selective hydration of islands and full app hydration\r\n */\r\n\r\nimport React from 'react';\r\nimport { hydrateRoot, createRoot } from 'react-dom/client';\r\n\r\n// Extend Window interface for __FLEXI_DATA__\r\ndeclare global {\r\n  interface Window {\r\n    __FLEXI_DATA__?: {\r\n      islands?: any[];\r\n      props?: Record<string, any>;\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Hydrates a specific island component\r\n */\r\nexport function hydrateIsland(islandId, Component, props) {\r\n  const element = document.querySelector(`[data-island=\"${islandId}\"]`);\r\n  \r\n  if (!element) {\r\n    console.warn(`Island element not found: ${islandId}`);\r\n    return;\r\n  }\r\n\r\n  if (element.hasAttribute('data-hydrated')) {\r\n    return; // Already hydrated\r\n  }\r\n\r\n  try {\r\n    hydrateRoot(element, React.createElement(Component, props));\r\n    element.setAttribute('data-hydrated', 'true');\r\n    \r\n    // Dispatch custom event\r\n    element.dispatchEvent(new CustomEvent('flexi:hydrated', {\r\n      bubbles: true,\r\n      detail: { islandId, props }\r\n    }));\r\n  } catch (error) {\r\n    console.error(`Failed to hydrate island ${islandId}:`, error);\r\n    \r\n    // Fallback: try full render instead of hydration\r\n    try {\r\n      createRoot(element).render(React.createElement(Component, props));\r\n      element.setAttribute('data-hydrated', 'true');\r\n    } catch (fallbackError) {\r\n      console.error(`Fallback render also failed for ${islandId}:`, fallbackError);\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Hydrates the entire application\r\n */\r\nexport function hydrateApp(App, props = {}) {\r\n  const root = document.getElementById('root');\r\n  \r\n  if (!root) {\r\n    console.error('Root element not found');\r\n    return;\r\n  }\r\n\r\n  // Get server-rendered props\r\n  const serverProps = window.__FLEXI_DATA__?.props || {};\r\n  const mergedProps = { ...serverProps, ...props };\r\n\r\n  try {\r\n    hydrateRoot(root, React.createElement(App, mergedProps));\r\n  } catch (error) {\r\n    console.error('Hydration failed, falling back to full render:', error);\r\n    createRoot(root).render(React.createElement(App, mergedProps));\r\n  }\r\n}\r\n\r\n/**\r\n * Hydrates all islands on the page\r\n */\r\nexport async function hydrateAllIslands(islandModules) {\r\n  const islands = document.querySelectorAll('[data-island]');\r\n  \r\n  for (const element of islands) {\r\n    if (element.hasAttribute('data-hydrated')) continue;\r\n    \r\n    const islandId = element.getAttribute('data-island');\r\n    const islandName = element.getAttribute('data-island-name');\r\n    const propsJson = element.getAttribute('data-island-props');\r\n    \r\n    try {\r\n      const props = propsJson ? JSON.parse(propsJson) : {};\r\n      const module = islandModules[islandName];\r\n      \r\n      if (module) {\r\n        hydrateIsland(islandId, module.default || module, props);\r\n      }\r\n    } catch (error) {\r\n      console.error(`Failed to hydrate island ${islandName}:`, error);\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Progressive hydration based on visibility\r\n */\r\nexport function setupProgressiveHydration(islandModules) {\r\n  const observer = new IntersectionObserver(\r\n    (entries) => {\r\n      entries.forEach(async (entry) => {\r\n        if (!entry.isIntersecting) return;\r\n        \r\n        const element = entry.target;\r\n        if (element.hasAttribute('data-hydrated')) return;\r\n        \r\n        const islandName = element.getAttribute('data-island-name');\r\n        const islandId = element.getAttribute('data-island');\r\n        const propsJson = element.getAttribute('data-island-props');\r\n        \r\n        try {\r\n          const props = propsJson ? JSON.parse(propsJson) : {};\r\n          const module = await islandModules[islandName]();\r\n          \r\n          hydrateIsland(islandId, module.default || module, props);\r\n          observer.unobserve(element);\r\n        } catch (error) {\r\n          console.error(`Failed to hydrate island ${islandName}:`, error);\r\n        }\r\n      });\r\n    },\r\n    { rootMargin: '50px' }\r\n  );\r\n\r\n  document.querySelectorAll('[data-island]:not([data-hydrated])').forEach(el => {\r\n    observer.observe(el);\r\n  });\r\n\r\n  return observer;\r\n}\r\n\r\nexport default {\r\n  hydrateIsland,\r\n  hydrateApp,\r\n  hydrateAllIslands,\r\n  setupProgressiveHydration\r\n};\r\n","/**\r\n * FlexiReact Client Navigation\r\n * Client-side navigation with prefetching\r\n */\r\n\r\nimport React from 'react';\r\n\r\n// Navigation state\r\nconst navigationState: {\r\n  listeners: Set<(url: string) => void>;\r\n  prefetched: Set<string>;\r\n} = {\r\n  listeners: new Set(),\r\n  prefetched: new Set()\r\n};\r\n\r\n/**\r\n * Navigates to a new URL\r\n */\r\ninterface NavigateOptions {\r\n  replace?: boolean;\r\n  scroll?: boolean;\r\n}\r\n\r\nexport function navigate(url: string, options: NavigateOptions = {}) {\r\n  const { replace = false, scroll = true } = options;\r\n\r\n  if (replace) {\r\n    window.history.replaceState({}, '', url);\r\n  } else {\r\n    window.history.pushState({}, '', url);\r\n  }\r\n\r\n  // Dispatch navigation event\r\n  window.dispatchEvent(new CustomEvent('flexi:navigate', {\r\n    detail: { url, replace, scroll }\r\n  }));\r\n\r\n  // Scroll to top if needed\r\n  if (scroll) {\r\n    window.scrollTo(0, 0);\r\n  }\r\n\r\n  // Notify listeners\r\n  navigationState.listeners.forEach(listener => listener(url));\r\n\r\n  // Fetch and render new page\r\n  return fetchAndRender(url);\r\n}\r\n\r\n/**\r\n * Prefetches a URL for faster navigation\r\n */\r\nexport function prefetch(url) {\r\n  if (navigationState.prefetched.has(url)) {\r\n    return Promise.resolve();\r\n  }\r\n\r\n  navigationState.prefetched.add(url);\r\n\r\n  // Create a link element for prefetching\r\n  const link = document.createElement('link');\r\n  link.rel = 'prefetch';\r\n  link.href = url;\r\n  document.head.appendChild(link);\r\n\r\n  return Promise.resolve();\r\n}\r\n\r\n/**\r\n * Fetches and renders a new page\r\n */\r\nasync function fetchAndRender(url) {\r\n  try {\r\n    const response = await fetch(url, {\r\n      headers: {\r\n        'X-Flexi-Navigation': 'true'\r\n      }\r\n    });\r\n\r\n    if (!response.ok) {\r\n      throw new Error(`Navigation failed: ${response.status}`);\r\n    }\r\n\r\n    const html = await response.text();\r\n    \r\n    // Parse the HTML\r\n    const parser = new DOMParser();\r\n    const doc = parser.parseFromString(html, 'text/html');\r\n\r\n    // Update the page content\r\n    const newRoot = doc.getElementById('root');\r\n    const currentRoot = document.getElementById('root');\r\n\r\n    if (newRoot && currentRoot) {\r\n      currentRoot.innerHTML = newRoot.innerHTML;\r\n    }\r\n\r\n    // Update the title\r\n    document.title = doc.title;\r\n\r\n    // Update meta tags\r\n    updateMetaTags(doc);\r\n\r\n    // Re-hydrate islands\r\n    window.dispatchEvent(new CustomEvent('flexi:pageload'));\r\n\r\n  } catch (error) {\r\n    console.error('Navigation error:', error);\r\n    // Fallback to full page navigation\r\n    window.location.href = url;\r\n  }\r\n}\r\n\r\n/**\r\n * Updates meta tags from new document\r\n */\r\nfunction updateMetaTags(doc) {\r\n  // Remove old meta tags\r\n  document.querySelectorAll('meta[data-flexi]').forEach(el => el.remove());\r\n\r\n  // Add new meta tags\r\n  doc.querySelectorAll('meta').forEach(meta => {\r\n    if (meta.name || meta.property) {\r\n      const newMeta = meta.cloneNode(true);\r\n      newMeta.setAttribute('data-flexi', 'true');\r\n      document.head.appendChild(newMeta);\r\n    }\r\n  });\r\n}\r\n\r\n/**\r\n * Link component for client-side navigation\r\n */\r\nexport function Link({ href, children, prefetch: shouldPrefetch = true, replace = false, className, ...props }) {\r\n  const handleClick = (e) => {\r\n    // Allow normal navigation for external links or modified clicks\r\n    if (\r\n      e.ctrlKey ||\r\n      e.metaKey ||\r\n      e.shiftKey ||\r\n      e.button !== 0 ||\r\n      href.startsWith('http') ||\r\n      href.startsWith('//')\r\n    ) {\r\n      return;\r\n    }\r\n\r\n    e.preventDefault();\r\n    navigate(href, { replace });\r\n  };\r\n\r\n  const handleMouseEnter = () => {\r\n    if (shouldPrefetch) {\r\n      prefetch(href);\r\n    }\r\n  };\r\n\r\n  return React.createElement('a', {\r\n    href,\r\n    onClick: handleClick,\r\n    onMouseEnter: handleMouseEnter,\r\n    className,\r\n    ...props\r\n  }, children);\r\n}\r\n\r\n/**\r\n * Hook to listen for navigation events\r\n */\r\nexport function useNavigation() {\r\n  const [pathname, setPathname] = React.useState(\r\n    typeof window !== 'undefined' ? window.location.pathname : '/'\r\n  );\r\n\r\n  React.useEffect(() => {\r\n    const handleNavigation = (url) => {\r\n      setPathname(new URL(url, window.location.origin).pathname);\r\n    };\r\n\r\n    navigationState.listeners.add(handleNavigation);\r\n\r\n    const handlePopState = () => {\r\n      setPathname(window.location.pathname);\r\n      navigationState.listeners.forEach(listener => listener(window.location.pathname));\r\n    };\r\n\r\n    window.addEventListener('popstate', handlePopState);\r\n\r\n    return () => {\r\n      navigationState.listeners.delete(handleNavigation);\r\n      window.removeEventListener('popstate', handlePopState);\r\n    };\r\n  }, []);\r\n\r\n  return { pathname, navigate, prefetch };\r\n}\r\n\r\n// Setup popstate listener\r\nif (typeof window !== 'undefined') {\r\n  window.addEventListener('popstate', () => {\r\n    const url = window.location.pathname + window.location.search;\r\n    navigationState.listeners.forEach(listener => listener(url));\r\n  });\r\n}\r\n\r\nexport default {\r\n  navigate,\r\n  prefetch,\r\n  Link,\r\n  useNavigation\r\n};\r\n","/**\r\n * FlexiReact Client Islands\r\n * Client-side island utilities\r\n */\r\n\r\nimport React from 'react';\r\n\r\n/**\r\n * Hook to check if component is hydrated\r\n */\r\nexport function useIsland() {\r\n  const [isHydrated, setIsHydrated] = React.useState(false);\r\n\r\n  React.useEffect(() => {\r\n    setIsHydrated(true);\r\n  }, []);\r\n\r\n  return { isHydrated };\r\n}\r\n\r\n/**\r\n * Island boundary component\r\n * Wraps interactive components for partial hydration\r\n */\r\nexport function IslandBoundary({ children, fallback = null, name = 'island' }) {\r\n  const { isHydrated } = useIsland();\r\n\r\n  // On server or before hydration, render children normally\r\n  // The server will wrap this in the island marker\r\n  if (!isHydrated && fallback) {\r\n    return fallback;\r\n  }\r\n\r\n  return React.createElement('div', {\r\n    'data-island-boundary': name,\r\n    children\r\n  });\r\n}\r\n\r\n/**\r\n * Creates a lazy-loaded island\r\n */\r\ninterface LazyIslandOptions {\r\n  fallback?: React.ReactNode;\r\n  name?: string;\r\n}\r\n\r\nexport function createClientIsland(loader: () => Promise<any>, options: LazyIslandOptions = {}) {\r\n  const { fallback = null, name = 'lazy-island' } = options;\r\n\r\n  return function LazyIsland(props) {\r\n    const [Component, setComponent] = React.useState(null);\r\n    const [error, setError] = React.useState(null);\r\n\r\n    React.useEffect(() => {\r\n      loader()\r\n        .then(mod => setComponent(() => mod.default || mod))\r\n        .catch(err => setError(err));\r\n    }, []);\r\n\r\n    if (error) {\r\n      return React.createElement('div', {\r\n        className: 'island-error',\r\n        children: `Failed to load ${name}`\r\n      });\r\n    }\r\n\r\n    if (!Component) {\r\n      return fallback || React.createElement('div', {\r\n        className: 'island-loading',\r\n        children: 'Loading...'\r\n      });\r\n    }\r\n\r\n    return React.createElement(Component, props);\r\n  };\r\n}\r\n\r\n/**\r\n * Island with interaction trigger\r\n * Only hydrates when user interacts\r\n */\r\nexport function InteractiveIsland({ children, trigger = 'click', fallback }) {\r\n  const [shouldHydrate, setShouldHydrate] = React.useState(false);\r\n  const ref = React.useRef(null);\r\n\r\n  React.useEffect(() => {\r\n    const element = ref.current;\r\n    if (!element) return;\r\n\r\n    const handleInteraction = () => {\r\n      setShouldHydrate(true);\r\n    };\r\n\r\n    element.addEventListener(trigger, handleInteraction, { once: true });\r\n\r\n    return () => {\r\n      element.removeEventListener(trigger, handleInteraction);\r\n    };\r\n  }, [trigger]);\r\n\r\n  if (!shouldHydrate) {\r\n    return React.createElement('div', {\r\n      ref,\r\n      'data-interactive-island': 'true',\r\n      children: fallback || children\r\n    });\r\n  }\r\n\r\n  return children;\r\n}\r\n\r\n/**\r\n * Media query island\r\n * Only hydrates when media query matches\r\n */\r\nexport function MediaIsland({ children, query, fallback }) {\r\n  const [matches, setMatches] = React.useState(false);\r\n\r\n  React.useEffect(() => {\r\n    const mediaQuery = window.matchMedia(query);\r\n    setMatches(mediaQuery.matches);\r\n\r\n    const handler = (e) => setMatches(e.matches);\r\n    mediaQuery.addEventListener('change', handler);\r\n\r\n    return () => mediaQuery.removeEventListener('change', handler);\r\n  }, [query]);\r\n\r\n  if (!matches) {\r\n    return fallback || null;\r\n  }\r\n\r\n  return children;\r\n}\r\n\r\nexport default {\r\n  useIsland,\r\n  IslandBoundary,\r\n  createClientIsland,\r\n  InteractiveIsland,\r\n  MediaIsland\r\n};\r\n","'use client';\r\n\r\n/**\r\n * FlexiReact Link Component\r\n * Enhanced link with prefetching, client-side navigation, and loading states\r\n */\r\n\r\nimport React, { useCallback, useEffect, useRef, useState } from 'react';\r\n\r\nexport interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {\r\n  /** The URL to navigate to */\r\n  href: string;\r\n  /** Prefetch the page on hover/visibility */\r\n  prefetch?: boolean | 'hover' | 'viewport';\r\n  /** Replace the current history entry instead of pushing */\r\n  replace?: boolean;\r\n  /** Scroll to top after navigation */\r\n  scroll?: boolean;\r\n  /** Show loading indicator while navigating */\r\n  showLoading?: boolean;\r\n  /** Custom loading component */\r\n  loadingComponent?: React.ReactNode;\r\n  /** Callback when navigation starts */\r\n  onNavigationStart?: () => void;\r\n  /** Callback when navigation ends */\r\n  onNavigationEnd?: () => void;\r\n  /** Children */\r\n  children: React.ReactNode;\r\n}\r\n\r\n// Prefetch cache to avoid duplicate requests\r\nconst prefetchCache = new Set<string>();\r\n\r\n// Prefetch a URL\r\nasync function prefetchUrl(url: string): Promise<void> {\r\n  if (prefetchCache.has(url)) return;\r\n  \r\n  try {\r\n    // Mark as prefetched immediately to prevent duplicate requests\r\n    prefetchCache.add(url);\r\n    \r\n    // Use link preload for better browser optimization\r\n    const link = document.createElement('link');\r\n    link.rel = 'prefetch';\r\n    link.href = url;\r\n    link.as = 'document';\r\n    document.head.appendChild(link);\r\n    \r\n    // Also fetch the page to warm the cache\r\n    const controller = new AbortController();\r\n    const timeoutId = setTimeout(() => controller.abort(), 5000);\r\n    \r\n    await fetch(url, {\r\n      method: 'GET',\r\n      credentials: 'same-origin',\r\n      signal: controller.signal,\r\n      headers: {\r\n        'X-Flexi-Prefetch': '1',\r\n        'Accept': 'text/html'\r\n      }\r\n    });\r\n    \r\n    clearTimeout(timeoutId);\r\n  } catch (error) {\r\n    // Remove from cache on error so it can be retried\r\n    prefetchCache.delete(url);\r\n  }\r\n}\r\n\r\n// Check if URL is internal\r\nfunction isInternalUrl(url: string): boolean {\r\n  if (url.startsWith('/')) return true;\r\n  if (url.startsWith('#')) return true;\r\n  \r\n  try {\r\n    const parsed = new URL(url, window.location.origin);\r\n    return parsed.origin === window.location.origin;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n// Navigate to a URL\r\nfunction navigate(url: string, options: { replace?: boolean; scroll?: boolean } = {}): void {\r\n  const { replace = false, scroll = true } = options;\r\n  \r\n  if (replace) {\r\n    window.history.replaceState({}, '', url);\r\n  } else {\r\n    window.history.pushState({}, '', url);\r\n  }\r\n  \r\n  // Dispatch popstate event to trigger any listeners\r\n  window.dispatchEvent(new PopStateEvent('popstate', { state: {} }));\r\n  \r\n  // Scroll to top if requested\r\n  if (scroll) {\r\n    window.scrollTo({ top: 0, behavior: 'smooth' });\r\n  }\r\n}\r\n\r\n/**\r\n * Link component with prefetching and client-side navigation\r\n * \r\n * @example\r\n * ```tsx\r\n * import { Link } from '@flexireact/core/client';\r\n * \r\n * // Basic usage\r\n * <Link href=\"/about\">About</Link>\r\n * \r\n * // With prefetch on hover\r\n * <Link href=\"/products\" prefetch=\"hover\">Products</Link>\r\n * \r\n * // With prefetch on viewport visibility\r\n * <Link href=\"/contact\" prefetch=\"viewport\">Contact</Link>\r\n * \r\n * // Replace history instead of push\r\n * <Link href=\"/login\" replace>Login</Link>\r\n * \r\n * // Disable scroll to top\r\n * <Link href=\"/section#anchor\" scroll={false}>Go to section</Link>\r\n * ```\r\n */\r\nexport function Link({\r\n  href,\r\n  prefetch = true,\r\n  replace = false,\r\n  scroll = true,\r\n  showLoading = false,\r\n  loadingComponent,\r\n  onNavigationStart,\r\n  onNavigationEnd,\r\n  children,\r\n  className,\r\n  onClick,\r\n  onMouseEnter,\r\n  onFocus,\r\n  ...props\r\n}: LinkProps) {\r\n  const [isNavigating, setIsNavigating] = useState(false);\r\n  const linkRef = useRef<HTMLAnchorElement>(null);\r\n  const hasPrefetched = useRef(false);\r\n\r\n  // Prefetch on viewport visibility\r\n  useEffect(() => {\r\n    if (prefetch !== 'viewport' && prefetch !== true) return;\r\n    if (!isInternalUrl(href)) return;\r\n    if (hasPrefetched.current) return;\r\n\r\n    const observer = new IntersectionObserver(\r\n      (entries) => {\r\n        entries.forEach((entry) => {\r\n          if (entry.isIntersecting) {\r\n            prefetchUrl(href);\r\n            hasPrefetched.current = true;\r\n            observer.disconnect();\r\n          }\r\n        });\r\n      },\r\n      { rootMargin: '200px' }\r\n    );\r\n\r\n    if (linkRef.current) {\r\n      observer.observe(linkRef.current);\r\n    }\r\n\r\n    return () => observer.disconnect();\r\n  }, [href, prefetch]);\r\n\r\n  // Handle hover prefetch\r\n  const handleMouseEnter = useCallback(\r\n    (e: React.MouseEvent<HTMLAnchorElement>) => {\r\n      onMouseEnter?.(e);\r\n      \r\n      if ((prefetch === 'hover' || prefetch === true) && isInternalUrl(href)) {\r\n        prefetchUrl(href);\r\n      }\r\n    },\r\n    [href, prefetch, onMouseEnter]\r\n  );\r\n\r\n  // Handle focus prefetch (for keyboard navigation)\r\n  const handleFocus = useCallback(\r\n    (e: React.FocusEvent<HTMLAnchorElement>) => {\r\n      onFocus?.(e);\r\n      \r\n      if ((prefetch === 'hover' || prefetch === true) && isInternalUrl(href)) {\r\n        prefetchUrl(href);\r\n      }\r\n    },\r\n    [href, prefetch, onFocus]\r\n  );\r\n\r\n  // Handle click for client-side navigation\r\n  const handleClick = useCallback(\r\n    async (e: React.MouseEvent<HTMLAnchorElement>) => {\r\n      onClick?.(e);\r\n      \r\n      // Don't handle if default was prevented\r\n      if (e.defaultPrevented) return;\r\n      \r\n      // Don't handle if modifier keys are pressed (open in new tab, etc.)\r\n      if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;\r\n      \r\n      // Don't handle external URLs\r\n      if (!isInternalUrl(href)) return;\r\n      \r\n      // Don't handle if target is set\r\n      if (props.target && props.target !== '_self') return;\r\n      \r\n      // Prevent default navigation\r\n      e.preventDefault();\r\n      \r\n      // Start navigation\r\n      setIsNavigating(true);\r\n      onNavigationStart?.();\r\n      \r\n      try {\r\n        // Fetch the new page\r\n        const response = await fetch(href, {\r\n          method: 'GET',\r\n          credentials: 'same-origin',\r\n          headers: {\r\n            'X-Flexi-Navigation': '1',\r\n            'Accept': 'text/html'\r\n          }\r\n        });\r\n        \r\n        if (response.ok) {\r\n          const html = await response.text();\r\n          \r\n          // Parse and update the page\r\n          const parser = new DOMParser();\r\n          const doc = parser.parseFromString(html, 'text/html');\r\n          \r\n          // Update title\r\n          const newTitle = doc.querySelector('title')?.textContent;\r\n          if (newTitle) {\r\n            document.title = newTitle;\r\n          }\r\n          \r\n          // Update body content (or specific container)\r\n          const newContent = doc.querySelector('#root') || doc.body;\r\n          const currentContent = document.querySelector('#root') || document.body;\r\n          \r\n          if (newContent && currentContent) {\r\n            currentContent.innerHTML = newContent.innerHTML;\r\n          }\r\n          \r\n          // Update URL\r\n          navigate(href, { replace, scroll });\r\n        } else {\r\n          // Fallback to regular navigation on error\r\n          window.location.href = href;\r\n        }\r\n      } catch (error) {\r\n        // Fallback to regular navigation on error\r\n        window.location.href = href;\r\n      } finally {\r\n        setIsNavigating(false);\r\n        onNavigationEnd?.();\r\n      }\r\n    },\r\n    [href, replace, scroll, onClick, onNavigationStart, onNavigationEnd, props.target]\r\n  );\r\n\r\n  return (\r\n    <a\r\n      ref={linkRef}\r\n      href={href}\r\n      className={className}\r\n      onClick={handleClick}\r\n      onMouseEnter={handleMouseEnter}\r\n      onFocus={handleFocus}\r\n      data-prefetch={prefetch}\r\n      data-navigating={isNavigating || undefined}\r\n      {...props}\r\n    >\r\n      {showLoading && isNavigating ? (\r\n        loadingComponent || (\r\n          <span className=\"flexi-link-loading\">\r\n            <span className=\"flexi-link-spinner\" />\r\n            {children}\r\n          </span>\r\n        )\r\n      ) : (\r\n        children\r\n      )}\r\n    </a>\r\n  );\r\n}\r\n\r\n/**\r\n * Programmatic navigation function\r\n * \r\n * @example\r\n * ```tsx\r\n * import { useRouter } from '@flexireact/core/client';\r\n * \r\n * function MyComponent() {\r\n *   const router = useRouter();\r\n *   \r\n *   const handleClick = () => {\r\n *     router.push('/dashboard');\r\n *   };\r\n *   \r\n *   return <button onClick={handleClick}>Go to Dashboard</button>;\r\n * }\r\n * ```\r\n */\r\nexport function useRouter() {\r\n  return {\r\n    push(url: string, options?: { scroll?: boolean }) {\r\n      navigate(url, { replace: false, scroll: options?.scroll ?? true });\r\n      // Trigger page reload for now (full SPA navigation requires more work)\r\n      window.location.href = url;\r\n    },\r\n    \r\n    replace(url: string, options?: { scroll?: boolean }) {\r\n      navigate(url, { replace: true, scroll: options?.scroll ?? true });\r\n      window.location.href = url;\r\n    },\r\n    \r\n    back() {\r\n      window.history.back();\r\n    },\r\n    \r\n    forward() {\r\n      window.history.forward();\r\n    },\r\n    \r\n    prefetch(url: string) {\r\n      if (isInternalUrl(url)) {\r\n        prefetchUrl(url);\r\n      }\r\n    },\r\n    \r\n    refresh() {\r\n      window.location.reload();\r\n    }\r\n  };\r\n}\r\n\r\nexport default Link;\r\n"],"mappings":"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","names":["React","React","navigate","Link","prefetch"]}
+{"version":3,"sources":["../../../core/client/hydration.ts","../../../core/client/navigation.ts","../../../core/client/islands.ts","../../../core/client/Link.tsx"],"sourcesContent":["/**\r\n * FlexiReact Client Hydration\r\n * Handles selective hydration of islands and full app hydration\r\n */\r\n\r\nimport React from 'react';\r\nimport { hydrateRoot, createRoot } from 'react-dom/client';\r\n\r\n// Extend Window interface for __FLEXI_DATA__\r\ndeclare global {\r\n  interface Window {\r\n    __FLEXI_DATA__?: {\r\n      islands?: any[];\r\n      props?: Record<string, any>;\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Hydrates a specific island component\r\n * React 19: Uses built-in hydration error recovery\r\n */\r\nexport function hydrateIsland(islandId, Component, props) {\r\n  const element = document.querySelector(`[data-island=\"${islandId}\"]`);\r\n\r\n  if (!element) {\r\n    console.warn(`Island element not found: ${islandId}`);\r\n    return;\r\n  }\r\n\r\n  if (element.hasAttribute('data-hydrated')) {\r\n    return; // Already hydrated\r\n  }\r\n\r\n  // React 19: Built-in hydration error recovery\r\n  hydrateRoot(element, React.createElement(Component, props), {\r\n    onRecoverableError: (error, errorInfo) => {\r\n      console.warn(`[FlexiReact] Hydration mismatch in ${islandId}:`, error);\r\n      if (process.env.NODE_ENV === 'development') {\r\n        console.debug('Component stack:', errorInfo.componentStack);\r\n      }\r\n    }\r\n  });\r\n\r\n  element.setAttribute('data-hydrated', 'true');\r\n\r\n  // Dispatch custom event\r\n  element.dispatchEvent(new CustomEvent('flexi:hydrated', {\r\n    bubbles: true,\r\n    detail: { islandId, props }\r\n  }));\r\n}\r\n\r\n/**\r\n * Hydrates the entire application\r\n */\r\nexport function hydrateApp(App, props = {}) {\r\n  const root = document.getElementById('root');\r\n\r\n  if (!root) {\r\n    console.error('Root element not found');\r\n    return;\r\n  }\r\n\r\n  // Get server-rendered props\r\n  const serverProps = window.__FLEXI_DATA__?.props || {};\r\n  const mergedProps = { ...serverProps, ...props };\r\n\r\n  try {\r\n    hydrateRoot(root, React.createElement(App, mergedProps));\r\n  } catch (error) {\r\n    console.error('Hydration failed, falling back to full render:', error);\r\n    createRoot(root).render(React.createElement(App, mergedProps));\r\n  }\r\n}\r\n\r\n/**\r\n * Hydrates all islands on the page\r\n */\r\nexport async function hydrateAllIslands(islandModules) {\r\n  const islands = document.querySelectorAll('[data-island]');\r\n\r\n  for (const element of islands) {\r\n    if (element.hasAttribute('data-hydrated')) continue;\r\n\r\n    const islandId = element.getAttribute('data-island');\r\n    const islandName = element.getAttribute('data-island-name');\r\n    const propsJson = element.getAttribute('data-island-props');\r\n\r\n    try {\r\n      const props = propsJson ? JSON.parse(propsJson) : {};\r\n      const module = islandModules[islandName];\r\n\r\n      if (module) {\r\n        hydrateIsland(islandId, module.default || module, props);\r\n      }\r\n    } catch (error) {\r\n      console.error(`Failed to hydrate island ${islandName}:`, error);\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Progressive hydration based on visibility\r\n */\r\nexport function setupProgressiveHydration(islandModules) {\r\n  const observer = new IntersectionObserver(\r\n    (entries) => {\r\n      entries.forEach(async (entry) => {\r\n        if (!entry.isIntersecting) return;\r\n\r\n        const element = entry.target;\r\n        if (element.hasAttribute('data-hydrated')) return;\r\n\r\n        const islandName = element.getAttribute('data-island-name');\r\n        const islandId = element.getAttribute('data-island');\r\n        const propsJson = element.getAttribute('data-island-props');\r\n\r\n        try {\r\n          const props = propsJson ? JSON.parse(propsJson) : {};\r\n          const module = await islandModules[islandName]();\r\n\r\n          hydrateIsland(islandId, module.default || module, props);\r\n          observer.unobserve(element);\r\n        } catch (error) {\r\n          console.error(`Failed to hydrate island ${islandName}:`, error);\r\n        }\r\n      });\r\n    },\r\n    { rootMargin: '50px' }\r\n  );\r\n\r\n  document.querySelectorAll('[data-island]:not([data-hydrated])').forEach(el => {\r\n    observer.observe(el);\r\n  });\r\n\r\n  return observer;\r\n}\r\n\r\nexport default {\r\n  hydrateIsland,\r\n  hydrateApp,\r\n  hydrateAllIslands,\r\n  setupProgressiveHydration\r\n};\r\n","/**\r\n * FlexiReact Client Navigation\r\n * Client-side navigation with prefetching\r\n */\r\n\r\nimport React from 'react';\r\n\r\n// Navigation state\r\nconst navigationState: {\r\n  listeners: Set<(url: string) => void>;\r\n  prefetched: Set<string>;\r\n} = {\r\n  listeners: new Set(),\r\n  prefetched: new Set()\r\n};\r\n\r\n/**\r\n * Navigates to a new URL\r\n */\r\ninterface NavigateOptions {\r\n  replace?: boolean;\r\n  scroll?: boolean;\r\n}\r\n\r\nexport function navigate(url: string, options: NavigateOptions = {}) {\r\n  const { replace = false, scroll = true } = options;\r\n\r\n  if (replace) {\r\n    window.history.replaceState({}, '', url);\r\n  } else {\r\n    window.history.pushState({}, '', url);\r\n  }\r\n\r\n  // Dispatch navigation event\r\n  window.dispatchEvent(new CustomEvent('flexi:navigate', {\r\n    detail: { url, replace, scroll }\r\n  }));\r\n\r\n  // Scroll to top if needed\r\n  if (scroll) {\r\n    window.scrollTo(0, 0);\r\n  }\r\n\r\n  // Notify listeners\r\n  navigationState.listeners.forEach(listener => listener(url));\r\n\r\n  // Fetch and render new page\r\n  return fetchAndRender(url);\r\n}\r\n\r\n/**\r\n * Prefetches a URL for faster navigation\r\n */\r\nexport function prefetch(url) {\r\n  if (navigationState.prefetched.has(url)) {\r\n    return Promise.resolve();\r\n  }\r\n\r\n  navigationState.prefetched.add(url);\r\n\r\n  // Create a link element for prefetching\r\n  const link = document.createElement('link');\r\n  link.rel = 'prefetch';\r\n  link.href = url;\r\n  document.head.appendChild(link);\r\n\r\n  return Promise.resolve();\r\n}\r\n\r\n/**\r\n * Fetches and renders a new page\r\n */\r\nasync function fetchAndRender(url) {\r\n  try {\r\n    const response = await fetch(url, {\r\n      headers: {\r\n        'X-Flexi-Navigation': 'true'\r\n      }\r\n    });\r\n\r\n    if (!response.ok) {\r\n      throw new Error(`Navigation failed: ${response.status}`);\r\n    }\r\n\r\n    const html = await response.text();\r\n    \r\n    // Parse the HTML\r\n    const parser = new DOMParser();\r\n    const doc = parser.parseFromString(html, 'text/html');\r\n\r\n    // Update the page content\r\n    const newRoot = doc.getElementById('root');\r\n    const currentRoot = document.getElementById('root');\r\n\r\n    if (newRoot && currentRoot) {\r\n      currentRoot.innerHTML = newRoot.innerHTML;\r\n    }\r\n\r\n    // Update the title\r\n    document.title = doc.title;\r\n\r\n    // Update meta tags\r\n    updateMetaTags(doc);\r\n\r\n    // Re-hydrate islands\r\n    window.dispatchEvent(new CustomEvent('flexi:pageload'));\r\n\r\n  } catch (error) {\r\n    console.error('Navigation error:', error);\r\n    // Fallback to full page navigation\r\n    window.location.href = url;\r\n  }\r\n}\r\n\r\n/**\r\n * Updates meta tags from new document\r\n */\r\nfunction updateMetaTags(doc) {\r\n  // Remove old meta tags\r\n  document.querySelectorAll('meta[data-flexi]').forEach(el => el.remove());\r\n\r\n  // Add new meta tags\r\n  doc.querySelectorAll('meta').forEach(meta => {\r\n    if (meta.name || meta.property) {\r\n      const newMeta = meta.cloneNode(true);\r\n      newMeta.setAttribute('data-flexi', 'true');\r\n      document.head.appendChild(newMeta);\r\n    }\r\n  });\r\n}\r\n\r\n/**\r\n * Link component for client-side navigation\r\n */\r\nexport function Link({ href, children, prefetch: shouldPrefetch = true, replace = false, className, ...props }) {\r\n  const handleClick = (e) => {\r\n    // Allow normal navigation for external links or modified clicks\r\n    if (\r\n      e.ctrlKey ||\r\n      e.metaKey ||\r\n      e.shiftKey ||\r\n      e.button !== 0 ||\r\n      href.startsWith('http') ||\r\n      href.startsWith('//')\r\n    ) {\r\n      return;\r\n    }\r\n\r\n    e.preventDefault();\r\n    navigate(href, { replace });\r\n  };\r\n\r\n  const handleMouseEnter = () => {\r\n    if (shouldPrefetch) {\r\n      prefetch(href);\r\n    }\r\n  };\r\n\r\n  return React.createElement('a', {\r\n    href,\r\n    onClick: handleClick,\r\n    onMouseEnter: handleMouseEnter,\r\n    className,\r\n    ...props\r\n  }, children);\r\n}\r\n\r\n/**\r\n * Hook to listen for navigation events\r\n */\r\nexport function useNavigation() {\r\n  const [pathname, setPathname] = React.useState(\r\n    typeof window !== 'undefined' ? window.location.pathname : '/'\r\n  );\r\n\r\n  React.useEffect(() => {\r\n    const handleNavigation = (url) => {\r\n      setPathname(new URL(url, window.location.origin).pathname);\r\n    };\r\n\r\n    navigationState.listeners.add(handleNavigation);\r\n\r\n    const handlePopState = () => {\r\n      setPathname(window.location.pathname);\r\n      navigationState.listeners.forEach(listener => listener(window.location.pathname));\r\n    };\r\n\r\n    window.addEventListener('popstate', handlePopState);\r\n\r\n    return () => {\r\n      navigationState.listeners.delete(handleNavigation);\r\n      window.removeEventListener('popstate', handlePopState);\r\n    };\r\n  }, []);\r\n\r\n  return { pathname, navigate, prefetch };\r\n}\r\n\r\n// Setup popstate listener\r\nif (typeof window !== 'undefined') {\r\n  window.addEventListener('popstate', () => {\r\n    const url = window.location.pathname + window.location.search;\r\n    navigationState.listeners.forEach(listener => listener(url));\r\n  });\r\n}\r\n\r\nexport default {\r\n  navigate,\r\n  prefetch,\r\n  Link,\r\n  useNavigation\r\n};\r\n","/**\r\n * FlexiReact Client Islands\r\n * Client-side island utilities\r\n */\r\n\r\nimport React from 'react';\r\n\r\n/**\r\n * Hook to check if component is hydrated\r\n */\r\nexport function useIsland() {\r\n  const [isHydrated, setIsHydrated] = React.useState(false);\r\n\r\n  React.useEffect(() => {\r\n    setIsHydrated(true);\r\n  }, []);\r\n\r\n  return { isHydrated };\r\n}\r\n\r\n/**\r\n * Island boundary component\r\n * Wraps interactive components for partial hydration\r\n */\r\nexport function IslandBoundary({ children, fallback = null, name = 'island' }) {\r\n  const { isHydrated } = useIsland();\r\n\r\n  // On server or before hydration, render children normally\r\n  // The server will wrap this in the island marker\r\n  if (!isHydrated && fallback) {\r\n    return fallback;\r\n  }\r\n\r\n  return React.createElement('div', {\r\n    'data-island-boundary': name,\r\n    children\r\n  });\r\n}\r\n\r\n/**\r\n * Creates a lazy-loaded island\r\n */\r\ninterface LazyIslandOptions {\r\n  fallback?: React.ReactNode;\r\n  name?: string;\r\n}\r\n\r\nexport function createClientIsland(loader: () => Promise<any>, options: LazyIslandOptions = {}) {\r\n  const { fallback = null, name = 'lazy-island' } = options;\r\n\r\n  return function LazyIsland(props) {\r\n    const [Component, setComponent] = React.useState(null);\r\n    const [error, setError] = React.useState(null);\r\n\r\n    React.useEffect(() => {\r\n      loader()\r\n        .then(mod => setComponent(() => mod.default || mod))\r\n        .catch(err => setError(err));\r\n    }, []);\r\n\r\n    if (error) {\r\n      return React.createElement('div', {\r\n        className: 'island-error',\r\n        children: `Failed to load ${name}`\r\n      });\r\n    }\r\n\r\n    if (!Component) {\r\n      return fallback || React.createElement('div', {\r\n        className: 'island-loading',\r\n        children: 'Loading...'\r\n      });\r\n    }\r\n\r\n    return React.createElement(Component, props);\r\n  };\r\n}\r\n\r\n/**\r\n * Island with interaction trigger\r\n * Only hydrates when user interacts\r\n */\r\nexport function InteractiveIsland({ children, trigger = 'click', fallback }) {\r\n  const [shouldHydrate, setShouldHydrate] = React.useState(false);\r\n  const ref = React.useRef(null);\r\n\r\n  React.useEffect(() => {\r\n    const element = ref.current;\r\n    if (!element) return;\r\n\r\n    const handleInteraction = () => {\r\n      setShouldHydrate(true);\r\n    };\r\n\r\n    element.addEventListener(trigger, handleInteraction, { once: true });\r\n\r\n    return () => {\r\n      element.removeEventListener(trigger, handleInteraction);\r\n    };\r\n  }, [trigger]);\r\n\r\n  if (!shouldHydrate) {\r\n    return React.createElement('div', {\r\n      ref,\r\n      'data-interactive-island': 'true',\r\n      children: fallback || children\r\n    });\r\n  }\r\n\r\n  return children;\r\n}\r\n\r\n/**\r\n * Media query island\r\n * Only hydrates when media query matches\r\n */\r\nexport function MediaIsland({ children, query, fallback }) {\r\n  const [matches, setMatches] = React.useState(false);\r\n\r\n  React.useEffect(() => {\r\n    const mediaQuery = window.matchMedia(query);\r\n    setMatches(mediaQuery.matches);\r\n\r\n    const handler = (e) => setMatches(e.matches);\r\n    mediaQuery.addEventListener('change', handler);\r\n\r\n    return () => mediaQuery.removeEventListener('change', handler);\r\n  }, [query]);\r\n\r\n  if (!matches) {\r\n    return fallback || null;\r\n  }\r\n\r\n  return children;\r\n}\r\n\r\nexport default {\r\n  useIsland,\r\n  IslandBoundary,\r\n  createClientIsland,\r\n  InteractiveIsland,\r\n  MediaIsland\r\n};\r\n","'use client';\r\n\r\n/**\r\n * FlexiReact Link Component\r\n * Enhanced link with prefetching, client-side navigation, and loading states\r\n */\r\n\r\nimport React, { useCallback, useEffect, useRef, useState } from 'react';\r\n\r\nexport interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {\r\n  /** The URL to navigate to */\r\n  href: string;\r\n  /** Prefetch the page on hover/visibility */\r\n  prefetch?: boolean | 'hover' | 'viewport';\r\n  /** Replace the current history entry instead of pushing */\r\n  replace?: boolean;\r\n  /** Scroll to top after navigation */\r\n  scroll?: boolean;\r\n  /** Show loading indicator while navigating */\r\n  showLoading?: boolean;\r\n  /** Custom loading component */\r\n  loadingComponent?: React.ReactNode;\r\n  /** Callback when navigation starts */\r\n  onNavigationStart?: () => void;\r\n  /** Callback when navigation ends */\r\n  onNavigationEnd?: () => void;\r\n  /** \r\n   * Ref to the anchor element (React 19: ref as regular prop)\r\n   * No forwardRef wrapper needed in React 19\r\n   */\r\n  ref?: React.Ref<HTMLAnchorElement>;\r\n  /** Children */\r\n  children: React.ReactNode;\r\n}\r\n\r\n// Prefetch cache to avoid duplicate requests\r\nconst prefetchCache = new Set<string>();\r\n\r\n// Prefetch a URL\r\nasync function prefetchUrl(url: string): Promise<void> {\r\n  if (prefetchCache.has(url)) return;\r\n\r\n  try {\r\n    // Mark as prefetched immediately to prevent duplicate requests\r\n    prefetchCache.add(url);\r\n\r\n    // Use link preload for better browser optimization\r\n    const link = document.createElement('link');\r\n    link.rel = 'prefetch';\r\n    link.href = url;\r\n    link.as = 'document';\r\n    document.head.appendChild(link);\r\n\r\n    // Also fetch the page to warm the cache\r\n    const controller = new AbortController();\r\n    const timeoutId = setTimeout(() => controller.abort(), 5000);\r\n\r\n    await fetch(url, {\r\n      method: 'GET',\r\n      credentials: 'same-origin',\r\n      signal: controller.signal,\r\n      headers: {\r\n        'X-Flexi-Prefetch': '1',\r\n        'Accept': 'text/html'\r\n      }\r\n    });\r\n\r\n    clearTimeout(timeoutId);\r\n  } catch (error) {\r\n    // Remove from cache on error so it can be retried\r\n    prefetchCache.delete(url);\r\n  }\r\n}\r\n\r\n// Check if URL is internal\r\nfunction isInternalUrl(url: string): boolean {\r\n  if (url.startsWith('/')) return true;\r\n  if (url.startsWith('#')) return true;\r\n\r\n  try {\r\n    const parsed = new URL(url, window.location.origin);\r\n    return parsed.origin === window.location.origin;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n// Navigate to a URL\r\nfunction navigate(url: string, options: { replace?: boolean; scroll?: boolean } = {}): void {\r\n  const { replace = false, scroll = true } = options;\r\n\r\n  if (replace) {\r\n    window.history.replaceState({}, '', url);\r\n  } else {\r\n    window.history.pushState({}, '', url);\r\n  }\r\n\r\n  // Dispatch popstate event to trigger any listeners\r\n  window.dispatchEvent(new PopStateEvent('popstate', { state: {} }));\r\n\r\n  // Scroll to top if requested\r\n  if (scroll) {\r\n    window.scrollTo({ top: 0, behavior: 'smooth' });\r\n  }\r\n}\r\n\r\n/**\r\n * Link component with prefetching and client-side navigation\r\n * \r\n * @example\r\n * ```tsx\r\n * import { Link } from '@flexireact/core/client';\r\n * \r\n * // Basic usage\r\n * <Link href=\"/about\">About</Link>\r\n * \r\n * // With prefetch on hover\r\n * <Link href=\"/products\" prefetch=\"hover\">Products</Link>\r\n * \r\n * // With prefetch on viewport visibility\r\n * <Link href=\"/contact\" prefetch=\"viewport\">Contact</Link>\r\n * \r\n * // Replace history instead of push\r\n * <Link href=\"/login\" replace>Login</Link>\r\n * \r\n * // Disable scroll to top\r\n * <Link href=\"/section#anchor\" scroll={false}>Go to section</Link>\r\n * ```\r\n */\r\nexport function Link({\r\n  href,\r\n  prefetch = true,\r\n  replace = false,\r\n  scroll = true,\r\n  showLoading = false,\r\n  loadingComponent,\r\n  onNavigationStart,\r\n  onNavigationEnd,\r\n  children,\r\n  className,\r\n  onClick,\r\n  onMouseEnter,\r\n  onFocus,\r\n  ...props\r\n}: LinkProps) {\r\n  const [isNavigating, setIsNavigating] = useState(false);\r\n  const linkRef = useRef<HTMLAnchorElement>(null);\r\n  const hasPrefetched = useRef(false);\r\n\r\n  // Prefetch on viewport visibility\r\n  useEffect(() => {\r\n    if (prefetch !== 'viewport' && prefetch !== true) return;\r\n    if (!isInternalUrl(href)) return;\r\n    if (hasPrefetched.current) return;\r\n\r\n    const observer = new IntersectionObserver(\r\n      (entries) => {\r\n        entries.forEach((entry) => {\r\n          if (entry.isIntersecting) {\r\n            prefetchUrl(href);\r\n            hasPrefetched.current = true;\r\n            observer.disconnect();\r\n          }\r\n        });\r\n      },\r\n      { rootMargin: '200px' }\r\n    );\r\n\r\n    if (linkRef.current) {\r\n      observer.observe(linkRef.current);\r\n    }\r\n\r\n    return () => observer.disconnect();\r\n  }, [href, prefetch]);\r\n\r\n  // Handle hover prefetch\r\n  const handleMouseEnter = useCallback(\r\n    (e: React.MouseEvent<HTMLAnchorElement>) => {\r\n      onMouseEnter?.(e);\r\n\r\n      if ((prefetch === 'hover' || prefetch === true) && isInternalUrl(href)) {\r\n        prefetchUrl(href);\r\n      }\r\n    },\r\n    [href, prefetch, onMouseEnter]\r\n  );\r\n\r\n  // Handle focus prefetch (for keyboard navigation)\r\n  const handleFocus = useCallback(\r\n    (e: React.FocusEvent<HTMLAnchorElement>) => {\r\n      onFocus?.(e);\r\n\r\n      if ((prefetch === 'hover' || prefetch === true) && isInternalUrl(href)) {\r\n        prefetchUrl(href);\r\n      }\r\n    },\r\n    [href, prefetch, onFocus]\r\n  );\r\n\r\n  // Handle click for client-side navigation\r\n  const handleClick = useCallback(\r\n    async (e: React.MouseEvent<HTMLAnchorElement>) => {\r\n      onClick?.(e);\r\n\r\n      // Don't handle if default was prevented\r\n      if (e.defaultPrevented) return;\r\n\r\n      // Don't handle if modifier keys are pressed (open in new tab, etc.)\r\n      if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;\r\n\r\n      // Don't handle external URLs\r\n      if (!isInternalUrl(href)) return;\r\n\r\n      // Don't handle if target is set\r\n      if (props.target && props.target !== '_self') return;\r\n\r\n      // Prevent default navigation\r\n      e.preventDefault();\r\n\r\n      // Start navigation\r\n      setIsNavigating(true);\r\n      onNavigationStart?.();\r\n\r\n      try {\r\n        // Fetch the new page\r\n        const response = await fetch(href, {\r\n          method: 'GET',\r\n          credentials: 'same-origin',\r\n          headers: {\r\n            'X-Flexi-Navigation': '1',\r\n            'Accept': 'text/html'\r\n          }\r\n        });\r\n\r\n        if (response.ok) {\r\n          const html = await response.text();\r\n\r\n          // Parse and update the page\r\n          const parser = new DOMParser();\r\n          const doc = parser.parseFromString(html, 'text/html');\r\n\r\n          // Update title\r\n          const newTitle = doc.querySelector('title')?.textContent;\r\n          if (newTitle) {\r\n            document.title = newTitle;\r\n          }\r\n\r\n          // Update body content (or specific container)\r\n          const newContent = doc.querySelector('#root') || doc.body;\r\n          const currentContent = document.querySelector('#root') || document.body;\r\n\r\n          if (newContent && currentContent) {\r\n            currentContent.innerHTML = newContent.innerHTML;\r\n          }\r\n\r\n          // Update URL\r\n          navigate(href, { replace, scroll });\r\n        } else {\r\n          // Fallback to regular navigation on error\r\n          window.location.href = href;\r\n        }\r\n      } catch (error) {\r\n        // Fallback to regular navigation on error\r\n        window.location.href = href;\r\n      } finally {\r\n        setIsNavigating(false);\r\n        onNavigationEnd?.();\r\n      }\r\n    },\r\n    [href, replace, scroll, onClick, onNavigationStart, onNavigationEnd, props.target]\r\n  );\r\n\r\n  return (\r\n    <a\r\n      ref={linkRef}\r\n      href={href}\r\n      className={className}\r\n      onClick={handleClick}\r\n      onMouseEnter={handleMouseEnter}\r\n      onFocus={handleFocus}\r\n      data-prefetch={prefetch}\r\n      data-navigating={isNavigating || undefined}\r\n      {...props}\r\n    >\r\n      {showLoading && isNavigating ? (\r\n        loadingComponent || (\r\n          <span className=\"flexi-link-loading\">\r\n            <span className=\"flexi-link-spinner\" />\r\n            {children}\r\n          </span>\r\n        )\r\n      ) : (\r\n        children\r\n      )}\r\n    </a>\r\n  );\r\n}\r\n\r\n/**\r\n * Programmatic navigation function\r\n * \r\n * @example\r\n * ```tsx\r\n * import { useRouter } from '@flexireact/core/client';\r\n * \r\n * function MyComponent() {\r\n *   const router = useRouter();\r\n *   \r\n *   const handleClick = () => {\r\n *     router.push('/dashboard');\r\n *   };\r\n *   \r\n *   return <button onClick={handleClick}>Go to Dashboard</button>;\r\n * }\r\n * ```\r\n */\r\nexport function useRouter() {\r\n  return {\r\n    push(url: string, options?: { scroll?: boolean }) {\r\n      navigate(url, { replace: false, scroll: options?.scroll ?? true });\r\n      // Trigger page reload for now (full SPA navigation requires more work)\r\n      window.location.href = url;\r\n    },\r\n\r\n    replace(url: string, options?: { scroll?: boolean }) {\r\n      navigate(url, { replace: true, scroll: options?.scroll ?? true });\r\n      window.location.href = url;\r\n    },\r\n\r\n    back() {\r\n      window.history.back();\r\n    },\r\n\r\n    forward() {\r\n      window.history.forward();\r\n    },\r\n\r\n    prefetch(url: string) {\r\n      if (isInternalUrl(url)) {\r\n        prefetchUrl(url);\r\n      }\r\n    },\r\n\r\n    refresh() {\r\n      window.location.reload();\r\n    }\r\n  };\r\n}\r\n\r\nexport default Link;\r\n"],"mappings":"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","names":["React","React","navigate","Link","prefetch"]}

package/dist/core/index.js

@@ -2911,6 +2911,9 @@ function isMethod(request, method) {
 }
 
 // core/actions/index.ts
+import { useActionState, useOptimistic } from "react";
+import { useFormStatus } from "react-dom";
+import { useActionState as useActionStateReact } from "react";
 globalThis.__FLEXI_ACTIONS__ = globalThis.__FLEXI_ACTIONS__ || {};
 globalThis.__FLEXI_ACTION_CONTEXT__ = null;
 function serverAction(fn, actionId) {
@@ -3075,11 +3078,18 @@ function formAction(action) {
     }
   };
 }
+function useFlexiAction(action, initialState, permalink) {
+  return useActionStateReact(action, initialState, permalink);
+}
 function createFormState(action, initialState = null) {
+  if (typeof window !== "undefined" && process.env.NODE_ENV === "development") {
+    console.warn(
+      "[FlexiReact] createFormState is deprecated. Use useActionState from React 19 instead.\nSee migration guide: https://flexireact.dev/docs/react-19-migration"
+    );
+  }
   return {
     action,
     initialState,
-    // This will be enhanced on the client
     pending: false,
     error: null,
     data: initialState
@@ -5749,8 +5759,34 @@ var jsonLd = {
   })
 };
 
+// core/index.ts
+import { useActionState as useActionState3, useOptimistic as useOptimistic3 } from "react";
+import { useFormStatus as useFormStatus3 } from "react-dom";
+
+// core/hooks/index.ts
+import { useActionState as useActionState2, useOptimistic as useOptimistic2 } from "react";
+import { useFormStatus as useFormStatus2 } from "react-dom";
+import { use } from "react";
+
+// core/client/Link.tsx
+import { useCallback, useEffect, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+// core/hooks/index.ts
+import { use as use2, useOptimistic as useOptimisticReact } from "react";
+function useAsyncData(promise) {
+  return use2(promise);
+}
+function useOptimisticMutation(currentState, updateFn) {
+  return useOptimisticReact(currentState, updateFn);
+}
+function preloadResource(fetcher) {
+  const promise = fetcher();
+  return promise;
+}
+
 // core/devtools/index.ts
-import React7 from "react";
+import React8 from "react";
 var devToolsState = {
   routes: [],
   components: /* @__PURE__ */ new Map(),
@@ -5928,24 +5964,24 @@ function initNetworkInterceptor() {
   };
 }
 function DevToolsOverlay() {
-  const [state, setState] = React7.useState({
+  const [state, setState] = React8.useState({
     enabled: true,
     position: "bottom-right",
     expanded: false,
     activeTab: "routes",
     theme: "dark"
   });
-  const [data, setData] = React7.useState(devtools.getState());
-  React7.useEffect(() => {
+  const [data, setData] = React8.useState(devtools.getState());
+  React8.useEffect(() => {
     return devtools.subscribe(() => {
       setData(devtools.getState());
     });
   }, []);
-  React7.useEffect(() => {
+  React8.useEffect(() => {
     initPerformanceMonitoring();
     initNetworkInterceptor();
   }, []);
-  React7.useEffect(() => {
+  React8.useEffect(() => {
     const handler = (e) => {
       if (e.ctrlKey && e.shiftKey && e.key === "D") {
         setState((s) => ({ ...s, expanded: !s.expanded }));
@@ -5962,7 +5998,7 @@ function DevToolsOverlay() {
     "top-left": { top: 16, left: 16 }
   };
   if (!state.expanded) {
-    return React7.createElement("button", {
+    return React8.createElement("button", {
       onClick: () => setState((s) => ({ ...s, expanded: true })),
       style: {
         position: "fixed",
@@ -5983,7 +6019,7 @@ function DevToolsOverlay() {
       onMouseEnter: (e) => e.target.style.transform = "scale(1.1)",
       onMouseLeave: (e) => e.target.style.transform = "scale(1)",
       title: "FlexiReact DevTools (Ctrl+Shift+D)"
-    }, React7.createElement("span", { style: { fontSize: 24 } }, "\u26A1"));
+    }, React8.createElement("span", { style: { fontSize: 24 } }, "\u26A1"));
   }
   const tabs = [
     { id: "routes", label: "\u{1F5FA}\uFE0F Routes", count: data.routes.length },
@@ -5992,7 +6028,7 @@ function DevToolsOverlay() {
     { id: "performance", label: "\u{1F4CA} Performance", count: data.performance.length },
     { id: "console", label: "\u{1F4DD} Console", count: data.logs.length }
   ];
-  return React7.createElement("div", {
+  return React8.createElement("div", {
     style: {
       position: "fixed",
       ...positionStyles[state.position],
@@ -6010,7 +6046,7 @@ function DevToolsOverlay() {
     }
   }, [
     // Header
-    React7.createElement("div", {
+    React8.createElement("div", {
       key: "header",
       style: {
         display: "flex",
@@ -6021,14 +6057,14 @@ function DevToolsOverlay() {
         background: "#111"
       }
     }, [
-      React7.createElement("div", {
+      React8.createElement("div", {
         key: "title",
         style: { display: "flex", alignItems: "center", gap: 8 }
       }, [
-        React7.createElement("span", { key: "icon" }, "\u26A1"),
-        React7.createElement("span", { key: "text", style: { fontWeight: 600 } }, "FlexiReact DevTools")
+        React8.createElement("span", { key: "icon" }, "\u26A1"),
+        React8.createElement("span", { key: "text", style: { fontWeight: 600 } }, "FlexiReact DevTools")
       ]),
-      React7.createElement("button", {
+      React8.createElement("button", {
         key: "close",
         onClick: () => setState((s) => ({ ...s, expanded: false })),
         style: {
@@ -6041,7 +6077,7 @@ function DevToolsOverlay() {
       }, "\xD7")
     ]),
     // Tabs
-    React7.createElement("div", {
+    React8.createElement("div", {
       key: "tabs",
       style: {
         display: "flex",
@@ -6050,7 +6086,7 @@ function DevToolsOverlay() {
         overflowX: "auto"
       }
     }, tabs.map(
-      (tab) => React7.createElement("button", {
+      (tab) => React8.createElement("button", {
         key: tab.id,
         onClick: () => setState((s) => ({ ...s, activeTab: tab.id })),
         style: {
@@ -6066,7 +6102,7 @@ function DevToolsOverlay() {
       }, `${tab.label} (${tab.count})`)
     )),
     // Content
-    React7.createElement("div", {
+    React8.createElement("div", {
       key: "content",
       style: {
         padding: 16,
@@ -6079,11 +6115,11 @@ function DevToolsOverlay() {
 function renderTabContent(tab, data) {
   switch (tab) {
     case "routes":
-      return React7.createElement(
+      return React8.createElement(
         "div",
         { style: { display: "flex", flexDirection: "column", gap: 8 } },
-        data.routes.length === 0 ? React7.createElement("div", { style: { color: "#666", textAlign: "center", padding: 20 } }, "No routes tracked yet") : data.routes.map(
-          (route, i) => React7.createElement("div", {
+        data.routes.length === 0 ? React8.createElement("div", { style: { color: "#666", textAlign: "center", padding: 20 } }, "No routes tracked yet") : data.routes.map(
+          (route, i) => React8.createElement("div", {
             key: i,
             style: {
               padding: 12,
@@ -6092,8 +6128,8 @@ function renderTabContent(tab, data) {
               border: "1px solid #222"
             }
           }, [
-            React7.createElement("div", { key: "path", style: { fontWeight: 600, color: "#00FF9C" } }, route.path),
-            React7.createElement(
+            React8.createElement("div", { key: "path", style: { fontWeight: 600, color: "#00FF9C" } }, route.path),
+            React8.createElement(
               "div",
               { key: "component", style: { fontSize: 11, color: "#888", marginTop: 4 } },
               `Component: ${route.component} \u2022 ${route.loadTime}ms`
@@ -6102,11 +6138,11 @@ function renderTabContent(tab, data) {
         )
       );
     case "components":
-      return React7.createElement(
+      return React8.createElement(
         "div",
         { style: { display: "flex", flexDirection: "column", gap: 8 } },
-        data.components.length === 0 ? React7.createElement("div", { style: { color: "#666", textAlign: "center", padding: 20 } }, "No components tracked") : data.components.map(
-          (comp, i) => React7.createElement("div", {
+        data.components.length === 0 ? React8.createElement("div", { style: { color: "#666", textAlign: "center", padding: 20 } }, "No components tracked") : data.components.map(
+          (comp, i) => React8.createElement("div", {
             key: i,
             style: {
               padding: 12,
@@ -6115,12 +6151,12 @@ function renderTabContent(tab, data) {
               border: "1px solid #222"
             }
           }, [
-            React7.createElement("div", {
+            React8.createElement("div", {
               key: "name",
               style: { display: "flex", alignItems: "center", gap: 8 }
             }, [
-              React7.createElement("span", { key: "text", style: { fontWeight: 600 } }, comp.name),
-              comp.isIsland && React7.createElement("span", {
+              React8.createElement("span", { key: "text", style: { fontWeight: 600 } }, comp.name),
+              comp.isIsland && React8.createElement("span", {
                 key: "island",
                 style: {
                   fontSize: 10,
@@ -6131,7 +6167,7 @@ function renderTabContent(tab, data) {
                 }
               }, "Island")
             ]),
-            React7.createElement(
+            React8.createElement(
               "div",
               { key: "info", style: { fontSize: 11, color: "#888", marginTop: 4 } },
               `Renders: ${comp.renderCount} \u2022 Last: ${new Date(comp.lastRenderTime).toLocaleTimeString()}`
@@ -6140,11 +6176,11 @@ function renderTabContent(tab, data) {
         )
       );
     case "network":
-      return React7.createElement(
+      return React8.createElement(
         "div",
         { style: { display: "flex", flexDirection: "column", gap: 8 } },
-        data.network.length === 0 ? React7.createElement("div", { style: { color: "#666", textAlign: "center", padding: 20 } }, "No requests yet") : data.network.map(
-          (req, i) => React7.createElement("div", {
+        data.network.length === 0 ? React8.createElement("div", { style: { color: "#666", textAlign: "center", padding: 20 } }, "No requests yet") : data.network.map(
+          (req, i) => React8.createElement("div", {
             key: i,
             style: {
               padding: 12,
@@ -6153,11 +6189,11 @@ function renderTabContent(tab, data) {
               border: "1px solid #222"
             }
           }, [
-            React7.createElement("div", {
+            React8.createElement("div", {
               key: "url",
               style: { display: "flex", alignItems: "center", gap: 8 }
             }, [
-              React7.createElement("span", {
+              React8.createElement("span", {
                 key: "method",
                 style: {
                   fontSize: 10,
@@ -6168,7 +6204,7 @@ function renderTabContent(tab, data) {
                   fontWeight: 600
                 }
               }, req.method),
-              React7.createElement("span", {
+              React8.createElement("span", {
                 key: "status",
                 style: {
                   fontSize: 10,
@@ -6178,12 +6214,12 @@ function renderTabContent(tab, data) {
                   borderRadius: 4
                 }
               }, req.status || "ERR"),
-              React7.createElement("span", {
+              React8.createElement("span", {
                 key: "path",
                 style: { fontSize: 12, color: "#fff", overflow: "hidden", textOverflow: "ellipsis" }
               }, new URL(req.url, "http://localhost").pathname)
             ]),
-            React7.createElement(
+            React8.createElement(
               "div",
               { key: "info", style: { fontSize: 11, color: "#888", marginTop: 4 } },
               `${req.duration}ms \u2022 ${formatBytes2(req.size)}`
@@ -6192,11 +6228,11 @@ function renderTabContent(tab, data) {
         )
       );
     case "performance":
-      return React7.createElement(
+      return React8.createElement(
         "div",
         { style: { display: "flex", flexDirection: "column", gap: 8 } },
-        data.performance.length === 0 ? React7.createElement("div", { style: { color: "#666", textAlign: "center", padding: 20 } }, "Collecting metrics...") : data.performance.map(
-          (metric, i) => React7.createElement("div", {
+        data.performance.length === 0 ? React8.createElement("div", { style: { color: "#666", textAlign: "center", padding: 20 } }, "Collecting metrics...") : data.performance.map(
+          (metric, i) => React8.createElement("div", {
             key: i,
             style: {
               padding: 12,
@@ -6208,14 +6244,14 @@ function renderTabContent(tab, data) {
               alignItems: "center"
             }
           }, [
-            React7.createElement("span", { key: "name", style: { fontWeight: 600 } }, metric.name),
-            React7.createElement("div", { key: "value", style: { display: "flex", alignItems: "center", gap: 8 } }, [
-              React7.createElement(
+            React8.createElement("span", { key: "name", style: { fontWeight: 600 } }, metric.name),
+            React8.createElement("div", { key: "value", style: { display: "flex", alignItems: "center", gap: 8 } }, [
+              React8.createElement(
                 "span",
                 { key: "num" },
                 metric.name === "CLS" ? metric.value.toFixed(3) : `${Math.round(metric.value)}ms`
               ),
-              React7.createElement("span", {
+              React8.createElement("span", {
                 key: "rating",
                 style: {
                   width: 8,
@@ -6229,11 +6265,11 @@ function renderTabContent(tab, data) {
         )
       );
     case "console":
-      return React7.createElement(
+      return React8.createElement(
         "div",
         { style: { display: "flex", flexDirection: "column", gap: 4 } },
-        data.logs.length === 0 ? React7.createElement("div", { style: { color: "#666", textAlign: "center", padding: 20 } }, "No logs yet") : data.logs.map(
-          (log, i) => React7.createElement("div", {
+        data.logs.length === 0 ? React8.createElement("div", { style: { color: "#666", textAlign: "center", padding: 20 } }, "No logs yet") : data.logs.map(
+          (log, i) => React8.createElement("div", {
             key: i,
             style: {
               padding: "8px 12px",
@@ -6244,7 +6280,7 @@ function renderTabContent(tab, data) {
               color: log.level === "error" ? "#EF4444" : log.level === "warn" ? "#F59E0B" : "#888"
             }
           }, [
-            React7.createElement(
+            React8.createElement(
               "span",
               { key: "time", style: { color: "#444", marginRight: 8 } },
               new Date(log.timestamp).toLocaleTimeString()
@@ -6254,7 +6290,7 @@ function renderTabContent(tab, data) {
         )
       );
     default:
-      return React7.createElement("div", {}, "Unknown tab");
+      return React8.createElement("div", {}, "Unknown tab");
   }
 }
 function formatBytes2(bytes) {
@@ -6266,7 +6302,7 @@ function formatBytes2(bytes) {
 }
 
 // core/index.ts
-var VERSION = "3.0.0";
+var VERSION = "3.1.0";
 var core_default = {
   VERSION,
   createServer
@@ -6384,6 +6420,7 @@ export {
   parseSearchParams,
   pluginManager,
   pprFetch,
+  preloadResource,
   prerenderWithPPR,
   processServerComponent,
   reactCache,
@@ -6407,6 +6444,12 @@ export {
   text,
   unstable_cache,
   useActionContext,
+  useActionState3 as useActionState,
+  useAsyncData,
+  useFlexiAction,
+  useFormStatus3 as useFormStatus,
+  useOptimistic3 as useOptimistic,
+  useOptimisticMutation,
   useParams,
   usePathname,
   useQuery,