@real-router/browser-plugin 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/README.md +68 -817
  2. package/dist/cjs/index.d.ts +1723 -144
  3. package/dist/cjs/index.js +1 -1
  4. package/dist/cjs/index.js.map +1 -1
  5. package/dist/cjs/metafile-cjs.json +1 -1
  6. package/dist/esm/index.d.mts +1723 -144
  7. package/dist/esm/index.mjs +1 -1
  8. package/dist/esm/index.mjs.map +1 -1
  9. package/dist/esm/metafile-esm.json +1 -1
  10. package/package.json +4 -4
package/dist/esm/index.mjs CHANGED
@@ -1 +1 @@
1
- import{isStateStrict as e,isHistoryState as t}from"type-guards";export{isHistoryState,isStateStrict as isState}from"type-guards";import{logger as a}from"logger";import{events as r,errorCodes as o}from"@real-router/core";var n={forceDeactivate:!0,useHash:!1,hashPrefix:"",base:"",mergeState:!1,preserveHash:!0},s="popstate",i="browser-plugin",l=()=>{},c=new Map,h=e=>{const t=c.get(e);if(void 0!==t)return t;const a=e.replaceAll(/[$()*+.?[\\\]^{|}-]/g,String.raw`\$&`);return c.set(e,a),a};function u(e,t,a,r,o){const n={meta:e.meta,name:e.name,params:e.params,path:e.path},s=o.mergeState&&r.getState()?{...r.getState(),...n}:n;a?r.replaceState(s,"",t):r.pushState(s,"",t)}function p(e,t){return e in t}function d(e,t,a){const r=typeof t;return r===a||void 0===t||(console.warn(`[${i}] Invalid type for '${e}': expected ${a}, got ${r}`),!1)}var g=()=>{},f=()=>globalThis.location.pathname,m=(()=>{let e,t=!1;return()=>{const a=globalThis.navigator.userAgent;return a!==e&&(e=a,t=!a.includes("Trident")),t}})(),b=(e,t,a)=>{globalThis.history.pushState(e,t??"",a)},S=(e,t,a)=>{globalThis.history.replaceState(e,t??"",a)},v=(e,t)=>{const a=t.useHash&&!m();return globalThis.addEventListener("popstate",e),a&&globalThis.addEventListener("hashchange",e),()=>{globalThis.removeEventListener("popstate",e),a&&globalThis.removeEventListener("hashchange",e)}},T=(()=>{const e=new Map;return t=>{let a=e.get(t);return a||(a=new RegExp(t),e.set(t,a)),a}})(),w=e=>{const{useHash:t,hashPrefix:a="",base:r=""}=e;if(!a&&!r){const e=t?globalThis.location.hash.slice(1):globalThis.location.pathname;return(y(e)||"/")+globalThis.location.search}const o=h(a),n=h(r),s=t?globalThis.location.hash.replace(T(`^#${o}`),""):globalThis.location.pathname.replace(T(`^${n}`),"");return(y(s)||"/")+globalThis.location.search},y=e=>{try{return encodeURI(decodeURI(e))}catch(t){return a.warn(i,`Could not encode path "${e}"`,t),e}},$=()=>{if(globalThis.history.state){if(t(globalThis.history.state))return globalThis.history.state;a.warn(i,"History state is not a valid state object, ignoring",globalThis.history.state)}},H=()=>globalThis.location.hash;function P(t,c=function(){return void 0!==globalThis.window&&globalThis.history?{getBase:f,pushState:b,replaceState:S,addPopstateListener:v,getLocation:w,getState:$,getHash:H}:function(){let e=!1;const t=t=>{e||(a.warn(i,`Browser plugin is running in a non-browser environment. Method "${t}" is a no-op. This is expected for SSR, but may indicate misconfiguration if you expected browser behavior.`),e=!0)};return{getBase:()=>(t("getBase"),""),pushState:()=>{t("pushState")},replaceState:()=>{t("replaceState")},addPopstateListener:()=>(t("addPopstateListener"),g),getLocation:()=>(t("getLocation"),""),getState:()=>{t("getState")},getHash:()=>(t("getHash"),"")}}()}()){const m=function(e,t){if(!e)return!1;let a=!1;for(const r of Object.keys(e))p(r,t)&&(d(r,e[r],typeof t[r])||(a=!0));if(!0===e.useHash&&"preserveHash"in e&&console.warn(`[${i}] preserveHash ignored in hash mode`),!1===e.useHash&&"hashPrefix"in e){const t=e.hashPrefix;void 0!==t&&""!==t&&console.warn(`[${i}] hashPrefix ignored in history mode`)}return a}(t,n);let T={...n,...t};m&&(console.warn(`[${i}] Using default options due to invalid types`),T={...n}),!0===T.useHash?delete T.preserveHash:delete T.hashPrefix,T.base&&"string"==typeof T.base&&(T.base.startsWith("/")||(T.base=`/${T.base}`),T.base.endsWith("/")&&(T.base=T.base.slice(0,-1)));const y=new Map,P=e=>{const t=y.get(e);if(void 0!==t)return t;const a=new RegExp(e);return y.set(e,a),a},L=T.forceDeactivate,x=void 0===L?{source:s}:{forceDeactivate:L,source:s};let U;return function(t){const a=t.start;let n,p=!1,d=null;const g=()=>T.base??"",f=T.hashPrefix??"",m=h(f),b=T.useHash?`#${f}`:"",S=m?P(`^#${m}`):null;function v(){if(d){const e=d;d=null,console.warn(`[${i}] Processing deferred popstate event`),w(e)}}function w(a){if(p)return console.warn(`[${i}] Transition in progress, deferring popstate event`),void(d=a);try{const n=t.getState(),i=function(t,a,r,o,n){return e(t.state)?a.makeState(t.state.name,t.state.params,t.state.path,{...t.state.meta,params:t.state.meta?.params??{},options:t.state.meta?.options??{},redirected:!!t.state.meta?.redirected,source:n},t.state.meta?.id):a.matchPath(r.getLocation(o),n)}(a,t,c,T,s),l=!e(a.state);if(!i&&function(e,t){const a=e.getOptions(),{defaultRoute:r}=a;return!!r&&(e.navigateToDefault({...t,reload:!0,replace:!0}),!0)}(t,x))return;if(function(e,t,a){return!e||!(!t||!a.areStatesEqual(e,t,!1))}(i,n,t))return;p=!0,t.navigateToState(i,n,x,(e,a)=>{p=!1,function(e,t,a,n,s,i,l){e?e.code===o.CANNOT_DEACTIVATE&&t&&a&&!n&&u(a,s.buildUrl(a.name,a.params),!0,i,l):s.invokeEventListeners(r.TRANSITION_SUCCESS,t,a,{replace:!0})}(e,a,n,l,t,c,T),v()},!1)}catch(e){p=!1,console.error(`[${i}] Critical error in onPopState`,e);try{const e=t.getState();if(e){const a=t.buildUrl(e.name,e.params);c.replaceState(e,"",a)}}catch(e){console.error(`[${i}] Failed to recover from critical error`,e)}v()}}return t.start=(...e)=>{const[r,o]=function(e,t,a){if(0===e.length){const e=t.getLocation(a);return"/"===e?[void 0,l]:[e,l]}if(1===e.length)return"function"==typeof e[0]?[t.getLocation(a),e[0]]:[e[0],l];const[r,o]=e;return[r,o]}(e,c,T);return r?a(r,o):a(o),t},t.buildUrl=(e,a)=>{const r=t.buildPath(e,a);return g()+b+r},t.matchUrl=e=>{const a=(e=>{try{const t=new URL(e,globalThis.location.origin),a=t.pathname,r=t.hash,o=t.search,n=g();if(!["http:","https:"].includes(t.protocol))return console.warn(`[${i}] Invalid URL protocol in ${e}`),null;if(T.useHash)return(S?r.replace(S,""):r.slice(1))+o;if(n){const e=h(n),t=P(`^${e}`),r=a.replace(t,"");return(r.startsWith("/")?"":"/")+r+o}return a+o}catch(t){return console.warn(`[${i}] Could not parse url ${e}`,t),null}})(e);return a?t.matchPath(a,s):void 0},t.replaceHistoryState=(e,a={})=>{const r=t.buildState(e,a);if(!r)throw new Error(`[real-router] Cannot replace state: route "${e}" is not found`);u(t.makeState(r.name,r.params,t.buildPath(r.name,r.params),{params:r.meta,options:{},redirected:!1},1),t.buildUrl(e,a),!0,c,T)},Object.defineProperty(t,"lastKnownState",{get:()=>n,set(e){n=e?Object.freeze({...e}):void 0},enumerable:!0,configurable:!0}),{onStart:()=>{U&&U(),U=c.addPopstateListener(w,T)},onStop:()=>{U&&(U(),U=void 0)},onTransitionSuccess:(e,a,r)=>{t.lastKnownState=e;const o=(r.replace??!a)||!!r.reload&&t.areStatesEqual(e,a,!1),n=t.buildUrl(e.name,e.params);u(e,!T.preserveHash||a&&a.path!==e.path?n:n+c.getHash(),o,c,T)},teardown:()=>{U&&(U(),U=void 0),t.start=a,delete t.buildUrl,delete t.matchUrl,delete t.replaceHistoryState,delete t.lastKnownState}}}}export{P as browserPluginFactory};//# sourceMappingURL=index.mjs.map
1
+ import{logger as e}from"@real-router/logger";import{events as t,errorCodes as r}from"@real-router/core";var n=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function a(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=>a(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=>a(e,t))}return!1}function o(e){if(null==e)return!0;const t=typeof e;return"string"===t||"boolean"===t||"number"===t&&Number.isFinite(e)}function s(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(!o(n)){const e=typeof n;if("function"===e||"symbol"===e)return!1;r=!0;break}}return!r||a(e)}function i(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 c(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)&&!i(e[t]))return!1;return!0}(t.params)||"options"in t&&"object"!=typeof t.options||"id"in t&&"number"!=typeof t.id||"redirected"in t&&"boolean"!=typeof t.redirected||"source"in t&&"string"!=typeof t.source)}function l(e){return"string"==typeof(t=e.name)&&(""===t||!(t.length>1e4)&&(!!t.startsWith("@@")||n.test(t)))&&"string"==typeof e.path&&s(e.params);var t}function u(e){if("object"!=typeof e||null===e)return!1;const t=e;return!!l(t)&&(void 0===t.meta||c(t.meta))}function h(e){if("object"!=typeof e||null===e)return!1;const t=e;return!!l(t)&&"meta"in t&&c(t.meta)}var p={forceDeactivate:!0,useHash:!1,hashPrefix:"",base:"",mergeState:!1,preserveHash:!0},f="popstate",d="browser-plugin",g=()=>{},b=new Map,m=e=>{const t=b.get(e);if(void 0!==t)return t;const r=e.replaceAll(/[$()*+.?[\\\]^{|}-]/g,String.raw`\$&`);return b.set(e,r),r};function y(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 v(e,t){return e in t}function S(e,t,r){const n=typeof t;return n===r||void 0===t||(console.warn(`[${d}] Invalid type for '${e}': expected ${r}, got ${n}`),!1)}var w=()=>{},T=()=>globalThis.location.pathname,$=(()=>{let e,t=!1;return()=>{const r=globalThis.navigator.userAgent;return r!==e&&(e=r,t=!r.includes("Trident")),t}})(),H=(e,t,r)=>{globalThis.history.pushState(e,t??"",r)},P=(e,t,r)=>{globalThis.history.replaceState(e,t??"",r)},j=(e,t)=>{const r=t.useHash&&!$();return globalThis.addEventListener("popstate",e),r&&globalThis.addEventListener("hashchange",e),()=>{globalThis.removeEventListener("popstate",e),r&&globalThis.removeEventListener("hashchange",e)}},L=(()=>{const e=new Map;return t=>{let r=e.get(t);return r||(r=new RegExp(t),e.set(t,r)),r}})(),O=e=>{const{useHash:t,hashPrefix:r="",base:n=""}=e;if(!r&&!n){const e=t?globalThis.location.hash.slice(1):globalThis.location.pathname;return(A(e)||"/")+globalThis.location.search}const a=m(r),o=m(n),s=t?globalThis.location.hash.replace(L(`^#${a}`),""):globalThis.location.pathname.replace(L(`^${o}`),"");return(A(s)||"/")+globalThis.location.search},A=t=>{try{return encodeURI(decodeURI(t))}catch(r){return e.warn(d,`Could not encode path "${t}"`,r),t}},U=()=>{if(globalThis.history.state){if(h(globalThis.history.state))return globalThis.history.state;e.warn(d,"History state is not a valid state object, ignoring",globalThis.history.state)}},x=()=>globalThis.location.hash;function E(n,a=function(){return void 0!==globalThis.window&&globalThis.history?{getBase:T,pushState:H,replaceState:P,addPopstateListener:j,getLocation:O,getState:U,getHash:x}:function(){let t=!1;const r=r=>{t||(e.warn(d,`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.`),t=!0)};return{getBase:()=>(r("getBase"),""),pushState:()=>{r("pushState")},replaceState:()=>{r("replaceState")},addPopstateListener:()=>(r("addPopstateListener"),w),getLocation:()=>(r("getLocation"),""),getState:()=>{r("getState")},getHash:()=>(r("getHash"),"")}}()}()){const o=function(e,t){if(!e)return!1;let r=!1;for(const n of Object.keys(e))v(n,t)&&(S(n,e[n],typeof t[n])||(r=!0));if(!0===e.useHash&&"preserveHash"in e&&console.warn(`[${d}] preserveHash ignored in hash mode`),!1===e.useHash&&"hashPrefix"in e){const t=e.hashPrefix;void 0!==t&&""!==t&&console.warn(`[${d}] hashPrefix ignored in history mode`)}return r}(n,p);let s={...p,...n};o&&(console.warn(`[${d}] Using default options due to invalid types`),s={...p}),!0===s.useHash?delete s.preserveHash:delete s.hashPrefix,s.base&&"string"==typeof s.base&&(s.base.startsWith("/")||(s.base=`/${s.base}`),s.base.endsWith("/")&&(s.base=s.base.slice(0,-1)));const i=new Map,c=e=>{const t=i.get(e);if(void 0!==t)return t;const r=new RegExp(e);return i.set(e,r),r},l=s.forceDeactivate,h=void 0===l?{source:f}:{forceDeactivate:l,source:f};let b;return function(e){const n=e.start;let o,i=!1,l=null;const p=()=>s.base??"",v=s.hashPrefix??"",S=m(v),w=s.useHash?`#${v}`:"",T=S?c(`^#${S}`):null;function $(){if(l){const e=l;l=null,console.warn(`[${d}] Processing deferred popstate event`),H(e)}}function H(n){if(i)return console.warn(`[${d}] Transition in progress, deferring popstate event`),void(l=n);try{const o=e.getState(),c=function(e,t,r,n,a){return u(e.state)?t.makeState(e.state.name,e.state.params,e.state.path,{...e.state.meta,params:e.state.meta?.params??{},options:e.state.meta?.options??{},redirected:!!e.state.meta?.redirected,source:a},e.state.meta?.id):t.matchPath(r.getLocation(n),a)}(n,e,a,s,f),l=!u(n.state);if(!c&&function(e,t){const r=e.getOptions(),{defaultRoute:n}=r;return!!n&&(e.navigateToDefault({...t,reload:!0,replace:!0}),!0)}(e,h))return;if(function(e,t,r){return!e||!(!t||!r.areStatesEqual(e,t,!1))}(c,o,e))return;i=!0,e.navigateToState(c,o,h,(n,c)=>{i=!1,function(e,n,a,o,s,i,c){e?e.code===r.CANNOT_DEACTIVATE&&n&&a&&!o&&y(a,s.buildUrl(a.name,a.params),!0,i,c):s.invokeEventListeners(t.TRANSITION_SUCCESS,n,a,{replace:!0})}(n,c,o,l,e,a,s),$()},!1)}catch(t){i=!1,console.error(`[${d}] Critical error in onPopState`,t);try{const t=e.getState();if(t){const r=e.buildUrl(t.name,t.params);a.replaceState(t,"",r)}}catch(e){console.error(`[${d}] Failed to recover from critical error`,e)}$()}}return e.start=(...t)=>{const[r,o]=function(e,t,r){if(0===e.length){const e=t.getLocation(r);return"/"===e?[void 0,g]:[e,g]}if(1===e.length)return"function"==typeof e[0]?[t.getLocation(r),e[0]]:[e[0],g];const[n,a]=e;return[n,a]}(t,a,s);return r?n(r,o):n(o),e},e.buildUrl=(t,r)=>{const n=e.buildPath(t,r);return p()+w+n},e.matchUrl=t=>{const r=(e=>{try{const t=new URL(e,globalThis.location.origin),r=t.pathname,n=t.hash,a=t.search,o=p();if(!["http:","https:"].includes(t.protocol))return console.warn(`[${d}] Invalid URL protocol in ${e}`),null;if(s.useHash)return(T?n.replace(T,""):n.slice(1))+a;if(o){const e=m(o),t=c(`^${e}`),n=r.replace(t,"");return(n.startsWith("/")?"":"/")+n+a}return r+a}catch(t){return console.warn(`[${d}] Could not parse url ${e}`,t),null}})(t);return r?e.matchPath(r,f):void 0},e.replaceHistoryState=(t,r={})=>{const n=e.buildState(t,r);if(!n)throw new Error(`[real-router] Cannot replace state: route "${t}" is not found`);y(e.makeState(n.name,n.params,e.buildPath(n.name,n.params),{params:n.meta,options:{},redirected:!1},1),e.buildUrl(t,r),!0,a,s)},Object.defineProperty(e,"lastKnownState",{get:()=>o,set(e){o=e?Object.freeze({...e}):void 0},enumerable:!0,configurable:!0}),{onStart:()=>{b&&b(),b=a.addPopstateListener(H,s)},onStop:()=>{b&&(b(),b=void 0)},onTransitionSuccess:(t,r,n)=>{e.lastKnownState=t;const o=(n.replace??!r)||!!n.reload&&e.areStatesEqual(t,r,!1),i=e.buildUrl(t.name,t.params);y(t,!s.preserveHash||r&&r.path!==t.path?i:i+a.getHash(),o,a,s)},teardown:()=>{b&&(b(),b=void 0),e.start=n,delete e.buildUrl,delete e.matchUrl,delete e.replaceHistoryState,delete e.lastKnownState}}}}export{E as browserPluginFactory,h as isHistoryState,u as isState};//# sourceMappingURL=index.mjs.map
package/dist/esm/index.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/constants.ts","../../src/utils.ts","../../src/browser.ts","../../src/plugin.ts"],"names":["source","isState","defaultOptions","rawPath","safePath","getCachedRegExp","getBase"],"mappings":"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","file":"index.mjs","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, events } from \"@real-router/core\";\nimport { isStateStrict as isState } from \"type-guards\";\n\nimport { type DefaultBrowserPluginOptions, LOGGER_CONTEXT } from \"./constants\";\n\nimport type {\n BrowserPluginOptions,\n HistoryState,\n StartRouterArguments,\n Browser,\n} from \"./types\";\nimport type {\n Router,\n State,\n DoneFn,\n NavigationOptions,\n RouterError,\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 * Extracts start router arguments from various overloads\n *\n * @param args - Arguments passed to router.start()\n * @param browser - Browser API instance\n * @param options - Browser plugin options\n * @returns Tuple of [startPathOrState, done callback]\n */\nexport function getStartRouterArguments(\n args: StartRouterArguments,\n browser: Browser,\n options: BrowserPluginOptions,\n): [startPathOrState: string | State | undefined, done: DoneFn] {\n if (args.length === 0) {\n const location = browser.getLocation(options);\n\n if (location === \"/\") {\n return [undefined, noop];\n }\n\n return [location, noop];\n }\n\n if (args.length === 1) {\n if (typeof args[0] === \"function\") {\n return [browser.getLocation(options), args[0]];\n }\n\n return [args[0], noop];\n }\n\n // args.length === 2\n const [pathOrState, done] = args as [string | State, DoneFn];\n\n return [pathOrState, done];\n}\n\n/**\n * Creates state from popstate event\n *\n * @param evt - PopStateEvent from browser\n * @param router - Router instance\n * @param browser - Browser API instance\n * @param options - Browser plugin options\n * @param source - Event source identifier\n * @returns Router state or undefined\n */\nexport function createStateFromEvent(\n evt: PopStateEvent,\n router: Router,\n browser: Browser,\n options: BrowserPluginOptions,\n source: string,\n): State | undefined {\n const isNewState = !isState(evt.state);\n\n if (isNewState) {\n return router.matchPath(browser.getLocation(options), source);\n }\n\n return router.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 options: evt.state.meta?.options ?? {},\n redirected: !!evt.state.meta?.redirected,\n source,\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 transitionOptions - Options for transition\n * @returns true if handled, false if no default route\n */\nexport function handleMissingState(\n router: Router,\n transitionOptions: NavigationOptions,\n): boolean {\n const routerOptions = router.getOptions();\n const { defaultRoute } = routerOptions;\n\n if (!defaultRoute) {\n return false;\n }\n\n 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, redirect, or error)\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 // Successful transition\n if (!err) {\n router.invokeEventListeners(events.TRANSITION_SUCCESS, toState, fromState, {\n replace: true,\n });\n\n return;\n }\n\n // Handle CANNOT_DEACTIVATE\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 \"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 { 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 getStartRouterArguments,\n validateOptions,\n} from \"./utils\";\n\nimport type {\n BrowserPluginOptions,\n Browser,\n HistoryState,\n StartRouterArguments,\n} 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 const forceDeactivate = options.forceDeactivate;\n /* v8 ignore next 2 -- @preserve both branches tested, coverage tool limitation */\n const transitionOptions =\n forceDeactivate === undefined ? { source } : { forceDeactivate, source };\n\n let removePopStateListener: (() => void) | undefined;\n\n return function browserPlugin(router: Router) {\n // Store original methods for restoration on teardown\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 * If no start path is provided, uses current browser URL.\n */\n router.start = (...args: StartRouterArguments) => {\n const [startPath, done] = getStartRouterArguments(args, browser, options);\n\n if (startPath) {\n routerStart(startPath, done);\n } else {\n routerStart(done);\n }\n\n return router;\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 ? router.matchPath(path, source) : 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 = router.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 = router.makeState(\n state.name,\n state.params,\n router.buildPath(state.name, state.params),\n {\n params: state.meta,\n options: {},\n redirected: false,\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 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 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(\n evt,\n router,\n browser,\n options,\n source,\n );\n const isNewState = !isState(evt.state);\n\n // Handle missing state\n if (!state && handleMissingState(router, 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 // Note: state is guaranteed to be defined here because:\n // 1. handleMissingState handles !state case (line 332)\n // 2. shouldSkipTransition returns true when !state (utils.ts:136)\n isTransitioning = true;\n\n // Use internal navigateToState without emitting TRANSITION_SUCCESS\n // We'll emit it in handleTransitionResult if needed\n router.navigateToState(\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed by shouldSkipTransition\n state!,\n routerState,\n transitionOptions,\n (err: RouterError | undefined, toState: State | undefined) => {\n isTransitioning = false;\n handleTransitionResult(\n err,\n toState,\n routerState,\n isNewState,\n router,\n browser,\n options,\n );\n\n // Process any deferred popstate events after transition completes\n processDeferredEvent();\n },\n false, // emitSuccess = false - handleTransitionResult will emit if needed\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 onPopState,\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"]}
1
+ {"version":3,"sources":["../../../type-guards/src/internal/router-error.ts","../../../type-guards/src/guards/routes.ts","../../../type-guards/src/guards/params.ts","../../../type-guards/src/internal/meta-fields.ts","../../../type-guards/src/guards/state.ts","../../src/constants.ts","../../src/utils.ts","../../src/browser.ts","../../src/plugin.ts"],"names":["source","defaultOptions","rawPath","safePath","getCachedRegExp","getBase"],"mappings":"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","file":"index.mjs","sourcesContent":["// packages/type-guards/modules/internal/router-error.ts\n\n/**\n * Checks if string contains at least one non-whitespace character.\n * Used to validate that route name is not empty or only whitespace.\n * Matches: any non-whitespace character (\\S = [^ \\t\\n\\r\\f])\n *\n * @internal\n */\nexport const HAS_NON_WHITESPACE = /\\S/;\n\n/**\n * Pattern for complete route validation (all segments at once).\n * Matches: single segment or multiple segments separated by dots.\n * Each segment must start with letter/underscore, followed by alphanumeric/hyphen/underscore.\n * Rejects: leading/trailing/consecutive dots, segments starting with numbers/hyphens.\n * Note: Empty string is handled by early return in validateRouteName.\n *\n * @internal\n */\nexport const FULL_ROUTE_PATTERN = /^[A-Z_a-z][\\w-]*(?:\\.[A-Z_a-z][\\w-]*)*$/;\n\n/**\n * Maximum route name length to prevent DoS and performance issues.\n * This is a technical limit, not a business constraint.\n * Real route names rarely exceed 200 characters even with deep nesting.\n *\n * @internal\n */\nexport const MAX_ROUTE_NAME_LENGTH = 10_000;\n\n/**\n * Creates a TypeError with consistent router error message format.\n *\n * @param methodName - Name of the method that triggered the error\n * @param message - Error message\n * @returns TypeError with formatted message\n * @internal\n */\nexport function createRouterError(\n methodName: string,\n message: string,\n): TypeError {\n return new TypeError(`[router.${methodName}] ${message}`);\n}\n","// packages/type-guards/modules/guards/routes.ts\n\nimport {\n FULL_ROUTE_PATTERN,\n MAX_ROUTE_NAME_LENGTH,\n} from \"../internal/router-error\";\n\n/**\n * Type guard that checks if a value is a valid route name.\n *\n * Route name rules:\n * - Must be a string\n * - Empty string (\"\") is valid and represents the root node\n * - Can use dots (.) for hierarchy (e.g., \"users.profile\")\n * - Each segment must match [a-zA-Z_][a-zA-Z0-9_-]*\n * - No consecutive dots (..)\n * - No leading/trailing dots\n * - Cannot contain only whitespace\n * - System routes (starting with @@) bypass pattern validation\n *\n * @param name - Value to check\n * @returns true if name is a valid route name string\n *\n * @example\n * // Valid names\n * isRouteName(\"\"); // true (root node)\n * isRouteName(\"home\"); // true\n * isRouteName(\"users.profile\"); // true\n * isRouteName(\"admin_panel\"); // true\n * isRouteName(\"api-v2\"); // true\n * isRouteName(\"@@router/UNKNOWN_ROUTE\"); // true (system route)\n *\n * @example\n * // Invalid names\n * isRouteName(\" \"); // false (only whitespace)\n * isRouteName(\".users\"); // false (leading dot)\n * isRouteName(\"users.\"); // false (trailing dot)\n * isRouteName(\"users..profile\"); // false (consecutive dots)\n * isRouteName(\"users.123\"); // false (segment starts with number)\n * isRouteName(\"users profile\"); // false (contains space)\n */\nexport function isRouteName(name: unknown): name is string {\n if (typeof name !== \"string\") {\n return false;\n }\n\n // Empty string is valid (represents root node)\n if (name === \"\") {\n return true;\n }\n\n // Too long is invalid\n if (name.length > MAX_ROUTE_NAME_LENGTH) {\n return false;\n }\n\n // System routes are valid (bypass pattern validation)\n if (name.startsWith(\"@@\")) {\n return true;\n }\n\n // Regular routes must match pattern\n // Note: FULL_ROUTE_PATTERN rejects whitespace-only strings\n return FULL_ROUTE_PATTERN.test(name);\n}\n","// packages/type-guards/modules/guards/params.ts\n\nimport type { Params } from \"core-types\";\n\n/**\n * Internal helper to check if value is serializable (no circular refs, functions, instances).\n * Recursively validates the entire object tree with protection against circular references.\n *\n * @param value - Value to check\n * @param visited - Set of visited objects to detect circular references\n * @returns true if value can be serialized\n * @internal\n */\nfunction isSerializable(\n value: unknown,\n visited = new WeakSet<object>(),\n): boolean {\n // null/undefined are serializable (JSON.stringify handles them)\n if (value === null || value === undefined) {\n return true;\n }\n\n const type = typeof value;\n\n // Primitives: string, boolean\n if (type === \"string\" || type === \"boolean\") {\n return true;\n }\n\n // Numbers: must be finite (reject NaN and Infinity)\n if (type === \"number\") {\n return Number.isFinite(value);\n }\n\n // Functions and symbols cannot be serialized\n if (type === \"function\" || type === \"symbol\") {\n return false;\n }\n\n // Arrays (including nested arrays)\n if (Array.isArray(value)) {\n // Circular reference detection\n if (visited.has(value)) {\n return false;\n }\n\n visited.add(value);\n\n // Recursively check all items\n return value.every((item) => isSerializable(item, visited));\n }\n\n // Objects\n if (type === \"object\") {\n // Circular reference detection\n if (visited.has(value)) {\n return false;\n }\n\n // Add to visited set\n visited.add(value);\n\n // Only allow plain objects (reject Date, RegExp, Map, Set, etc.)\n const proto = Object.getPrototypeOf(value) as object | null;\n\n if (proto !== null && proto !== Object.prototype) {\n return false; // Instance of a class\n }\n\n // Recursively check all values\n return Object.values(value).every((v) => isSerializable(v, visited));\n }\n\n return false;\n}\n\n/**\n * Fast path check for primitive values (no recursion needed).\n * Returns true if primitive, false if needs deeper inspection.\n *\n * @internal\n */\nfunction isPrimitiveValue(value: unknown): boolean {\n if (value === null || value === undefined) {\n return true;\n }\n\n const type = typeof value;\n\n if (type === \"string\" || type === \"boolean\") {\n return true;\n }\n\n if (type === \"number\") {\n return Number.isFinite(value);\n }\n\n // object, array, function, symbol — need deeper check\n return false;\n}\n\n/**\n * Type guard for Params object.\n * Validates that all values are serializable (primitives, arrays, nested arrays, or nested objects).\n * Rejects circular references, functions, symbols, and class instances.\n * Allows null/undefined anywhere (objects and arrays).\n *\n * Performance optimization: Uses two-phase validation.\n * Phase 1 (fast path): Check if all values are primitives — O(p) without recursion.\n * Phase 2 (slow path): Full recursive validation only if nested structures detected.\n *\n * @param value - Value to check\n * @returns true if value is a valid Params object\n *\n * @example\n * // Valid\n * isParams({ id: '123', page: 1 }); // true (fast path)\n * isParams({ sort: ['name', 'age'] }); // true (slow path)\n * isParams({ filter: { status: 'active' } }); // true (slow path)\n * isParams({ teamId: null, orgId: undefined }); // true (fast path)\n * isParams({ matrix: [[1, 2], [3, 4]] }); // true (slow path)\n * isParams({ users: [{ id: 1 }, { id: 2 }] }); // true (slow path)\n * isParams({ scores: [100, null, 85] }); // true (slow path)\n *\n * // Invalid\n * isParams({ fn: () => {} }); // false (function)\n * isParams({ date: new Date() }); // false (class instance)\n * isParams({ self: circularRef }); // false (circular reference)\n * isParams(null); // false (not an object)\n * isParams([]); // false (array, not object)\n */\nexport function isParams(value: unknown): value is Params {\n // Reject null, undefined, and arrays (must be a plain object)\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n return false;\n }\n\n // Reject objects with custom prototype (e.g., Object.create(proto), class instances)\n // This check is required for both fast and slow paths\n const proto = Object.getPrototypeOf(value) as object | null;\n\n if (proto !== null && proto !== Object.prototype) {\n return false;\n }\n\n // Phase 1: Fast path for flat objects (95%+ of real-world params)\n // Check if all values are primitives — no recursion, no WeakSet allocation\n let needsDeepCheck = false;\n\n for (const key in value) {\n // Skip inherited properties (only check own properties for fast path)\n // Note: With proto === Object.prototype check above, inherited properties\n // would only come from Object.prototype, which has no enumerable properties.\n // This check is defensive against Object.prototype pollution.\n /* v8 ignore next 3 -- @preserve Defensive: Object.prototype pollution */\n if (!Object.hasOwn(value, key)) {\n continue;\n }\n\n const val = (value as Record<string, unknown>)[key];\n\n if (!isPrimitiveValue(val)) {\n // Found non-primitive — need full validation\n // But first check for obvious invalids (functions, symbols)\n const type = typeof val;\n\n if (type === \"function\" || type === \"symbol\") {\n return false; // Early reject\n }\n\n needsDeepCheck = true;\n\n break; // Exit fast path, proceed to slow path\n }\n }\n\n // Fast path: all primitives, valid params\n if (!needsDeepCheck) {\n return true;\n }\n\n // Phase 2: Slow path — full recursive validation\n return isSerializable(value);\n}\n\n/**\n * Internal helper for strict param validation (browser plugin).\n * Only allows primitives and arrays of primitives, no nested objects.\n *\n * @param value - Value to check\n * @returns true if value is valid\n * @internal\n */\nexport function isValidParamValueStrict(value: unknown): boolean {\n if (value === null || value === undefined) {\n return true;\n }\n\n const type = typeof value;\n\n // Primitives: string, boolean, finite number\n if (type === \"string\" || type === \"boolean\") {\n return true;\n }\n\n if (type === \"number\") {\n return Number.isFinite(value as number);\n }\n\n // Arrays of primitives only\n if (Array.isArray(value)) {\n return value.every((item) => {\n const itemType = typeof item;\n\n // Primitives: string, boolean, finite number\n if (itemType === \"string\" || itemType === \"boolean\") {\n return true;\n }\n\n if (itemType === \"number\") {\n return Number.isFinite(item);\n }\n\n // Reject everything else (objects, arrays, functions, symbols, etc.)\n return false;\n });\n }\n\n // Reject objects, functions, symbols, etc.\n return false;\n}\n\n/**\n * Strict type guard for Params (browser plugin version).\n * Only allows primitives and arrays of primitives, no nested objects.\n *\n * @param value - Value to check\n * @returns true if value is a valid Params object\n */\nexport function isParamsStrict(value: unknown): value is Params {\n // Check if value is an object (null returns \"object\" but fails Array.isArray and other checks)\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n return false;\n }\n\n // Check all own properties have valid param values\n for (const key in value) {\n if (!Object.hasOwn(value, key)) {\n continue; // Skip inherited properties\n }\n\n const val = (value as Record<string, unknown>)[key];\n\n if (!isValidParamValueStrict(val)) {\n return false;\n }\n }\n\n return true;\n}\n","// packages/type-guards/modules/internal/meta-fields.ts\n\nimport { isParams, isParamsStrict } from \"../guards/params\";\nimport { isRouteName } from \"../guards/routes\";\n\nimport type { Params, StateMeta } from \"core-types\";\n\n/**\n * Type guard for meta object fields if present.\n * Used by both isStateStrict and isHistoryState.\n *\n * @param meta - Value to check\n * @returns true if meta has valid StateMeta structure\n * @internal\n */\nexport function isMetaFields<MP extends Params = Params>(\n meta: unknown,\n): meta is StateMeta<MP> {\n // Early check: must be a non-null object\n if (typeof meta !== \"object\" || meta === null) {\n return false;\n }\n\n const obj = meta as Record<string, unknown>;\n\n // Check params field if present\n if (\"params\" in obj && !isParamsStrict(obj.params)) {\n return false;\n }\n\n // Check options field if present\n if (\"options\" in obj && typeof obj.options !== \"object\") {\n return false;\n }\n\n // Check id field if present\n if (\"id\" in obj && typeof obj.id !== \"number\") {\n return false;\n }\n\n // Check redirected field if present\n if (\"redirected\" in obj && typeof obj.redirected !== \"boolean\") {\n return false;\n }\n\n // Check source field if present\n return !(\"source\" in obj && typeof obj.source !== \"string\");\n}\n\n/**\n * Type guard helper that checks if required State fields have valid types.\n * Validates that name, path, and params exist and have correct types.\n * Used by both isStateStrict and isHistoryState.\n *\n * @param obj - Object to check\n * @returns true if object has valid required fields\n * @internal\n */\nexport function isRequiredFields(obj: Record<string, unknown>): boolean {\n return (\n isRouteName(obj.name) &&\n typeof obj.path === \"string\" &&\n isParams(obj.params)\n );\n}\n","// packages/type-guards/modules/guards/state.ts\n\nimport { isMetaFields, isRequiredFields } from \"../internal/meta-fields\";\n\nimport type { Params, State } from \"core-types\";\n\n/**\n * Type guard for State object.\n * Checks for required fields: name, params, path.\n * Does NOT validate meta field deeply.\n *\n * @param value - Value to check\n * @returns true if value is a valid State object\n *\n * @example\n * isState({ name: 'home', params: {}, path: '/' }); // true\n * isState({ name: 'home', path: '/' }); // false (missing params)\n */\nexport function isState<P extends Params = Params, MP extends Params = Params>(\n value: unknown,\n): value is State<P, MP> {\n if (typeof value !== \"object\" || value === null) {\n return false;\n }\n\n const obj = value as Record<string, unknown>;\n\n return isRequiredFields(obj);\n}\n\n/**\n * Enhanced type guard for State with deep validation.\n * Checks not only presence but also types of all required fields.\n * Validates params using isParams and meta structure if present.\n *\n * @param value - Value to check\n * @returns true if value is a valid State object with correct types\n *\n * @example\n * isStateStrict({ name: 'home', params: {}, path: '/', meta: { id: 1 } }); // true\n * isStateStrict({ name: 'home', params: 'invalid', path: '/' }); // false\n */\nexport function isStateStrict<\n P extends Params = Params,\n MP extends Params = Params,\n>(value: unknown): value is State<P, MP> {\n // Basic structure check\n if (typeof value !== \"object\" || value === null) {\n return false;\n }\n\n const obj = value as Record<string, unknown>;\n\n // Check required fields and their types\n if (!isRequiredFields(obj)) {\n return false;\n }\n\n // Validate meta if present\n if (obj.meta !== undefined) {\n return isMetaFields(obj.meta);\n }\n\n return true;\n}\n\n/**\n * Type guard for HistoryState (browser plugin).\n * HistoryState must have meta object with specific structure.\n * This is stricter than regular State validation.\n *\n * @param value - Value to check\n * @returns true if value is a valid HistoryState object\n */\nexport function isHistoryState(value: unknown): value is State & {\n meta: NonNullable<State[\"meta\"]>;\n} {\n // Basic structure check\n if (typeof value !== \"object\" || value === null) {\n return false;\n }\n\n const obj = value as Record<string, unknown>;\n\n // Check required fields and their types\n if (!isRequiredFields(obj)) {\n return false;\n }\n\n // HistoryState requires meta to be present and valid\n // Note: The check !(\"meta\" in obj) is redundant because isMetaFields(undefined) returns false\n // However, we keep it for clarity and explicit error semantics\n return \"meta\" in obj && isMetaFields(obj.meta);\n}\n","// 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, events } from \"@real-router/core\";\nimport { isStateStrict as isState } from \"type-guards\";\n\nimport { type DefaultBrowserPluginOptions, LOGGER_CONTEXT } from \"./constants\";\n\nimport type {\n BrowserPluginOptions,\n HistoryState,\n StartRouterArguments,\n Browser,\n} from \"./types\";\nimport type {\n Router,\n State,\n DoneFn,\n NavigationOptions,\n RouterError,\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 * Extracts start router arguments from various overloads\n *\n * @param args - Arguments passed to router.start()\n * @param browser - Browser API instance\n * @param options - Browser plugin options\n * @returns Tuple of [startPathOrState, done callback]\n */\nexport function getStartRouterArguments(\n args: StartRouterArguments,\n browser: Browser,\n options: BrowserPluginOptions,\n): [startPathOrState: string | State | undefined, done: DoneFn] {\n if (args.length === 0) {\n const location = browser.getLocation(options);\n\n if (location === \"/\") {\n return [undefined, noop];\n }\n\n return [location, noop];\n }\n\n if (args.length === 1) {\n if (typeof args[0] === \"function\") {\n return [browser.getLocation(options), args[0]];\n }\n\n return [args[0], noop];\n }\n\n // args.length === 2\n const [pathOrState, done] = args as [string | State, DoneFn];\n\n return [pathOrState, done];\n}\n\n/**\n * Creates state from popstate event\n *\n * @param evt - PopStateEvent from browser\n * @param router - Router instance\n * @param browser - Browser API instance\n * @param options - Browser plugin options\n * @param source - Event source identifier\n * @returns Router state or undefined\n */\nexport function createStateFromEvent(\n evt: PopStateEvent,\n router: Router,\n browser: Browser,\n options: BrowserPluginOptions,\n source: string,\n): State | undefined {\n const isNewState = !isState(evt.state);\n\n if (isNewState) {\n return router.matchPath(browser.getLocation(options), source);\n }\n\n return router.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 options: evt.state.meta?.options ?? {},\n redirected: !!evt.state.meta?.redirected,\n source,\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 transitionOptions - Options for transition\n * @returns true if handled, false if no default route\n */\nexport function handleMissingState(\n router: Router,\n transitionOptions: NavigationOptions,\n): boolean {\n const routerOptions = router.getOptions();\n const { defaultRoute } = routerOptions;\n\n if (!defaultRoute) {\n return false;\n }\n\n 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, redirect, or error)\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 // Successful transition\n if (!err) {\n router.invokeEventListeners(events.TRANSITION_SUCCESS, toState, fromState, {\n replace: true,\n });\n\n return;\n }\n\n // Handle CANNOT_DEACTIVATE\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 { 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 getStartRouterArguments,\n validateOptions,\n} from \"./utils\";\n\nimport type {\n BrowserPluginOptions,\n Browser,\n HistoryState,\n StartRouterArguments,\n} 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 const forceDeactivate = options.forceDeactivate;\n /* v8 ignore next 2 -- @preserve both branches tested, coverage tool limitation */\n const transitionOptions =\n forceDeactivate === undefined ? { source } : { forceDeactivate, source };\n\n let removePopStateListener: (() => void) | undefined;\n\n return function browserPlugin(router: Router) {\n // Store original methods for restoration on teardown\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 * If no start path is provided, uses current browser URL.\n */\n router.start = (...args: StartRouterArguments) => {\n const [startPath, done] = getStartRouterArguments(args, browser, options);\n\n if (startPath) {\n routerStart(startPath, done);\n } else {\n routerStart(done);\n }\n\n return router;\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 ? router.matchPath(path, source) : 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 = router.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 = router.makeState(\n state.name,\n state.params,\n router.buildPath(state.name, state.params),\n {\n params: state.meta,\n options: {},\n redirected: false,\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 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 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(\n evt,\n router,\n browser,\n options,\n source,\n );\n const isNewState = !isState(evt.state);\n\n // Handle missing state\n if (!state && handleMissingState(router, 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 // Note: state is guaranteed to be defined here because:\n // 1. handleMissingState handles !state case (line 332)\n // 2. shouldSkipTransition returns true when !state (utils.ts:136)\n isTransitioning = true;\n\n // Use internal navigateToState without emitting TRANSITION_SUCCESS\n // We'll emit it in handleTransitionResult if needed\n router.navigateToState(\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed by shouldSkipTransition\n state!,\n routerState,\n transitionOptions,\n (err: RouterError | undefined, toState: State | undefined) => {\n isTransitioning = false;\n handleTransitionResult(\n err,\n toState,\n routerState,\n isNewState,\n router,\n browser,\n options,\n );\n\n // Process any deferred popstate events after transition completes\n processDeferredEvent();\n },\n false, // emitSuccess = false - handleTransitionResult will emit if needed\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 onPopState,\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"]}
package/dist/esm/metafile-esm.json CHANGED
@@ -1 +1 @@
1
- {"inputs":{"src/constants.ts":{"bytes":1668,"imports":[],"format":"esm"},"src/utils.ts":{"bytes":8548,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"type-guards","kind":"import-statement","external":true},{"path":"src/constants.ts","kind":"import-statement","original":"./constants"}],"format":"esm"},"src/browser.ts":{"bytes":6847,"imports":[{"path":"logger","kind":"import-statement","external":true},{"path":"type-guards","kind":"import-statement","external":true},{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"src/utils.ts","kind":"import-statement","original":"./utils"}],"format":"esm"},"src/plugin.ts":{"bytes":15343,"imports":[{"path":"type-guards","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/utils.ts","kind":"import-statement","original":"./utils"}],"format":"esm"},"src/index.ts":{"bytes":1277,"imports":[{"path":"src/plugin.ts","kind":"import-statement","original":"./plugin"},{"path":"type-guards","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":45982},"dist/esm/index.mjs":{"imports":[{"path":"type-guards","kind":"import-statement","external":true},{"path":"logger","kind":"import-statement","external":true},{"path":"type-guards","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"type-guards","kind":"import-statement","external":true},{"path":"type-guards","kind":"import-statement","external":true}],"exports":["browserPluginFactory","isHistoryState","isState"],"entryPoint":"src/index.ts","inputs":{"src/plugin.ts":{"bytesInOutput":8327},"src/browser.ts":{"bytesInOutput":4074},"src/constants.ts":{"bytesInOutput":205},"src/utils.ts":{"bytesInOutput":4084},"src/index.ts":{"bytesInOutput":80}},"bytes":17211}}}
1
+ {"inputs":{"../type-guards/src/guards/navigation.ts":{"bytes":1316,"imports":[],"format":"esm"},"../type-guards/src/internal/router-error.ts":{"bytes":1468,"imports":[],"format":"esm"},"../type-guards/src/guards/routes.ts":{"bytes":2060,"imports":[{"path":"../type-guards/src/internal/router-error.ts","kind":"import-statement","original":"../internal/router-error"}],"format":"esm"},"../type-guards/src/guards/params.ts":{"bytes":7491,"imports":[],"format":"esm"},"../type-guards/src/internal/meta-fields.ts":{"bytes":1757,"imports":[{"path":"../type-guards/src/guards/params.ts","kind":"import-statement","original":"../guards/params"},{"path":"../type-guards/src/guards/routes.ts","kind":"import-statement","original":"../guards/routes"}],"format":"esm"},"../type-guards/src/guards/state.ts":{"bytes":2689,"imports":[{"path":"../type-guards/src/internal/meta-fields.ts","kind":"import-statement","original":"../internal/meta-fields"}],"format":"esm"},"../type-guards/src/guards/primitives.ts":{"bytes":1632,"imports":[],"format":"esm"},"../type-guards/src/guards/index.ts":{"bytes":486,"imports":[{"path":"../type-guards/src/guards/navigation.ts","kind":"import-statement","original":"./navigation"},{"path":"../type-guards/src/guards/routes.ts","kind":"import-statement","original":"./routes"},{"path":"../type-guards/src/guards/state.ts","kind":"import-statement","original":"./state"},{"path":"../type-guards/src/guards/primitives.ts","kind":"import-statement","original":"./primitives"},{"path":"../type-guards/src/guards/params.ts","kind":"import-statement","original":"./params"}],"format":"esm"},"../type-guards/src/validators/routes.ts":{"bytes":3141,"imports":[{"path":"../type-guards/src/internal/router-error.ts","kind":"import-statement","original":"../internal/router-error"}],"format":"esm"},"../type-guards/src/utilities/type-description.ts":{"bytes":1232,"imports":[],"format":"esm"},"../type-guards/src/validators/state.ts":{"bytes":1055,"imports":[{"path":"../type-guards/src/guards/index.ts","kind":"import-statement","original":"../guards"},{"path":"../type-guards/src/utilities/type-description.ts","kind":"import-statement","original":"../utilities/type-description"}],"format":"esm"},"../type-guards/src/validators/index.ts":{"bytes":197,"imports":[{"path":"../type-guards/src/validators/routes.ts","kind":"import-statement","original":"./routes"},{"path":"../type-guards/src/validators/state.ts","kind":"import-statement","original":"./state"}],"format":"esm"},"../type-guards/src/index.ts":{"bytes":1416,"imports":[{"path":"../type-guards/src/guards/index.ts","kind":"import-statement","original":"./guards"},{"path":"../type-guards/src/validators/index.ts","kind":"import-statement","original":"./validators"},{"path":"../type-guards/src/utilities/type-description.ts","kind":"import-statement","original":"./utilities/type-description"}],"format":"esm"},"src/constants.ts":{"bytes":1668,"imports":[],"format":"esm"},"src/utils.ts":{"bytes":8548,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"../type-guards/src/index.ts","kind":"import-statement","original":"type-guards"},{"path":"src/constants.ts","kind":"import-statement","original":"./constants"}],"format":"esm"},"src/browser.ts":{"bytes":6860,"imports":[{"path":"@real-router/logger","kind":"import-statement","external":true},{"path":"../type-guards/src/index.ts","kind":"import-statement","original":"type-guards"},{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"src/utils.ts","kind":"import-statement","original":"./utils"}],"format":"esm"},"src/plugin.ts":{"bytes":15343,"imports":[{"path":"../type-guards/src/index.ts","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"}],"format":"esm"},"src/index.ts":{"bytes":1277,"imports":[{"path":"src/plugin.ts","kind":"import-statement","original":"./plugin"},{"path":"../type-guards/src/index.ts","kind":"import-statement","original":"type-guards"}],"format":"esm"}},"outputs":{"dist/esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":64244},"dist/esm/index.mjs":{"imports":[{"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":{"../type-guards/src/internal/router-error.ts":{"bytesInOutput":101},"../type-guards/src/guards/routes.ts":{"bytesInOutput":288},"../type-guards/src/guards/params.ts":{"bytesInOutput":2778},"../type-guards/src/internal/meta-fields.ts":{"bytesInOutput":635},"../type-guards/src/guards/state.ts":{"bytesInOutput":502},"../type-guards/src/guards/index.ts":{"bytesInOutput":0},"../type-guards/src/index.ts":{"bytesInOutput":0},"src/browser.ts":{"bytesInOutput":4041},"src/constants.ts":{"bytesInOutput":205},"src/utils.ts":{"bytesInOutput":4034},"src/plugin.ts":{"bytesInOutput":8275},"src/index.ts":{"bytesInOutput":0}},"bytes":21534}}}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@real-router/browser-plugin",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "type": "commonjs",
5
5
  "description": "Browser integration plugin with History API, hash routing, and popstate support",
6
6
  "main": "./dist/cjs/index.js",
@@ -52,11 +52,11 @@
52
52
  "sideEffects": false,
53
53
  "dependencies": {
54
54
  "@real-router/core": "workspace:^",
55
- "logger": "workspace:^",
56
- "type-guards": "workspace:^"
55
+ "@real-router/logger": "workspace:^"
57
56
  },
58
57
  "devDependencies": {
59
58
  "@testing-library/jest-dom": "6.9.1",
60
- "jsdom": "27.4.0"
59
+ "jsdom": "27.4.0",
60
+ "type-guards": "workspace:^"
61
61
  }
62
62
  }