@chrryai/pepper 1.1.78

package/README.md

@@ -0,0 +1,159 @@
+# 🌶️ Pepper Router
+
+**Universal router for React** - Works seamlessly in web apps, React Native, and browser extensions with built-in view transitions.
+
+## ✨ Features
+
+- 🌍 **Universal** - One API for web, React Native, and browser extensions
+- ⚡ **Lightweight** - Zero dependencies, minimal bundle size
+- 🎨 **View Transitions** - Built-in support for smooth page transitions
+- 📱 **Platform-aware** - Automatically adapts to your environment
+- 🔒 **Type-safe** - Full TypeScript support
+- 🚀 **Battle-tested** - Powers [Vex](https://askvex.com)'s polished UX
+
+## 📦 Installation
+
+```bash
+npm install @askvex/pepper
+```
+
+## 🚀 Quick Start
+
+### Web (with View Transitions)
+
+```tsx
+import { HistoryRouterProvider, useNavigation } from "@askvex/pepper/web"
+
+function App() {
+  return (
+    <HistoryRouterProvider>
+      <YourApp />
+    </HistoryRouterProvider>
+  )
+}
+
+function YourComponent() {
+  const { navigate, pathname } = useNavigation()
+
+  return <button onClick={() => navigate("/about")}>Go to About</button>
+}
+```
+
+### React Native
+
+```tsx
+import { HistoryRouterProvider, useNavigation } from "@askvex/pepper/native"
+
+function App() {
+  return (
+    <HistoryRouterProvider>
+      <YourApp />
+    </HistoryRouterProvider>
+  )
+}
+```
+
+### Browser Extension
+
+```tsx
+import { HistoryRouterProvider, useNavigation } from "@askvex/pepper/extension"
+
+function App() {
+  return (
+    <HistoryRouterProvider>
+      <YourApp />
+    </HistoryRouterProvider>
+  )
+}
+```
+
+## 📖 API
+
+### `HistoryRouterProvider`
+
+Wrap your app with this provider to enable routing.
+
+```tsx
+<HistoryRouterProvider>
+  <App />
+</HistoryRouterProvider>
+```
+
+### `useNavigation()`
+
+Hook to access navigation functions and state.
+
+```tsx
+const {
+  navigate, // Navigate to a path
+  goBack, // Go back in history
+  goForward, // Go forward in history
+  pathname, // Current pathname
+  searchParams, // URL search params
+  hash, // URL hash
+} = useNavigation()
+```
+
+#### Methods
+
+- **`navigate(path: string, options?)`** - Navigate to a new path
+  - `options.replace?: boolean` - Replace current history entry
+  - `options.state?: any` - Pass state to the new route
+
+- **`goBack()`** - Navigate back in history
+- **`goForward()`** - Navigate forward in history
+
+### View Transitions (Web only)
+
+Pepper automatically uses the [View Transitions API](https://developer.mozilla.org/en-US/docs/Web/API/View_Transitions_API) when available for smooth page transitions.
+
+```tsx
+// Transitions happen automatically!
+navigate("/about") // ✨ Smooth transition
+```
+
+## 🎯 Why Pepper?
+
+Most routers are built for one platform. Pepper works everywhere:
+
+| Feature            | Pepper | React Router | Expo Router |
+| ------------------ | ------ | ------------ | ----------- |
+| Web                | ✅     | ✅           | ❌          |
+| React Native       | ✅     | ❌           | ✅          |
+| Browser Extensions | ✅     | ❌           | ❌          |
+| View Transitions   | ✅     | ❌           | ❌          |
+| Zero Config        | ✅     | ❌           | ❌          |
+
+## 🏗️ Platform Detection
+
+Pepper automatically detects your platform and uses the appropriate navigation method:
+
+- **Web**: Uses `window.history` API with view transitions
+- **React Native**: Uses in-memory history stack
+- **Extensions**: Uses extension-compatible history management
+
+## 📱 Examples
+
+Check out the [examples](./examples) directory for complete working examples:
+
+- [Web App](./examples/web)
+- [React Native App](./examples/native)
+- [Browser Extension](./examples/extension)
+
+## 🤝 Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](./CONTRIBUTING.md) for details.
+
+## 📄 License
+
+MIT © [Iliyan Velinov](https://github.com/askvex)
+
+## 🔗 Links
+
+- [GitHub](https://github.com/askvex/pepper)
+- [Issues](https://github.com/askvex/pepper/issues)
+- [Vex - Powered by Pepper](https://askvex.com)
+
+---
+
+Made with 🌶️ by the Vex team

package/dist/extension.d.mts

@@ -0,0 +1,3 @@
+export { ClientRouter, HistoryRouterProvider, NavigateOptions, RouterState, clientRouter, useHash, useHistoryRouter, useNavigation, usePathname, useRouter, useSearchParams } from './index.mjs';
+import 'react/jsx-runtime';
+import 'react';

package/dist/extension.d.ts

@@ -0,0 +1,3 @@
+export { ClientRouter, HistoryRouterProvider, NavigateOptions, RouterState, clientRouter, useHash, useHistoryRouter, useNavigation, usePathname, useRouter, useSearchParams } from './index.js';
+import 'react/jsx-runtime';
+import 'react';

package/dist/extension.js

@@ -0,0 +1,349 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/extension.ts
+var extension_exports = {};
+__export(extension_exports, {
+  ClientRouter: () => ClientRouter,
+  HistoryRouterProvider: () => HistoryRouterProvider,
+  clientRouter: () => clientRouter,
+  useHash: () => useHash,
+  useHistoryRouter: () => useHistoryRouter,
+  useNavigation: () => useNavigation,
+  usePathname: () => usePathname,
+  useRouter: () => useRouter,
+  useSearchParams: () => useSearchParams
+});
+module.exports = __toCommonJS(extension_exports);
+
+// src/core/ClientRouter.ts
+var ClientRouter = class {
+  // Track mobile swipe gestures
+  constructor() {
+    this.listeners = /* @__PURE__ */ new Set();
+    this.isProgrammaticNavigation = false;
+    this.lastNavigationTime = 0;
+    this.navigationDebounceMs = 10;
+    // Prevent double-tap navigation
+    this.isSwipeNavigation = false;
+    this.handlePopState = () => {
+      if (this.isProgrammaticNavigation) {
+        return;
+      }
+      console.log("\u{1F336}\uFE0F Native back/forward navigation (no view transition)");
+      this.state = this.getCurrentState();
+      this.notifyListeners();
+    };
+    this.handleHashChange = () => {
+      this.state = this.getCurrentState();
+      this.notifyListeners();
+    };
+    this.state = typeof window !== "undefined" && window.__ROUTER_STATE__ ? window.__ROUTER_STATE__ : this.getCurrentState();
+    this.supportsViewTransitions = typeof document !== "undefined" && "startViewTransition" in document;
+    if (typeof window !== "undefined") {
+      console.log(
+        "\u{1F336}\uFE0F Pepper Router: View Transitions supported:",
+        this.supportsViewTransitions
+      );
+    }
+    if (typeof window === "undefined") return;
+    window.addEventListener("popstate", this.handlePopState, { passive: true });
+    window.addEventListener("hashchange", this.handleHashChange, {
+      passive: true
+    });
+    this.setupSwipeDetection();
+  }
+  getCurrentState() {
+    if (typeof window === "undefined") {
+      return {
+        pathname: "",
+        searchParams: new URLSearchParams(),
+        hash: ""
+      };
+    }
+    const url = new URL(window.location.href);
+    return {
+      pathname: url.pathname,
+      searchParams: url.searchParams,
+      hash: url.hash
+    };
+  }
+  notifyListeners() {
+    this.listeners.forEach((listener) => listener());
+  }
+  setupSwipeDetection() {
+    if (typeof window === "undefined") return;
+    let touchStartX = 0;
+    let touchStartY = 0;
+    window.addEventListener(
+      "touchstart",
+      (e) => {
+        if (e.touches[0]) {
+          touchStartX = e.touches[0].clientX;
+          touchStartY = e.touches[0].clientY;
+        }
+      },
+      { passive: true }
+    );
+    window.addEventListener(
+      "touchmove",
+      (e) => {
+        if (!e.touches[0]) return;
+        const touchEndX = e.touches[0].clientX;
+        const touchEndY = e.touches[0].clientY;
+        const deltaX = touchEndX - touchStartX;
+        const deltaY = touchEndY - touchStartY;
+        const isHorizontalSwipe = Math.abs(deltaX) > Math.abs(deltaY);
+        const isFromEdge = touchStartX < 50 || touchStartX > window.innerWidth - 50;
+        if (isHorizontalSwipe && isFromEdge && Math.abs(deltaX) > 10) {
+          this.isSwipeNavigation = true;
+          console.log("\u{1F336}\uFE0F Swipe gesture detected - disabling view transitions");
+        }
+      },
+      { passive: true }
+    );
+    window.addEventListener(
+      "touchend",
+      () => {
+        setTimeout(() => {
+          this.isSwipeNavigation = false;
+        }, 500);
+      },
+      { passive: true }
+    );
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  push(href, options = {}) {
+    if (typeof window === "undefined") return;
+    const now = Date.now();
+    if (now - this.lastNavigationTime < this.navigationDebounceMs) {
+      console.log("\u{1F336}\uFE0F Navigation debounced (double-tap prevented)");
+      return;
+    }
+    this.lastNavigationTime = now;
+    this.isProgrammaticNavigation = true;
+    const url = new URL(href, window.location.origin);
+    const performNavigation = () => {
+      if (options.replace) {
+        window.history.replaceState({}, "", url.toString());
+      } else {
+        window.history.pushState({}, "", url.toString());
+      }
+      this.state = this.getCurrentState();
+      if (options.scroll !== false) {
+        window.scrollTo(0, 0);
+      }
+      this.notifyListeners();
+      queueMicrotask(() => {
+        this.isProgrammaticNavigation = false;
+      });
+    };
+    if (this.supportsViewTransitions && !options.shallow && !this.isSwipeNavigation) {
+      console.log("\u{1F336}\uFE0F Using View Transition for navigation to:", href);
+      document.startViewTransition(performNavigation);
+    } else {
+      if (this.isSwipeNavigation) {
+        console.log("\u{1F336}\uFE0F Swipe navigation - skipping view transition");
+      }
+      performNavigation();
+    }
+  }
+  replace(href, options = {}) {
+    this.push(href, { ...options, replace: true });
+  }
+  /**
+   * Prefetch a route to warm up the cache
+   * Useful for hover/focus prefetching
+   */
+  prefetch(url) {
+    if (typeof window === "undefined") return;
+    try {
+      fetch(url, { method: "HEAD", mode: "no-cors" }).catch(() => {
+      });
+    } catch {
+    }
+  }
+  /**
+   * Get current router state (useful for SSR hydration)
+   */
+  getState() {
+    return this.state;
+  }
+  refresh() {
+    if (typeof window === "undefined") return;
+    this.state = this.getCurrentState();
+    this.notifyListeners();
+    window.scrollTo(0, 0);
+  }
+  back() {
+    if (typeof window === "undefined") return;
+    window.history.back();
+  }
+  forward() {
+    if (typeof window === "undefined") return;
+    window.history.forward();
+  }
+  destroy() {
+    if (typeof window === "undefined") return;
+    window.removeEventListener("popstate", this.handlePopState);
+    window.removeEventListener("hashchange", this.handleHashChange);
+    this.listeners.clear();
+  }
+  // Get cached View Transitions support status
+  hasViewTransitions() {
+    return this.supportsViewTransitions;
+  }
+};
+var clientRouter = new ClientRouter();
+
+// src/providers/HistoryRouterProvider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var HistoryRouterContext = (0, import_react.createContext)(
+  null
+);
+function useHistoryRouter() {
+  const context = (0, import_react.useContext)(HistoryRouterContext);
+  if (!context) {
+    throw new Error(
+      "useHistoryRouter must be used within HistoryRouterProvider"
+    );
+  }
+  return context;
+}
+function HistoryRouterProvider({
+  children
+}) {
+  const [state, setState] = (0, import_react.useState)(() => clientRouter.getState());
+  const [updateTrigger, setUpdateTrigger] = (0, import_react.useState)(0);
+  (0, import_react.useEffect)(() => {
+    const unsubscribe = clientRouter.subscribe(() => {
+      const newState = clientRouter.getState();
+      setState(newState);
+      setUpdateTrigger((prev) => prev + 1);
+    });
+    return () => {
+      unsubscribe();
+    };
+  }, []);
+  const forceUpdate = () => {
+    setState(clientRouter.getState());
+    setUpdateTrigger((prev) => prev + 1);
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    HistoryRouterContext.Provider,
+    {
+      value: {
+        pathname: state.pathname,
+        searchParams: state.searchParams,
+        hash: state.hash,
+        forceUpdate
+      },
+      children
+    }
+  );
+}
+
+// src/hooks/useNavigation.ts
+var import_react2 = require("react");
+function useRouter() {
+  return {
+    push: clientRouter.push.bind(clientRouter),
+    replace: clientRouter.replace.bind(clientRouter),
+    back: clientRouter.back.bind(clientRouter),
+    forward: clientRouter.forward.bind(clientRouter),
+    refresh: clientRouter.refresh.bind(clientRouter),
+    prefetch: clientRouter.prefetch.bind(clientRouter)
+  };
+}
+function usePathname() {
+  const [pathname, setPathname] = (0, import_react2.useState)(clientRouter.getState().pathname);
+  (0, import_react2.useEffect)(() => {
+    const unsubscribe = clientRouter.subscribe(() => {
+      setPathname(clientRouter.getState().pathname);
+    });
+    return () => {
+      unsubscribe();
+    };
+  }, []);
+  return pathname;
+}
+function useSearchParams() {
+  const [searchParams, setSearchParams] = (0, import_react2.useState)(
+    clientRouter.getState().searchParams
+  );
+  (0, import_react2.useEffect)(() => {
+    const unsubscribe = clientRouter.subscribe(() => {
+      setSearchParams(clientRouter.getState().searchParams);
+    });
+    return () => {
+      unsubscribe();
+    };
+  }, []);
+  return searchParams;
+}
+function useHash() {
+  const [hash, setHash] = (0, import_react2.useState)(clientRouter.getState().hash);
+  (0, import_react2.useEffect)(() => {
+    const unsubscribe = clientRouter.subscribe(() => {
+      setHash(clientRouter.getState().hash);
+    });
+    return () => {
+      unsubscribe();
+    };
+  }, []);
+  return hash;
+}
+function useNavigation() {
+  const router = useRouter();
+  const pathname = usePathname();
+  const searchParams = useSearchParams();
+  const hash = useHash();
+  return {
+    // Navigation methods
+    navigate: router.push,
+    replace: router.replace,
+    goBack: router.back,
+    goForward: router.forward,
+    refresh: router.refresh,
+    prefetch: router.prefetch,
+    // Current state
+    pathname,
+    searchParams,
+    hash
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ClientRouter,
+  HistoryRouterProvider,
+  clientRouter,
+  useHash,
+  useHistoryRouter,
+  useNavigation,
+  usePathname,
+  useRouter,
+  useSearchParams
+});
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/extension.ts","../src/core/ClientRouter.ts","../src/providers/HistoryRouterProvider.tsx","../src/hooks/useNavigation.ts"],"sourcesContent":["/**\n * 🌶️ Pepper Router - Browser Extension\n * Optimized for browser extensions (Chrome, Firefox, etc.)\n */\n\nexport * from \"./index\"\n","// Types\nexport interface NavigateOptions {\n  scroll?: boolean\n  shallow?: boolean\n  replace?: boolean // Use replaceState instead of pushState\n}\n\nexport interface RouterState {\n  pathname: string\n  searchParams: URLSearchParams\n  hash: string\n}\n\n// SSR hydration state\ndeclare global {\n  interface Window {\n    __ROUTER_STATE__?: RouterState\n  }\n}\n\nexport class ClientRouter {\n  private listeners: Set<() => void> = new Set()\n  private state: RouterState\n  private isProgrammaticNavigation = false\n  private supportsViewTransitions: boolean\n  private lastNavigationTime = 0\n  private navigationDebounceMs = 10 // Prevent double-tap navigation\n  private isSwipeNavigation = false // Track mobile swipe gestures\n\n  constructor() {\n    // SSR hydration: Use server state if available\n    this.state =\n      typeof window !== \"undefined\" && window.__ROUTER_STATE__\n        ? window.__ROUTER_STATE__\n        : this.getCurrentState()\n\n    // Cache View Transitions API support check\n    this.supportsViewTransitions =\n      typeof document !== \"undefined\" && \"startViewTransition\" in document\n\n    // Log support status for debugging\n    if (typeof window !== \"undefined\") {\n      console.log(\n        \"🌶️ Pepper Router: View Transitions supported:\",\n        this.supportsViewTransitions,\n      )\n    }\n\n    if (typeof window === \"undefined\") return\n\n    // Listen to browser navigation events (passive for better performance)\n    window.addEventListener(\"popstate\", this.handlePopState, { passive: true })\n    window.addEventListener(\"hashchange\", this.handleHashChange, {\n      passive: true,\n    })\n\n    // Detect mobile swipe gestures for back/forward navigation\n    this.setupSwipeDetection()\n  }\n\n  private getCurrentState(): RouterState {\n    if (typeof window === \"undefined\") {\n      return {\n        pathname: \"\",\n        searchParams: new URLSearchParams(),\n        hash: \"\",\n      }\n    }\n    const url = new URL(window.location.href)\n    return {\n      pathname: url.pathname,\n      searchParams: url.searchParams,\n      hash: url.hash,\n    }\n  }\n\n  private handlePopState = () => {\n    // Ignore popstate during programmatic navigation\n    if (this.isProgrammaticNavigation) {\n      return\n    }\n\n    // Native browser back/forward (mobile swipe gestures, browser buttons)\n    // Don't use view transitions - let browser handle it natively for smooth UX\n    console.log(\"🌶️ Native back/forward navigation (no view transition)\")\n    this.state = this.getCurrentState()\n    this.notifyListeners()\n  }\n\n  private handleHashChange = () => {\n    this.state = this.getCurrentState()\n    this.notifyListeners()\n  }\n\n  private notifyListeners() {\n    this.listeners.forEach((listener) => listener())\n  }\n\n  private setupSwipeDetection() {\n    if (typeof window === \"undefined\") return\n\n    let touchStartX = 0\n    let touchStartY = 0\n\n    window.addEventListener(\n      \"touchstart\",\n      (e) => {\n        if (e.touches[0]) {\n          touchStartX = e.touches[0].clientX\n          touchStartY = e.touches[0].clientY\n        }\n      },\n      { passive: true },\n    )\n\n    window.addEventListener(\n      \"touchmove\",\n      (e) => {\n        if (!e.touches[0]) return\n\n        const touchEndX = e.touches[0].clientX\n        const touchEndY = e.touches[0].clientY\n\n        const deltaX = touchEndX - touchStartX\n        const deltaY = touchEndY - touchStartY\n\n        // Detect horizontal swipe from screen edge (back/forward gesture)\n        // iOS Safari: swipe from left edge = back, right edge = forward\n        const isHorizontalSwipe = Math.abs(deltaX) > Math.abs(deltaY)\n        const isFromEdge =\n          touchStartX < 50 || touchStartX > window.innerWidth - 50\n\n        if (isHorizontalSwipe && isFromEdge && Math.abs(deltaX) > 10) {\n          this.isSwipeNavigation = true\n          console.log(\"🌶️ Swipe gesture detected - disabling view transitions\")\n        }\n      },\n      { passive: true },\n    )\n\n    window.addEventListener(\n      \"touchend\",\n      () => {\n        // Reset swipe flag after a delay\n        setTimeout(() => {\n          this.isSwipeNavigation = false\n        }, 500)\n      },\n      { passive: true },\n    )\n  }\n\n  subscribe(listener: () => void) {\n    this.listeners.add(listener)\n    return () => {\n      this.listeners.delete(listener)\n    }\n  }\n\n  push(href: string, options: NavigateOptions = {}) {\n    if (typeof window === \"undefined\") return\n\n    // Debounce: Prevent double navigation (mobile double-tap)\n    const now = Date.now()\n    if (now - this.lastNavigationTime < this.navigationDebounceMs) {\n      console.log(\"🌶️ Navigation debounced (double-tap prevented)\")\n      return\n    }\n    this.lastNavigationTime = now\n\n    this.isProgrammaticNavigation = true\n    const url = new URL(href, window.location.origin)\n\n    const performNavigation = () => {\n      // Support both push and replace\n      if (options.replace) {\n        window.history.replaceState({}, \"\", url.toString())\n      } else {\n        window.history.pushState({}, \"\", url.toString())\n      }\n\n      this.state = this.getCurrentState()\n\n      if (options.scroll !== false) {\n        window.scrollTo(0, 0)\n      }\n\n      this.notifyListeners()\n\n      // Use queueMicrotask for better performance than setTimeout\n      queueMicrotask(() => {\n        this.isProgrammaticNavigation = false\n      })\n    }\n\n    // Use cached View Transitions API check\n    // Skip transitions during swipe gestures to avoid conflicts with native animations\n    if (\n      this.supportsViewTransitions &&\n      !options.shallow &&\n      !this.isSwipeNavigation\n    ) {\n      console.log(\"🌶️ Using View Transition for navigation to:\", href)\n      document.startViewTransition(performNavigation)\n    } else {\n      if (this.isSwipeNavigation) {\n        console.log(\"🌶️ Swipe navigation - skipping view transition\")\n      }\n      performNavigation()\n    }\n  }\n\n  replace(href: string, options: NavigateOptions = {}) {\n    // Delegate to push with replace option\n    this.push(href, { ...options, replace: true })\n  }\n\n  /**\n   * Prefetch a route to warm up the cache\n   * Useful for hover/focus prefetching\n   */\n  prefetch(url: string) {\n    if (typeof window === \"undefined\") return\n\n    try {\n      // HEAD request to warm up cache without downloading full content\n      fetch(url, { method: \"HEAD\", mode: \"no-cors\" }).catch(() => {\n        // Silently fail - prefetch is a hint, not critical\n      })\n    } catch {\n      // Ignore prefetch errors\n    }\n  }\n\n  /**\n   * Get current router state (useful for SSR hydration)\n   */\n  getState(): RouterState {\n    return this.state\n  }\n\n  refresh() {\n    if (typeof window === \"undefined\") return\n    // Force refresh by updating state and notifying listeners\n    this.state = this.getCurrentState()\n    this.notifyListeners()\n    // Scroll to top on refresh\n    window.scrollTo(0, 0)\n  }\n\n  back() {\n    if (typeof window === \"undefined\") return\n    window.history.back()\n  }\n\n  forward() {\n    if (typeof window === \"undefined\") return\n    window.history.forward()\n  }\n\n  destroy() {\n    if (typeof window === \"undefined\") return\n    window.removeEventListener(\"popstate\", this.handlePopState)\n    window.removeEventListener(\"hashchange\", this.handleHashChange)\n    this.listeners.clear()\n  }\n\n  // Get cached View Transitions support status\n  hasViewTransitions() {\n    return this.supportsViewTransitions\n  }\n}\n\n// Create singleton instance\nexport const clientRouter = new ClientRouter()\n","/**\n * HistoryRouterProvider - Makes window.history changes trigger React re-renders\n *\n * This provider ensures that when clientRouter.push() is called,\n * all components using pathname/searchParams will re-render properly\n */\n\nimport {\n  createContext,\n  useContext,\n  useEffect,\n  useState,\n  ReactNode,\n} from \"react\"\nimport { clientRouter } from \"../core/ClientRouter\"\n\ninterface HistoryRouterContextValue {\n  pathname: string\n  searchParams: URLSearchParams\n  hash: string\n  forceUpdate: () => void\n}\n\nconst HistoryRouterContext = createContext<HistoryRouterContextValue | null>(\n  null,\n)\n\nexport function useHistoryRouter() {\n  const context = useContext(HistoryRouterContext)\n  if (!context) {\n    throw new Error(\n      \"useHistoryRouter must be used within HistoryRouterProvider\",\n    )\n  }\n  return context\n}\n\ninterface HistoryRouterProviderProps {\n  children: ReactNode\n}\n\n/**\n * HistoryRouterProvider\n *\n * Wraps the app and listens to window.history changes,\n * triggering React re-renders when navigation occurs\n *\n * @example\n * ```tsx\n * <HistoryRouterProvider>\n *   <App />\n * </HistoryRouterProvider>\n * ```\n */\nexport function HistoryRouterProvider({\n  children,\n}: HistoryRouterProviderProps) {\n  const [state, setState] = useState(() => clientRouter.getState())\n  const [updateTrigger, setUpdateTrigger] = useState(0)\n\n  useEffect(() => {\n    // Subscribe to router changes\n    const unsubscribe = clientRouter.subscribe(() => {\n      const newState = clientRouter.getState()\n      setState(newState)\n      setUpdateTrigger((prev) => prev + 1)\n    })\n\n    return () => {\n      unsubscribe()\n    }\n  }, [])\n\n  const forceUpdate = () => {\n    setState(clientRouter.getState())\n    setUpdateTrigger((prev) => prev + 1)\n  }\n\n  return (\n    <HistoryRouterContext.Provider\n      value={{\n        pathname: state.pathname,\n        searchParams: state.searchParams,\n        hash: state.hash,\n        forceUpdate,\n      }}\n    >\n      {children}\n    </HistoryRouterContext.Provider>\n  )\n}\n","import { useEffect, useState } from \"react\"\nimport { clientRouter, NavigateOptions } from \"../core/ClientRouter\"\n\nexport function useRouter() {\n  return {\n    push: clientRouter.push.bind(clientRouter),\n    replace: clientRouter.replace.bind(clientRouter),\n    back: clientRouter.back.bind(clientRouter),\n    forward: clientRouter.forward.bind(clientRouter),\n    refresh: clientRouter.refresh.bind(clientRouter),\n    prefetch: clientRouter.prefetch.bind(clientRouter),\n  }\n}\n\nexport function usePathname() {\n  const [pathname, setPathname] = useState(clientRouter.getState().pathname)\n\n  useEffect(() => {\n    const unsubscribe = clientRouter.subscribe(() => {\n      setPathname(clientRouter.getState().pathname)\n    })\n\n    return () => {\n      unsubscribe()\n    }\n  }, [])\n\n  return pathname\n}\n\nexport function useSearchParams() {\n  const [searchParams, setSearchParams] = useState(\n    clientRouter.getState().searchParams,\n  )\n\n  useEffect(() => {\n    const unsubscribe = clientRouter.subscribe(() => {\n      setSearchParams(clientRouter.getState().searchParams)\n    })\n\n    return () => {\n      unsubscribe()\n    }\n  }, [])\n\n  return searchParams\n}\n\nexport function useHash() {\n  const [hash, setHash] = useState(clientRouter.getState().hash)\n\n  useEffect(() => {\n    const unsubscribe = clientRouter.subscribe(() => {\n      setHash(clientRouter.getState().hash)\n    })\n\n    return () => {\n      unsubscribe()\n    }\n  }, [])\n\n  return hash\n}\n\n/**\n * Main navigation hook - provides all navigation methods and state\n *\n * @example\n * ```tsx\n * const { navigate, pathname, searchParams } = useNavigation()\n *\n * navigate('/about')\n * navigate('/search?q=pepper', { replace: true })\n * ```\n */\nexport function useNavigation() {\n  const router = useRouter()\n  const pathname = usePathname()\n  const searchParams = useSearchParams()\n  const hash = useHash()\n\n  return {\n    // Navigation methods\n    navigate: router.push,\n    replace: router.replace,\n    goBack: router.back,\n    goForward: router.forward,\n    refresh: router.refresh,\n    prefetch: router.prefetch,\n\n    // Current state\n    pathname,\n    searchParams,\n    hash,\n  }\n}\n"],"mappings":"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","names":["import_react"]}