@real-router/browser-plugin 0.12.2 → 0.13.1
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.
- package/README.md +1 -1
- package/dist/cjs/index.d.ts +1 -1
- package/dist/cjs/index.d.ts.map +1 -1
- package/dist/cjs/index.js +1 -1
- package/dist/cjs/index.js.map +1 -1
- package/dist/esm/index.d.mts +1 -1
- package/dist/esm/index.d.mts.map +1 -1
- package/dist/esm/index.mjs +1 -1
- package/dist/esm/index.mjs.map +1 -1
- package/package.json +4 -4
- package/src/constants.ts +1 -3
- package/src/factory.ts +6 -3
- package/src/index.ts +1 -7
- package/src/plugin.ts +13 -11
- package/src/types.ts +0 -2
- package/src/validation.ts +2 -1
package/README.md
CHANGED
|
@@ -56,7 +56,7 @@ The plugin extends the router instance with three methods via [`extendRouter()`]
|
|
|
56
56
|
| -------------------------------------------- | -------------------- | ------------------------------------------------ |
|
|
57
57
|
| `buildUrl(name, params?)` | `string` | Build full URL with base path |
|
|
58
58
|
| `matchUrl(url)` | `State \| undefined` | Parse URL to router state |
|
|
59
|
-
| `replaceHistoryState(name, params
|
|
59
|
+
| `replaceHistoryState(name, params?)` | `void` | Update browser URL without triggering navigation |
|
|
60
60
|
|
|
61
61
|
```typescript
|
|
62
62
|
router.buildUrl("users", { id: "123" });
|
package/dist/cjs/index.d.ts
CHANGED
|
@@ -86,7 +86,7 @@ declare module "@real-router/core" {
|
|
|
86
86
|
* Replaces current history state without triggering navigation.
|
|
87
87
|
* Added by browser plugin.
|
|
88
88
|
*/
|
|
89
|
-
replaceHistoryState: (name: string, params?: Params
|
|
89
|
+
replaceHistoryState: (name: string, params?: Params) => void;
|
|
90
90
|
start(path?: string): Promise<State>;
|
|
91
91
|
}
|
|
92
92
|
} //# sourceMappingURL=index.d.ts.map
|
package/dist/cjs/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":["NavigationOptions","Params","State","isNavigationOptions","value","isRouteName","name","isState","P","isStateStrict","isString","isBoolean","isObjKey","T","Extract","key","obj","isPrimitiveValue","isParams","isParamsStrict","validateRouteName","methodName","validateState","state","method","getTypeDescription"],"sources":["../../src/types.ts","../../../../shared/browser-env/types.ts","../../src/factory.ts","../../../type-guards/dist/esm/index.d.mts","../../src/index.ts"],"mappings":";;;;;;;
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":["NavigationOptions","Params","State","isNavigationOptions","value","isRouteName","name","isState","P","isStateStrict","isString","isBoolean","isObjKey","T","Extract","key","obj","isPrimitiveValue","isParams","isParamsStrict","validateRouteName","methodName","validateState","state","method","getTypeDescription"],"sources":["../../src/types.ts","../../../../shared/browser-env/types.ts","../../src/factory.ts","../../../type-guards/dist/esm/index.d.mts","../../src/index.ts"],"mappings":";;;;;;;KAGY,aAAA;AAAA,UAEK,cAAA;EACf,MAAA,EAAQ,aAAA;AAAA;AAAA,UAGO,oBAAA;EANQ;;AAEzB;;;EAUE,eAAA;EATqB;AAGvB;;;;EAaE,IAAA;AAAA;;;UCtBe,cAAA;EACf,SAAA,GAAY,KAAA,WAAgB,IAAA;EAC5B,YAAA,GAAe,KAAA,WAAgB,IAAA;EAC/B,mBAAA,GAAsB,EAAA,GAAK,GAAA,EAAK,aAAA;EAChC,OAAA;AAAA;AAAA,UAGe,OAAA,SAAgB,cAAA;EAC/B,WAAA;AAAA;;;iBCQc,oBAAA,CACd,IAAA,GAAO,OAAA,CAAQ,oBAAA,GACf,OAAA,GAAU,OAAA,GACT,aAAA;;;;;;;;;;;;;;;iBC8DcS,aAAAA,WAAwBR,QAAAA,GAASA,QAAAA,CAAAA,CAAQG,KAAAA,YAAiBA,KAAAA,IAASF,OAAAA,CAAMM,CAAAA;AAAAA;;;;;;AChEnC;;;AJdvD;;;;AAAA;EAAA,UIqBY,YAAA;IACR,OAAA,GARmD,cAAA;EAAA;AAAA;AAAA;EAAA,UAa3C,MAAA;IJrByB;;;;II0BjC,QAAA,GAAW,IAAA,UAAc,MAAA,GAAS,MAAA;;;AHnCtC;;IGyCI,QAAA,GAAW,GAAA,aAAgB,KAAA;IHtCgB;;;;IG4C3C,mBAAA,GAAsB,IAAA,UAAc,MAAA,GAAS,MAAA;IAE7C,KAAA,CAAM,IAAA,YAAgB,OAAA,CAAQ,KAAA;EAAA;AAAA"}
|
package/dist/cjs/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`@real-router/core/api`),t=require(`@real-router/core`);const n=()=>globalThis.window!==void 0&&!!globalThis.history,r=(e,t)=>{globalThis.history.pushState(e,``,t)},i=(e,t)=>{globalThis.history.replaceState(e,``,t)},a=e=>(globalThis.addEventListener(`popstate`,e),()=>{globalThis.removeEventListener(`popstate`,e)}),o=()=>globalThis.location.hash;function s(e){if(!e)return e;let t=e;return t.startsWith(`/`)||(t=`/${t}`),t.endsWith(`/`)&&(t=t.slice(0,-1)),t}const c=e=>{try{return encodeURI(decodeURI(e))}catch(t){return console.warn(`[browser-env] Could not encode path "${e}"`,t),e}},l=()=>{},u=e=>{let t=!1;return n=>{t||=(console.warn(`[browser-env] Browser API is running in a non-browser environment (context: "${e}"). Method "${n}" is a no-op. This is expected for SSR, but may indicate misconfiguration if you expected browser behavior.`),!0)}},d=e=>{let t=u(e);return{pushState:()=>{t(`pushState`)},replaceState:()=>{t(`replaceState`)},addPopstateListener:()=>(t(`addPopstateListener`),l),getHash:()=>(t(`getHash`),``)}},f=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function p(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:f.test(e):!1}function m(e,t=new WeakSet){if(e==null)return!0;let n=typeof e;if(n===`string`||n===`boolean`)return!0;if(n===`number`)return Number.isFinite(e);if(n===`function`||n===`symbol`)return!1;if(Array.isArray(e))return t.has(e)?!1:(t.add(e),e.every(e=>m(e,t)));if(n===`object`){if(t.has(e))return!1;t.add(e);let n=Object.getPrototypeOf(e);return n!==null&&n!==Object.prototype?!1:Object.values(e).every(e=>m(e,t))}return!1}function h(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}function g(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let r=e[t];if(!h(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return n?m(e):!0}function _(e){return p(e.name)&&typeof e.path==`string`&&g(e.params)}function v(e){return!(typeof e!=`object`||!e||!_(e))}function y(e,t,n){if(v(e.state))return{name:e.state.name,params:e.state.params};let r=t.matchPath(n.getLocation());return r?{name:r.name,params:r.params}:void 0}function b(e,t,n,r){let i={name:e.name,params:e.params,path:e.path};n?r.replaceState(i,t):r.pushState(i,t)}function x(e,t){return
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`@real-router/core/api`),t=require(`@real-router/core`);const n=()=>globalThis.window!==void 0&&!!globalThis.history,r=(e,t)=>{globalThis.history.pushState(e,``,t)},i=(e,t)=>{globalThis.history.replaceState(e,``,t)},a=e=>(globalThis.addEventListener(`popstate`,e),()=>{globalThis.removeEventListener(`popstate`,e)}),o=()=>globalThis.location.hash;function s(e){if(!e)return e;let t=e.replaceAll(/\/+/g,`/`);return t.startsWith(`/`)||(t=`/${t}`),t.length>1&&t.endsWith(`/`)&&(t=t.slice(0,-1)),t===`/`?``:t}const c=e=>{try{return encodeURI(decodeURI(e))}catch(t){return console.warn(`[browser-env] Could not encode path "${e}"`,t),e}},l=()=>{},u=e=>{let t=!1;return n=>{t||=(console.warn(`[browser-env] Browser API is running in a non-browser environment (context: "${e}"). Method "${n}" is a no-op. This is expected for SSR, but may indicate misconfiguration if you expected browser behavior.`),!0)}},d=e=>{let t=u(e);return{pushState:()=>{t(`pushState`)},replaceState:()=>{t(`replaceState`)},addPopstateListener:()=>(t(`addPopstateListener`),l),getHash:()=>(t(`getHash`),``)}},f=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function p(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:f.test(e):!1}function m(e,t=new WeakSet){if(e==null)return!0;let n=typeof e;if(n===`string`||n===`boolean`)return!0;if(n===`number`)return Number.isFinite(e);if(n===`function`||n===`symbol`)return!1;if(Array.isArray(e))return t.has(e)?!1:(t.add(e),e.every(e=>m(e,t)));if(n===`object`){if(t.has(e))return!1;t.add(e);let n=Object.getPrototypeOf(e);return n!==null&&n!==Object.prototype?!1:Object.values(e).every(e=>m(e,t))}return!1}function h(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}function g(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let r=e[t];if(!h(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return n?m(e):!0}function _(e){return p(e.name)&&typeof e.path==`string`&&g(e.params)}function v(e){return!(typeof e!=`object`||!e||!_(e))}function y(e,t,n){if(v(e.state))return{name:e.state.name,params:e.state.params};let r=t.matchPath(n.getLocation());return r?{name:r.name,params:r.params}:void 0}function b(e,t,n,r){let i={name:e.name,params:e.params,path:e.path};n?r.replaceState(i,t):r.pushState(i,t)}function x(e,t,n){return r=>{if(r)for(let i of Object.keys(r)){if(!(i in e))continue;let a=r[i];if(a===void 0)continue;let o=typeof e[i],s=typeof a;if(s!==o)throw Error(`[${t}] Invalid type for '${i}': expected ${o}, got ${s}`);let c=n?.[i];if(c){let e=c.validate(a);if(e!==null)throw Error(`[${t}] Invalid '${i}': ${e}`)}}}}const S=/[\u0000-\u001F\u007F]/,C={validate:e=>S.test(e)?`must not contain control characters`:e.split(`/`).includes(`..`)?`must not contain '..' segments`:null};function w(e,t){if(n())return{pushState:r,replaceState:i,addPopstateListener:a,getLocation:e,getHash:o};let s=u(t);return{...d(t),getLocation:()=>(s(`getLocation`),``)}}function T(e){let n=!1,r=null;function i(){if(r){let t=r;r=null,console.warn(`[${e.loggerContext}] Processing deferred popstate event`),o(t)}}function a(t){console.error(`[${e.loggerContext}] Critical error in onPopState`,t);try{let t=e.router.getState();if(t){let n=e.buildUrl(t.name,t.params);e.browser.replaceState(t,n)}}catch(t){console.error(`[${e.loggerContext}] Failed to recover from critical error`,t)}}async function o(o){if(n){console.warn(`[${e.loggerContext}] Transition in progress, deferring popstate event`),r=o;return}n=!0;try{let t=y(o,e.api,e.browser);t?await e.router.navigate(t.name,t.params,e.transitionOptions):e.allowNotFound?e.router.navigateToNotFound(e.browser.getLocation()):await e.router.navigateToDefault({...e.transitionOptions,reload:!0,replace:!0})}catch(e){e instanceof t.RouterError||a(e)}finally{n=!1,i()}}return e=>void o(e)}function E(e){return{onStart:()=>{e.shared.removePopStateListener&&e.shared.removePopStateListener(),e.shared.removePopStateListener=e.browser.addPopstateListener(e.handler)},onStop:()=>{e.shared.removePopStateListener&&(e.shared.removePopStateListener(),e.shared.removePopStateListener=void 0)},teardown:()=>{e.shared.removePopStateListener&&(e.shared.removePopStateListener(),e.shared.removePopStateListener=void 0),e.cleanup()}}}function D(e,t){return e.addInterceptor(`start`,(e,n)=>e(n??t.getLocation()))}function O(e,t,n,r,i=!0){return(a,o={})=>{let s=e.buildState(a,o);if(!s)throw Error(`[real-router] Cannot replace state: route "${a}" is not found`);let c=e.makeState(s.name,s.params,t.buildPath(s.name,s.params),{params:s.meta}),l=i?n.getHash():``;b(c,r(a,o)+l,!0,n)}}function k(e,t,n){return(e.replace??!n)||!!e.reload&&t.path===n?.path}function A(e,t){try{let n=new URL(e,globalThis.location.origin);return[`http:`,`https:`].includes(n.protocol)?n:(console.warn(`[${t}] Invalid URL protocol in ${e}`),null)}catch(n){return console.warn(`[${t}] Could not parse url ${e}`,n),null}}function j(e,t){if(!e)return`/`;if(t&&(e===t||e.startsWith(`${t}/`))){let n=e.slice(t.length);return n.startsWith(`/`)?n:`/${n}`}return e.startsWith(`/`)?e:`/${e}`}function M(e,t){return e?t?e.startsWith(`/`)?`${t}${e}`:`${t}/${e}`:e.startsWith(`/`)?e:`/${e}`:t}function N(e,t,n){let r=A(e,n);return r?j(r.pathname,t)+r.search:null}const P={forceDeactivate:!0,base:``},F=`popstate`,I=`browser-plugin`,L=Object.freeze({source:`popstate`}),R=Object.freeze({source:`navigate`});var z=class{#e;#t;#n;#r;#i;#a;constructor(e,t,n,r,i,a){this.#e=r,this.#t=n.base,this.#i=t.claimContextNamespace(`browser`),this.#n=D(t,r);let o=(t,r)=>M(e.buildPath(t,r),n.base);this.#r=t.extendRouter({buildUrl:o,matchUrl:e=>{let r=N(e,n.base,I);return r?t.matchPath(r):void 0},replaceHistoryState:O(t,e,r,o)}),this.#a=E({browser:r,shared:a,handler:T({router:e,api:t,browser:r,allowNotFound:t.getOptions().allowNotFound,transitionOptions:i,loggerContext:I,buildUrl:o}),cleanup:()=>{this.#n(),this.#r(),this.#i.release()}})}getPlugin(){return{...this.#a,onTransitionSuccess:(e,t,n)=>{let r=k(n,e,t),i=M(e.path,this.#t),a=!t||t.path===e.path?this.#e.getHash():``;b(e,a?i+a:i,r,this.#e);let o=n.source===F;this.#i.write(e,o?L:R)}}}};const B=x(P,I,{base:C});function V(t,n){B(t);let r={...P,...t};r.base=s(r.base);let i=n??w(()=>c(j(globalThis.location.pathname,r.base))+globalThis.location.search,`browser-plugin`),a={forceDeactivate:r.forceDeactivate,source:F,replace:!0},o={removePopStateListener:void 0};return function(t){return new z(t,(0,e.getPluginApi)(t),r,i,a,o).getPlugin()}}exports.browserPluginFactory=V,exports.isState=v;
|
|
2
2
|
//# sourceMappingURL=index.js.map
|
package/dist/cjs/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":["isState","RouterError","#router","#browser","#removeStartInterceptor","#removeExtensions","#claim","#lifecycle","POPSTATE_SOURCE"],"sources":["../../../../shared/browser-env/detect.ts","../../../../shared/browser-env/history-api.ts","../../../../shared/browser-env/utils.ts","../../../../shared/browser-env/ssr-fallback.ts","../../../type-guards/dist/esm/index.mjs","../../../../shared/browser-env/popstate-utils.ts","../../../../shared/browser-env/validation.ts","../../../../shared/browser-env/safe-browser.ts","../../../../shared/browser-env/popstate-handler.ts","../../../../shared/browser-env/plugin-utils.ts","../../../../shared/browser-env/url-parsing.ts","../../../../shared/browser-env/url-utils.ts","../../src/constants.ts","../../src/plugin.ts","../../src/validation.ts","../../src/factory.ts"],"sourcesContent":["export const isBrowserEnvironment = (): boolean =>\n typeof globalThis.window !== \"undefined\" && !!globalThis.history;\n","import type { HistoryBrowser } from \"./types.js\";\n\nexport const pushState = (state: unknown, path: string): void => {\n globalThis.history.pushState(state, \"\", path);\n};\n\nexport const replaceState = (state: unknown, path: string): void => {\n globalThis.history.replaceState(state, \"\", path);\n};\n\nexport const addPopstateListener: HistoryBrowser[\"addPopstateListener\"] = (\n fn,\n) => {\n globalThis.addEventListener(\"popstate\", fn);\n\n return () => {\n globalThis.removeEventListener(\"popstate\", fn);\n };\n};\n\nexport const getHash = (): string => globalThis.location.hash;\n","/**\n * Normalizes base path: ensures leading slash, removes trailing slash.\n *\n * @example\n * normalizeBase(\"app\") // \"/app\"\n * normalizeBase(\"/app/\") // \"/app\"\n * normalizeBase(\"\") // \"\"\n */\nexport function normalizeBase(base: string): string {\n if (!base) {\n return base;\n }\n\n let result = base;\n\n if (!result.startsWith(\"/\")) {\n result = `/${result}`;\n }\n\n if (result.endsWith(\"/\")) {\n result = result.slice(0, -1);\n }\n\n return result;\n}\n\nexport const safelyEncodePath = (path: string): string => {\n try {\n return encodeURI(decodeURI(path));\n } catch (error) {\n console.warn(`[browser-env] Could not encode path \"${path}\"`, error);\n\n return path;\n }\n};\n","import type { HistoryBrowser } from \"./types.js\";\n\nconst NOOP = (): void => {};\n\nexport const createWarnOnce = (context: string) => {\n let hasWarned = false;\n\n return (method: string): void => {\n if (!hasWarned) {\n console.warn(\n `[browser-env] Browser API is running in a non-browser environment (context: \"${context}\"). ` +\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\nexport const createHistoryFallbackBrowser = (\n context: string,\n): HistoryBrowser => {\n const warnOnce = createWarnOnce(context);\n\n return {\n pushState: () => {\n warnOnce(\"pushState\");\n },\n replaceState: () => {\n warnOnce(\"replaceState\");\n },\n addPopstateListener: () => {\n warnOnce(\"addPopstateListener\");\n\n return NOOP;\n },\n getHash: () => {\n warnOnce(\"getHash\");\n\n return \"\";\n },\n };\n};\n","const e=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`];function t(t){if(typeof t!=`object`||!t||Array.isArray(t))return!1;let n=t;for(let t of e){let e=n[t];if(e!==void 0&&typeof e!=`boolean`)return!1}let r=n.signal;return!(r!==void 0&&!(r instanceof AbortSignal))}const n=/\\S/,r=/^[A-Z_a-z][\\w-]*(?:\\.[A-Z_a-z][\\w-]*)*$/;function i(e,t){return TypeError(`[router.${e}] ${t}`)}function a(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:r.test(e):!1}function o(e,t=new WeakSet){if(e==null)return!0;let n=typeof e;if(n===`string`||n===`boolean`)return!0;if(n===`number`)return Number.isFinite(e);if(n===`function`||n===`symbol`)return!1;if(Array.isArray(e))return t.has(e)?!1:(t.add(e),e.every(e=>o(e,t)));if(n===`object`){if(t.has(e))return!1;t.add(e);let n=Object.getPrototypeOf(e);return n!==null&&n!==Object.prototype?!1:Object.values(e).every(e=>o(e,t))}return!1}function s(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}function c(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let r=e[t];if(!s(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return n?o(e):!0}function l(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):Array.isArray(e)?e.every(e=>{let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}):!1}function u(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let n=e[t];if(!l(n))return!1}return!0}function d(e){return a(e.name)&&typeof e.path==`string`&&c(e.params)}function f(e){return typeof e!=`object`||!e?!1:d(e)}function p(e){return!(typeof e!=`object`||!e||!d(e))}function m(e){return typeof e==`string`}function h(e){return typeof e==`boolean`}function g(e,t){return e in t}function _(e){return typeof e==`number`?Number.isFinite(e):typeof e==`string`||typeof e==`boolean`}function v(e,t){if(typeof e!=`string`)throw i(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!n.test(e))throw i(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw i(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!r.test(e))throw i(t,`Invalid route name \"${e}\". Each segment must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens. Segments are separated by dots (e.g., \"users.profile\").`)}}function y(e){return e===null?`null`:Array.isArray(e)?`array[${e.length}]`:typeof e==`object`?`constructor`in e&&e.constructor.name!==`Object`?e.constructor.name:`object`:typeof e}function b(e,t){if(!f(e))throw TypeError(`[${t}] Invalid state structure: ${y(e)}. Expected State object with name, params, and path properties.`)}export{y as getTypeDescription,h as isBoolean,t as isNavigationOptions,g as isObjKey,c as isParams,u as isParamsStrict,_ as isPrimitiveValue,a as isRouteName,f as isState,p as isStateStrict,m as isString,v as validateRouteName,b as validateState};\n//# sourceMappingURL=index.mjs.map","import { isStateStrict as isState } from \"type-guards\";\n\nimport type { Browser } from \"./types.js\";\nimport type { State, Params } from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\n/**\n * Extracts route name and params from a popstate event.\n *\n * - If history.state is a valid router state → returns name/params from it\n * - If not (e.g. manually entered URL) → matches current URL against route tree\n * - Returns undefined if no route matches\n *\n * @param evt - PopStateEvent from browser\n * @param api - PluginApi instance\n * @param browser - Browser API instance\n * @returns Route identifier or undefined\n */\nexport function getRouteFromEvent(\n evt: PopStateEvent,\n api: PluginApi,\n browser: Browser,\n): { name: string; params: Params } | undefined {\n if (isState(evt.state)) {\n return { name: evt.state.name, params: evt.state.params };\n }\n\n const state = api.matchPath(browser.getLocation());\n\n return state ? { name: state.name, params: state.params } : undefined;\n}\n\n/**\n * Updates browser state (pushState or replaceState)\n *\n * @param state - Router state\n * @param url - URL to set\n * @param replace - Whether to replace instead of push\n * @param browser - Browser API instance\n */\nexport function updateBrowserState(\n state: State,\n url: string,\n replace: boolean,\n browser: Browser,\n): void {\n const historyState = {\n name: state.name,\n params: state.params,\n path: state.path,\n };\n\n if (replace) {\n browser.replaceState(historyState, url);\n } else {\n browser.pushState(historyState, url);\n }\n}\n","export function createOptionsValidator<T extends object>(\n defaults: Required<T>,\n loggerContext: string,\n): (opts: Partial<T> | undefined) => void {\n return (opts) => {\n if (!opts) {\n return;\n }\n\n for (const key of Object.keys(opts)) {\n if (key in defaults) {\n const value = opts[key as keyof typeof opts];\n const expected = typeof defaults[key as keyof typeof defaults];\n const actual = typeof value;\n\n if (value !== undefined && actual !== expected) {\n throw new Error(\n `[${loggerContext}] Invalid type for '${key}': expected ${expected}, got ${actual}`,\n );\n }\n }\n }\n };\n}\n","import { isBrowserEnvironment } from \"./detect.js\";\nimport {\n pushState,\n replaceState,\n addPopstateListener,\n getHash,\n} from \"./history-api.js\";\nimport {\n createWarnOnce,\n createHistoryFallbackBrowser,\n} from \"./ssr-fallback.js\";\n\nimport type { Browser } from \"./types.js\";\n\nexport function createSafeBrowser(\n getLocation: () => string,\n context: string,\n): Browser {\n if (isBrowserEnvironment()) {\n return {\n pushState,\n replaceState,\n addPopstateListener,\n getLocation,\n getHash,\n };\n }\n\n const warnOnce = createWarnOnce(context);\n\n return {\n ...createHistoryFallbackBrowser(context),\n getLocation: () => {\n warnOnce(\"getLocation\");\n\n return \"\";\n },\n };\n}\n","import { RouterError } from \"@real-router/core\";\n\nimport { getRouteFromEvent } from \"./popstate-utils.js\";\n\nimport type { Browser, SharedFactoryState } from \"./types.js\";\nimport type { Params, Plugin, Router } from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nexport interface PopstateHandlerDeps {\n router: Router;\n api: PluginApi;\n browser: Browser;\n allowNotFound: boolean;\n transitionOptions: {\n source: string;\n replace: true;\n forceDeactivate?: boolean;\n };\n loggerContext: string;\n buildUrl: (name: string, params?: Params) => string;\n}\n\nexport function createPopstateHandler(\n deps: PopstateHandlerDeps,\n): (evt: PopStateEvent) => void {\n let isTransitioning = false;\n let deferredEvent: PopStateEvent | null = null;\n\n function processDeferredEvent(): void {\n if (deferredEvent) {\n const evt = deferredEvent;\n\n deferredEvent = null;\n console.warn(\n `[${deps.loggerContext}] Processing deferred popstate event`,\n );\n void onPopState(evt);\n }\n }\n\n function recoverFromCriticalError(error: unknown): void {\n console.error(\n `[${deps.loggerContext}] Critical error in onPopState`,\n error,\n );\n\n try {\n const currentState = deps.router.getState();\n\n /* v8 ignore next -- @preserve: router always has state after start(); defensive guard for edge cases */\n if (currentState) {\n const url = deps.buildUrl(currentState.name, currentState.params);\n\n deps.browser.replaceState(currentState, url);\n }\n } catch (recoveryError) {\n console.error(\n `[${deps.loggerContext}] Failed to recover from critical error`,\n recoveryError,\n );\n }\n }\n\n async function onPopState(evt: PopStateEvent): Promise<void> {\n if (isTransitioning) {\n console.warn(\n `[${deps.loggerContext}] Transition in progress, deferring popstate event`,\n );\n deferredEvent = evt;\n\n return;\n }\n\n isTransitioning = true;\n\n try {\n const route = getRouteFromEvent(evt, deps.api, deps.browser);\n\n if (route) {\n await deps.router.navigate(\n route.name,\n route.params,\n deps.transitionOptions,\n );\n } else if (deps.allowNotFound) {\n deps.router.navigateToNotFound(deps.browser.getLocation());\n } else {\n await deps.router.navigateToDefault({\n ...deps.transitionOptions,\n reload: true,\n replace: true,\n });\n }\n } catch (error) {\n if (!(error instanceof RouterError)) {\n recoverFromCriticalError(error);\n }\n } finally {\n isTransitioning = false;\n processDeferredEvent();\n }\n }\n\n return (evt: PopStateEvent) => void onPopState(evt);\n}\n\nexport interface PopstateLifecycleDeps {\n browser: Browser;\n shared: SharedFactoryState;\n handler: (evt: PopStateEvent) => void;\n cleanup: () => void;\n}\n\nexport function createPopstateLifecycle(\n deps: PopstateLifecycleDeps,\n): Pick<Plugin, \"onStart\" | \"onStop\" | \"teardown\"> {\n return {\n onStart: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n }\n\n deps.shared.removePopStateListener = deps.browser.addPopstateListener(\n deps.handler,\n );\n },\n\n onStop: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n deps.shared.removePopStateListener = undefined;\n }\n },\n\n teardown: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n deps.shared.removePopStateListener = undefined;\n }\n\n deps.cleanup();\n },\n };\n}\n","import { updateBrowserState } from \"./popstate-utils.js\";\n\nimport type { Browser } from \"./types.js\";\nimport type {\n NavigationOptions,\n Params,\n Router,\n State,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nexport function createStartInterceptor(\n api: PluginApi,\n browser: Browser,\n): () => void {\n return api.addInterceptor(\"start\", (next, path) =>\n next(path ?? browser.getLocation()),\n );\n}\n\nexport function createReplaceHistoryState(\n api: PluginApi,\n router: Router,\n browser: Browser,\n buildUrl: (name: string, params?: Params) => string,\n): (name: string, params?: Params) => void {\n return (name: string, params: Params = {}) => {\n const state = api.buildState(name, params);\n\n if (!state) {\n throw new Error(\n `[real-router] Cannot replace state: route \"${name}\" is not found`,\n );\n }\n\n const builtState = api.makeState(\n state.name,\n state.params,\n router.buildPath(state.name, state.params),\n {\n params: state.meta,\n },\n );\n\n updateBrowserState(builtState, buildUrl(name, params), true, browser);\n };\n}\n\nexport function shouldReplaceHistory(\n navOptions: NavigationOptions,\n toState: State,\n fromState: State | undefined,\n): boolean {\n return (\n (navOptions.replace ?? !fromState) ||\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- fromState is NOT narrowed when replace is false (#447)\n (!!navOptions.reload && toState.path === fromState?.path)\n );\n}\n","export function safeParseUrl(url: string, loggerContext: string): URL | null {\n try {\n const parsedUrl = new URL(url, globalThis.location.origin);\n\n if (![\"http:\", \"https:\"].includes(parsedUrl.protocol)) {\n console.warn(`[${loggerContext}] Invalid URL protocol in ${url}`);\n\n return null;\n }\n\n return parsedUrl;\n } catch (error) {\n console.warn(`[${loggerContext}] Could not parse url ${url}`, error);\n\n return null;\n }\n}\n","import { safeParseUrl } from \"./url-parsing.js\";\n\nexport function extractPath(pathname: string, base: string): string {\n if (base && (pathname === base || pathname.startsWith(`${base}/`))) {\n const stripped = pathname.slice(base.length);\n\n return stripped.startsWith(\"/\") ? stripped : `/${stripped}`;\n }\n\n return pathname;\n}\n\nexport function buildUrl(path: string, base: string): string {\n return base + path;\n}\n\nexport function urlToPath(\n url: string,\n base: string,\n context: string,\n): string | null {\n const parsedUrl = safeParseUrl(url, context);\n\n return parsedUrl\n ? extractPath(parsedUrl.pathname, base) + parsedUrl.search\n : null;\n}\n","// packages/browser-plugin/modules/constants.ts\n\nimport type { BrowserPluginOptions } from \"./types\";\n\nexport const defaultOptions: Required<BrowserPluginOptions> = {\n forceDeactivate: true,\n base: \"\",\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","import {\n createPopstateHandler,\n createPopstateLifecycle,\n createStartInterceptor,\n createReplaceHistoryState,\n shouldReplaceHistory,\n updateBrowserState,\n buildUrl,\n urlToPath,\n} from \"./browser-env/index.js\";\nimport { LOGGER_CONTEXT, source as POPSTATE_SOURCE } from \"./constants\";\n\nimport type { Browser, SharedFactoryState } from \"./browser-env/index.js\";\nimport type { BrowserContext, BrowserPluginOptions } from \"./types\";\nimport type {\n NavigationOptions,\n Params,\n Router,\n State,\n Plugin,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nexport class BrowserPlugin {\n readonly #router: Router;\n readonly #browser: Browser;\n readonly #removeStartInterceptor: () => void;\n readonly #removeExtensions: () => void;\n readonly #claim: {\n write: (state: State, value: BrowserContext) => void;\n release: () => void;\n };\n readonly #lifecycle: Pick<Plugin, \"onStart\" | \"onStop\" | \"teardown\">;\n\n constructor(\n router: Router,\n api: PluginApi,\n options: Required<BrowserPluginOptions>,\n browser: Browser,\n transitionOptions: {\n source: string;\n replace: true;\n forceDeactivate?: boolean;\n },\n shared: SharedFactoryState,\n ) {\n this.#router = router;\n this.#browser = browser;\n this.#claim = api.claimContextNamespace(\"browser\");\n\n this.#removeStartInterceptor = createStartInterceptor(api, browser);\n\n const pluginBuildUrl = (route: string, params?: Params) => {\n const path = router.buildPath(route, params);\n\n return buildUrl(path, options.base);\n };\n\n this.#removeExtensions = api.extendRouter({\n buildUrl: pluginBuildUrl,\n matchUrl: (url: string) => {\n const path = urlToPath(url, options.base, LOGGER_CONTEXT);\n\n return path ? api.matchPath(path) : undefined;\n },\n replaceHistoryState: createReplaceHistoryState(\n api,\n router,\n browser,\n pluginBuildUrl,\n ),\n });\n\n const handler = createPopstateHandler({\n router,\n api,\n browser,\n allowNotFound: api.getOptions().allowNotFound,\n transitionOptions,\n loggerContext: \"browser-plugin\",\n buildUrl: (name: string, params?: Params) =>\n router.buildUrl(name, params),\n });\n\n this.#lifecycle = createPopstateLifecycle({\n browser,\n shared,\n handler,\n cleanup: () => {\n this.#removeStartInterceptor();\n this.#removeExtensions();\n this.#claim.release();\n },\n });\n }\n\n getPlugin(): Plugin {\n return {\n ...this.#lifecycle,\n\n onTransitionSuccess: (\n toState: State,\n fromState: State | undefined,\n navOptions: NavigationOptions,\n ) => {\n const replaceHistory = shouldReplaceHistory(\n navOptions,\n toState,\n fromState,\n );\n\n const url = this.#router.buildUrl(toState.name, toState.params);\n\n const shouldPreserveHash =\n !fromState || fromState.path === toState.path;\n\n const finalUrl = shouldPreserveHash\n ? url + this.#browser.getHash()\n : url;\n\n updateBrowserState(toState, finalUrl, replaceHistory, this.#browser);\n\n const isPopstate =\n (navOptions as Record<string, unknown>).source === POPSTATE_SOURCE;\n\n this.#claim.write(\n toState,\n Object.freeze({ source: isPopstate ? \"popstate\" : \"navigate\" }),\n );\n },\n };\n }\n}\n","import { createOptionsValidator } from \"./browser-env/index.js\";\nimport { LOGGER_CONTEXT, defaultOptions } from \"./constants\";\n\nimport type { BrowserPluginOptions } from \"./types\";\n\nexport const validateOptions = createOptionsValidator<BrowserPluginOptions>(\n defaultOptions,\n LOGGER_CONTEXT,\n);\n","import { getPluginApi } from \"@real-router/core/api\";\n\nimport {\n createSafeBrowser,\n normalizeBase,\n safelyEncodePath,\n extractPath,\n} from \"./browser-env/index.js\";\nimport { defaultOptions, source } from \"./constants\";\nimport { BrowserPlugin } from \"./plugin\";\nimport { validateOptions } from \"./validation\";\n\nimport type { Browser, SharedFactoryState } from \"./browser-env/index.js\";\nimport type { BrowserPluginOptions } from \"./types\";\nimport type { PluginFactory, Router } from \"@real-router/core\";\n\nexport function browserPluginFactory(\n opts?: Partial<BrowserPluginOptions>,\n browser?: Browser,\n): PluginFactory {\n validateOptions(opts);\n\n const options: Required<BrowserPluginOptions> = {\n ...defaultOptions,\n ...opts,\n };\n\n options.base = normalizeBase(options.base);\n\n const resolvedBrowser =\n browser ??\n createSafeBrowser(\n () =>\n safelyEncodePath(\n extractPath(globalThis.location.pathname, options.base),\n ) + globalThis.location.search,\n \"browser-plugin\",\n );\n\n const forceDeactivate = options.forceDeactivate;\n const transitionOptions = { forceDeactivate, source, replace: true as const };\n\n const shared: SharedFactoryState = { removePopStateListener: undefined };\n\n return function browserPlugin(routerBase) {\n const plugin = new BrowserPlugin(\n routerBase as Router,\n getPluginApi(routerBase),\n options,\n resolvedBrowser,\n transitionOptions,\n shared,\n );\n\n return plugin.getPlugin();\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":["isState","RouterError","#browser","#base","#removeStartInterceptor","#removeExtensions","#claim","#lifecycle"],"sources":["../../../../shared/browser-env/detect.ts","../../../../shared/browser-env/history-api.ts","../../../../shared/browser-env/utils.ts","../../../../shared/browser-env/ssr-fallback.ts","../../../type-guards/dist/esm/index.mjs","../../../../shared/browser-env/popstate-utils.ts","../../../../shared/browser-env/validation.ts","../../../../shared/browser-env/safe-browser.ts","../../../../shared/browser-env/popstate-handler.ts","../../../../shared/browser-env/plugin-utils.ts","../../../../shared/browser-env/url-parsing.ts","../../../../shared/browser-env/url-utils.ts","../../src/constants.ts","../../src/plugin.ts","../../src/validation.ts","../../src/factory.ts"],"sourcesContent":["export const isBrowserEnvironment = (): boolean =>\n typeof globalThis.window !== \"undefined\" && !!globalThis.history;\n","import type { HistoryBrowser } from \"./types.js\";\n\nexport const pushState = (state: unknown, path: string): void => {\n globalThis.history.pushState(state, \"\", path);\n};\n\nexport const replaceState = (state: unknown, path: string): void => {\n globalThis.history.replaceState(state, \"\", path);\n};\n\nexport const addPopstateListener: HistoryBrowser[\"addPopstateListener\"] = (\n fn,\n) => {\n globalThis.addEventListener(\"popstate\", fn);\n\n return () => {\n globalThis.removeEventListener(\"popstate\", fn);\n };\n};\n\nexport const getHash = (): string => globalThis.location.hash;\n","/**\n * Normalizes base path to canonical form: leading slash, no trailing slash,\n * no repeated slashes. Isolated \"/\" collapses to \"\".\n *\n * @example\n * normalizeBase(\"app\") // \"/app\"\n * normalizeBase(\"/app/\") // \"/app\"\n * normalizeBase(\"//app//\") // \"/app\"\n * normalizeBase(\"\") // \"\"\n * normalizeBase(\"/\") // \"\"\n */\nexport function normalizeBase(base: string): string {\n if (!base) {\n return base;\n }\n\n let result = base.replaceAll(/\\/+/g, \"/\");\n\n if (!result.startsWith(\"/\")) {\n result = `/${result}`;\n }\n\n if (result.length > 1 && result.endsWith(\"/\")) {\n result = result.slice(0, -1);\n }\n\n return result === \"/\" ? \"\" : result;\n}\n\nexport const safelyEncodePath = (path: string): string => {\n try {\n return encodeURI(decodeURI(path));\n } catch (error) {\n console.warn(`[browser-env] Could not encode path \"${path}\"`, error);\n\n return path;\n }\n};\n","import type { HistoryBrowser } from \"./types.js\";\n\nconst NOOP = (): void => {};\n\nexport const createWarnOnce = (context: string) => {\n let hasWarned = false;\n\n return (method: string): void => {\n if (!hasWarned) {\n console.warn(\n `[browser-env] Browser API is running in a non-browser environment (context: \"${context}\"). ` +\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\nexport const createHistoryFallbackBrowser = (\n context: string,\n): HistoryBrowser => {\n const warnOnce = createWarnOnce(context);\n\n return {\n pushState: () => {\n warnOnce(\"pushState\");\n },\n replaceState: () => {\n warnOnce(\"replaceState\");\n },\n addPopstateListener: () => {\n warnOnce(\"addPopstateListener\");\n\n return NOOP;\n },\n getHash: () => {\n warnOnce(\"getHash\");\n\n return \"\";\n },\n };\n};\n","const e=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`];function t(t){if(typeof t!=`object`||!t||Array.isArray(t))return!1;let n=t;for(let t of e){let e=n[t];if(e!==void 0&&typeof e!=`boolean`)return!1}let r=n.signal;return!(r!==void 0&&!(r instanceof AbortSignal))}const n=/\\S/,r=/^[A-Z_a-z][\\w-]*(?:\\.[A-Z_a-z][\\w-]*)*$/;function i(e,t){return TypeError(`[router.${e}] ${t}`)}function a(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:r.test(e):!1}function o(e,t=new WeakSet){if(e==null)return!0;let n=typeof e;if(n===`string`||n===`boolean`)return!0;if(n===`number`)return Number.isFinite(e);if(n===`function`||n===`symbol`)return!1;if(Array.isArray(e))return t.has(e)?!1:(t.add(e),e.every(e=>o(e,t)));if(n===`object`){if(t.has(e))return!1;t.add(e);let n=Object.getPrototypeOf(e);return n!==null&&n!==Object.prototype?!1:Object.values(e).every(e=>o(e,t))}return!1}function s(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}function c(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let r=e[t];if(!s(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return n?o(e):!0}function l(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):Array.isArray(e)?e.every(e=>{let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}):!1}function u(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let n=e[t];if(!l(n))return!1}return!0}function d(e){return a(e.name)&&typeof e.path==`string`&&c(e.params)}function f(e){return typeof e!=`object`||!e?!1:d(e)}function p(e){return!(typeof e!=`object`||!e||!d(e))}function m(e){return typeof e==`string`}function h(e){return typeof e==`boolean`}function g(e,t){return e in t}function _(e){return typeof e==`number`?Number.isFinite(e):typeof e==`string`||typeof e==`boolean`}function v(e,t){if(typeof e!=`string`)throw i(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!n.test(e))throw i(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw i(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!r.test(e))throw i(t,`Invalid route name \"${e}\". Each segment must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens. Segments are separated by dots (e.g., \"users.profile\").`)}}function y(e){return e===null?`null`:Array.isArray(e)?`array[${e.length}]`:typeof e==`object`?`constructor`in e&&e.constructor.name!==`Object`?e.constructor.name:`object`:typeof e}function b(e,t){if(!f(e))throw TypeError(`[${t}] Invalid state structure: ${y(e)}. Expected State object with name, params, and path properties.`)}export{y as getTypeDescription,h as isBoolean,t as isNavigationOptions,g as isObjKey,c as isParams,u as isParamsStrict,_ as isPrimitiveValue,a as isRouteName,f as isState,p as isStateStrict,m as isString,v as validateRouteName,b as validateState};\n//# sourceMappingURL=index.mjs.map","import { isStateStrict as isState } from \"type-guards\";\n\nimport type { Browser } from \"./types.js\";\nimport type { State, Params } from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\n/**\n * Extracts route name and params from a popstate event.\n *\n * - If history.state is a valid router state → returns name/params from it\n * - If not (e.g. manually entered URL) → matches current URL against route tree\n * - Returns undefined if no route matches\n *\n * @param evt - PopStateEvent from browser\n * @param api - PluginApi instance\n * @param browser - Browser API instance\n * @returns Route identifier or undefined\n */\nexport function getRouteFromEvent(\n evt: PopStateEvent,\n api: PluginApi,\n browser: Browser,\n): { name: string; params: Params } | undefined {\n if (isState(evt.state)) {\n return { name: evt.state.name, params: evt.state.params };\n }\n\n const state = api.matchPath(browser.getLocation());\n\n return state ? { name: state.name, params: state.params } : undefined;\n}\n\n/**\n * Updates browser state (pushState or replaceState)\n *\n * @param state - Router state\n * @param url - URL to set\n * @param replace - Whether to replace instead of push\n * @param browser - Browser API instance\n */\nexport function updateBrowserState(\n state: State,\n url: string,\n replace: boolean,\n browser: Browser,\n): void {\n const historyState = {\n name: state.name,\n params: state.params,\n path: state.path,\n };\n\n if (replace) {\n browser.replaceState(historyState, url);\n } else {\n browser.pushState(historyState, url);\n }\n}\n","export interface OptionRule<T> {\n validate: (value: T) => string | null;\n}\n\nexport type OptionRules<T extends object> = {\n [K in keyof T]?: OptionRule<NonNullable<T[K]>>;\n};\n\nexport function createOptionsValidator<T extends object>(\n defaults: Required<T>,\n loggerContext: string,\n rules?: OptionRules<T>,\n): (opts: Partial<T> | undefined) => void {\n return (opts) => {\n if (!opts) {\n return;\n }\n\n for (const key of Object.keys(opts)) {\n if (!(key in defaults)) {\n continue;\n }\n\n const value = opts[key as keyof typeof opts];\n\n if (value === undefined) {\n continue;\n }\n\n const expected = typeof defaults[key as keyof typeof defaults];\n const actual = typeof value;\n\n if (actual !== expected) {\n throw new Error(\n `[${loggerContext}] Invalid type for '${key}': expected ${expected}, got ${actual}`,\n );\n }\n\n const rule = rules?.[key as keyof T];\n\n if (rule) {\n const msg = (rule.validate as (input: unknown) => string | null)(value);\n\n if (msg !== null) {\n throw new Error(`[${loggerContext}] Invalid '${key}': ${msg}`);\n }\n }\n }\n };\n}\n\n// eslint-disable-next-line no-control-regex -- control characters are exactly what this rule rejects\nconst CONTROL_CHARS = /[\\u0000-\\u001F\\u007F]/;\n\nexport const safeBaseRule: OptionRule<string> = {\n validate: (value) => {\n if (CONTROL_CHARS.test(value)) {\n return \"must not contain control characters\";\n }\n\n if (value.split(\"/\").includes(\"..\")) {\n return \"must not contain '..' segments\";\n }\n\n return null;\n },\n};\n\nexport const safeHashPrefixRule: OptionRule<string> = {\n validate: (value) => {\n if (CONTROL_CHARS.test(value)) {\n return \"must not contain control characters\";\n }\n\n if (value.includes(\"/\")) {\n return \"must not contain '/' (slash is added before the path automatically)\";\n }\n\n if (value.includes(\"#\")) {\n return \"must not contain '#' (it is added as the hash delimiter)\";\n }\n\n if (value.includes(\"?\")) {\n return \"must not contain '?' (it conflicts with the query delimiter)\";\n }\n\n return null;\n },\n};\n\nexport const nonNegativeIntegerRule: OptionRule<number> = {\n validate: (value) => {\n if (!Number.isFinite(value)) {\n return `expected finite number, got ${String(value)}`;\n }\n\n if (!Number.isInteger(value)) {\n return `expected integer, got ${String(value)}`;\n }\n\n if (value < 0) {\n return `expected non-negative integer, got ${value}`;\n }\n\n return null;\n },\n};\n","import { isBrowserEnvironment } from \"./detect.js\";\nimport {\n pushState,\n replaceState,\n addPopstateListener,\n getHash,\n} from \"./history-api.js\";\nimport {\n createWarnOnce,\n createHistoryFallbackBrowser,\n} from \"./ssr-fallback.js\";\n\nimport type { Browser } from \"./types.js\";\n\nexport function createSafeBrowser(\n getLocation: () => string,\n context: string,\n): Browser {\n if (isBrowserEnvironment()) {\n return {\n pushState,\n replaceState,\n addPopstateListener,\n getLocation,\n getHash,\n };\n }\n\n const warnOnce = createWarnOnce(context);\n\n return {\n ...createHistoryFallbackBrowser(context),\n getLocation: () => {\n warnOnce(\"getLocation\");\n\n return \"\";\n },\n };\n}\n","import { RouterError } from \"@real-router/core\";\n\nimport { getRouteFromEvent } from \"./popstate-utils.js\";\n\nimport type { Browser, SharedFactoryState } from \"./types.js\";\nimport type { Params, Plugin, Router } from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nexport interface PopstateHandlerDeps {\n router: Router;\n api: PluginApi;\n browser: Browser;\n allowNotFound: boolean;\n transitionOptions: {\n source: string;\n replace: true;\n forceDeactivate?: boolean;\n };\n loggerContext: string;\n buildUrl: (name: string, params?: Params) => string;\n}\n\nexport function createPopstateHandler(\n deps: PopstateHandlerDeps,\n): (evt: PopStateEvent) => void {\n let isTransitioning = false;\n let deferredEvent: PopStateEvent | null = null;\n\n function processDeferredEvent(): void {\n if (deferredEvent) {\n const evt = deferredEvent;\n\n deferredEvent = null;\n console.warn(\n `[${deps.loggerContext}] Processing deferred popstate event`,\n );\n void onPopState(evt);\n }\n }\n\n function recoverFromCriticalError(error: unknown): void {\n console.error(\n `[${deps.loggerContext}] Critical error in onPopState`,\n error,\n );\n\n try {\n const currentState = deps.router.getState();\n\n /* v8 ignore next -- @preserve: router always has state after start(); defensive guard for edge cases */\n if (currentState) {\n const url = deps.buildUrl(currentState.name, currentState.params);\n\n deps.browser.replaceState(currentState, url);\n }\n } catch (recoveryError) {\n console.error(\n `[${deps.loggerContext}] Failed to recover from critical error`,\n recoveryError,\n );\n }\n }\n\n async function onPopState(evt: PopStateEvent): Promise<void> {\n if (isTransitioning) {\n console.warn(\n `[${deps.loggerContext}] Transition in progress, deferring popstate event`,\n );\n deferredEvent = evt;\n\n return;\n }\n\n isTransitioning = true;\n\n try {\n const route = getRouteFromEvent(evt, deps.api, deps.browser);\n\n if (route) {\n await deps.router.navigate(\n route.name,\n route.params,\n deps.transitionOptions,\n );\n } else if (deps.allowNotFound) {\n deps.router.navigateToNotFound(deps.browser.getLocation());\n } else {\n await deps.router.navigateToDefault({\n ...deps.transitionOptions,\n reload: true,\n replace: true,\n });\n }\n } catch (error) {\n if (!(error instanceof RouterError)) {\n recoverFromCriticalError(error);\n }\n } finally {\n isTransitioning = false;\n processDeferredEvent();\n }\n }\n\n return (evt: PopStateEvent) => void onPopState(evt);\n}\n\nexport interface PopstateLifecycleDeps {\n browser: Browser;\n shared: SharedFactoryState;\n handler: (evt: PopStateEvent) => void;\n cleanup: () => void;\n}\n\nexport function createPopstateLifecycle(\n deps: PopstateLifecycleDeps,\n): Pick<Plugin, \"onStart\" | \"onStop\" | \"teardown\"> {\n return {\n onStart: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n }\n\n deps.shared.removePopStateListener = deps.browser.addPopstateListener(\n deps.handler,\n );\n },\n\n onStop: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n deps.shared.removePopStateListener = undefined;\n }\n },\n\n teardown: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n deps.shared.removePopStateListener = undefined;\n }\n\n deps.cleanup();\n },\n };\n}\n","import { updateBrowserState } from \"./popstate-utils.js\";\n\nimport type { Browser } from \"./types.js\";\nimport type {\n NavigationOptions,\n Params,\n Router,\n State,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nexport function createStartInterceptor(\n api: PluginApi,\n browser: Browser,\n): () => void {\n return api.addInterceptor(\"start\", (next, path) =>\n next(path ?? browser.getLocation()),\n );\n}\n\nexport function createReplaceHistoryState(\n api: PluginApi,\n router: Router,\n browser: Browser,\n buildUrl: (name: string, params?: Params) => string,\n preserveHash = true,\n): (name: string, params?: Params) => void {\n return (name: string, params: Params = {}) => {\n const state = api.buildState(name, params);\n\n if (!state) {\n throw new Error(\n `[real-router] Cannot replace state: route \"${name}\" is not found`,\n );\n }\n\n const builtState = api.makeState(\n state.name,\n state.params,\n router.buildPath(state.name, state.params),\n {\n params: state.meta,\n },\n );\n\n const hash = preserveHash ? browser.getHash() : \"\";\n const url = buildUrl(name, params) + hash;\n\n updateBrowserState(builtState, url, true, browser);\n };\n}\n\nexport function shouldReplaceHistory(\n navOptions: NavigationOptions,\n toState: State,\n fromState: State | undefined,\n): boolean {\n return (\n (navOptions.replace ?? !fromState) ||\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- fromState is NOT narrowed when replace is false (#447)\n (!!navOptions.reload && toState.path === fromState?.path)\n );\n}\n","export function safeParseUrl(url: string, loggerContext: string): URL | null {\n try {\n const parsedUrl = new URL(url, globalThis.location.origin);\n\n if (![\"http:\", \"https:\"].includes(parsedUrl.protocol)) {\n console.warn(`[${loggerContext}] Invalid URL protocol in ${url}`);\n\n return null;\n }\n\n return parsedUrl;\n } catch (error) {\n console.warn(`[${loggerContext}] Could not parse url ${url}`, error);\n\n return null;\n }\n}\n","import { safeParseUrl } from \"./url-parsing.js\";\n\nexport function extractPath(pathname: string, base: string): string {\n if (!pathname) {\n return \"/\";\n }\n\n if (base && (pathname === base || pathname.startsWith(`${base}/`))) {\n const stripped = pathname.slice(base.length);\n\n return stripped.startsWith(\"/\") ? stripped : `/${stripped}`;\n }\n\n return pathname.startsWith(\"/\") ? pathname : `/${pathname}`;\n}\n\nexport function buildUrl(path: string, base: string): string {\n if (!path) {\n return base;\n }\n\n if (!base) {\n return path.startsWith(\"/\") ? path : `/${path}`;\n }\n\n return path.startsWith(\"/\") ? `${base}${path}` : `${base}/${path}`;\n}\n\nexport function urlToPath(\n url: string,\n base: string,\n context: string,\n): string | null {\n const parsedUrl = safeParseUrl(url, context);\n\n return parsedUrl\n ? extractPath(parsedUrl.pathname, base) + parsedUrl.search\n : null;\n}\n\n/**\n * Parses an absolute URL and returns its path + search, stripped of `base`.\n * Alias of {@link urlToPath} with an explicit non-null contract when the caller\n * already knows the URL is valid (e.g., sourced from the Navigation API or a\n * plugin-owned history store). Safe against malformed input — returns `null`.\n */\nexport function extractPathFromAbsoluteUrl(\n url: string,\n base: string,\n context: string,\n): string | null {\n return urlToPath(url, base, context);\n}\n","import type { BrowserPluginOptions } from \"./types\";\n\nexport const defaultOptions: Required<BrowserPluginOptions> = {\n forceDeactivate: true,\n base: \"\",\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 POPSTATE_SOURCE = \"popstate\";\n\nexport const LOGGER_CONTEXT = \"browser-plugin\";\n","import {\n createPopstateHandler,\n createPopstateLifecycle,\n createStartInterceptor,\n createReplaceHistoryState,\n shouldReplaceHistory,\n updateBrowserState,\n buildUrl,\n urlToPath,\n} from \"./browser-env/index.js\";\nimport { LOGGER_CONTEXT, POPSTATE_SOURCE } from \"./constants\";\n\nimport type { Browser, SharedFactoryState } from \"./browser-env/index.js\";\nimport type { BrowserContext, BrowserPluginOptions } from \"./types\";\nimport type {\n NavigationOptions,\n Params,\n Router,\n State,\n Plugin,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nconst FROZEN_POPSTATE: BrowserContext = Object.freeze({ source: \"popstate\" });\nconst FROZEN_NAVIGATE: BrowserContext = Object.freeze({ source: \"navigate\" });\n\n/** @internal — instantiated by `browserPluginFactory`; not part of the public API. */\nexport class BrowserPlugin {\n readonly #browser: Browser;\n readonly #base: string;\n readonly #removeStartInterceptor: () => void;\n readonly #removeExtensions: () => void;\n readonly #claim: {\n write: (state: State, value: BrowserContext) => void;\n release: () => void;\n };\n readonly #lifecycle: Pick<Plugin, \"onStart\" | \"onStop\" | \"teardown\">;\n\n constructor(\n router: Router,\n api: PluginApi,\n options: Required<BrowserPluginOptions>,\n browser: Browser,\n transitionOptions: {\n source: string;\n replace: true;\n forceDeactivate?: boolean;\n },\n shared: SharedFactoryState,\n ) {\n this.#browser = browser;\n this.#base = options.base;\n this.#claim = api.claimContextNamespace(\"browser\");\n\n this.#removeStartInterceptor = createStartInterceptor(api, browser);\n\n const pluginBuildUrl = (route: string, params?: Params) => {\n const path = router.buildPath(route, params);\n\n return buildUrl(path, options.base);\n };\n\n this.#removeExtensions = api.extendRouter({\n buildUrl: pluginBuildUrl,\n matchUrl: (url: string) => {\n const path = urlToPath(url, options.base, LOGGER_CONTEXT);\n\n return path ? api.matchPath(path) : undefined;\n },\n replaceHistoryState: createReplaceHistoryState(\n api,\n router,\n browser,\n pluginBuildUrl,\n ),\n });\n\n const handler = createPopstateHandler({\n router,\n api,\n browser,\n allowNotFound: api.getOptions().allowNotFound,\n transitionOptions,\n loggerContext: LOGGER_CONTEXT,\n buildUrl: pluginBuildUrl,\n });\n\n this.#lifecycle = createPopstateLifecycle({\n browser,\n shared,\n handler,\n cleanup: () => {\n this.#removeStartInterceptor();\n this.#removeExtensions();\n this.#claim.release();\n },\n });\n }\n\n getPlugin(): Plugin {\n return {\n ...this.#lifecycle,\n\n onTransitionSuccess: (\n toState: State,\n fromState: State | undefined,\n navOptions: NavigationOptions,\n ) => {\n const replaceHistory = shouldReplaceHistory(\n navOptions,\n toState,\n fromState,\n );\n\n const url = buildUrl(toState.path, this.#base);\n\n const shouldPreserveHash =\n !fromState || fromState.path === toState.path;\n\n const hash = shouldPreserveHash ? this.#browser.getHash() : \"\";\n const finalUrl = hash ? url + hash : url;\n\n updateBrowserState(toState, finalUrl, replaceHistory, this.#browser);\n\n const isPopstate =\n (navOptions as Record<string, unknown>).source === POPSTATE_SOURCE;\n\n this.#claim.write(\n toState,\n isPopstate ? FROZEN_POPSTATE : FROZEN_NAVIGATE,\n );\n },\n };\n }\n}\n","import { createOptionsValidator, safeBaseRule } from \"./browser-env/index.js\";\nimport { LOGGER_CONTEXT, defaultOptions } from \"./constants\";\n\nimport type { BrowserPluginOptions } from \"./types\";\n\nexport const validateOptions = createOptionsValidator<BrowserPluginOptions>(\n defaultOptions,\n LOGGER_CONTEXT,\n { base: safeBaseRule },\n);\n","import { getPluginApi } from \"@real-router/core/api\";\n\nimport {\n createSafeBrowser,\n normalizeBase,\n safelyEncodePath,\n extractPath,\n} from \"./browser-env/index.js\";\nimport { defaultOptions, POPSTATE_SOURCE } from \"./constants\";\nimport { BrowserPlugin } from \"./plugin\";\nimport { validateOptions } from \"./validation\";\n\nimport type { Browser, SharedFactoryState } from \"./browser-env/index.js\";\nimport type { BrowserPluginOptions } from \"./types\";\nimport type { PluginFactory, Router } from \"@real-router/core\";\n\nexport function browserPluginFactory(\n opts?: Partial<BrowserPluginOptions>,\n browser?: Browser,\n): PluginFactory {\n validateOptions(opts);\n\n const options: Required<BrowserPluginOptions> = {\n ...defaultOptions,\n ...opts,\n };\n\n options.base = normalizeBase(options.base);\n\n const resolvedBrowser =\n browser ??\n createSafeBrowser(\n () =>\n safelyEncodePath(\n extractPath(globalThis.location.pathname, options.base),\n ) + globalThis.location.search,\n \"browser-plugin\",\n );\n\n const transitionOptions = {\n forceDeactivate: options.forceDeactivate,\n source: POPSTATE_SOURCE,\n replace: true as const,\n };\n\n const shared: SharedFactoryState = { removePopStateListener: undefined };\n\n return function browserPlugin(routerBase) {\n const plugin = new BrowserPlugin(\n routerBase as Router,\n getPluginApi(routerBase),\n options,\n resolvedBrowser,\n transitionOptions,\n shared,\n );\n\n return plugin.getPlugin();\n };\n}\n"],"mappings":"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"}
|
package/dist/esm/index.d.mts
CHANGED
|
@@ -86,7 +86,7 @@ declare module "@real-router/core" {
|
|
|
86
86
|
* Replaces current history state without triggering navigation.
|
|
87
87
|
* Added by browser plugin.
|
|
88
88
|
*/
|
|
89
|
-
replaceHistoryState: (name: string, params?: Params
|
|
89
|
+
replaceHistoryState: (name: string, params?: Params) => void;
|
|
90
90
|
start(path?: string): Promise<State>;
|
|
91
91
|
}
|
|
92
92
|
} //# sourceMappingURL=index.d.ts.map
|
package/dist/esm/index.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.mts","names":["NavigationOptions","Params","State","isNavigationOptions","value","isRouteName","name","isState","P","isStateStrict","isString","isBoolean","isObjKey","T","Extract","key","obj","isPrimitiveValue","isParams","isParamsStrict","validateRouteName","methodName","validateState","state","method","getTypeDescription"],"sources":["../../src/types.ts","../../../../shared/browser-env/types.ts","../../src/factory.ts","../../../type-guards/dist/esm/index.d.mts","../../src/index.ts"],"mappings":";;;;;;;
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":["NavigationOptions","Params","State","isNavigationOptions","value","isRouteName","name","isState","P","isStateStrict","isString","isBoolean","isObjKey","T","Extract","key","obj","isPrimitiveValue","isParams","isParamsStrict","validateRouteName","methodName","validateState","state","method","getTypeDescription"],"sources":["../../src/types.ts","../../../../shared/browser-env/types.ts","../../src/factory.ts","../../../type-guards/dist/esm/index.d.mts","../../src/index.ts"],"mappings":";;;;;;;KAGY,aAAA;AAAA,UAEK,cAAA;EACf,MAAA,EAAQ,aAAA;AAAA;AAAA,UAGO,oBAAA;EANQ;;AAEzB;;;EAUE,eAAA;EATqB;AAGvB;;;;EAaE,IAAA;AAAA;;;UCtBe,cAAA;EACf,SAAA,GAAY,KAAA,WAAgB,IAAA;EAC5B,YAAA,GAAe,KAAA,WAAgB,IAAA;EAC/B,mBAAA,GAAsB,EAAA,GAAK,GAAA,EAAK,aAAA;EAChC,OAAA;AAAA;AAAA,UAGe,OAAA,SAAgB,cAAA;EAC/B,WAAA;AAAA;;;iBCQc,oBAAA,CACd,IAAA,GAAO,OAAA,CAAQ,oBAAA,GACf,OAAA,GAAU,OAAA,GACT,aAAA;;;;;;;;;;;;;;;iBC8DcS,aAAAA,WAAwBR,QAAAA,GAASA,QAAAA,CAAAA,CAAQG,KAAAA,YAAiBA,KAAAA,IAASF,OAAAA,CAAMM,CAAAA;AAAAA;;;;;;AChEnC;;;AJdvD;;;;AAAA;EAAA,UIqBY,YAAA;IACR,OAAA,GARmD,cAAA;EAAA;AAAA;AAAA;EAAA,UAa3C,MAAA;IJrByB;;;;II0BjC,QAAA,GAAW,IAAA,UAAc,MAAA,GAAS,MAAA;;;AHnCtC;;IGyCI,QAAA,GAAW,GAAA,aAAgB,KAAA;IHtCgB;;;;IG4C3C,mBAAA,GAAsB,IAAA,UAAc,MAAA,GAAS,MAAA;IAE7C,KAAA,CAAM,IAAA,YAAgB,OAAA,CAAQ,KAAA;EAAA;AAAA"}
|
package/dist/esm/index.mjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{getPluginApi as e}from"@real-router/core/api";import{RouterError as t}from"@real-router/core";const n=()=>globalThis.window!==void 0&&!!globalThis.history,r=(e,t)=>{globalThis.history.pushState(e,``,t)},i=(e,t)=>{globalThis.history.replaceState(e,``,t)},a=e=>(globalThis.addEventListener(`popstate`,e),()=>{globalThis.removeEventListener(`popstate`,e)}),o=()=>globalThis.location.hash;function s(e){if(!e)return e;let t=e;return t.startsWith(`/`)||(t=`/${t}`),t.endsWith(`/`)&&(t=t.slice(0,-1)),t}const c=e=>{try{return encodeURI(decodeURI(e))}catch(t){return console.warn(`[browser-env] Could not encode path "${e}"`,t),e}},l=()=>{},u=e=>{let t=!1;return n=>{t||=(console.warn(`[browser-env] Browser API is running in a non-browser environment (context: "${e}"). Method "${n}" is a no-op. This is expected for SSR, but may indicate misconfiguration if you expected browser behavior.`),!0)}},d=e=>{let t=u(e);return{pushState:()=>{t(`pushState`)},replaceState:()=>{t(`replaceState`)},addPopstateListener:()=>(t(`addPopstateListener`),l),getHash:()=>(t(`getHash`),``)}},f=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function p(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:f.test(e):!1}function m(e,t=new WeakSet){if(e==null)return!0;let n=typeof e;if(n===`string`||n===`boolean`)return!0;if(n===`number`)return Number.isFinite(e);if(n===`function`||n===`symbol`)return!1;if(Array.isArray(e))return t.has(e)?!1:(t.add(e),e.every(e=>m(e,t)));if(n===`object`){if(t.has(e))return!1;t.add(e);let n=Object.getPrototypeOf(e);return n!==null&&n!==Object.prototype?!1:Object.values(e).every(e=>m(e,t))}return!1}function h(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}function g(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let r=e[t];if(!h(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return n?m(e):!0}function _(e){return p(e.name)&&typeof e.path==`string`&&g(e.params)}function v(e){return!(typeof e!=`object`||!e||!_(e))}function y(e,t,n){if(v(e.state))return{name:e.state.name,params:e.state.params};let r=t.matchPath(n.getLocation());return r?{name:r.name,params:r.params}:void 0}function b(e,t,n,r){let i={name:e.name,params:e.params,path:e.path};n?r.replaceState(i,t):r.pushState(i,t)}function x(e,t){return
|
|
1
|
+
import{getPluginApi as e}from"@real-router/core/api";import{RouterError as t}from"@real-router/core";const n=()=>globalThis.window!==void 0&&!!globalThis.history,r=(e,t)=>{globalThis.history.pushState(e,``,t)},i=(e,t)=>{globalThis.history.replaceState(e,``,t)},a=e=>(globalThis.addEventListener(`popstate`,e),()=>{globalThis.removeEventListener(`popstate`,e)}),o=()=>globalThis.location.hash;function s(e){if(!e)return e;let t=e.replaceAll(/\/+/g,`/`);return t.startsWith(`/`)||(t=`/${t}`),t.length>1&&t.endsWith(`/`)&&(t=t.slice(0,-1)),t===`/`?``:t}const c=e=>{try{return encodeURI(decodeURI(e))}catch(t){return console.warn(`[browser-env] Could not encode path "${e}"`,t),e}},l=()=>{},u=e=>{let t=!1;return n=>{t||=(console.warn(`[browser-env] Browser API is running in a non-browser environment (context: "${e}"). Method "${n}" is a no-op. This is expected for SSR, but may indicate misconfiguration if you expected browser behavior.`),!0)}},d=e=>{let t=u(e);return{pushState:()=>{t(`pushState`)},replaceState:()=>{t(`replaceState`)},addPopstateListener:()=>(t(`addPopstateListener`),l),getHash:()=>(t(`getHash`),``)}},f=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function p(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:f.test(e):!1}function m(e,t=new WeakSet){if(e==null)return!0;let n=typeof e;if(n===`string`||n===`boolean`)return!0;if(n===`number`)return Number.isFinite(e);if(n===`function`||n===`symbol`)return!1;if(Array.isArray(e))return t.has(e)?!1:(t.add(e),e.every(e=>m(e,t)));if(n===`object`){if(t.has(e))return!1;t.add(e);let n=Object.getPrototypeOf(e);return n!==null&&n!==Object.prototype?!1:Object.values(e).every(e=>m(e,t))}return!1}function h(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}function g(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let r=e[t];if(!h(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return n?m(e):!0}function _(e){return p(e.name)&&typeof e.path==`string`&&g(e.params)}function v(e){return!(typeof e!=`object`||!e||!_(e))}function y(e,t,n){if(v(e.state))return{name:e.state.name,params:e.state.params};let r=t.matchPath(n.getLocation());return r?{name:r.name,params:r.params}:void 0}function b(e,t,n,r){let i={name:e.name,params:e.params,path:e.path};n?r.replaceState(i,t):r.pushState(i,t)}function x(e,t,n){return r=>{if(r)for(let i of Object.keys(r)){if(!(i in e))continue;let a=r[i];if(a===void 0)continue;let o=typeof e[i],s=typeof a;if(s!==o)throw Error(`[${t}] Invalid type for '${i}': expected ${o}, got ${s}`);let c=n?.[i];if(c){let e=c.validate(a);if(e!==null)throw Error(`[${t}] Invalid '${i}': ${e}`)}}}}const S=/[\u0000-\u001F\u007F]/,C={validate:e=>S.test(e)?`must not contain control characters`:e.split(`/`).includes(`..`)?`must not contain '..' segments`:null};function w(e,t){if(n())return{pushState:r,replaceState:i,addPopstateListener:a,getLocation:e,getHash:o};let s=u(t);return{...d(t),getLocation:()=>(s(`getLocation`),``)}}function T(e){let n=!1,r=null;function i(){if(r){let t=r;r=null,console.warn(`[${e.loggerContext}] Processing deferred popstate event`),o(t)}}function a(t){console.error(`[${e.loggerContext}] Critical error in onPopState`,t);try{let t=e.router.getState();if(t){let n=e.buildUrl(t.name,t.params);e.browser.replaceState(t,n)}}catch(t){console.error(`[${e.loggerContext}] Failed to recover from critical error`,t)}}async function o(o){if(n){console.warn(`[${e.loggerContext}] Transition in progress, deferring popstate event`),r=o;return}n=!0;try{let t=y(o,e.api,e.browser);t?await e.router.navigate(t.name,t.params,e.transitionOptions):e.allowNotFound?e.router.navigateToNotFound(e.browser.getLocation()):await e.router.navigateToDefault({...e.transitionOptions,reload:!0,replace:!0})}catch(e){e instanceof t||a(e)}finally{n=!1,i()}}return e=>void o(e)}function E(e){return{onStart:()=>{e.shared.removePopStateListener&&e.shared.removePopStateListener(),e.shared.removePopStateListener=e.browser.addPopstateListener(e.handler)},onStop:()=>{e.shared.removePopStateListener&&(e.shared.removePopStateListener(),e.shared.removePopStateListener=void 0)},teardown:()=>{e.shared.removePopStateListener&&(e.shared.removePopStateListener(),e.shared.removePopStateListener=void 0),e.cleanup()}}}function D(e,t){return e.addInterceptor(`start`,(e,n)=>e(n??t.getLocation()))}function O(e,t,n,r,i=!0){return(a,o={})=>{let s=e.buildState(a,o);if(!s)throw Error(`[real-router] Cannot replace state: route "${a}" is not found`);let c=e.makeState(s.name,s.params,t.buildPath(s.name,s.params),{params:s.meta}),l=i?n.getHash():``;b(c,r(a,o)+l,!0,n)}}function k(e,t,n){return(e.replace??!n)||!!e.reload&&t.path===n?.path}function A(e,t){try{let n=new URL(e,globalThis.location.origin);return[`http:`,`https:`].includes(n.protocol)?n:(console.warn(`[${t}] Invalid URL protocol in ${e}`),null)}catch(n){return console.warn(`[${t}] Could not parse url ${e}`,n),null}}function j(e,t){if(!e)return`/`;if(t&&(e===t||e.startsWith(`${t}/`))){let n=e.slice(t.length);return n.startsWith(`/`)?n:`/${n}`}return e.startsWith(`/`)?e:`/${e}`}function M(e,t){return e?t?e.startsWith(`/`)?`${t}${e}`:`${t}/${e}`:e.startsWith(`/`)?e:`/${e}`:t}function N(e,t,n){let r=A(e,n);return r?j(r.pathname,t)+r.search:null}const P={forceDeactivate:!0,base:``},F=`popstate`,I=`browser-plugin`,L=Object.freeze({source:`popstate`}),R=Object.freeze({source:`navigate`});var z=class{#e;#t;#n;#r;#i;#a;constructor(e,t,n,r,i,a){this.#e=r,this.#t=n.base,this.#i=t.claimContextNamespace(`browser`),this.#n=D(t,r);let o=(t,r)=>M(e.buildPath(t,r),n.base);this.#r=t.extendRouter({buildUrl:o,matchUrl:e=>{let r=N(e,n.base,I);return r?t.matchPath(r):void 0},replaceHistoryState:O(t,e,r,o)}),this.#a=E({browser:r,shared:a,handler:T({router:e,api:t,browser:r,allowNotFound:t.getOptions().allowNotFound,transitionOptions:i,loggerContext:I,buildUrl:o}),cleanup:()=>{this.#n(),this.#r(),this.#i.release()}})}getPlugin(){return{...this.#a,onTransitionSuccess:(e,t,n)=>{let r=k(n,e,t),i=M(e.path,this.#t),a=!t||t.path===e.path?this.#e.getHash():``;b(e,a?i+a:i,r,this.#e);let o=n.source===F;this.#i.write(e,o?L:R)}}}};const B=x(P,I,{base:C});function V(t,n){B(t);let r={...P,...t};r.base=s(r.base);let i=n??w(()=>c(j(globalThis.location.pathname,r.base))+globalThis.location.search,`browser-plugin`),a={forceDeactivate:r.forceDeactivate,source:F,replace:!0},o={removePopStateListener:void 0};return function(t){return new z(t,e(t),r,i,a,o).getPlugin()}}export{V as browserPluginFactory,v as isState};
|
|
2
2
|
//# sourceMappingURL=index.mjs.map
|
package/dist/esm/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.mjs","names":["isState","#router","#browser","#removeStartInterceptor","#removeExtensions","#claim","#lifecycle","POPSTATE_SOURCE"],"sources":["../../../../shared/browser-env/detect.ts","../../../../shared/browser-env/history-api.ts","../../../../shared/browser-env/utils.ts","../../../../shared/browser-env/ssr-fallback.ts","../../../type-guards/dist/esm/index.mjs","../../../../shared/browser-env/popstate-utils.ts","../../../../shared/browser-env/validation.ts","../../../../shared/browser-env/safe-browser.ts","../../../../shared/browser-env/popstate-handler.ts","../../../../shared/browser-env/plugin-utils.ts","../../../../shared/browser-env/url-parsing.ts","../../../../shared/browser-env/url-utils.ts","../../src/constants.ts","../../src/plugin.ts","../../src/validation.ts","../../src/factory.ts"],"sourcesContent":["export const isBrowserEnvironment = (): boolean =>\n typeof globalThis.window !== \"undefined\" && !!globalThis.history;\n","import type { HistoryBrowser } from \"./types.js\";\n\nexport const pushState = (state: unknown, path: string): void => {\n globalThis.history.pushState(state, \"\", path);\n};\n\nexport const replaceState = (state: unknown, path: string): void => {\n globalThis.history.replaceState(state, \"\", path);\n};\n\nexport const addPopstateListener: HistoryBrowser[\"addPopstateListener\"] = (\n fn,\n) => {\n globalThis.addEventListener(\"popstate\", fn);\n\n return () => {\n globalThis.removeEventListener(\"popstate\", fn);\n };\n};\n\nexport const getHash = (): string => globalThis.location.hash;\n","/**\n * Normalizes base path: ensures leading slash, removes trailing slash.\n *\n * @example\n * normalizeBase(\"app\") // \"/app\"\n * normalizeBase(\"/app/\") // \"/app\"\n * normalizeBase(\"\") // \"\"\n */\nexport function normalizeBase(base: string): string {\n if (!base) {\n return base;\n }\n\n let result = base;\n\n if (!result.startsWith(\"/\")) {\n result = `/${result}`;\n }\n\n if (result.endsWith(\"/\")) {\n result = result.slice(0, -1);\n }\n\n return result;\n}\n\nexport const safelyEncodePath = (path: string): string => {\n try {\n return encodeURI(decodeURI(path));\n } catch (error) {\n console.warn(`[browser-env] Could not encode path \"${path}\"`, error);\n\n return path;\n }\n};\n","import type { HistoryBrowser } from \"./types.js\";\n\nconst NOOP = (): void => {};\n\nexport const createWarnOnce = (context: string) => {\n let hasWarned = false;\n\n return (method: string): void => {\n if (!hasWarned) {\n console.warn(\n `[browser-env] Browser API is running in a non-browser environment (context: \"${context}\"). ` +\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\nexport const createHistoryFallbackBrowser = (\n context: string,\n): HistoryBrowser => {\n const warnOnce = createWarnOnce(context);\n\n return {\n pushState: () => {\n warnOnce(\"pushState\");\n },\n replaceState: () => {\n warnOnce(\"replaceState\");\n },\n addPopstateListener: () => {\n warnOnce(\"addPopstateListener\");\n\n return NOOP;\n },\n getHash: () => {\n warnOnce(\"getHash\");\n\n return \"\";\n },\n };\n};\n","const e=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`];function t(t){if(typeof t!=`object`||!t||Array.isArray(t))return!1;let n=t;for(let t of e){let e=n[t];if(e!==void 0&&typeof e!=`boolean`)return!1}let r=n.signal;return!(r!==void 0&&!(r instanceof AbortSignal))}const n=/\\S/,r=/^[A-Z_a-z][\\w-]*(?:\\.[A-Z_a-z][\\w-]*)*$/;function i(e,t){return TypeError(`[router.${e}] ${t}`)}function a(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:r.test(e):!1}function o(e,t=new WeakSet){if(e==null)return!0;let n=typeof e;if(n===`string`||n===`boolean`)return!0;if(n===`number`)return Number.isFinite(e);if(n===`function`||n===`symbol`)return!1;if(Array.isArray(e))return t.has(e)?!1:(t.add(e),e.every(e=>o(e,t)));if(n===`object`){if(t.has(e))return!1;t.add(e);let n=Object.getPrototypeOf(e);return n!==null&&n!==Object.prototype?!1:Object.values(e).every(e=>o(e,t))}return!1}function s(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}function c(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let r=e[t];if(!s(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return n?o(e):!0}function l(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):Array.isArray(e)?e.every(e=>{let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}):!1}function u(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let n=e[t];if(!l(n))return!1}return!0}function d(e){return a(e.name)&&typeof e.path==`string`&&c(e.params)}function f(e){return typeof e!=`object`||!e?!1:d(e)}function p(e){return!(typeof e!=`object`||!e||!d(e))}function m(e){return typeof e==`string`}function h(e){return typeof e==`boolean`}function g(e,t){return e in t}function _(e){return typeof e==`number`?Number.isFinite(e):typeof e==`string`||typeof e==`boolean`}function v(e,t){if(typeof e!=`string`)throw i(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!n.test(e))throw i(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw i(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!r.test(e))throw i(t,`Invalid route name \"${e}\". Each segment must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens. Segments are separated by dots (e.g., \"users.profile\").`)}}function y(e){return e===null?`null`:Array.isArray(e)?`array[${e.length}]`:typeof e==`object`?`constructor`in e&&e.constructor.name!==`Object`?e.constructor.name:`object`:typeof e}function b(e,t){if(!f(e))throw TypeError(`[${t}] Invalid state structure: ${y(e)}. Expected State object with name, params, and path properties.`)}export{y as getTypeDescription,h as isBoolean,t as isNavigationOptions,g as isObjKey,c as isParams,u as isParamsStrict,_ as isPrimitiveValue,a as isRouteName,f as isState,p as isStateStrict,m as isString,v as validateRouteName,b as validateState};\n//# sourceMappingURL=index.mjs.map","import { isStateStrict as isState } from \"type-guards\";\n\nimport type { Browser } from \"./types.js\";\nimport type { State, Params } from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\n/**\n * Extracts route name and params from a popstate event.\n *\n * - If history.state is a valid router state → returns name/params from it\n * - If not (e.g. manually entered URL) → matches current URL against route tree\n * - Returns undefined if no route matches\n *\n * @param evt - PopStateEvent from browser\n * @param api - PluginApi instance\n * @param browser - Browser API instance\n * @returns Route identifier or undefined\n */\nexport function getRouteFromEvent(\n evt: PopStateEvent,\n api: PluginApi,\n browser: Browser,\n): { name: string; params: Params } | undefined {\n if (isState(evt.state)) {\n return { name: evt.state.name, params: evt.state.params };\n }\n\n const state = api.matchPath(browser.getLocation());\n\n return state ? { name: state.name, params: state.params } : undefined;\n}\n\n/**\n * Updates browser state (pushState or replaceState)\n *\n * @param state - Router state\n * @param url - URL to set\n * @param replace - Whether to replace instead of push\n * @param browser - Browser API instance\n */\nexport function updateBrowserState(\n state: State,\n url: string,\n replace: boolean,\n browser: Browser,\n): void {\n const historyState = {\n name: state.name,\n params: state.params,\n path: state.path,\n };\n\n if (replace) {\n browser.replaceState(historyState, url);\n } else {\n browser.pushState(historyState, url);\n }\n}\n","export function createOptionsValidator<T extends object>(\n defaults: Required<T>,\n loggerContext: string,\n): (opts: Partial<T> | undefined) => void {\n return (opts) => {\n if (!opts) {\n return;\n }\n\n for (const key of Object.keys(opts)) {\n if (key in defaults) {\n const value = opts[key as keyof typeof opts];\n const expected = typeof defaults[key as keyof typeof defaults];\n const actual = typeof value;\n\n if (value !== undefined && actual !== expected) {\n throw new Error(\n `[${loggerContext}] Invalid type for '${key}': expected ${expected}, got ${actual}`,\n );\n }\n }\n }\n };\n}\n","import { isBrowserEnvironment } from \"./detect.js\";\nimport {\n pushState,\n replaceState,\n addPopstateListener,\n getHash,\n} from \"./history-api.js\";\nimport {\n createWarnOnce,\n createHistoryFallbackBrowser,\n} from \"./ssr-fallback.js\";\n\nimport type { Browser } from \"./types.js\";\n\nexport function createSafeBrowser(\n getLocation: () => string,\n context: string,\n): Browser {\n if (isBrowserEnvironment()) {\n return {\n pushState,\n replaceState,\n addPopstateListener,\n getLocation,\n getHash,\n };\n }\n\n const warnOnce = createWarnOnce(context);\n\n return {\n ...createHistoryFallbackBrowser(context),\n getLocation: () => {\n warnOnce(\"getLocation\");\n\n return \"\";\n },\n };\n}\n","import { RouterError } from \"@real-router/core\";\n\nimport { getRouteFromEvent } from \"./popstate-utils.js\";\n\nimport type { Browser, SharedFactoryState } from \"./types.js\";\nimport type { Params, Plugin, Router } from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nexport interface PopstateHandlerDeps {\n router: Router;\n api: PluginApi;\n browser: Browser;\n allowNotFound: boolean;\n transitionOptions: {\n source: string;\n replace: true;\n forceDeactivate?: boolean;\n };\n loggerContext: string;\n buildUrl: (name: string, params?: Params) => string;\n}\n\nexport function createPopstateHandler(\n deps: PopstateHandlerDeps,\n): (evt: PopStateEvent) => void {\n let isTransitioning = false;\n let deferredEvent: PopStateEvent | null = null;\n\n function processDeferredEvent(): void {\n if (deferredEvent) {\n const evt = deferredEvent;\n\n deferredEvent = null;\n console.warn(\n `[${deps.loggerContext}] Processing deferred popstate event`,\n );\n void onPopState(evt);\n }\n }\n\n function recoverFromCriticalError(error: unknown): void {\n console.error(\n `[${deps.loggerContext}] Critical error in onPopState`,\n error,\n );\n\n try {\n const currentState = deps.router.getState();\n\n /* v8 ignore next -- @preserve: router always has state after start(); defensive guard for edge cases */\n if (currentState) {\n const url = deps.buildUrl(currentState.name, currentState.params);\n\n deps.browser.replaceState(currentState, url);\n }\n } catch (recoveryError) {\n console.error(\n `[${deps.loggerContext}] Failed to recover from critical error`,\n recoveryError,\n );\n }\n }\n\n async function onPopState(evt: PopStateEvent): Promise<void> {\n if (isTransitioning) {\n console.warn(\n `[${deps.loggerContext}] Transition in progress, deferring popstate event`,\n );\n deferredEvent = evt;\n\n return;\n }\n\n isTransitioning = true;\n\n try {\n const route = getRouteFromEvent(evt, deps.api, deps.browser);\n\n if (route) {\n await deps.router.navigate(\n route.name,\n route.params,\n deps.transitionOptions,\n );\n } else if (deps.allowNotFound) {\n deps.router.navigateToNotFound(deps.browser.getLocation());\n } else {\n await deps.router.navigateToDefault({\n ...deps.transitionOptions,\n reload: true,\n replace: true,\n });\n }\n } catch (error) {\n if (!(error instanceof RouterError)) {\n recoverFromCriticalError(error);\n }\n } finally {\n isTransitioning = false;\n processDeferredEvent();\n }\n }\n\n return (evt: PopStateEvent) => void onPopState(evt);\n}\n\nexport interface PopstateLifecycleDeps {\n browser: Browser;\n shared: SharedFactoryState;\n handler: (evt: PopStateEvent) => void;\n cleanup: () => void;\n}\n\nexport function createPopstateLifecycle(\n deps: PopstateLifecycleDeps,\n): Pick<Plugin, \"onStart\" | \"onStop\" | \"teardown\"> {\n return {\n onStart: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n }\n\n deps.shared.removePopStateListener = deps.browser.addPopstateListener(\n deps.handler,\n );\n },\n\n onStop: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n deps.shared.removePopStateListener = undefined;\n }\n },\n\n teardown: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n deps.shared.removePopStateListener = undefined;\n }\n\n deps.cleanup();\n },\n };\n}\n","import { updateBrowserState } from \"./popstate-utils.js\";\n\nimport type { Browser } from \"./types.js\";\nimport type {\n NavigationOptions,\n Params,\n Router,\n State,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nexport function createStartInterceptor(\n api: PluginApi,\n browser: Browser,\n): () => void {\n return api.addInterceptor(\"start\", (next, path) =>\n next(path ?? browser.getLocation()),\n );\n}\n\nexport function createReplaceHistoryState(\n api: PluginApi,\n router: Router,\n browser: Browser,\n buildUrl: (name: string, params?: Params) => string,\n): (name: string, params?: Params) => void {\n return (name: string, params: Params = {}) => {\n const state = api.buildState(name, params);\n\n if (!state) {\n throw new Error(\n `[real-router] Cannot replace state: route \"${name}\" is not found`,\n );\n }\n\n const builtState = api.makeState(\n state.name,\n state.params,\n router.buildPath(state.name, state.params),\n {\n params: state.meta,\n },\n );\n\n updateBrowserState(builtState, buildUrl(name, params), true, browser);\n };\n}\n\nexport function shouldReplaceHistory(\n navOptions: NavigationOptions,\n toState: State,\n fromState: State | undefined,\n): boolean {\n return (\n (navOptions.replace ?? !fromState) ||\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- fromState is NOT narrowed when replace is false (#447)\n (!!navOptions.reload && toState.path === fromState?.path)\n );\n}\n","export function safeParseUrl(url: string, loggerContext: string): URL | null {\n try {\n const parsedUrl = new URL(url, globalThis.location.origin);\n\n if (![\"http:\", \"https:\"].includes(parsedUrl.protocol)) {\n console.warn(`[${loggerContext}] Invalid URL protocol in ${url}`);\n\n return null;\n }\n\n return parsedUrl;\n } catch (error) {\n console.warn(`[${loggerContext}] Could not parse url ${url}`, error);\n\n return null;\n }\n}\n","import { safeParseUrl } from \"./url-parsing.js\";\n\nexport function extractPath(pathname: string, base: string): string {\n if (base && (pathname === base || pathname.startsWith(`${base}/`))) {\n const stripped = pathname.slice(base.length);\n\n return stripped.startsWith(\"/\") ? stripped : `/${stripped}`;\n }\n\n return pathname;\n}\n\nexport function buildUrl(path: string, base: string): string {\n return base + path;\n}\n\nexport function urlToPath(\n url: string,\n base: string,\n context: string,\n): string | null {\n const parsedUrl = safeParseUrl(url, context);\n\n return parsedUrl\n ? extractPath(parsedUrl.pathname, base) + parsedUrl.search\n : null;\n}\n","// packages/browser-plugin/modules/constants.ts\n\nimport type { BrowserPluginOptions } from \"./types\";\n\nexport const defaultOptions: Required<BrowserPluginOptions> = {\n forceDeactivate: true,\n base: \"\",\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","import {\n createPopstateHandler,\n createPopstateLifecycle,\n createStartInterceptor,\n createReplaceHistoryState,\n shouldReplaceHistory,\n updateBrowserState,\n buildUrl,\n urlToPath,\n} from \"./browser-env/index.js\";\nimport { LOGGER_CONTEXT, source as POPSTATE_SOURCE } from \"./constants\";\n\nimport type { Browser, SharedFactoryState } from \"./browser-env/index.js\";\nimport type { BrowserContext, BrowserPluginOptions } from \"./types\";\nimport type {\n NavigationOptions,\n Params,\n Router,\n State,\n Plugin,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nexport class BrowserPlugin {\n readonly #router: Router;\n readonly #browser: Browser;\n readonly #removeStartInterceptor: () => void;\n readonly #removeExtensions: () => void;\n readonly #claim: {\n write: (state: State, value: BrowserContext) => void;\n release: () => void;\n };\n readonly #lifecycle: Pick<Plugin, \"onStart\" | \"onStop\" | \"teardown\">;\n\n constructor(\n router: Router,\n api: PluginApi,\n options: Required<BrowserPluginOptions>,\n browser: Browser,\n transitionOptions: {\n source: string;\n replace: true;\n forceDeactivate?: boolean;\n },\n shared: SharedFactoryState,\n ) {\n this.#router = router;\n this.#browser = browser;\n this.#claim = api.claimContextNamespace(\"browser\");\n\n this.#removeStartInterceptor = createStartInterceptor(api, browser);\n\n const pluginBuildUrl = (route: string, params?: Params) => {\n const path = router.buildPath(route, params);\n\n return buildUrl(path, options.base);\n };\n\n this.#removeExtensions = api.extendRouter({\n buildUrl: pluginBuildUrl,\n matchUrl: (url: string) => {\n const path = urlToPath(url, options.base, LOGGER_CONTEXT);\n\n return path ? api.matchPath(path) : undefined;\n },\n replaceHistoryState: createReplaceHistoryState(\n api,\n router,\n browser,\n pluginBuildUrl,\n ),\n });\n\n const handler = createPopstateHandler({\n router,\n api,\n browser,\n allowNotFound: api.getOptions().allowNotFound,\n transitionOptions,\n loggerContext: \"browser-plugin\",\n buildUrl: (name: string, params?: Params) =>\n router.buildUrl(name, params),\n });\n\n this.#lifecycle = createPopstateLifecycle({\n browser,\n shared,\n handler,\n cleanup: () => {\n this.#removeStartInterceptor();\n this.#removeExtensions();\n this.#claim.release();\n },\n });\n }\n\n getPlugin(): Plugin {\n return {\n ...this.#lifecycle,\n\n onTransitionSuccess: (\n toState: State,\n fromState: State | undefined,\n navOptions: NavigationOptions,\n ) => {\n const replaceHistory = shouldReplaceHistory(\n navOptions,\n toState,\n fromState,\n );\n\n const url = this.#router.buildUrl(toState.name, toState.params);\n\n const shouldPreserveHash =\n !fromState || fromState.path === toState.path;\n\n const finalUrl = shouldPreserveHash\n ? url + this.#browser.getHash()\n : url;\n\n updateBrowserState(toState, finalUrl, replaceHistory, this.#browser);\n\n const isPopstate =\n (navOptions as Record<string, unknown>).source === POPSTATE_SOURCE;\n\n this.#claim.write(\n toState,\n Object.freeze({ source: isPopstate ? \"popstate\" : \"navigate\" }),\n );\n },\n };\n }\n}\n","import { createOptionsValidator } from \"./browser-env/index.js\";\nimport { LOGGER_CONTEXT, defaultOptions } from \"./constants\";\n\nimport type { BrowserPluginOptions } from \"./types\";\n\nexport const validateOptions = createOptionsValidator<BrowserPluginOptions>(\n defaultOptions,\n LOGGER_CONTEXT,\n);\n","import { getPluginApi } from \"@real-router/core/api\";\n\nimport {\n createSafeBrowser,\n normalizeBase,\n safelyEncodePath,\n extractPath,\n} from \"./browser-env/index.js\";\nimport { defaultOptions, source } from \"./constants\";\nimport { BrowserPlugin } from \"./plugin\";\nimport { validateOptions } from \"./validation\";\n\nimport type { Browser, SharedFactoryState } from \"./browser-env/index.js\";\nimport type { BrowserPluginOptions } from \"./types\";\nimport type { PluginFactory, Router } from \"@real-router/core\";\n\nexport function browserPluginFactory(\n opts?: Partial<BrowserPluginOptions>,\n browser?: Browser,\n): PluginFactory {\n validateOptions(opts);\n\n const options: Required<BrowserPluginOptions> = {\n ...defaultOptions,\n ...opts,\n };\n\n options.base = normalizeBase(options.base);\n\n const resolvedBrowser =\n browser ??\n createSafeBrowser(\n () =>\n safelyEncodePath(\n extractPath(globalThis.location.pathname, options.base),\n ) + globalThis.location.search,\n \"browser-plugin\",\n );\n\n const forceDeactivate = options.forceDeactivate;\n const transitionOptions = { forceDeactivate, source, replace: true as const };\n\n const shared: SharedFactoryState = { removePopStateListener: undefined };\n\n return function browserPlugin(routerBase) {\n const plugin = new BrowserPlugin(\n routerBase as Router,\n getPluginApi(routerBase),\n options,\n resolvedBrowser,\n transitionOptions,\n shared,\n );\n\n return plugin.getPlugin();\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.mjs","names":["isState","#browser","#base","#removeStartInterceptor","#removeExtensions","#claim","#lifecycle"],"sources":["../../../../shared/browser-env/detect.ts","../../../../shared/browser-env/history-api.ts","../../../../shared/browser-env/utils.ts","../../../../shared/browser-env/ssr-fallback.ts","../../../type-guards/dist/esm/index.mjs","../../../../shared/browser-env/popstate-utils.ts","../../../../shared/browser-env/validation.ts","../../../../shared/browser-env/safe-browser.ts","../../../../shared/browser-env/popstate-handler.ts","../../../../shared/browser-env/plugin-utils.ts","../../../../shared/browser-env/url-parsing.ts","../../../../shared/browser-env/url-utils.ts","../../src/constants.ts","../../src/plugin.ts","../../src/validation.ts","../../src/factory.ts"],"sourcesContent":["export const isBrowserEnvironment = (): boolean =>\n typeof globalThis.window !== \"undefined\" && !!globalThis.history;\n","import type { HistoryBrowser } from \"./types.js\";\n\nexport const pushState = (state: unknown, path: string): void => {\n globalThis.history.pushState(state, \"\", path);\n};\n\nexport const replaceState = (state: unknown, path: string): void => {\n globalThis.history.replaceState(state, \"\", path);\n};\n\nexport const addPopstateListener: HistoryBrowser[\"addPopstateListener\"] = (\n fn,\n) => {\n globalThis.addEventListener(\"popstate\", fn);\n\n return () => {\n globalThis.removeEventListener(\"popstate\", fn);\n };\n};\n\nexport const getHash = (): string => globalThis.location.hash;\n","/**\n * Normalizes base path to canonical form: leading slash, no trailing slash,\n * no repeated slashes. Isolated \"/\" collapses to \"\".\n *\n * @example\n * normalizeBase(\"app\") // \"/app\"\n * normalizeBase(\"/app/\") // \"/app\"\n * normalizeBase(\"//app//\") // \"/app\"\n * normalizeBase(\"\") // \"\"\n * normalizeBase(\"/\") // \"\"\n */\nexport function normalizeBase(base: string): string {\n if (!base) {\n return base;\n }\n\n let result = base.replaceAll(/\\/+/g, \"/\");\n\n if (!result.startsWith(\"/\")) {\n result = `/${result}`;\n }\n\n if (result.length > 1 && result.endsWith(\"/\")) {\n result = result.slice(0, -1);\n }\n\n return result === \"/\" ? \"\" : result;\n}\n\nexport const safelyEncodePath = (path: string): string => {\n try {\n return encodeURI(decodeURI(path));\n } catch (error) {\n console.warn(`[browser-env] Could not encode path \"${path}\"`, error);\n\n return path;\n }\n};\n","import type { HistoryBrowser } from \"./types.js\";\n\nconst NOOP = (): void => {};\n\nexport const createWarnOnce = (context: string) => {\n let hasWarned = false;\n\n return (method: string): void => {\n if (!hasWarned) {\n console.warn(\n `[browser-env] Browser API is running in a non-browser environment (context: \"${context}\"). ` +\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\nexport const createHistoryFallbackBrowser = (\n context: string,\n): HistoryBrowser => {\n const warnOnce = createWarnOnce(context);\n\n return {\n pushState: () => {\n warnOnce(\"pushState\");\n },\n replaceState: () => {\n warnOnce(\"replaceState\");\n },\n addPopstateListener: () => {\n warnOnce(\"addPopstateListener\");\n\n return NOOP;\n },\n getHash: () => {\n warnOnce(\"getHash\");\n\n return \"\";\n },\n };\n};\n","const e=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`];function t(t){if(typeof t!=`object`||!t||Array.isArray(t))return!1;let n=t;for(let t of e){let e=n[t];if(e!==void 0&&typeof e!=`boolean`)return!1}let r=n.signal;return!(r!==void 0&&!(r instanceof AbortSignal))}const n=/\\S/,r=/^[A-Z_a-z][\\w-]*(?:\\.[A-Z_a-z][\\w-]*)*$/;function i(e,t){return TypeError(`[router.${e}] ${t}`)}function a(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:r.test(e):!1}function o(e,t=new WeakSet){if(e==null)return!0;let n=typeof e;if(n===`string`||n===`boolean`)return!0;if(n===`number`)return Number.isFinite(e);if(n===`function`||n===`symbol`)return!1;if(Array.isArray(e))return t.has(e)?!1:(t.add(e),e.every(e=>o(e,t)));if(n===`object`){if(t.has(e))return!1;t.add(e);let n=Object.getPrototypeOf(e);return n!==null&&n!==Object.prototype?!1:Object.values(e).every(e=>o(e,t))}return!1}function s(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}function c(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let r=e[t];if(!s(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return n?o(e):!0}function l(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):Array.isArray(e)?e.every(e=>{let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}):!1}function u(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let n=e[t];if(!l(n))return!1}return!0}function d(e){return a(e.name)&&typeof e.path==`string`&&c(e.params)}function f(e){return typeof e!=`object`||!e?!1:d(e)}function p(e){return!(typeof e!=`object`||!e||!d(e))}function m(e){return typeof e==`string`}function h(e){return typeof e==`boolean`}function g(e,t){return e in t}function _(e){return typeof e==`number`?Number.isFinite(e):typeof e==`string`||typeof e==`boolean`}function v(e,t){if(typeof e!=`string`)throw i(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!n.test(e))throw i(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw i(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!r.test(e))throw i(t,`Invalid route name \"${e}\". Each segment must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens. Segments are separated by dots (e.g., \"users.profile\").`)}}function y(e){return e===null?`null`:Array.isArray(e)?`array[${e.length}]`:typeof e==`object`?`constructor`in e&&e.constructor.name!==`Object`?e.constructor.name:`object`:typeof e}function b(e,t){if(!f(e))throw TypeError(`[${t}] Invalid state structure: ${y(e)}. Expected State object with name, params, and path properties.`)}export{y as getTypeDescription,h as isBoolean,t as isNavigationOptions,g as isObjKey,c as isParams,u as isParamsStrict,_ as isPrimitiveValue,a as isRouteName,f as isState,p as isStateStrict,m as isString,v as validateRouteName,b as validateState};\n//# sourceMappingURL=index.mjs.map","import { isStateStrict as isState } from \"type-guards\";\n\nimport type { Browser } from \"./types.js\";\nimport type { State, Params } from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\n/**\n * Extracts route name and params from a popstate event.\n *\n * - If history.state is a valid router state → returns name/params from it\n * - If not (e.g. manually entered URL) → matches current URL against route tree\n * - Returns undefined if no route matches\n *\n * @param evt - PopStateEvent from browser\n * @param api - PluginApi instance\n * @param browser - Browser API instance\n * @returns Route identifier or undefined\n */\nexport function getRouteFromEvent(\n evt: PopStateEvent,\n api: PluginApi,\n browser: Browser,\n): { name: string; params: Params } | undefined {\n if (isState(evt.state)) {\n return { name: evt.state.name, params: evt.state.params };\n }\n\n const state = api.matchPath(browser.getLocation());\n\n return state ? { name: state.name, params: state.params } : undefined;\n}\n\n/**\n * Updates browser state (pushState or replaceState)\n *\n * @param state - Router state\n * @param url - URL to set\n * @param replace - Whether to replace instead of push\n * @param browser - Browser API instance\n */\nexport function updateBrowserState(\n state: State,\n url: string,\n replace: boolean,\n browser: Browser,\n): void {\n const historyState = {\n name: state.name,\n params: state.params,\n path: state.path,\n };\n\n if (replace) {\n browser.replaceState(historyState, url);\n } else {\n browser.pushState(historyState, url);\n }\n}\n","export interface OptionRule<T> {\n validate: (value: T) => string | null;\n}\n\nexport type OptionRules<T extends object> = {\n [K in keyof T]?: OptionRule<NonNullable<T[K]>>;\n};\n\nexport function createOptionsValidator<T extends object>(\n defaults: Required<T>,\n loggerContext: string,\n rules?: OptionRules<T>,\n): (opts: Partial<T> | undefined) => void {\n return (opts) => {\n if (!opts) {\n return;\n }\n\n for (const key of Object.keys(opts)) {\n if (!(key in defaults)) {\n continue;\n }\n\n const value = opts[key as keyof typeof opts];\n\n if (value === undefined) {\n continue;\n }\n\n const expected = typeof defaults[key as keyof typeof defaults];\n const actual = typeof value;\n\n if (actual !== expected) {\n throw new Error(\n `[${loggerContext}] Invalid type for '${key}': expected ${expected}, got ${actual}`,\n );\n }\n\n const rule = rules?.[key as keyof T];\n\n if (rule) {\n const msg = (rule.validate as (input: unknown) => string | null)(value);\n\n if (msg !== null) {\n throw new Error(`[${loggerContext}] Invalid '${key}': ${msg}`);\n }\n }\n }\n };\n}\n\n// eslint-disable-next-line no-control-regex -- control characters are exactly what this rule rejects\nconst CONTROL_CHARS = /[\\u0000-\\u001F\\u007F]/;\n\nexport const safeBaseRule: OptionRule<string> = {\n validate: (value) => {\n if (CONTROL_CHARS.test(value)) {\n return \"must not contain control characters\";\n }\n\n if (value.split(\"/\").includes(\"..\")) {\n return \"must not contain '..' segments\";\n }\n\n return null;\n },\n};\n\nexport const safeHashPrefixRule: OptionRule<string> = {\n validate: (value) => {\n if (CONTROL_CHARS.test(value)) {\n return \"must not contain control characters\";\n }\n\n if (value.includes(\"/\")) {\n return \"must not contain '/' (slash is added before the path automatically)\";\n }\n\n if (value.includes(\"#\")) {\n return \"must not contain '#' (it is added as the hash delimiter)\";\n }\n\n if (value.includes(\"?\")) {\n return \"must not contain '?' (it conflicts with the query delimiter)\";\n }\n\n return null;\n },\n};\n\nexport const nonNegativeIntegerRule: OptionRule<number> = {\n validate: (value) => {\n if (!Number.isFinite(value)) {\n return `expected finite number, got ${String(value)}`;\n }\n\n if (!Number.isInteger(value)) {\n return `expected integer, got ${String(value)}`;\n }\n\n if (value < 0) {\n return `expected non-negative integer, got ${value}`;\n }\n\n return null;\n },\n};\n","import { isBrowserEnvironment } from \"./detect.js\";\nimport {\n pushState,\n replaceState,\n addPopstateListener,\n getHash,\n} from \"./history-api.js\";\nimport {\n createWarnOnce,\n createHistoryFallbackBrowser,\n} from \"./ssr-fallback.js\";\n\nimport type { Browser } from \"./types.js\";\n\nexport function createSafeBrowser(\n getLocation: () => string,\n context: string,\n): Browser {\n if (isBrowserEnvironment()) {\n return {\n pushState,\n replaceState,\n addPopstateListener,\n getLocation,\n getHash,\n };\n }\n\n const warnOnce = createWarnOnce(context);\n\n return {\n ...createHistoryFallbackBrowser(context),\n getLocation: () => {\n warnOnce(\"getLocation\");\n\n return \"\";\n },\n };\n}\n","import { RouterError } from \"@real-router/core\";\n\nimport { getRouteFromEvent } from \"./popstate-utils.js\";\n\nimport type { Browser, SharedFactoryState } from \"./types.js\";\nimport type { Params, Plugin, Router } from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nexport interface PopstateHandlerDeps {\n router: Router;\n api: PluginApi;\n browser: Browser;\n allowNotFound: boolean;\n transitionOptions: {\n source: string;\n replace: true;\n forceDeactivate?: boolean;\n };\n loggerContext: string;\n buildUrl: (name: string, params?: Params) => string;\n}\n\nexport function createPopstateHandler(\n deps: PopstateHandlerDeps,\n): (evt: PopStateEvent) => void {\n let isTransitioning = false;\n let deferredEvent: PopStateEvent | null = null;\n\n function processDeferredEvent(): void {\n if (deferredEvent) {\n const evt = deferredEvent;\n\n deferredEvent = null;\n console.warn(\n `[${deps.loggerContext}] Processing deferred popstate event`,\n );\n void onPopState(evt);\n }\n }\n\n function recoverFromCriticalError(error: unknown): void {\n console.error(\n `[${deps.loggerContext}] Critical error in onPopState`,\n error,\n );\n\n try {\n const currentState = deps.router.getState();\n\n /* v8 ignore next -- @preserve: router always has state after start(); defensive guard for edge cases */\n if (currentState) {\n const url = deps.buildUrl(currentState.name, currentState.params);\n\n deps.browser.replaceState(currentState, url);\n }\n } catch (recoveryError) {\n console.error(\n `[${deps.loggerContext}] Failed to recover from critical error`,\n recoveryError,\n );\n }\n }\n\n async function onPopState(evt: PopStateEvent): Promise<void> {\n if (isTransitioning) {\n console.warn(\n `[${deps.loggerContext}] Transition in progress, deferring popstate event`,\n );\n deferredEvent = evt;\n\n return;\n }\n\n isTransitioning = true;\n\n try {\n const route = getRouteFromEvent(evt, deps.api, deps.browser);\n\n if (route) {\n await deps.router.navigate(\n route.name,\n route.params,\n deps.transitionOptions,\n );\n } else if (deps.allowNotFound) {\n deps.router.navigateToNotFound(deps.browser.getLocation());\n } else {\n await deps.router.navigateToDefault({\n ...deps.transitionOptions,\n reload: true,\n replace: true,\n });\n }\n } catch (error) {\n if (!(error instanceof RouterError)) {\n recoverFromCriticalError(error);\n }\n } finally {\n isTransitioning = false;\n processDeferredEvent();\n }\n }\n\n return (evt: PopStateEvent) => void onPopState(evt);\n}\n\nexport interface PopstateLifecycleDeps {\n browser: Browser;\n shared: SharedFactoryState;\n handler: (evt: PopStateEvent) => void;\n cleanup: () => void;\n}\n\nexport function createPopstateLifecycle(\n deps: PopstateLifecycleDeps,\n): Pick<Plugin, \"onStart\" | \"onStop\" | \"teardown\"> {\n return {\n onStart: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n }\n\n deps.shared.removePopStateListener = deps.browser.addPopstateListener(\n deps.handler,\n );\n },\n\n onStop: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n deps.shared.removePopStateListener = undefined;\n }\n },\n\n teardown: () => {\n if (deps.shared.removePopStateListener) {\n deps.shared.removePopStateListener();\n deps.shared.removePopStateListener = undefined;\n }\n\n deps.cleanup();\n },\n };\n}\n","import { updateBrowserState } from \"./popstate-utils.js\";\n\nimport type { Browser } from \"./types.js\";\nimport type {\n NavigationOptions,\n Params,\n Router,\n State,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nexport function createStartInterceptor(\n api: PluginApi,\n browser: Browser,\n): () => void {\n return api.addInterceptor(\"start\", (next, path) =>\n next(path ?? browser.getLocation()),\n );\n}\n\nexport function createReplaceHistoryState(\n api: PluginApi,\n router: Router,\n browser: Browser,\n buildUrl: (name: string, params?: Params) => string,\n preserveHash = true,\n): (name: string, params?: Params) => void {\n return (name: string, params: Params = {}) => {\n const state = api.buildState(name, params);\n\n if (!state) {\n throw new Error(\n `[real-router] Cannot replace state: route \"${name}\" is not found`,\n );\n }\n\n const builtState = api.makeState(\n state.name,\n state.params,\n router.buildPath(state.name, state.params),\n {\n params: state.meta,\n },\n );\n\n const hash = preserveHash ? browser.getHash() : \"\";\n const url = buildUrl(name, params) + hash;\n\n updateBrowserState(builtState, url, true, browser);\n };\n}\n\nexport function shouldReplaceHistory(\n navOptions: NavigationOptions,\n toState: State,\n fromState: State | undefined,\n): boolean {\n return (\n (navOptions.replace ?? !fromState) ||\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- fromState is NOT narrowed when replace is false (#447)\n (!!navOptions.reload && toState.path === fromState?.path)\n );\n}\n","export function safeParseUrl(url: string, loggerContext: string): URL | null {\n try {\n const parsedUrl = new URL(url, globalThis.location.origin);\n\n if (![\"http:\", \"https:\"].includes(parsedUrl.protocol)) {\n console.warn(`[${loggerContext}] Invalid URL protocol in ${url}`);\n\n return null;\n }\n\n return parsedUrl;\n } catch (error) {\n console.warn(`[${loggerContext}] Could not parse url ${url}`, error);\n\n return null;\n }\n}\n","import { safeParseUrl } from \"./url-parsing.js\";\n\nexport function extractPath(pathname: string, base: string): string {\n if (!pathname) {\n return \"/\";\n }\n\n if (base && (pathname === base || pathname.startsWith(`${base}/`))) {\n const stripped = pathname.slice(base.length);\n\n return stripped.startsWith(\"/\") ? stripped : `/${stripped}`;\n }\n\n return pathname.startsWith(\"/\") ? pathname : `/${pathname}`;\n}\n\nexport function buildUrl(path: string, base: string): string {\n if (!path) {\n return base;\n }\n\n if (!base) {\n return path.startsWith(\"/\") ? path : `/${path}`;\n }\n\n return path.startsWith(\"/\") ? `${base}${path}` : `${base}/${path}`;\n}\n\nexport function urlToPath(\n url: string,\n base: string,\n context: string,\n): string | null {\n const parsedUrl = safeParseUrl(url, context);\n\n return parsedUrl\n ? extractPath(parsedUrl.pathname, base) + parsedUrl.search\n : null;\n}\n\n/**\n * Parses an absolute URL and returns its path + search, stripped of `base`.\n * Alias of {@link urlToPath} with an explicit non-null contract when the caller\n * already knows the URL is valid (e.g., sourced from the Navigation API or a\n * plugin-owned history store). Safe against malformed input — returns `null`.\n */\nexport function extractPathFromAbsoluteUrl(\n url: string,\n base: string,\n context: string,\n): string | null {\n return urlToPath(url, base, context);\n}\n","import type { BrowserPluginOptions } from \"./types\";\n\nexport const defaultOptions: Required<BrowserPluginOptions> = {\n forceDeactivate: true,\n base: \"\",\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 POPSTATE_SOURCE = \"popstate\";\n\nexport const LOGGER_CONTEXT = \"browser-plugin\";\n","import {\n createPopstateHandler,\n createPopstateLifecycle,\n createStartInterceptor,\n createReplaceHistoryState,\n shouldReplaceHistory,\n updateBrowserState,\n buildUrl,\n urlToPath,\n} from \"./browser-env/index.js\";\nimport { LOGGER_CONTEXT, POPSTATE_SOURCE } from \"./constants\";\n\nimport type { Browser, SharedFactoryState } from \"./browser-env/index.js\";\nimport type { BrowserContext, BrowserPluginOptions } from \"./types\";\nimport type {\n NavigationOptions,\n Params,\n Router,\n State,\n Plugin,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\nconst FROZEN_POPSTATE: BrowserContext = Object.freeze({ source: \"popstate\" });\nconst FROZEN_NAVIGATE: BrowserContext = Object.freeze({ source: \"navigate\" });\n\n/** @internal — instantiated by `browserPluginFactory`; not part of the public API. */\nexport class BrowserPlugin {\n readonly #browser: Browser;\n readonly #base: string;\n readonly #removeStartInterceptor: () => void;\n readonly #removeExtensions: () => void;\n readonly #claim: {\n write: (state: State, value: BrowserContext) => void;\n release: () => void;\n };\n readonly #lifecycle: Pick<Plugin, \"onStart\" | \"onStop\" | \"teardown\">;\n\n constructor(\n router: Router,\n api: PluginApi,\n options: Required<BrowserPluginOptions>,\n browser: Browser,\n transitionOptions: {\n source: string;\n replace: true;\n forceDeactivate?: boolean;\n },\n shared: SharedFactoryState,\n ) {\n this.#browser = browser;\n this.#base = options.base;\n this.#claim = api.claimContextNamespace(\"browser\");\n\n this.#removeStartInterceptor = createStartInterceptor(api, browser);\n\n const pluginBuildUrl = (route: string, params?: Params) => {\n const path = router.buildPath(route, params);\n\n return buildUrl(path, options.base);\n };\n\n this.#removeExtensions = api.extendRouter({\n buildUrl: pluginBuildUrl,\n matchUrl: (url: string) => {\n const path = urlToPath(url, options.base, LOGGER_CONTEXT);\n\n return path ? api.matchPath(path) : undefined;\n },\n replaceHistoryState: createReplaceHistoryState(\n api,\n router,\n browser,\n pluginBuildUrl,\n ),\n });\n\n const handler = createPopstateHandler({\n router,\n api,\n browser,\n allowNotFound: api.getOptions().allowNotFound,\n transitionOptions,\n loggerContext: LOGGER_CONTEXT,\n buildUrl: pluginBuildUrl,\n });\n\n this.#lifecycle = createPopstateLifecycle({\n browser,\n shared,\n handler,\n cleanup: () => {\n this.#removeStartInterceptor();\n this.#removeExtensions();\n this.#claim.release();\n },\n });\n }\n\n getPlugin(): Plugin {\n return {\n ...this.#lifecycle,\n\n onTransitionSuccess: (\n toState: State,\n fromState: State | undefined,\n navOptions: NavigationOptions,\n ) => {\n const replaceHistory = shouldReplaceHistory(\n navOptions,\n toState,\n fromState,\n );\n\n const url = buildUrl(toState.path, this.#base);\n\n const shouldPreserveHash =\n !fromState || fromState.path === toState.path;\n\n const hash = shouldPreserveHash ? this.#browser.getHash() : \"\";\n const finalUrl = hash ? url + hash : url;\n\n updateBrowserState(toState, finalUrl, replaceHistory, this.#browser);\n\n const isPopstate =\n (navOptions as Record<string, unknown>).source === POPSTATE_SOURCE;\n\n this.#claim.write(\n toState,\n isPopstate ? FROZEN_POPSTATE : FROZEN_NAVIGATE,\n );\n },\n };\n }\n}\n","import { createOptionsValidator, safeBaseRule } from \"./browser-env/index.js\";\nimport { LOGGER_CONTEXT, defaultOptions } from \"./constants\";\n\nimport type { BrowserPluginOptions } from \"./types\";\n\nexport const validateOptions = createOptionsValidator<BrowserPluginOptions>(\n defaultOptions,\n LOGGER_CONTEXT,\n { base: safeBaseRule },\n);\n","import { getPluginApi } from \"@real-router/core/api\";\n\nimport {\n createSafeBrowser,\n normalizeBase,\n safelyEncodePath,\n extractPath,\n} from \"./browser-env/index.js\";\nimport { defaultOptions, POPSTATE_SOURCE } from \"./constants\";\nimport { BrowserPlugin } from \"./plugin\";\nimport { validateOptions } from \"./validation\";\n\nimport type { Browser, SharedFactoryState } from \"./browser-env/index.js\";\nimport type { BrowserPluginOptions } from \"./types\";\nimport type { PluginFactory, Router } from \"@real-router/core\";\n\nexport function browserPluginFactory(\n opts?: Partial<BrowserPluginOptions>,\n browser?: Browser,\n): PluginFactory {\n validateOptions(opts);\n\n const options: Required<BrowserPluginOptions> = {\n ...defaultOptions,\n ...opts,\n };\n\n options.base = normalizeBase(options.base);\n\n const resolvedBrowser =\n browser ??\n createSafeBrowser(\n () =>\n safelyEncodePath(\n extractPath(globalThis.location.pathname, options.base),\n ) + globalThis.location.search,\n \"browser-plugin\",\n );\n\n const transitionOptions = {\n forceDeactivate: options.forceDeactivate,\n source: POPSTATE_SOURCE,\n replace: true as const,\n };\n\n const shared: SharedFactoryState = { removePopStateListener: undefined };\n\n return function browserPlugin(routerBase) {\n const plugin = new BrowserPlugin(\n routerBase as Router,\n getPluginApi(routerBase),\n options,\n resolvedBrowser,\n transitionOptions,\n shared,\n );\n\n return plugin.getPlugin();\n };\n}\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@real-router/browser-plugin",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.13.1",
|
|
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",
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
},
|
|
46
46
|
"sideEffects": false,
|
|
47
47
|
"dependencies": {
|
|
48
|
-
"@real-router/core": "^0.
|
|
48
|
+
"@real-router/core": "^0.49.0",
|
|
49
49
|
"@real-router/types": "^0.34.0"
|
|
50
50
|
},
|
|
51
51
|
"devDependencies": {
|
|
@@ -57,10 +57,10 @@
|
|
|
57
57
|
"test": "vitest",
|
|
58
58
|
"test:stress": "vitest --config vitest.config.stress.mts --run",
|
|
59
59
|
"test:properties": "vitest --config vitest.config.properties.mts --run",
|
|
60
|
-
"build": "tsdown --config-loader unrun",
|
|
61
60
|
"type-check": "tsc --noEmit",
|
|
62
61
|
"lint": "eslint --cache --ext .ts src/ tests/ --fix --max-warnings 0",
|
|
63
62
|
"lint:package": "publint",
|
|
64
|
-
"lint:types": "attw --pack ."
|
|
63
|
+
"lint:types": "attw --pack .",
|
|
64
|
+
"bundle": "tsdown --config-loader unrun"
|
|
65
65
|
}
|
|
66
66
|
}
|
package/src/constants.ts
CHANGED
|
@@ -1,5 +1,3 @@
|
|
|
1
|
-
// packages/browser-plugin/modules/constants.ts
|
|
2
|
-
|
|
3
1
|
import type { BrowserPluginOptions } from "./types";
|
|
4
2
|
|
|
5
3
|
export const defaultOptions: Required<BrowserPluginOptions> = {
|
|
@@ -12,6 +10,6 @@ export const defaultOptions: Required<BrowserPluginOptions> = {
|
|
|
12
10
|
* Used to distinguish browser-initiated navigation (back/forward buttons)
|
|
13
11
|
* from programmatic navigation (router.navigate()).
|
|
14
12
|
*/
|
|
15
|
-
export const
|
|
13
|
+
export const POPSTATE_SOURCE = "popstate";
|
|
16
14
|
|
|
17
15
|
export const LOGGER_CONTEXT = "browser-plugin";
|
package/src/factory.ts
CHANGED
|
@@ -6,7 +6,7 @@ import {
|
|
|
6
6
|
safelyEncodePath,
|
|
7
7
|
extractPath,
|
|
8
8
|
} from "./browser-env/index.js";
|
|
9
|
-
import { defaultOptions,
|
|
9
|
+
import { defaultOptions, POPSTATE_SOURCE } from "./constants";
|
|
10
10
|
import { BrowserPlugin } from "./plugin";
|
|
11
11
|
import { validateOptions } from "./validation";
|
|
12
12
|
|
|
@@ -37,8 +37,11 @@ export function browserPluginFactory(
|
|
|
37
37
|
"browser-plugin",
|
|
38
38
|
);
|
|
39
39
|
|
|
40
|
-
const
|
|
41
|
-
|
|
40
|
+
const transitionOptions = {
|
|
41
|
+
forceDeactivate: options.forceDeactivate,
|
|
42
|
+
source: POPSTATE_SOURCE,
|
|
43
|
+
replace: true as const,
|
|
44
|
+
};
|
|
42
45
|
|
|
43
46
|
const shared: SharedFactoryState = { removePopStateListener: undefined };
|
|
44
47
|
|
package/src/index.ts
CHANGED
|
@@ -1,6 +1,4 @@
|
|
|
1
|
-
// packages/browser-plugin/modules/index.ts
|
|
2
1
|
/* eslint-disable @typescript-eslint/method-signature-style -- method syntax required for declaration merging overload (property syntax causes TS2717) */
|
|
3
|
-
// Public API exports for browser-plugin
|
|
4
2
|
|
|
5
3
|
import type { Params, State } from "@real-router/core";
|
|
6
4
|
|
|
@@ -47,11 +45,7 @@ declare module "@real-router/core" {
|
|
|
47
45
|
* Replaces current history state without triggering navigation.
|
|
48
46
|
* Added by browser plugin.
|
|
49
47
|
*/
|
|
50
|
-
replaceHistoryState: (
|
|
51
|
-
name: string,
|
|
52
|
-
params?: Params,
|
|
53
|
-
title?: string,
|
|
54
|
-
) => void;
|
|
48
|
+
replaceHistoryState: (name: string, params?: Params) => void;
|
|
55
49
|
|
|
56
50
|
start(path?: string): Promise<State>;
|
|
57
51
|
}
|
package/src/plugin.ts
CHANGED
|
@@ -8,7 +8,7 @@ import {
|
|
|
8
8
|
buildUrl,
|
|
9
9
|
urlToPath,
|
|
10
10
|
} from "./browser-env/index.js";
|
|
11
|
-
import { LOGGER_CONTEXT,
|
|
11
|
+
import { LOGGER_CONTEXT, POPSTATE_SOURCE } from "./constants";
|
|
12
12
|
|
|
13
13
|
import type { Browser, SharedFactoryState } from "./browser-env/index.js";
|
|
14
14
|
import type { BrowserContext, BrowserPluginOptions } from "./types";
|
|
@@ -21,9 +21,13 @@ import type {
|
|
|
21
21
|
} from "@real-router/core";
|
|
22
22
|
import type { PluginApi } from "@real-router/core/api";
|
|
23
23
|
|
|
24
|
+
const FROZEN_POPSTATE: BrowserContext = Object.freeze({ source: "popstate" });
|
|
25
|
+
const FROZEN_NAVIGATE: BrowserContext = Object.freeze({ source: "navigate" });
|
|
26
|
+
|
|
27
|
+
/** @internal — instantiated by `browserPluginFactory`; not part of the public API. */
|
|
24
28
|
export class BrowserPlugin {
|
|
25
|
-
readonly #router: Router;
|
|
26
29
|
readonly #browser: Browser;
|
|
30
|
+
readonly #base: string;
|
|
27
31
|
readonly #removeStartInterceptor: () => void;
|
|
28
32
|
readonly #removeExtensions: () => void;
|
|
29
33
|
readonly #claim: {
|
|
@@ -44,8 +48,8 @@ export class BrowserPlugin {
|
|
|
44
48
|
},
|
|
45
49
|
shared: SharedFactoryState,
|
|
46
50
|
) {
|
|
47
|
-
this.#router = router;
|
|
48
51
|
this.#browser = browser;
|
|
52
|
+
this.#base = options.base;
|
|
49
53
|
this.#claim = api.claimContextNamespace("browser");
|
|
50
54
|
|
|
51
55
|
this.#removeStartInterceptor = createStartInterceptor(api, browser);
|
|
@@ -77,9 +81,8 @@ export class BrowserPlugin {
|
|
|
77
81
|
browser,
|
|
78
82
|
allowNotFound: api.getOptions().allowNotFound,
|
|
79
83
|
transitionOptions,
|
|
80
|
-
loggerContext:
|
|
81
|
-
buildUrl:
|
|
82
|
-
router.buildUrl(name, params),
|
|
84
|
+
loggerContext: LOGGER_CONTEXT,
|
|
85
|
+
buildUrl: pluginBuildUrl,
|
|
83
86
|
});
|
|
84
87
|
|
|
85
88
|
this.#lifecycle = createPopstateLifecycle({
|
|
@@ -109,14 +112,13 @@ export class BrowserPlugin {
|
|
|
109
112
|
fromState,
|
|
110
113
|
);
|
|
111
114
|
|
|
112
|
-
const url =
|
|
115
|
+
const url = buildUrl(toState.path, this.#base);
|
|
113
116
|
|
|
114
117
|
const shouldPreserveHash =
|
|
115
118
|
!fromState || fromState.path === toState.path;
|
|
116
119
|
|
|
117
|
-
const
|
|
118
|
-
|
|
119
|
-
: url;
|
|
120
|
+
const hash = shouldPreserveHash ? this.#browser.getHash() : "";
|
|
121
|
+
const finalUrl = hash ? url + hash : url;
|
|
120
122
|
|
|
121
123
|
updateBrowserState(toState, finalUrl, replaceHistory, this.#browser);
|
|
122
124
|
|
|
@@ -125,7 +127,7 @@ export class BrowserPlugin {
|
|
|
125
127
|
|
|
126
128
|
this.#claim.write(
|
|
127
129
|
toState,
|
|
128
|
-
|
|
130
|
+
isPopstate ? FROZEN_POPSTATE : FROZEN_NAVIGATE,
|
|
129
131
|
);
|
|
130
132
|
},
|
|
131
133
|
};
|
package/src/types.ts
CHANGED
package/src/validation.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { createOptionsValidator } from "./browser-env/index.js";
|
|
1
|
+
import { createOptionsValidator, safeBaseRule } from "./browser-env/index.js";
|
|
2
2
|
import { LOGGER_CONTEXT, defaultOptions } from "./constants";
|
|
3
3
|
|
|
4
4
|
import type { BrowserPluginOptions } from "./types";
|
|
@@ -6,4 +6,5 @@ import type { BrowserPluginOptions } from "./types";
|
|
|
6
6
|
export const validateOptions = createOptionsValidator<BrowserPluginOptions>(
|
|
7
7
|
defaultOptions,
|
|
8
8
|
LOGGER_CONTEXT,
|
|
9
|
+
{ base: safeBaseRule },
|
|
9
10
|
);
|