@uniweb/kit 0.1.4 → 0.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/kit",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Standard component library for Uniweb foundations",
   "type": "module",
   "exports": {
@@ -36,7 +36,7 @@
   },
   "dependencies": {
     "tailwind-merge": "^2.6.0",
-    "@uniweb/core": "0.1.6"
+    "@uniweb/core": "0.1.8"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/src/hooks/index.js

@@ -1 +1,2 @@
 export { useWebsite, default } from './useWebsite.js'
+export { useRouting } from './useRouting.js'

package/src/hooks/useRouting.js

@@ -0,0 +1,119 @@
+/**
+ * useRouting Hook
+ *
+ * Provides SSG-safe access to routing functionality.
+ *
+ * The runtime registers routing components (Link, useNavigate, useLocation, useParams)
+ * via the bridge pattern. This hook provides safe access that gracefully handles
+ * SSG/SSR contexts where the Router context isn't available.
+ *
+ * @example
+ * function NavItem({ route }) {
+ *   const { useLocation } = useRouting()
+ *   const location = useLocation()
+ *   const isActive = location.pathname === route
+ *   return <Link to={route} className={isActive ? 'active' : ''}>...</Link>
+ * }
+ */
+
+import { getUniweb } from '@uniweb/core'
+
+/**
+ * Default location object for SSG/SSR contexts
+ */
+const DEFAULT_LOCATION = {
+  pathname: '/',
+  search: '',
+  hash: '',
+  state: null,
+  key: 'default'
+}
+
+/**
+ * Default params object for SSG/SSR contexts
+ */
+const DEFAULT_PARAMS = {}
+
+/**
+ * Get routing utilities with SSG-safe fallbacks
+ * @returns {Object} Routing utilities
+ */
+export function useRouting() {
+  const uniweb = getUniweb()
+  const routing = uniweb?.routingComponents || {}
+
+  return {
+    /**
+     * SSG-safe useLocation hook
+     * Returns current location or defaults during SSG
+     * @returns {Object} Location object { pathname, search, hash, state, key }
+     */
+    useLocation: () => {
+      if (!routing.useLocation) {
+        return DEFAULT_LOCATION
+      }
+      try {
+        return routing.useLocation()
+      } catch {
+        // Router context not available (SSG/SSR)
+        return DEFAULT_LOCATION
+      }
+    },
+
+    /**
+     * SSG-safe useParams hook
+     * Returns route params or empty object during SSG
+     * @returns {Object} Params object
+     */
+    useParams: () => {
+      if (!routing.useParams) {
+        return DEFAULT_PARAMS
+      }
+      try {
+        return routing.useParams()
+      } catch {
+        // Router context not available (SSG/SSR)
+        return DEFAULT_PARAMS
+      }
+    },
+
+    /**
+     * SSG-safe useNavigate hook
+     * Returns navigate function or no-op during SSG
+     * @returns {Function} Navigate function
+     */
+    useNavigate: () => {
+      if (!routing.useNavigate) {
+        return () => {} // No-op during SSG
+      }
+      try {
+        return routing.useNavigate()
+      } catch {
+        // Router context not available (SSG/SSR)
+        return () => {}
+      }
+    },
+
+    /**
+     * Router Link component (or fallback to 'a')
+     * Use Kit's Link component instead for most cases
+     */
+    Link: routing.Link || 'a',
+
+    /**
+     * Check if routing is available (browser with Router context)
+     * @returns {boolean}
+     */
+    isRoutingAvailable: () => {
+      if (!routing.useLocation) return false
+      try {
+        routing.useLocation()
+        return true
+      } catch {
+        return false
+      }
+    }
+  }
+}
+
+export default useRouting

package/src/index.js

@@ -52,7 +52,7 @@ export { Disclaimer } from './components/Disclaimer/index.js'
 // Hooks
 // ============================================================================
 
-export { useWebsite } from './hooks/index.js'
+export { useWebsite, useRouting } from './hooks/index.js'
 
 // ============================================================================
 // Utilities