@real-router/browser-plugin 0.6.2 → 0.7.0

package/README.md

@@ -40,7 +40,7 @@ router.usePlugin(
   }),
 );
 
-router.start();
+await router.start();
 ```
 
 ---
@@ -66,7 +66,6 @@ router.navigate("products", { id: "123" });
 | `preserveHash`    | `boolean` | `true`  | Keep URL hash fragment during navigation. Only with `useHash: false` |
 | `base`            | `string`  | `""`    | Base path for all routes (e.g., `"/app"`)                            |
 | `forceDeactivate` | `boolean` | `true`  | Bypass `canDeactivate` guards on browser back/forward                |
-| `mergeState`      | `boolean` | `false` | Merge with existing `history.state`                                  |
 
 **Type Safety:** Options use discriminated union — `hashPrefix` and `preserveHash` are mutually exclusive at compile time.
 
@@ -79,6 +78,7 @@ See [Wiki](https://github.com/greydragon888/real-router/wiki/browser-plugin#3-co
 The plugin extends the router with browser-specific methods:
 
 #### `router.buildUrl(name: string, params?: Params): string`
+
 Build full URL with base path and hash prefix.\
 `name: string` — route name\
 `params?: Params` — route parameters\
@@ -86,16 +86,12 @@ Returns: `string` — full URL\
 [Wiki](https://github.com/greydragon888/real-router/wiki/browser-plugin#5-router-interaction)
 
 ```typescript
-const state = router.lastKnownState;
-// Returns frozen copy of state or undefined
-
-if (state) {
-  console.log("Last route:", state.name);
-  console.log("Parameters:", state.params);
-}
+router.buildUrl("users", { id: "123" });
+// => "/app/users/123" (with base "/app")
 ```
 
 #### `router.matchUrl(url: string): State | undefined`
+
 Parse URL to router state.\
 `url: string` — URL to parse\
 Returns: `State | undefined`\
@@ -112,6 +108,7 @@ router.navigate("page3");
 ```
 
 #### `router.replaceHistoryState(name: string, params?: Params, title?: string): void`
+
 Update browser URL without triggering navigation.\
 `name: string` — route name\
 `params?: Params` — route parameters\
@@ -123,11 +120,6 @@ Returns: `void`\
 router.replaceHistoryState("users", { id: "456" });
 ```
 
-#### `router.lastKnownState: State | undefined`
-Last successful navigation state (readonly).\
-Returns: `State | undefined`\
-[Wiki](https://github.com/greydragon888/real-router/wiki/browser-plugin#5-router-interaction)
-
 ---
 
 ## Usage Examples
@@ -169,12 +161,11 @@ router.usePlugin(
   }),
 );
 
-router.addDeactivateGuard("checkout", () => (toState, fromState, done) => {
-  if (hasUnsavedChanges()) {
-    done({ error: new Error("Unsaved changes") });
-  } else {
-    done();
-  }
+import { getLifecycleApi } from "@real-router/core";
+
+const lifecycle = getLifecycleApi(router);
+lifecycle.addDeactivateGuard("checkout", () => (toState, fromState) => {
+  return !hasUnsavedChanges(); // false blocks navigation
 });
 ```
 

package/dist/cjs/index.d.ts

@@ -16,13 +16,6 @@ interface BaseBrowserPluginOptions {
      * @default ""
      */
     base?: string;
-    /**
-     * Merge new state with existing history.state when updating.
-     * Useful for preserving external state set by other code.
-     *
-     * @default false
-     */
-    mergeState?: boolean;
 }
 /**
  * Hash-based routing configuration.
@@ -134,37 +127,21 @@ type BrowserPluginOptions = HashModeOptions | HistoryModeOptions;
  * Provides same interface in browser and SSR contexts.
  */
 interface Browser {
-    /**
-     * Gets base path from current browser location
-     *
-     * @returns Current pathname
-     */
-    getBase: () => string;
     /**
      * Pushes new state to browser history
      *
      * @param state - History state object
-     * @param title - Document title (usually ignored by browsers)
      * @param path - URL path
      */
-    pushState: (state: HistoryState, title: string | null, path: string) => void;
+    pushState: (state: State$1, path: string) => void;
     /**
      * Replaces current history state
      *
      * @param state - History state object
-     * @param title - Document title (usually ignored by browsers)
      * @param path - URL path
      */
-    replaceState: (state: HistoryState, title: string | null, path: string) => void;
-    /**
-     * Adds popstate/hashchange event listeners.
-     * Overloaded to support both PopStateEvent and HashChangeEvent.
-     *
-     * @param fn - Event handler
-     * @param opts - Plugin options
-     * @returns Cleanup function to remove listeners
-     */
-    addPopstateListener: ((fn: (evt: PopStateEvent) => void, opts: BrowserPluginOptions) => () => void) & ((fn: (evt: HashChangeEvent) => void, opts: BrowserPluginOptions) => () => void);
+    replaceState: (state: State$1, path: string) => void;
+    addPopstateListener: (fn: (evt: PopStateEvent) => void) => () => void;
     /**
      * Gets current location path respecting plugin options
      *
@@ -172,12 +149,6 @@ interface Browser {
      * @returns Current path string
      */
     getLocation: (opts: BrowserPluginOptions) => string;
-    /**
-     * Gets current history state with validation
-     *
-     * @returns Valid history state or undefined
-     */
-    getState: () => HistoryState | undefined;
     /**
      * Gets current URL hash
      *
@@ -185,24 +156,11 @@ interface Browser {
      */
     getHash: () => string;
 }
-/**
- * History state object stored in browser history.
- * Extends real-router State with additional properties that may be set by external code.
- */
-type HistoryState = State$1 & Record<string, unknown>;
 
 /**
  * Browser plugin factory for real-router.
  * Integrates router with browser history API.
  *
- * Features:
- * - Syncs router state with browser history (pushState/replaceState)
- * - Handles popstate events for browser back/forward navigation
- * - Supports hash-based routing for legacy browsers
- * - Provides URL building and matching utilities
- * - SSR-safe with graceful fallbacks
- * - Runtime validation warns about conflicting options
- *
  * @param opts - Plugin configuration options
  * @param browser - Browser API abstraction (for testing/SSR)
  * @returns Plugin factory function
@@ -261,17 +219,6 @@ interface Params {
  * isStateStrict({ name: 'home', params: 'invalid', path: '/' }); // false
  */
 declare function isStateStrict<P extends Params = Params, MP extends Params = Params>(value: unknown): value is State<P, MP>;
-/**
- * Type guard for HistoryState (browser plugin).
- * HistoryState must have meta object with specific structure.
- * This is stricter than regular State validation.
- *
- * @param value - Value to check
- * @returns true if value is a valid HistoryState object
- */
-declare function isHistoryState(value: unknown): value is State & {
-    meta: NonNullable<State["meta"]>;
-};
 
 /**
  * Module augmentation for real-router.
@@ -294,13 +241,8 @@ declare module "@real-router/core" {
          * Added by browser plugin.
          */
         replaceHistoryState: (name: string, params?: Params$1, title?: string) => void;
-        /**
-         * Last known router state.
-         * Added by browser plugin.
-         */
-        lastKnownState?: State$1;
         start(path?: string): Promise<State$1>;
     }
 }
 
-export { type Browser, type BrowserPluginOptions, type HistoryState, browserPluginFactory, isHistoryState, isStateStrict as isState };
+export { type Browser, type BrowserPluginOptions, browserPluginFactory, isStateStrict as isState };

package/dist/cjs/index.js

@@ -1 +1 @@
-var e=require("@real-router/core"),t=require("@real-router/logger"),r=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function n(e,t=new WeakSet){if(null==e)return!0;const r=typeof e;if("string"===r||"boolean"===r)return!0;if("number"===r)return Number.isFinite(e);if("function"===r||"symbol"===r)return!1;if(Array.isArray(e))return!t.has(e)&&(t.add(e),e.every(e=>n(e,t)));if("object"===r){if(t.has(e))return!1;t.add(e);const r=Object.getPrototypeOf(e);return(null===r||r===Object.prototype)&&Object.values(e).every(e=>n(e,t))}return!1}function a(e){if(null==e)return!0;const t=typeof e;return"string"===t||"boolean"===t||"number"===t&&Number.isFinite(e)}function o(e){if("object"!=typeof e||null===e||Array.isArray(e))return!1;const t=Object.getPrototypeOf(e);if(null!==t&&t!==Object.prototype)return!1;let r=!1;for(const t in e){if(!Object.hasOwn(e,t))continue;const n=e[t];if(!a(n)){const e=typeof n;if("function"===e||"symbol"===e)return!1;r=!0;break}}return!r||n(e)}function s(e){if(null==e)return!0;const t=typeof e;return"string"===t||"boolean"===t||("number"===t?Number.isFinite(e):!!Array.isArray(e)&&e.every(e=>{const t=typeof e;return"string"===t||"boolean"===t||"number"===t&&Number.isFinite(e)}))}function i(e){if("object"!=typeof e||null===e)return!1;const t=e;return!("params"in t&&!function(e){if("object"!=typeof e||null===e||Array.isArray(e))return!1;for(const t in e)if(Object.hasOwn(e,t)&&!s(e[t]))return!1;return!0}(t.params)||"id"in t&&"number"!=typeof t.id)}function l(e){return function(e){return"string"==typeof e&&(""===e||!(e.length>1e4)&&(!!e.startsWith("@@")||r.test(e)))}(e.name)&&"string"==typeof e.path&&o(e.params)}function c(e){if("object"!=typeof e||null===e)return!1;const t=e;return!!l(t)&&(void 0===t.meta||i(t.meta))}function u(e){if("object"!=typeof e||null===e)return!1;const t=e;return!!l(t)&&"meta"in t&&i(t.meta)}var h={forceDeactivate:!0,useHash:!1,hashPrefix:"",base:"",mergeState:!1,preserveHash:!0},p="popstate",f="browser-plugin",g=new Map,d=e=>{const t=g.get(e);if(void 0!==t)return t;const r=e.replaceAll(/[$()*+.?[\\\]^{|}-]/g,String.raw`\$&`);return g.set(e,r),r};function b(e,t,r,n,a){const o={meta:e.meta,name:e.name,params:e.params,path:e.path},s=a.mergeState&&n.getState()?{...n.getState(),...o}:o;r?n.replaceState(s,"",t):n.pushState(s,"",t)}function m(t,r,n,a,o,s,i){t&&t.code===e.errorCodes.CANNOT_DEACTIVATE&&r&&n&&!a&&b(n,o.buildUrl(n.name,n.params),!0,s,i)}function y(e,t){return e in t}function v(e,t,r){const n=typeof t;return n===r||void 0===t||(console.warn(`[${f}] Invalid type for '${e}': expected ${r}, got ${n}`),!1)}var S=()=>{},w=()=>globalThis.location.pathname,T=(()=>{let e,t=!1;return()=>{const r=globalThis.navigator.userAgent;return r!==e&&(e=r,t=!r.includes("Trident")),t}})(),$=(e,t,r)=>{globalThis.history.pushState(e,t??"",r)},P=(e,t,r)=>{globalThis.history.replaceState(e,t??"",r)},H=(e,t)=>{const r=t.useHash&&!T();return globalThis.addEventListener("popstate",e),r&&globalThis.addEventListener("hashchange",e),()=>{globalThis.removeEventListener("popstate",e),r&&globalThis.removeEventListener("hashchange",e)}},j=(()=>{const e=new Map;return t=>{let r=e.get(t);return r||(r=new RegExp(t),e.set(t,r)),r}})(),A=e=>{const{useHash:t,hashPrefix:r="",base:n=""}=e;if(!r&&!n){const e=t?globalThis.location.hash.slice(1):globalThis.location.pathname;return(O(e)||"/")+globalThis.location.search}const a=d(r),o=d(n),s=t?globalThis.location.hash.replace(j(`^#${a}`),""):globalThis.location.pathname.replace(j(`^${o}`),"");return(O(s)||"/")+globalThis.location.search},O=e=>{try{return encodeURI(decodeURI(e))}catch(r){return t.logger.warn(f,`Could not encode path "${e}"`,r),e}},x=()=>{if(globalThis.history.state){if(u(globalThis.history.state))return globalThis.history.state;t.logger.warn(f,"History state is not a valid state object, ignoring",globalThis.history.state)}},L=()=>globalThis.location.hash;exports.browserPluginFactory=function(r,n=function(){return void 0!==globalThis.window&&globalThis.history?{getBase:w,pushState:$,replaceState:P,addPopstateListener:H,getLocation:A,getState:x,getHash:L}:function(){let e=!1;const r=r=>{e||(t.logger.warn(f,`Browser plugin is running in a non-browser environment. Method "${r}" is a no-op. This is expected for SSR, but may indicate misconfiguration if you expected browser behavior.`),e=!0)};return{getBase:()=>(r("getBase"),""),pushState:()=>{r("pushState")},replaceState:()=>{r("replaceState")},addPopstateListener:()=>(r("addPopstateListener"),S),getLocation:()=>(r("getLocation"),""),getState:()=>{r("getState")},getHash:()=>(r("getHash"),"")}}()}()){const a=function(e,t){if(!e)return!1;let r=!1;for(const n of Object.keys(e))y(n,t)&&(v(n,e[n],typeof t[n])||(r=!0));if(!0===e.useHash&&"preserveHash"in e&&console.warn(`[${f}] preserveHash ignored in hash mode`),!1===e.useHash&&"hashPrefix"in e){const t=e.hashPrefix;void 0!==t&&""!==t&&console.warn(`[${f}] hashPrefix ignored in history mode`)}return r}(r,h);let o={...h,...r};a&&(console.warn(`[${f}] Using default options due to invalid types`),o={...h}),!0===o.useHash?delete o.preserveHash:delete o.hashPrefix,o.base&&"string"==typeof o.base&&(o.base.startsWith("/")||(o.base=`/${o.base}`),o.base.endsWith("/")&&(o.base=o.base.slice(0,-1)));const s=new Map,i=e=>{const t=s.get(e);if(void 0!==t)return t;const r=new RegExp(e);return s.set(e,r),r},l=o.forceDeactivate,u=void 0===l?{source:p,replace:!0}:{forceDeactivate:l,source:p,replace:!0};let g;return function(t){const r=t,a=e.getPluginApi(t),s=r.start;let l,h=!1,p=null;const y=()=>o.base??"",v=o.hashPrefix??"",S=d(v),w=o.useHash?`#${v}`:"",T=S?i(`^#${S}`):null;function $(){if(p){const e=p;p=null,console.warn(`[${f}] Processing deferred popstate event`),P(e)}}async function P(e){if(h)return console.warn(`[${f}] Transition in progress, deferring popstate event`),void(p=e);try{const t=r.getState(),s=function(e,t,r,n){return c(e.state)?t.makeState(e.state.name,e.state.params,e.state.path,{...e.state.meta,params:e.state.meta?.params??{}},e.state.meta?.id):t.matchPath(r.getLocation(n))}(e,a,n,o),i=!c(e.state);if(!s&&function(e,t,r){const n=t.getOptions(),{defaultRoute:a}=n;return!!a&&(e.navigateToDefault({...r,reload:!0,replace:!0}),!0)}(r,a,u))return;if(function(e,t,r){return!e||!(!t||!r.areStatesEqual(e,t,!1))}(s,t,r))return;if(!s)return;h=!0;try{m(void 0,await a.navigateToState(s,t,u),t,i,r,n,o)}catch(e){m(e,void 0,t,i,r,n,o)}finally{h=!1,$()}}catch(e){h=!1,console.error(`[${f}] Critical error in onPopState`,e);try{const e=r.getState();if(e){const t=r.buildUrl(e.name,e.params);n.replaceState(e,"",t)}}catch(e){console.error(`[${f}] Failed to recover from critical error`,e)}$()}}return r.start=e=>s(e??n.getLocation(o)),r.buildUrl=(e,t)=>{const n=r.buildPath(e,t);return y()+w+n},r.matchUrl=e=>{const t=(e=>{try{const t=new URL(e,globalThis.location.origin),r=t.pathname,n=t.hash,a=t.search,s=y();if(!["http:","https:"].includes(t.protocol))return console.warn(`[${f}] Invalid URL protocol in ${e}`),null;if(o.useHash)return(T?n.replace(T,""):n.slice(1))+a;if(s){const e=d(s),t=i(`^${e}`),n=r.replace(t,"");return(n.startsWith("/")?"":"/")+n+a}return r+a}catch(t){return console.warn(`[${f}] Could not parse url ${e}`,t),null}})(e);return t?a.matchPath(t):void 0},r.replaceHistoryState=(e,t={})=>{const s=a.buildState(e,t);if(!s)throw new Error(`[real-router] Cannot replace state: route "${e}" is not found`);b(a.makeState(s.name,s.params,r.buildPath(s.name,s.params),{params:s.meta},1),r.buildUrl(e,t),!0,n,o)},Object.defineProperty(r,"lastKnownState",{get:()=>l,set(e){l=e?Object.freeze({...e}):void 0},enumerable:!0,configurable:!0}),{onStart:()=>{g&&g(),g=n.addPopstateListener(e=>{P(e)},o)},onStop:()=>{g&&(g(),g=void 0)},onTransitionSuccess:(e,t,a)=>{r.lastKnownState=e;const s=(a.replace??!t)||!!a.reload&&r.areStatesEqual(e,t,!1),i=r.buildUrl(e.name,e.params);b(e,!o.preserveHash||t&&t.path!==e.path?i:i+n.getHash(),s,n,o)},teardown:()=>{g&&(g(),g=void 0),r.start=s,delete r.buildUrl,delete r.matchUrl,delete r.replaceHistoryState,delete r.lastKnownState}}}},exports.isHistoryState=u,exports.isState=c;//# sourceMappingURL=index.js.map
+var e=require("@real-router/core"),t=require("@real-router/logger"),r={forceDeactivate:!0,useHash:!1,hashPrefix:"",base:"",preserveHash:!0},n="popstate",o="browser-plugin",s=new Map,i=e=>{const t=s.get(e);if(void 0!==t)return t;const r=e.replaceAll(/[$()*+.?[\\\]^{|}-]/g,String.raw`\$&`);return s.set(e,r),r};function a(e,t,r,n){if(r.useHash){const e=i(r.hashPrefix);return(e?t.replace(n.get(`^#${e}`),""):t.slice(1))||"/"}if(r.base){const t=i(r.base),o=e.replace(n.get(`^${t}`),"");return o.startsWith("/")?o:`/${o}`}return e}function c(){const e=new Map;return{get(t){const r=e.get(t);if(void 0!==r)return r;const n=new RegExp(t);return e.set(t,n),n}}}var h=()=>{},u=(e,t)=>{globalThis.history.pushState(e,"",t)},p=(e,t)=>{globalThis.history.replaceState(e,"",t)},l=e=>(globalThis.addEventListener("popstate",e),()=>{globalThis.removeEventListener("popstate",e)}),f=c(),d=e=>(e=>{try{return encodeURI(decodeURI(e))}catch(r){return t.logger.warn(o,`Could not encode path "${e}"`,r),e}})(a(globalThis.location.pathname,globalThis.location.hash,e,f))+globalThis.location.search,g=()=>globalThis.location.hash;var m=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function b(e,t=new WeakSet){if(null==e)return!0;const r=typeof e;if("string"===r||"boolean"===r)return!0;if("number"===r)return Number.isFinite(e);if("function"===r||"symbol"===r)return!1;if(Array.isArray(e))return!t.has(e)&&(t.add(e),e.every(e=>b(e,t)));if("object"===r){if(t.has(e))return!1;t.add(e);const r=Object.getPrototypeOf(e);return(null===r||r===Object.prototype)&&Object.values(e).every(e=>b(e,t))}return!1}function v(e){if(null==e)return!0;const t=typeof e;return"string"===t||"boolean"===t||"number"===t&&Number.isFinite(e)}function y(e){if("object"!=typeof e||null===e||Array.isArray(e))return!1;const t=Object.getPrototypeOf(e);if(null!==t&&t!==Object.prototype)return!1;let r=!1;for(const t in e){if(!Object.hasOwn(e,t))continue;const n=e[t];if(!v(n)){const e=typeof n;if("function"===e||"symbol"===e)return!1;r=!0;break}}return!r||b(e)}function w(e){if(null==e)return!0;const t=typeof e;return"string"===t||"boolean"===t||("number"===t?Number.isFinite(e):!!Array.isArray(e)&&e.every(e=>{const t=typeof e;return"string"===t||"boolean"===t||"number"===t&&Number.isFinite(e)}))}function S(e){if("object"!=typeof e||null===e)return!1;const t=e;return!!function(e){return function(e){return"string"==typeof e&&(""===e||!(e.length>1e4)&&(!!e.startsWith("@@")||m.test(e)))}(e.name)&&"string"==typeof e.path&&y(e.params)}(t)&&(void 0===t.meta||function(e){if("object"!=typeof e||null===e)return!1;const t=e;return!("params"in t&&!function(e){if("object"!=typeof e||null===e||Array.isArray(e))return!1;for(const t in e)if(Object.hasOwn(e,t)&&!w(e[t]))return!1;return!0}(t.params)||"id"in t&&"number"!=typeof t.id)}(t.meta))}function P(e,t,r,n){const o={meta:e.meta,name:e.name,params:e.params,path:e.path};r?n.replaceState(o,t):n.pushState(o,t)}var $=class{#e;#t;#r;#n;#o;#s;#i;#a;#c=!1;#h=null;#u;constructor(e,t,r,n,o,s,i){this.#e=e,this.#t=t,this.#r=r,this.#n=n,this.#o=o,this.#i=s,this.#a=i,this.#s=r.useHash?`#${r.hashPrefix}`:"",this.#u=this.#t.addInterceptor("start",(e,t)=>e(t??this.#n.getLocation(this.#r))),this.#p()}getPlugin(){return{onStart:()=>{this.#a.removePopStateListener&&this.#a.removePopStateListener(),this.#a.removePopStateListener=this.#n.addPopstateListener(e=>{this.#l(e)})},onStop:()=>{this.#a.removePopStateListener&&(this.#a.removePopStateListener(),this.#a.removePopStateListener=void 0)},onTransitionSuccess:(e,t,r)=>{const n=(r.replace??!t)||!!r.reload&&this.#e.areStatesEqual(e,t,!1),o=this.#e.buildUrl(e.name,e.params);P(e,!this.#r.preserveHash||t&&t.path!==e.path?o:o+this.#n.getHash(),n,this.#n)},teardown:()=>{this.#f()}}}#p(){const e=this.#e;e.buildUrl=(t,r)=>{return n=e.buildPath(t,r),o=this.#r.base,s=this.#s,o+s+n;var n,o,s},e.matchUrl=e=>{const t=function(e,t,r){try{const n=new URL(e,globalThis.location.origin);return["http:","https:"].includes(n.protocol)?a(n.pathname,n.hash,t,r)+n.search:(console.warn(`[${o}] Invalid URL protocol in ${e}`),null)}catch(t){return console.warn(`[${o}] Could not parse url ${e}`,t),null}}(e,this.#r,this.#o);return t?this.#t.matchPath(t):void 0},e.replaceHistoryState=(t,r={})=>{const n=this.#t.buildState(t,r);if(!n)throw new Error(`[real-router] Cannot replace state: route "${t}" is not found`);P(this.#t.makeState(n.name,n.params,e.buildPath(n.name,n.params),{params:n.meta},1),e.buildUrl(t,r),!0,this.#n)}}#f(){this.#a.removePopStateListener&&(this.#a.removePopStateListener(),this.#a.removePopStateListener=void 0),this.#u(),delete this.#e.buildUrl,delete this.#e.matchUrl,delete this.#e.replaceHistoryState}#d(){if(this.#h){const e=this.#h;this.#h=null,console.warn(`[${o}] Processing deferred popstate event`),this.#l(e)}}async#l(t){if(this.#c)return console.warn(`[${o}] Transition in progress, deferring popstate event`),void(this.#h=t);this.#c=!0;try{const e=function(e,t,r,n){if(S(e.state))return{name:e.state.name,params:e.state.params};const o=t.matchPath(r.getLocation(n));return o?{name:o.name,params:o.params}:void 0}(t,this.#t,this.#n,this.#r);e?await this.#e.navigate(e.name,e.params,this.#i):await this.#e.navigateToDefault({...this.#i,reload:!0,replace:!0})}catch(t){t instanceof e.RouterError||this.#g(t)}finally{this.#c=!1,this.#d()}}#g(e){console.error(`[${o}] Critical error in onPopState`,e);try{const e=this.#e.getState();if(e){const t=this.#e.buildUrl(e.name,e.params);this.#n.replaceState(e,t)}}catch(e){console.error(`[${o}] Failed to recover from critical error`,e)}}};function L(e,t){return e in t}function x(e,t,r){const n=typeof t;return n===r||void 0===t||(console.warn(`[${o}] Invalid type for '${e}': expected ${r}, got ${n}`),!1)}exports.browserPluginFactory=function(s,i=function(){return void 0!==globalThis.window&&globalThis.history?{pushState:u,replaceState:p,addPopstateListener:l,getLocation:d,getHash:g}:function(){let e=!1;const r=r=>{e||(t.logger.warn(o,`Browser plugin is running in a non-browser environment. Method "${r}" is a no-op. This is expected for SSR, but may indicate misconfiguration if you expected browser behavior.`),e=!0)};return{pushState:()=>{r("pushState")},replaceState:()=>{r("replaceState")},addPopstateListener:()=>(r("addPopstateListener"),h),getLocation:()=>(r("getLocation"),""),getHash:()=>(r("getHash"),"")}}()}()){const a=function(e,t){if(!e)return!1;let r=!1;for(const n of Object.keys(e))L(n,t)&&(x(n,e[n],typeof t[n])||(r=!0));if(!0===e.useHash&&"preserveHash"in e&&console.warn(`[${o}] preserveHash ignored in hash mode`),!1===e.useHash&&"hashPrefix"in e){const t=e.hashPrefix;void 0!==t&&""!==t&&console.warn(`[${o}] hashPrefix ignored in history mode`)}return r}(s,r);let f={...r,...s};a&&(console.warn(`[${o}] Using default options due to invalid types`),f={...r}),!0===f.useHash?delete f.preserveHash:delete f.hashPrefix,f.base&&(f.base.startsWith("/")||(f.base=`/${f.base}`),f.base.endsWith("/")&&(f.base=f.base.slice(0,-1)));const m=c(),b=f.forceDeactivate,v=void 0===b?{source:n,replace:!0}:{forceDeactivate:b,source:n,replace:!0},y={removePopStateListener:void 0};return function(t){return new $(t,e.getPluginApi(t),f,i,m,v,y).getPlugin()}},exports.isState=S;//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/constants.ts","../../src/utils.ts","../../src/browser.ts","../../src/plugin.ts"],"names":["errorCodes","defaultOptions","rawPath","safePath","logger","getCachedRegExp","getPluginApi","getBase"],"mappings":"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","file":"index.js","sourcesContent":["// packages/browser-plugin/modules/constants.ts\n\n/**\n * Internal type for default options.\n *\n * Why separate type instead of BrowserPluginOptions?\n *\n * BrowserPluginOptions is a discriminated union:\n * - HashModeOptions: allows hashPrefix, forbids preserveHash (never)\n * - HistoryModeOptions: allows preserveHash, forbids hashPrefix (never)\n *\n * We cannot create a single object of type BrowserPluginOptions that contains\n * BOTH hashPrefix and preserveHash - one will always be 'never' depending on useHash.\n *\n * Example - this would fail TypeScript:\n * const defaults: BrowserPluginOptions = {\n *   useHash: false,      // → HistoryModeOptions branch\n *   preserveHash: true,  // ✅ OK\n *   hashPrefix: \"\"       // ❌ Error: Type 'string' is not assignable to type 'never'\n * };\n *\n * DefaultBrowserPluginOptions solves this by containing ALL options,\n * enabling:\n * - Default values for every option\n * - Type validation via typeof defaultOptions\n * - Runtime validation of user-provided option types\n */\nexport interface DefaultBrowserPluginOptions {\n  forceDeactivate: boolean;\n  useHash: boolean;\n  base: string;\n  mergeState: boolean;\n  preserveHash: boolean;\n  hashPrefix: string;\n}\n\nexport const defaultOptions: DefaultBrowserPluginOptions = {\n  forceDeactivate: true,\n  useHash: false,\n  hashPrefix: \"\",\n  base: \"\",\n  mergeState: false,\n  preserveHash: true,\n};\n\n/**\n * Source identifier for transitions triggered by browser events.\n * Used to distinguish browser-initiated navigation (back/forward buttons)\n * from programmatic navigation (router.navigate()).\n */\nexport const source = \"popstate\";\n\nexport const LOGGER_CONTEXT = \"browser-plugin\";\n","// packages/browser-plugin/modules/utils.ts\n\nimport { errorCodes } from \"@real-router/core\";\nimport { isStateStrict as isState } from \"type-guards\";\n\nimport { type DefaultBrowserPluginOptions, LOGGER_CONTEXT } from \"./constants\";\n\nimport type { BrowserPluginOptions, HistoryState, Browser } from \"./types\";\nimport type {\n  PluginApi,\n  Router,\n  NavigationOptions,\n  RouterError,\n  State,\n} from \"@real-router/core\";\n\n/**\n * No-op function for default callbacks\n */\nexport const noop = (): void => undefined;\n\n/**\n * Cache for escaped RegExp strings\n */\nconst escapeRegExpCache = new Map<string, string>();\n\n/**\n * Escapes special RegExp characters in a string.\n * Used to safely build RegExp from user-provided strings (hashPrefix, base).\n *\n * @param str - String to escape\n * @returns Escaped string safe for RegExp construction\n */\nexport const escapeRegExp = (str: string): string => {\n  const cached = escapeRegExpCache.get(str);\n\n  if (cached !== undefined) {\n    return cached;\n  }\n\n  const escaped = str.replaceAll(/[$()*+.?[\\\\\\]^{|}-]/g, String.raw`\\$&`);\n\n  escapeRegExpCache.set(str, escaped);\n\n  return escaped;\n};\n\n/**\n * Creates state from popstate event\n *\n * @param evt - PopStateEvent from browser\n * @param api - PluginApi instance\n * @param browser - Browser API instance\n * @param options - Browser plugin options\n * @returns Router state or undefined\n */\nexport function createStateFromEvent(\n  evt: PopStateEvent,\n  api: PluginApi,\n  browser: Browser,\n  options: BrowserPluginOptions,\n): State | undefined {\n  const isNewState = !isState(evt.state);\n\n  if (isNewState) {\n    return api.matchPath(browser.getLocation(options));\n  }\n\n  return api.makeState(\n    evt.state.name,\n    evt.state.params,\n    evt.state.path,\n    {\n      ...evt.state.meta,\n      params: evt.state.meta?.params ?? {},\n    },\n    evt.state.meta?.id,\n  );\n}\n\n/**\n * Checks if transition should be skipped (same states)\n *\n * @param newState - New state from event\n * @param currentState - Current router state\n * @param router - Router instance\n * @returns true if transition should be skipped\n */\nexport function shouldSkipTransition(\n  newState: State | undefined,\n  currentState: State | undefined,\n  router: Router,\n): boolean {\n  if (!newState) {\n    return true;\n  }\n\n  return !!(\n    currentState && router.areStatesEqual(newState, currentState, false)\n  );\n}\n\n/**\n * Handles missing state by navigating to default route\n *\n * @param router - Router instance\n * @param api - Plugin API instance\n * @param transitionOptions - Options for transition\n * @returns true if handled, false if no default route\n */\nexport function handleMissingState(\n  router: Router,\n  api: PluginApi,\n  transitionOptions: NavigationOptions,\n): boolean {\n  const routerOptions = api.getOptions();\n  const { defaultRoute } = routerOptions;\n\n  if (!defaultRoute) {\n    return false;\n  }\n\n  void router.navigateToDefault({\n    ...transitionOptions,\n    reload: true,\n    replace: true,\n  });\n\n  return true;\n}\n\n/**\n * Updates browser state (pushState or replaceState)\n *\n * @param state - Router state\n * @param url - URL to set\n * @param replace - Whether to replace instead of push\n * @param browser - Browser API instance\n * @param options - Browser plugin options\n */\nexport function updateBrowserState(\n  state: State,\n  url: string,\n  replace: boolean,\n  browser: Browser,\n  options: BrowserPluginOptions,\n): void {\n  const trimmedState: HistoryState = {\n    meta: state.meta,\n    name: state.name,\n    params: state.params,\n    path: state.path,\n  };\n\n  const finalState: HistoryState =\n    options.mergeState && browser.getState()\n      ? { ...browser.getState(), ...trimmedState }\n      : trimmedState;\n\n  if (replace) {\n    browser.replaceState(finalState, \"\", url);\n  } else {\n    browser.pushState(finalState, \"\", url);\n  }\n}\n\n/**\n * Handles transition result (success or error)\n *\n * Success case is handled by the router FSM chain (TRANSITION_SUCCESS event).\n * This function only handles error cases that need URL restoration.\n *\n * @param err - Router error or undefined if successful\n * @param toState - Target state\n * @param fromState - Source state\n * @param isNewState - Whether this is a new state (not from history)\n * @param router - Router instance\n * @param browser - Browser API instance\n * @param options - Browser plugin options\n */\nexport function handleTransitionResult(\n  err: RouterError | undefined,\n  toState: State | undefined,\n  fromState: State | undefined,\n  isNewState: boolean,\n  router: Router,\n  browser: Browser,\n  options: BrowserPluginOptions,\n): void {\n  // Success case handled by the router FSM chain (TRANSITION_SUCCESS event)\n  if (!err) {\n    return;\n  }\n\n  // Handle CANNOT_DEACTIVATE - restore previous URL\n  if (\n    err.code === errorCodes.CANNOT_DEACTIVATE &&\n    toState &&\n    fromState &&\n    !isNewState\n  ) {\n    const url = router.buildUrl(fromState.name, fromState.params);\n\n    updateBrowserState(fromState, url, true, browser, options);\n  }\n}\n\n/**\n * Type guard to check if a key exists in default options\n */\nfunction isDefaultOptionKey(\n  key: string,\n  defaults: DefaultBrowserPluginOptions,\n): key is keyof DefaultBrowserPluginOptions {\n  return key in defaults;\n}\n\n/**\n * Validates that an option value has the correct type\n */\nfunction validateOptionType(\n  key: keyof DefaultBrowserPluginOptions,\n  value: unknown,\n  expectedType: string,\n): boolean {\n  const actualType = typeof value;\n\n  if (actualType !== expectedType && value !== undefined) {\n    console.warn(\n      `[${LOGGER_CONTEXT}] Invalid type for '${key}': expected ${expectedType}, got ${actualType}`,\n    );\n\n    return false;\n  }\n\n  return true;\n}\n\n/**\n * Validates browser plugin options and warns about conflicting configurations.\n * TypeScript types prevent conflicts at compile-time, but runtime validation\n * is needed for JavaScript users and dynamic configurations.\n *\n * IMPORTANT: This validates only user-provided options, not merged defaults.\n *\n * @returns true if invalid types detected, false otherwise\n */\nexport function validateOptions(\n  opts: Partial<BrowserPluginOptions> | undefined,\n  defaultOptions: DefaultBrowserPluginOptions,\n): boolean {\n  if (!opts) {\n    return false;\n  }\n\n  let hasInvalidTypes = false;\n\n  // Validate option types against defaults\n  // Using Object.keys ensures we only check properties that actually exist\n  for (const key of Object.keys(opts)) {\n    if (isDefaultOptionKey(key, defaultOptions)) {\n      const expectedType = typeof defaultOptions[key];\n      const value = opts[key];\n      const isValid = validateOptionType(key, value, expectedType);\n\n      if (!isValid) {\n        hasInvalidTypes = true;\n      }\n    }\n  }\n\n  // Check for hash mode conflicts\n  // Runtime validation for JS users - TypeScript prevents this at compile time\n\n  if (opts.useHash === true && \"preserveHash\" in opts) {\n    console.warn(`[${LOGGER_CONTEXT}] preserveHash ignored in hash mode`);\n  }\n\n  // Check for history mode conflicts\n  // Runtime validation for JS users - TypeScript prevents this at compile time\n\n  if (opts.useHash === false && \"hashPrefix\" in opts) {\n    // Single type assertion needed: TypeScript narrows opts to HistoryModeOptions\n    // where hashPrefix is 'never', but we need to check it at runtime for JS users\n    const optsRecord = opts as unknown as Record<string, unknown>;\n    const hashPrefix = optsRecord.hashPrefix;\n\n    if (hashPrefix !== undefined && hashPrefix !== \"\") {\n      console.warn(`[${LOGGER_CONTEXT}] hashPrefix ignored in history mode`);\n    }\n  }\n\n  return hasInvalidTypes;\n}\n","// packages/browser-plugin/modules/browser.ts\n\nimport { logger } from \"@real-router/logger\";\nimport { isHistoryState } from \"type-guards\";\n\nimport { LOGGER_CONTEXT } from \"./constants\";\nimport { escapeRegExp } from \"./utils\";\n\nimport type { Browser, BrowserPluginOptions, HistoryState } from \"./types\";\nimport type { State } from \"@real-router/core\";\n\n/** No-operation cleanup function for fallback browser */\nconst NOOP = (): void => {};\n\n/**\n * Returns current base path from browser location\n */\nconst getBase = () => globalThis.location.pathname;\n\n/**\n * Detects if browser supports popstate events on hash changes.\n * Old IE (Trident engine) doesn't fire popstate on hashchange.\n * Uses memoization based on userAgent for performance while remaining testable.\n */\nconst supportsPopStateOnHashChange = (() => {\n  let cachedUserAgent: string | undefined;\n  let cachedResult = false;\n\n  return (): boolean => {\n    // Note: This function is only called from real browser's addPopstateListener,\n    // never from fallback browser (SSR), so window is guaranteed to exist\n    const currentUserAgent = globalThis.navigator.userAgent;\n\n    // Only recalculate if userAgent changed (or first call)\n    if (currentUserAgent !== cachedUserAgent) {\n      cachedUserAgent = currentUserAgent;\n      cachedResult = !currentUserAgent.includes(\"Trident\");\n    }\n\n    return cachedResult;\n  };\n})();\n\n/**\n * Pushes new state to browser history\n */\nconst pushState = (state: State, title: string | null, path: string | URL) => {\n  globalThis.history.pushState(state, title ?? \"\", path);\n};\n\n/**\n * Replaces current state in browser history\n */\nconst replaceState = (\n  state: State,\n  title: string | null,\n  path: string | URL,\n) => {\n  globalThis.history.replaceState(state, title ?? \"\", path);\n};\n\n/**\n * Adds popstate/hashchange event listeners based on browser capabilities\n *\n * @param fn - Event handler function\n * @param opts - Browser plugin options\n * @returns Cleanup function to remove listeners\n */\nconst addPopstateListener: Browser[\"addPopstateListener\"] = (fn, opts) => {\n  const needsHashChangeListener =\n    opts.useHash && !supportsPopStateOnHashChange();\n\n  globalThis.addEventListener(\"popstate\", fn as (evt: PopStateEvent) => void);\n\n  if (needsHashChangeListener) {\n    globalThis.addEventListener(\n      \"hashchange\",\n      fn as (evt: HashChangeEvent) => void,\n    );\n  }\n\n  return () => {\n    globalThis.removeEventListener(\n      \"popstate\",\n      fn as (evt: PopStateEvent) => void,\n    );\n\n    if (needsHashChangeListener) {\n      globalThis.removeEventListener(\n        \"hashchange\",\n        fn as (evt: HashChangeEvent) => void,\n      );\n    }\n  };\n};\n\n/**\n * Creates RegExp cache for getLocation optimization\n */\nconst createRegExpCache = () => {\n  const cache = new Map<string, RegExp>();\n\n  return (pattern: string): RegExp => {\n    let regex = cache.get(pattern);\n\n    if (!regex) {\n      regex = new RegExp(pattern);\n      cache.set(pattern, regex);\n    }\n\n    return regex;\n  };\n};\n\nconst getCachedRegExp = createRegExpCache();\n\n/**\n * Gets current location path from browser, respecting plugin options\n *\n * @param opts - Browser plugin options\n * @returns Current path string\n */\nconst getLocation = (opts: BrowserPluginOptions) => {\n  const { useHash, hashPrefix = \"\", base = \"\" } = opts;\n\n  // Optimization: skip RegExp for empty values\n  if (!hashPrefix && !base) {\n    const rawPath = useHash\n      ? globalThis.location.hash.slice(1)\n      : globalThis.location.pathname;\n    const safePath = safelyEncodePath(rawPath);\n\n    return (safePath || \"/\") + globalThis.location.search;\n  }\n\n  const escapedHashPrefix = escapeRegExp(hashPrefix);\n  const escapedBase = escapeRegExp(base);\n\n  const rawPath = useHash\n    ? globalThis.location.hash.replace(\n        getCachedRegExp(`^#${escapedHashPrefix}`),\n        \"\",\n      )\n    : globalThis.location.pathname.replace(\n        getCachedRegExp(`^${escapedBase}`),\n        \"\",\n      );\n\n  const safePath = safelyEncodePath(rawPath);\n\n  return (safePath || \"/\") + globalThis.location.search;\n};\n\n/**\n * Safely encodes/decodes path to normalize URL encoding\n *\n * @param path - Path to normalize\n * @returns Normalized path or original on error\n */\nconst safelyEncodePath = (path: string): string => {\n  try {\n    return encodeURI(decodeURI(path));\n  } catch (error) {\n    logger.warn(LOGGER_CONTEXT, `Could not encode path \"${path}\"`, error);\n\n    return path;\n  }\n};\n\n/**\n * Gets current history state with validation.\n * Returns undefined instead of throwing for safer error handling.\n *\n * @returns Valid history state or undefined\n */\nconst getState = (): HistoryState | undefined => {\n  if (!globalThis.history.state) {\n    return undefined;\n  }\n\n  // Validate state structure instead of throwing\n  if (!isHistoryState(globalThis.history.state)) {\n    logger.warn(\n      LOGGER_CONTEXT,\n      \"History state is not a valid state object, ignoring\",\n      globalThis.history.state,\n    );\n\n    return undefined;\n  }\n\n  return globalThis.history.state as HistoryState;\n};\n\n/**\n * Gets current URL hash\n */\nconst getHash = () => globalThis.location.hash;\n\n/**\n * Creates a fallback browser for non-browser environments (SSR).\n * Logs warning on first method call to help diagnose misconfiguration.\n *\n * @returns Browser API with no-op implementations\n */\nfunction createFallbackBrowser(): Browser {\n  let hasWarned = false;\n\n  const warnOnce = (method: string) => {\n    if (!hasWarned) {\n      logger.warn(\n        LOGGER_CONTEXT,\n        `Browser plugin is running in a non-browser environment. ` +\n          `Method \"${method}\" is a no-op. ` +\n          `This is expected for SSR, but may indicate misconfiguration if you expected browser behavior.`,\n      );\n      hasWarned = true;\n    }\n  };\n\n  return {\n    getBase: () => {\n      warnOnce(\"getBase\");\n\n      return \"\";\n    },\n    pushState: () => {\n      warnOnce(\"pushState\");\n    },\n    replaceState: () => {\n      warnOnce(\"replaceState\");\n    },\n    addPopstateListener: () => {\n      warnOnce(\"addPopstateListener\");\n\n      return NOOP;\n    },\n    getLocation: () => {\n      warnOnce(\"getLocation\");\n\n      return \"\";\n    },\n    getState: () => {\n      warnOnce(\"getState\");\n\n      // eslint-disable-next-line unicorn/no-useless-undefined\n      return undefined;\n    },\n    getHash: () => {\n      warnOnce(\"getHash\");\n\n      return \"\";\n    },\n  };\n}\n\n/**\n * Creates browser API abstraction that works in both browser and SSR environments\n *\n * @returns Browser API object\n */\nexport function createSafeBrowser(): Browser {\n  const isBrowser =\n    typeof globalThis.window !== \"undefined\" && !!globalThis.history;\n\n  return isBrowser\n    ? {\n        getBase,\n        pushState,\n        replaceState,\n        addPopstateListener,\n        getLocation,\n        getState,\n        getHash,\n      }\n    : createFallbackBrowser();\n}\n","// packages/browser-plugin/modules/plugin.ts\n\nimport { getPluginApi } from \"@real-router/core\";\nimport { isStateStrict as isState } from \"type-guards\";\n\nimport { createSafeBrowser } from \"./browser\";\nimport { defaultOptions, LOGGER_CONTEXT, source } from \"./constants\";\nimport {\n  escapeRegExp,\n  createStateFromEvent,\n  shouldSkipTransition,\n  handleMissingState,\n  updateBrowserState,\n  handleTransitionResult,\n  validateOptions,\n} from \"./utils\";\n\nimport type { BrowserPluginOptions, Browser, HistoryState } from \"./types\";\nimport type {\n  PluginFactory,\n  Router,\n  RouterError,\n  State,\n} from \"@real-router/core\";\n\n/**\n * Browser plugin factory for real-router.\n * Integrates router with browser history API.\n *\n * Features:\n * - Syncs router state with browser history (pushState/replaceState)\n * - Handles popstate events for browser back/forward navigation\n * - Supports hash-based routing for legacy browsers\n * - Provides URL building and matching utilities\n * - SSR-safe with graceful fallbacks\n * - Runtime validation warns about conflicting options\n *\n * @param opts - Plugin configuration options\n * @param browser - Browser API abstraction (for testing/SSR)\n * @returns Plugin factory function\n *\n * @example\n * ```ts\n * // Hash routing\n * router.usePlugin(browserPluginFactory({ useHash: true, hashPrefix: \"!\" }));\n *\n * // History routing with hash preservation\n * router.usePlugin(browserPluginFactory({ useHash: false, preserveHash: true }));\n * ```\n */\nexport function browserPluginFactory(\n  opts?: Partial<BrowserPluginOptions>,\n  browser: Browser = createSafeBrowser(),\n): PluginFactory {\n  // Validate user-provided options before merging with defaults\n  const hasInvalidTypes = validateOptions(opts, defaultOptions);\n\n  let options = { ...defaultOptions, ...opts } as BrowserPluginOptions;\n\n  // Skip normalization if invalid types detected (prevents runtime errors)\n  if (hasInvalidTypes) {\n    console.warn(\n      `[${LOGGER_CONTEXT}] Using default options due to invalid types`,\n    );\n    options = { ...defaultOptions } as BrowserPluginOptions;\n  }\n\n  // Remove conflicting properties based on mode to prevent misuse\n  // This ensures options object is clean even if JS users pass invalid config\n  if (options.useHash === true) {\n    // Hash mode: remove history-only options\n    delete (options as unknown as Record<string, unknown>).preserveHash;\n  } else {\n    // History mode (default): remove hash-only options\n    delete (options as unknown as Record<string, unknown>).hashPrefix;\n  }\n\n  // Normalize base path to prevent common configuration errors\n  // Type check needed for runtime safety (JS users may pass wrong types)\n  if (options.base && typeof options.base === \"string\") {\n    // Ensure leading slash for absolute paths\n    if (!options.base.startsWith(\"/\")) {\n      options.base = `/${options.base}`;\n    }\n\n    // Remove trailing slash to prevent double slashes\n    if (options.base.endsWith(\"/\")) {\n      options.base = options.base.slice(0, -1);\n    }\n  }\n\n  // Cache RegExp patterns at plugin creation for performance\n  const regExpCache = new Map<string, RegExp>();\n  const getCachedRegExp = (pattern: string): RegExp => {\n    const cached = regExpCache.get(pattern);\n\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    const newRegExp = new RegExp(pattern);\n\n    regExpCache.set(pattern, newRegExp);\n\n    return newRegExp;\n  };\n\n  // Create transition options with proper typing for exactOptionalPropertyTypes\n  // replace: true is needed because popstate means URL already changed (back/forward)\n  const forceDeactivate = options.forceDeactivate;\n  /* v8 ignore next 4 -- @preserve both branches tested, coverage tool limitation */\n  const transitionOptions =\n    forceDeactivate === undefined\n      ? { source, replace: true }\n      : { forceDeactivate, source, replace: true };\n\n  let removePopStateListener: (() => void) | undefined;\n\n  return function browserPlugin(routerBase) {\n    // Cast to augmented Router (class + module augmentation: buildUrl, matchUrl, etc.)\n    const router = routerBase as Router;\n    const api = getPluginApi(routerBase);\n\n    // Store original methods for restoration on teardown\n\n    const routerStart = router.start;\n\n    // Transition state management\n    let isTransitioning = false;\n\n    // Deferred popstate event queue (stores only the last event)\n    let deferredPopstateEvent: PopStateEvent | null = null;\n\n    // Frozen copy of lastKnownState for immutability\n    let cachedFrozenState: State | undefined;\n\n    // Options can be changed at runtime in onStart\n    /* v8 ignore next -- @preserve fallback for undefined base */\n    const getBase = () => options.base ?? \"\";\n    /* v8 ignore next -- @preserve fallback for undefined hashPrefix */\n    const hashPrefix = options.hashPrefix ?? \"\";\n    const escapedHashPrefix = escapeRegExp(hashPrefix);\n    const prefix = options.useHash ? `#${hashPrefix}` : \"\";\n\n    // Pre-compute RegExp patterns\n    const hashPrefixRegExp = escapedHashPrefix\n      ? getCachedRegExp(`^#${escapedHashPrefix}`)\n      : null;\n\n    /**\n     * Parses URL and extracts path using native URL API.\n     * More robust than regex parsing - handles IPv6, Unicode, edge cases.\n     *\n     * @param url - URL to parse\n     * @returns Path string or null on parse error\n     */\n    const urlToPath = (url: string): string | null => {\n      try {\n        // Use URL API for reliable parsing\n        const parsedUrl = new URL(url, globalThis.location.origin);\n        const pathname = parsedUrl.pathname;\n        const hash = parsedUrl.hash;\n        const search = parsedUrl.search;\n        const base = getBase();\n\n        if (![\"http:\", \"https:\"].includes(parsedUrl.protocol)) {\n          console.warn(`[${LOGGER_CONTEXT}] Invalid URL protocol in ${url}`);\n\n          return null;\n        }\n\n        if (options.useHash) {\n          // Use cached RegExp or simple slice if no prefix\n          const path = hashPrefixRegExp\n            ? hash.replace(hashPrefixRegExp, \"\")\n            : hash.slice(1);\n\n          return path + search;\n        } else if (base) {\n          // Remove base prefix\n          const escapedBase = escapeRegExp(base);\n          const baseRegExp = getCachedRegExp(`^${escapedBase}`);\n          const stripped = pathname.replace(baseRegExp, \"\");\n\n          return (stripped.startsWith(\"/\") ? \"\" : \"/\") + stripped + search;\n        }\n\n        return pathname + search;\n      } catch (error) {\n        // Graceful fallback instead of throw\n        console.warn(`[${LOGGER_CONTEXT}] Could not parse url ${url}`, error);\n\n        return null;\n      }\n    };\n\n    /**\n     * Overrides router.start to integrate with browser location.\n     * When no path is provided, resolves current browser URL automatically.\n     */\n    router.start = (path?: string) => {\n      return routerStart(path ?? browser.getLocation(options));\n    };\n\n    /**\n     * Builds URL from route name and params.\n     * Adds base path and hash prefix according to options.\n     *\n     * @security\n     * When using buildUrl output in templates:\n     * - ✅ SAFE: Modern frameworks (React, Vue, Angular) auto-escape in templates\n     * - ✅ SAFE: Setting href attribute via DOM API (element.href = url)\n     * - ❌ UNSAFE: Using innerHTML or similar without escaping\n     *\n     * @example\n     * // Safe - React auto-escapes\n     * <Link to={router.buildUrl('users', params)} />\n     *\n     * // Safe - Vue auto-escapes\n     * <router-link :to=\"router.buildUrl('users', params)\" />\n     *\n     * // Unsafe - manual HTML construction\n     * element.innerHTML = `<a href=\"${router.buildUrl('users', params)}\">Link</a>`; // ❌ DON'T\n     */\n    router.buildUrl = (route, params) => {\n      const path = router.buildPath(route, params);\n\n      return getBase() + prefix + path;\n    };\n\n    /**\n     * Matches URL and returns corresponding state\n     */\n    router.matchUrl = (url) => {\n      const path = urlToPath(url);\n\n      return path ? api.matchPath(path) : undefined;\n    };\n\n    /**\n     * Replaces current history state without triggering navigation.\n     * Useful for updating URL without causing a full transition.\n     */\n    router.replaceHistoryState = (name, params = {}) => {\n      const state = api.buildState(name, params);\n\n      if (!state) {\n        throw new Error(\n          `[real-router] Cannot replace state: route \"${name}\" is not found`,\n        );\n      }\n\n      const builtState = api.makeState(\n        state.name,\n        state.params,\n        router.buildPath(state.name, state.params),\n        {\n          params: state.meta,\n        },\n        1, // forceId\n      );\n      const url = router.buildUrl(name, params);\n\n      updateBrowserState(builtState, url, true, browser, options);\n    };\n\n    /**\n     * lastKnownState: Immutable reference to last successful state.\n     * Uses caching to avoid creating new objects on every read.\n     * Optimized: Single copy + freeze operation instead of double copying.\n     */\n    Object.defineProperty(router, \"lastKnownState\", {\n      get() {\n        // Note: After teardown, this property is deleted from router,\n        // so this getter is only called while plugin is active\n        return cachedFrozenState;\n      },\n      set(value?: State) {\n        // Create frozen copy in one operation (no double copying)\n        cachedFrozenState = value ? Object.freeze({ ...value }) : undefined;\n      },\n      enumerable: true,\n      configurable: true,\n    });\n\n    /**\n     * Processes a deferred popstate event if one exists.\n     * Called after transition completes.\n     */\n    function processDeferredEvent() {\n      if (deferredPopstateEvent) {\n        const event = deferredPopstateEvent;\n\n        deferredPopstateEvent = null; // Clear before processing\n        console.warn(`[${LOGGER_CONTEXT}] Processing deferred popstate event`);\n        void onPopState(event);\n      }\n    }\n\n    /**\n     * Main popstate event handler.\n     * Protected against concurrent transitions and handles errors gracefully.\n     * Defers events during transitions to prevent browser history desync.\n     */\n    async function onPopState(evt: PopStateEvent) {\n      // Race condition protection: defer event if transition in progress\n      if (isTransitioning) {\n        console.warn(\n          `[${LOGGER_CONTEXT}] Transition in progress, deferring popstate event`,\n        );\n        // Store only the latest event (skip intermediate states)\n        deferredPopstateEvent = evt;\n\n        return;\n      }\n\n      // Top-level error recovery\n      try {\n        const routerState = router.getState();\n        const state = createStateFromEvent(evt, api, browser, options);\n        const isNewState = !isState(evt.state);\n\n        // Handle missing state\n        if (!state && handleMissingState(router, api, transitionOptions)) {\n          return;\n        }\n\n        // Skip if states are equal\n        if (shouldSkipTransition(state, routerState, router)) {\n          return;\n        }\n\n        // Execute transition with race protection\n        // state is guaranteed to be defined here because:\n        // 1. handleMissingState handles !state case (line 339)\n        // 2. shouldSkipTransition returns true when !state (utils.ts:129)\n        /* v8 ignore start: defensive guard - state guaranteed defined by control flow above */\n        if (!state) {\n          return;\n        }\n        /* v8 ignore stop */\n\n        isTransitioning = true;\n\n        try {\n          // transitionOptions includes replace: true, which is passed to TRANSITION_SUCCESS\n          const toState = await api.navigateToState(\n            state,\n            routerState,\n            transitionOptions,\n          );\n\n          handleTransitionResult(\n            undefined,\n            toState,\n            routerState,\n            isNewState,\n            router,\n            browser,\n            options,\n          );\n        } catch (error) {\n          handleTransitionResult(\n            error as RouterError,\n            undefined,\n            routerState,\n            isNewState,\n            router,\n            browser,\n            options,\n          );\n        } finally {\n          isTransitioning = false;\n          // Process any deferred popstate events after transition completes\n          processDeferredEvent();\n        }\n      } catch (error) {\n        isTransitioning = false;\n        console.error(\n          `[${LOGGER_CONTEXT}] Critical error in onPopState`,\n          error,\n        );\n\n        // Attempt recovery: sync browser with router state\n        try {\n          const currentState = router.getState();\n\n          if (currentState) {\n            const url = router.buildUrl(currentState.name, currentState.params);\n\n            browser.replaceState(currentState as HistoryState, \"\", url);\n          }\n        } catch (recoveryError) {\n          // If recovery fails, there's nothing more we can do\n          console.error(\n            `[${LOGGER_CONTEXT}] Failed to recover from critical error`,\n            recoveryError,\n          );\n        }\n\n        // Process any deferred events even after error\n        processDeferredEvent();\n      }\n    }\n\n    return {\n      /**\n       * Called when router.start() is invoked.\n       * Sets up browser history integration.\n       */\n      onStart: () => {\n        if (removePopStateListener) {\n          removePopStateListener();\n        }\n\n        removePopStateListener = browser.addPopstateListener(\n          (evt: PopStateEvent) => void onPopState(evt),\n          options,\n        );\n      },\n\n      /**\n       * Called when router.stop() is invoked.\n       * Cleans up event listeners.\n       */\n      onStop: () => {\n        if (removePopStateListener) {\n          removePopStateListener();\n          removePopStateListener = undefined;\n        }\n      },\n\n      /**\n       * Called after successful navigation.\n       * Updates browser history with new state.\n       */\n      onTransitionSuccess: (toState, fromState, navOptions) => {\n        router.lastKnownState = toState;\n\n        // Determine if we should replace or push history entry\n        const replaceHistory =\n          (navOptions.replace ?? !fromState) ||\n          (!!navOptions.reload &&\n            router.areStatesEqual(toState, fromState, false));\n\n        // Build URL with base and hash prefix\n        const url = router.buildUrl(toState.name, toState.params);\n\n        // Preserve hash fragment if configured\n        // Note: preserveHash is deleted in hash mode, so it's always undefined there\n        const shouldPreserveHash =\n          options.preserveHash &&\n          (!fromState || fromState.path === toState.path);\n\n        const finalUrl = shouldPreserveHash ? url + browser.getHash() : url;\n\n        // Update browser history\n        updateBrowserState(toState, finalUrl, replaceHistory, browser, options);\n      },\n\n      /**\n       * Called when plugin is unsubscribed.\n       * Restores original router state for clean teardown.\n       */\n      teardown: () => {\n        // Remove event listeners\n        if (removePopStateListener) {\n          removePopStateListener();\n          removePopStateListener = undefined;\n        }\n\n        // Restore original router methods\n        router.start = routerStart;\n\n        // Clean up added properties\n        delete (router as Partial<Router>).buildUrl;\n        delete (router as Partial<Router>).matchUrl;\n        delete (router as Partial<Router>).replaceHistoryState;\n        delete (router as Partial<Router>).lastKnownState;\n      },\n    };\n  };\n}\n"]}
+{"version":3,"sources":["../../src/constants.ts","../../src/url-utils.ts","../../src/browser.ts","../../src/popstate-utils.ts","../../src/plugin.ts","../../src/validation.ts","../../src/factory.ts"],"names":["regExpCache","logger","RouterError","defaultOptions","getPluginApi"],"mappings":"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","file":"index.js","sourcesContent":["// packages/browser-plugin/modules/constants.ts\n\n/**\n * Internal type for default options.\n *\n * Why separate type instead of BrowserPluginOptions?\n *\n * BrowserPluginOptions is a discriminated union:\n * - HashModeOptions: allows hashPrefix, forbids preserveHash (never)\n * - HistoryModeOptions: allows preserveHash, forbids hashPrefix (never)\n *\n * We cannot create a single object of type BrowserPluginOptions that contains\n * BOTH hashPrefix and preserveHash - one will always be 'never' depending on useHash.\n *\n * Example - this would fail TypeScript:\n * const defaults: BrowserPluginOptions = {\n *   useHash: false,      // → HistoryModeOptions branch\n *   preserveHash: true,  // ✅ OK\n *   hashPrefix: \"\"       // ❌ Error: Type 'string' is not assignable to type 'never'\n * };\n *\n * DefaultBrowserPluginOptions solves this by containing ALL options,\n * enabling:\n * - Default values for every option\n * - Type validation via typeof defaultOptions\n * - Runtime validation of user-provided option types\n */\nexport interface DefaultBrowserPluginOptions {\n  forceDeactivate: boolean;\n  useHash: boolean;\n  base: string;\n  preserveHash: boolean;\n  hashPrefix: string;\n}\n\nexport const defaultOptions: DefaultBrowserPluginOptions = {\n  forceDeactivate: true,\n  useHash: false,\n  hashPrefix: \"\",\n  base: \"\",\n  preserveHash: true,\n};\n\n/**\n * Source identifier for transitions triggered by browser events.\n * Used to distinguish browser-initiated navigation (back/forward buttons)\n * from programmatic navigation (router.navigate()).\n */\nexport const source = \"popstate\";\n\nexport const LOGGER_CONTEXT = \"browser-plugin\";\n","// packages/browser-plugin/src/url-utils.ts\n\nimport { LOGGER_CONTEXT } from \"./constants\";\n\nimport type { URLParseOptions, RegExpCache } from \"./types\";\n\nconst escapeRegExpCache = new Map<string, string>();\n\nexport const escapeRegExp = (str: string): string => {\n  const cached = escapeRegExpCache.get(str);\n\n  if (cached !== undefined) {\n    return cached;\n  }\n\n  const escaped = str.replaceAll(/[$()*+.?[\\\\\\]^{|}-]/g, String.raw`\\$&`);\n\n  escapeRegExpCache.set(str, escaped);\n\n  return escaped;\n};\n\nexport function extractPath(\n  pathname: string,\n  hash: string,\n  options: URLParseOptions,\n  regExpCache: RegExpCache,\n): string {\n  if (options.useHash) {\n    const escapedHashPrefix = escapeRegExp(options.hashPrefix);\n    const path = escapedHashPrefix\n      ? hash.replace(regExpCache.get(`^#${escapedHashPrefix}`), \"\")\n      : hash.slice(1);\n\n    return path || \"/\";\n  }\n\n  if (options.base) {\n    const escapedBase = escapeRegExp(options.base);\n    const stripped = pathname.replace(regExpCache.get(`^${escapedBase}`), \"\");\n\n    return stripped.startsWith(\"/\") ? stripped : `/${stripped}`;\n  }\n\n  return pathname;\n}\n\nexport function urlToPath(\n  url: string,\n  options: URLParseOptions,\n  regExpCache: RegExpCache,\n): string | null {\n  try {\n    const parsedUrl = new URL(url, globalThis.location.origin);\n\n    if (![\"http:\", \"https:\"].includes(parsedUrl.protocol)) {\n      console.warn(`[${LOGGER_CONTEXT}] Invalid URL protocol in ${url}`);\n\n      return null;\n    }\n\n    return (\n      extractPath(parsedUrl.pathname, parsedUrl.hash, options, regExpCache) +\n      parsedUrl.search\n    );\n  } catch (error) {\n    console.warn(`[${LOGGER_CONTEXT}] Could not parse url ${url}`, error);\n\n    return null;\n  }\n}\n\nexport function buildUrl(path: string, base: string, prefix: string): string {\n  return base + prefix + path;\n}\n\nexport function createRegExpCache(): RegExpCache {\n  const cache = new Map<string, RegExp>();\n\n  return {\n    get(pattern: string): RegExp {\n      const cached = cache.get(pattern);\n\n      if (cached !== undefined) {\n        return cached;\n      }\n\n      const newRegExp = new RegExp(pattern);\n\n      cache.set(pattern, newRegExp);\n\n      return newRegExp;\n    },\n  };\n}\n","// packages/browser-plugin/modules/browser.ts\n\nimport { logger } from \"@real-router/logger\";\n\nimport { LOGGER_CONTEXT } from \"./constants\";\nimport { createRegExpCache, extractPath } from \"./url-utils\";\n\nimport type { Browser, BrowserPluginOptions, URLParseOptions } from \"./types\";\nimport type { State } from \"@real-router/core\";\n\n/** No-operation cleanup function for fallback browser */\nconst NOOP = (): void => {};\n\nconst pushState = (state: State, path: string) => {\n  globalThis.history.pushState(state, \"\", path);\n};\n\nconst replaceState = (state: State, path: string) => {\n  globalThis.history.replaceState(state, \"\", path);\n};\n\nconst addPopstateListener: Browser[\"addPopstateListener\"] = (fn) => {\n  globalThis.addEventListener(\"popstate\", fn);\n\n  return () => {\n    globalThis.removeEventListener(\"popstate\", fn);\n  };\n};\n\nconst regExpCache = createRegExpCache();\n\n/**\n * Safely encodes/decodes path to normalize URL encoding\n *\n * @param path - Path to normalize\n * @returns Normalized path or original on error\n */\nconst safelyEncodePath = (path: string): string => {\n  try {\n    return encodeURI(decodeURI(path));\n  } catch (error) {\n    logger.warn(LOGGER_CONTEXT, `Could not encode path \"${path}\"`, error);\n\n    return path;\n  }\n};\n\nconst getLocation = (opts: BrowserPluginOptions) => {\n  const rawPath = extractPath(\n    globalThis.location.pathname,\n    globalThis.location.hash,\n    opts as URLParseOptions,\n    regExpCache,\n  );\n\n  return safelyEncodePath(rawPath) + globalThis.location.search;\n};\n\n/**\n * Gets current URL hash\n */\nconst getHash = () => globalThis.location.hash;\n\n/**\n * Creates a fallback browser for non-browser environments (SSR).\n * Logs warning on first method call to help diagnose misconfiguration.\n *\n * @returns Browser API with no-op implementations\n */\nfunction createFallbackBrowser(): Browser {\n  let hasWarned = false;\n\n  const warnOnce = (method: string) => {\n    if (!hasWarned) {\n      logger.warn(\n        LOGGER_CONTEXT,\n        `Browser plugin is running in a non-browser environment. ` +\n          `Method \"${method}\" is a no-op. ` +\n          `This is expected for SSR, but may indicate misconfiguration if you expected browser behavior.`,\n      );\n      hasWarned = true;\n    }\n  };\n\n  return {\n    pushState: () => {\n      warnOnce(\"pushState\");\n    },\n    replaceState: () => {\n      warnOnce(\"replaceState\");\n    },\n    addPopstateListener: () => {\n      warnOnce(\"addPopstateListener\");\n\n      return NOOP;\n    },\n    getLocation: () => {\n      warnOnce(\"getLocation\");\n\n      return \"\";\n    },\n    getHash: () => {\n      warnOnce(\"getHash\");\n\n      return \"\";\n    },\n  };\n}\n\n/**\n * Creates browser API abstraction that works in both browser and SSR environments\n *\n * @returns Browser API object\n */\nexport function createSafeBrowser(): Browser {\n  const isBrowser =\n    typeof globalThis.window !== \"undefined\" && !!globalThis.history;\n\n  return isBrowser\n    ? {\n        pushState,\n        replaceState,\n        addPopstateListener,\n        getLocation,\n        getHash,\n      }\n    : createFallbackBrowser();\n}\n","import { isStateStrict as isState } from \"type-guards\";\n\nimport type { BrowserPluginOptions, Browser } from \"./types\";\nimport type { PluginApi, State, Params } from \"@real-router/core\";\n\n/**\n * Extracts route name and params from a popstate event.\n *\n * - If history.state is a valid router state → returns name/params from it\n * - If not (e.g. manually entered URL) → matches current URL against route tree\n * - Returns undefined if no route matches\n *\n * @param evt - PopStateEvent from browser\n * @param api - PluginApi instance\n * @param browser - Browser API instance\n * @param options - Browser plugin options\n * @returns Route identifier or undefined\n */\nexport function getRouteFromEvent(\n  evt: PopStateEvent,\n  api: PluginApi,\n  browser: Browser,\n  options: BrowserPluginOptions,\n): { name: string; params: Params } | undefined {\n  if (isState(evt.state)) {\n    return { name: evt.state.name, params: evt.state.params };\n  }\n\n  const state = api.matchPath(browser.getLocation(options));\n\n  return state ? { name: state.name, params: state.params } : undefined;\n}\n\n/**\n * Updates browser state (pushState or replaceState)\n *\n * @param state - Router state\n * @param url - URL to set\n * @param replace - Whether to replace instead of push\n * @param browser - Browser API instance\n */\nexport function updateBrowserState(\n  state: State,\n  url: string,\n  replace: boolean,\n  browser: Browser,\n): void {\n  const historyState = {\n    meta: state.meta,\n    name: state.name,\n    params: state.params,\n    path: state.path,\n  };\n\n  if (replace) {\n    browser.replaceState(historyState, url);\n  } else {\n    browser.pushState(historyState, url);\n  }\n}\n","import { RouterError } from \"@real-router/core\";\n\nimport { LOGGER_CONTEXT } from \"./constants\";\nimport { getRouteFromEvent, updateBrowserState } from \"./popstate-utils\";\nimport { buildUrl, urlToPath } from \"./url-utils\";\n\nimport type {\n  Browser,\n  BrowserPluginOptions,\n  RegExpCache,\n  SharedFactoryState,\n  URLParseOptions,\n} from \"./types\";\nimport type {\n  NavigationOptions,\n  PluginApi,\n  Router,\n  State,\n  Plugin,\n} from \"@real-router/core\";\n\nexport class BrowserPlugin {\n  readonly #router: Router;\n  readonly #api: PluginApi;\n  readonly #options: BrowserPluginOptions;\n  readonly #browser: Browser;\n  readonly #regExpCache: RegExpCache;\n  readonly #prefix: string;\n  readonly #transitionOptions: {\n    source: string;\n    replace: true;\n    forceDeactivate?: boolean;\n  };\n  readonly #shared: SharedFactoryState;\n\n  #isTransitioning = false;\n  #deferredPopstateEvent: PopStateEvent | null = null;\n  readonly #removeStartInterceptor: () => void;\n\n  constructor(\n    router: Router,\n    api: PluginApi,\n    options: BrowserPluginOptions,\n    browser: Browser,\n    regExpCache: RegExpCache,\n    transitionOptions: {\n      source: string;\n      replace: true;\n      forceDeactivate?: boolean;\n    },\n    shared: SharedFactoryState,\n  ) {\n    this.#router = router;\n    this.#api = api;\n    this.#options = options;\n    this.#browser = browser;\n    this.#regExpCache = regExpCache;\n    this.#transitionOptions = transitionOptions;\n    this.#shared = shared;\n\n    const normalizedOptions = options as URLParseOptions;\n\n    this.#prefix = options.useHash ? `#${normalizedOptions.hashPrefix}` : \"\";\n\n    this.#removeStartInterceptor = this.#api.addInterceptor(\n      \"start\",\n      (next, path) => next(path ?? this.#browser.getLocation(this.#options)),\n    );\n\n    this.#augmentRouter();\n  }\n\n  getPlugin(): Plugin {\n    return {\n      onStart: () => {\n        if (this.#shared.removePopStateListener) {\n          this.#shared.removePopStateListener();\n        }\n\n        this.#shared.removePopStateListener = this.#browser.addPopstateListener(\n          (evt: PopStateEvent) => void this.#onPopState(evt),\n        );\n      },\n\n      onStop: () => {\n        if (this.#shared.removePopStateListener) {\n          this.#shared.removePopStateListener();\n          this.#shared.removePopStateListener = undefined;\n        }\n      },\n\n      onTransitionSuccess: (\n        toState: State,\n        fromState: State | undefined,\n        navOptions: NavigationOptions,\n      ) => {\n        const shouldReplaceHistory =\n          (navOptions.replace ?? !fromState) ||\n          (!!navOptions.reload &&\n            this.#router.areStatesEqual(toState, fromState, false));\n\n        const url = this.#router.buildUrl(toState.name, toState.params);\n\n        const shouldPreserveHash =\n          !!this.#options.preserveHash &&\n          (!fromState || fromState.path === toState.path);\n\n        const finalUrl = shouldPreserveHash\n          ? url + this.#browser.getHash()\n          : url;\n\n        updateBrowserState(\n          toState,\n          finalUrl,\n          shouldReplaceHistory,\n          this.#browser,\n        );\n      },\n\n      teardown: () => {\n        this.#cleanupAugmentation();\n      },\n    };\n  }\n\n  #augmentRouter(): void {\n    const router = this.#router;\n\n    router.buildUrl = (route, params) => {\n      const path = router.buildPath(route, params);\n\n      return buildUrl(\n        path,\n        (this.#options as URLParseOptions).base,\n        this.#prefix,\n      );\n    };\n\n    router.matchUrl = (url) => {\n      const path = urlToPath(\n        url,\n        this.#options as URLParseOptions,\n        this.#regExpCache,\n      );\n\n      return path ? this.#api.matchPath(path) : undefined;\n    };\n\n    router.replaceHistoryState = (name, params = {}) => {\n      const state = this.#api.buildState(name, params);\n\n      if (!state) {\n        throw new Error(\n          `[real-router] Cannot replace state: route \"${name}\" is not found`,\n        );\n      }\n\n      const builtState = this.#api.makeState(\n        state.name,\n        state.params,\n        router.buildPath(state.name, state.params),\n        {\n          params: state.meta,\n        },\n        1, // forceId\n      );\n      const url = router.buildUrl(name, params);\n\n      updateBrowserState(builtState, url, true, this.#browser);\n    };\n  }\n\n  #cleanupAugmentation(): void {\n    if (this.#shared.removePopStateListener) {\n      this.#shared.removePopStateListener();\n      this.#shared.removePopStateListener = undefined;\n    }\n\n    this.#removeStartInterceptor();\n\n    delete (this.#router as Partial<Router>).buildUrl;\n    delete (this.#router as Partial<Router>).matchUrl;\n    delete (this.#router as Partial<Router>).replaceHistoryState;\n  }\n\n  #processDeferredEvent(): void {\n    if (this.#deferredPopstateEvent) {\n      const event = this.#deferredPopstateEvent;\n\n      this.#deferredPopstateEvent = null;\n      console.warn(`[${LOGGER_CONTEXT}] Processing deferred popstate event`);\n      void this.#onPopState(event);\n    }\n  }\n\n  async #onPopState(evt: PopStateEvent): Promise<void> {\n    if (this.#isTransitioning) {\n      console.warn(\n        `[${LOGGER_CONTEXT}] Transition in progress, deferring popstate event`,\n      );\n      this.#deferredPopstateEvent = evt;\n\n      return;\n    }\n\n    this.#isTransitioning = true;\n\n    try {\n      const route = getRouteFromEvent(\n        evt,\n        this.#api,\n        this.#browser,\n        this.#options,\n      );\n\n      // eslint-disable-next-line unicorn/prefer-ternary\n      if (route) {\n        await this.#router.navigate(\n          route.name,\n          route.params,\n          this.#transitionOptions,\n        );\n      } else {\n        await this.#router.navigateToDefault({\n          ...this.#transitionOptions,\n          reload: true,\n          replace: true,\n        });\n      }\n    } catch (error) {\n      if (!(error instanceof RouterError)) {\n        this.#recoverFromCriticalError(error);\n      }\n    } finally {\n      this.#isTransitioning = false;\n      this.#processDeferredEvent();\n    }\n  }\n\n  #recoverFromCriticalError(error: unknown): void {\n    console.error(`[${LOGGER_CONTEXT}] Critical error in onPopState`, error);\n\n    try {\n      const currentState = this.#router.getState();\n\n      /* v8 ignore next -- @preserve: router always has state after start(); defensive guard for edge cases */\n      if (currentState) {\n        const url = this.#router.buildUrl(\n          currentState.name,\n          currentState.params,\n        );\n\n        this.#browser.replaceState(currentState, url);\n      }\n    } catch (recoveryError) {\n      console.error(\n        `[${LOGGER_CONTEXT}] Failed to recover from critical error`,\n        recoveryError,\n      );\n    }\n  }\n}\n","import { type DefaultBrowserPluginOptions, LOGGER_CONTEXT } from \"./constants\";\n\nimport type { BrowserPluginOptions } from \"./types\";\n\nfunction isDefaultOptionKey(\n  key: string,\n  defaults: DefaultBrowserPluginOptions,\n): key is keyof DefaultBrowserPluginOptions {\n  return key in defaults;\n}\n\nfunction validateOptionType(\n  key: keyof DefaultBrowserPluginOptions,\n  value: unknown,\n  expectedType: string,\n): boolean {\n  const actualType = typeof value;\n\n  if (actualType !== expectedType && value !== undefined) {\n    console.warn(\n      `[${LOGGER_CONTEXT}] Invalid type for '${key}': expected ${expectedType}, got ${actualType}`,\n    );\n\n    return false;\n  }\n\n  return true;\n}\n\nexport function validateOptions(\n  opts: Partial<BrowserPluginOptions> | undefined,\n  defaultOptions: DefaultBrowserPluginOptions,\n): boolean {\n  if (!opts) {\n    return false;\n  }\n\n  let hasInvalidTypes = false;\n\n  for (const key of Object.keys(opts)) {\n    if (isDefaultOptionKey(key, defaultOptions)) {\n      const expectedType = typeof defaultOptions[key];\n      const value = opts[key];\n      const isValid = validateOptionType(key, value, expectedType);\n\n      if (!isValid) {\n        hasInvalidTypes = true;\n      }\n    }\n  }\n\n  if (opts.useHash === true && \"preserveHash\" in opts) {\n    console.warn(`[${LOGGER_CONTEXT}] preserveHash ignored in hash mode`);\n  }\n\n  if (opts.useHash === false && \"hashPrefix\" in opts) {\n    const optsRecord = opts as unknown as Record<string, unknown>;\n    const hashPrefix = optsRecord.hashPrefix;\n\n    if (hashPrefix !== undefined && hashPrefix !== \"\") {\n      console.warn(`[${LOGGER_CONTEXT}] hashPrefix ignored in history mode`);\n    }\n  }\n\n  return hasInvalidTypes;\n}\n","import { getPluginApi } from \"@real-router/core\";\n\nimport { createSafeBrowser } from \"./browser\";\nimport { defaultOptions, LOGGER_CONTEXT, source } from \"./constants\";\nimport { BrowserPlugin } from \"./plugin\";\nimport { createRegExpCache } from \"./url-utils\";\nimport { validateOptions } from \"./validation\";\n\nimport type {\n  BrowserPluginOptions,\n  Browser,\n  SharedFactoryState,\n} from \"./types\";\nimport type { PluginFactory, Router } from \"@real-router/core\";\n\n/**\n * Browser plugin factory for real-router.\n * Integrates router with browser history API.\n *\n * @param opts - Plugin configuration options\n * @param browser - Browser API abstraction (for testing/SSR)\n * @returns Plugin factory function\n *\n * @example\n * ```ts\n * // Hash routing\n * router.usePlugin(browserPluginFactory({ useHash: true, hashPrefix: \"!\" }));\n *\n * // History routing with hash preservation\n * router.usePlugin(browserPluginFactory({ useHash: false, preserveHash: true }));\n * ```\n */\nexport function browserPluginFactory(\n  opts?: Partial<BrowserPluginOptions>,\n  browser: Browser = createSafeBrowser(),\n): PluginFactory {\n  const hasInvalidTypes = validateOptions(opts, defaultOptions);\n\n  let options = { ...defaultOptions, ...opts } as BrowserPluginOptions;\n\n  if (hasInvalidTypes) {\n    console.warn(\n      `[${LOGGER_CONTEXT}] Using default options due to invalid types`,\n    );\n    options = { ...defaultOptions } as BrowserPluginOptions;\n  }\n\n  if (options.useHash === true) {\n    delete (options as unknown as Record<string, unknown>).preserveHash;\n  } else {\n    delete (options as unknown as Record<string, unknown>).hashPrefix;\n  }\n\n  if (options.base) {\n    if (!options.base.startsWith(\"/\")) {\n      options.base = `/${options.base}`;\n    }\n\n    if (options.base.endsWith(\"/\")) {\n      options.base = options.base.slice(0, -1);\n    }\n  }\n\n  const regExpCache = createRegExpCache();\n\n  const forceDeactivate = options.forceDeactivate;\n  /* v8 ignore next 4 -- @preserve both branches tested, coverage tool limitation */\n  const transitionOptions =\n    forceDeactivate === undefined\n      ? { source, replace: true as const }\n      : { forceDeactivate, source, replace: true as const };\n\n  const shared: SharedFactoryState = { removePopStateListener: undefined };\n\n  return function browserPlugin(routerBase) {\n    const plugin = new BrowserPlugin(\n      routerBase as Router,\n      getPluginApi(routerBase),\n      options,\n      browser,\n      regExpCache,\n      transitionOptions,\n      shared,\n    );\n\n    return plugin.getPlugin();\n  };\n}\n"]}

package/dist/cjs/metafile-cjs.json

@@ -1 +1 @@
-{"inputs":{"../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js":{"bytes":569,"imports":[],"format":"esm"},"../type-guards/dist/esm/index.mjs":{"bytes":3575,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/constants.ts":{"bytes":1668,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/utils.ts":{"bytes":7574,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"../type-guards/dist/esm/index.mjs","kind":"import-statement","original":"type-guards"},{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/browser.ts":{"bytes":6860,"imports":[{"path":"@real-router/logger","kind":"import-statement","external":true},{"path":"../type-guards/dist/esm/index.mjs","kind":"import-statement","original":"type-guards"},{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"src/utils.ts","kind":"import-statement","original":"./utils"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/plugin.ts":{"bytes":15521,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"../type-guards/dist/esm/index.mjs","kind":"import-statement","original":"type-guards"},{"path":"src/browser.ts","kind":"import-statement","original":"./browser"},{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"src/utils.ts","kind":"import-statement","original":"./utils"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":1442,"imports":[{"path":"src/plugin.ts","kind":"import-statement","original":"./plugin"},{"path":"../type-guards/dist/esm/index.mjs","kind":"import-statement","original":"type-guards"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/cjs/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":43181},"dist/cjs/index.js":{"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/logger","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true}],"exports":["browserPluginFactory","isHistoryState","isState"],"entryPoint":"src/index.ts","inputs":{"src/plugin.ts":{"bytesInOutput":8234},"../type-guards/dist/esm/index.mjs":{"bytesInOutput":2394},"src/browser.ts":{"bytesInOutput":4028},"src/constants.ts":{"bytesInOutput":205},"src/utils.ts":{"bytesInOutput":3282},"src/index.ts":{"bytesInOutput":0}},"bytes":18579}}}
+{"inputs":{"../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js":{"bytes":569,"imports":[],"format":"esm"},"src/constants.ts":{"bytes":1624,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/url-utils.ts":{"bytes":2202,"imports":[{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/browser.ts":{"bytes":3076,"imports":[{"path":"@real-router/logger","kind":"import-statement","external":true},{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"src/url-utils.ts","kind":"import-statement","original":"./url-utils"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"../type-guards/dist/esm/index.mjs":{"bytes":3451,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/popstate-utils.ts":{"bytes":1657,"imports":[{"path":"../type-guards/dist/esm/index.mjs","kind":"import-statement","original":"type-guards"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/plugin.ts":{"bytes":6714,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"src/popstate-utils.ts","kind":"import-statement","original":"./popstate-utils"},{"path":"src/url-utils.ts","kind":"import-statement","original":"./url-utils"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/validation.ts":{"bytes":1699,"imports":[{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/factory.ts":{"bytes":2537,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"src/browser.ts","kind":"import-statement","original":"./browser"},{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"src/plugin.ts","kind":"import-statement","original":"./plugin"},{"path":"src/url-utils.ts","kind":"import-statement","original":"./url-utils"},{"path":"src/validation.ts","kind":"import-statement","original":"./validation"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":1275,"imports":[{"path":"src/factory.ts","kind":"import-statement","original":"./factory"},{"path":"../type-guards/dist/esm/index.mjs","kind":"import-statement","original":"type-guards"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/cjs/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":28994},"dist/cjs/index.js":{"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/logger","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true}],"exports":["browserPluginFactory","isState"],"entryPoint":"src/index.ts","inputs":{"src/factory.ts":{"bytesInOutput":1257},"src/browser.ts":{"bytesInOutput":1962},"src/constants.ts":{"bytesInOutput":184},"src/url-utils.ts":{"bytesInOutput":1749},"src/plugin.ts":{"bytesInOutput":5248},"../type-guards/dist/esm/index.mjs":{"bytesInOutput":2275},"src/popstate-utils.ts":{"bytesInOutput":581},"src/validation.ts":{"bytesInOutput":1259},"src/index.ts":{"bytesInOutput":0}},"bytes":14993}}}

package/dist/esm/index.d.mts

@@ -16,13 +16,6 @@ interface BaseBrowserPluginOptions {
      * @default ""
      */
     base?: string;
-    /**
-     * Merge new state with existing history.state when updating.
-     * Useful for preserving external state set by other code.
-     *
-     * @default false
-     */
-    mergeState?: boolean;
 }
 /**
  * Hash-based routing configuration.
@@ -134,37 +127,21 @@ type BrowserPluginOptions = HashModeOptions | HistoryModeOptions;
  * Provides same interface in browser and SSR contexts.
  */
 interface Browser {
-    /**
-     * Gets base path from current browser location
-     *
-     * @returns Current pathname
-     */
-    getBase: () => string;
     /**
      * Pushes new state to browser history
      *
      * @param state - History state object
-     * @param title - Document title (usually ignored by browsers)
      * @param path - URL path
      */
-    pushState: (state: HistoryState, title: string | null, path: string) => void;
+    pushState: (state: State$1, path: string) => void;
     /**
      * Replaces current history state
      *
      * @param state - History state object
-     * @param title - Document title (usually ignored by browsers)
      * @param path - URL path
      */
-    replaceState: (state: HistoryState, title: string | null, path: string) => void;
-    /**
-     * Adds popstate/hashchange event listeners.
-     * Overloaded to support both PopStateEvent and HashChangeEvent.
-     *
-     * @param fn - Event handler
-     * @param opts - Plugin options
-     * @returns Cleanup function to remove listeners
-     */
-    addPopstateListener: ((fn: (evt: PopStateEvent) => void, opts: BrowserPluginOptions) => () => void) & ((fn: (evt: HashChangeEvent) => void, opts: BrowserPluginOptions) => () => void);
+    replaceState: (state: State$1, path: string) => void;
+    addPopstateListener: (fn: (evt: PopStateEvent) => void) => () => void;
     /**
      * Gets current location path respecting plugin options
      *
@@ -172,12 +149,6 @@ interface Browser {
      * @returns Current path string
      */
     getLocation: (opts: BrowserPluginOptions) => string;
-    /**
-     * Gets current history state with validation
-     *
-     * @returns Valid history state or undefined
-     */
-    getState: () => HistoryState | undefined;
     /**
      * Gets current URL hash
      *
@@ -185,24 +156,11 @@ interface Browser {
      */
     getHash: () => string;
 }
-/**
- * History state object stored in browser history.
- * Extends real-router State with additional properties that may be set by external code.
- */
-type HistoryState = State$1 & Record<string, unknown>;
 
 /**
  * Browser plugin factory for real-router.
  * Integrates router with browser history API.
  *
- * Features:
- * - Syncs router state with browser history (pushState/replaceState)
- * - Handles popstate events for browser back/forward navigation
- * - Supports hash-based routing for legacy browsers
- * - Provides URL building and matching utilities
- * - SSR-safe with graceful fallbacks
- * - Runtime validation warns about conflicting options
- *
  * @param opts - Plugin configuration options
  * @param browser - Browser API abstraction (for testing/SSR)
  * @returns Plugin factory function
@@ -261,17 +219,6 @@ interface Params {
  * isStateStrict({ name: 'home', params: 'invalid', path: '/' }); // false
  */
 declare function isStateStrict<P extends Params = Params, MP extends Params = Params>(value: unknown): value is State<P, MP>;
-/**
- * Type guard for HistoryState (browser plugin).
- * HistoryState must have meta object with specific structure.
- * This is stricter than regular State validation.
- *
- * @param value - Value to check
- * @returns true if value is a valid HistoryState object
- */
-declare function isHistoryState(value: unknown): value is State & {
-    meta: NonNullable<State["meta"]>;
-};
 
 /**
  * Module augmentation for real-router.
@@ -294,13 +241,8 @@ declare module "@real-router/core" {
          * Added by browser plugin.
          */
         replaceHistoryState: (name: string, params?: Params$1, title?: string) => void;
-        /**
-         * Last known router state.
-         * Added by browser plugin.
-         */
-        lastKnownState?: State$1;
         start(path?: string): Promise<State$1>;
     }
 }
 
-export { type Browser, type BrowserPluginOptions, type HistoryState, browserPluginFactory, isHistoryState, isStateStrict as isState };
+export { type Browser, type BrowserPluginOptions, browserPluginFactory, isStateStrict as isState };