@ktjs/router 0.6.6 → 0.13.0

package/README.md

@@ -2,10 +2,14 @@
 
 <img src="https://raw.githubusercontent.com/baendlorel/kt.js/dev/.assets/ktjs-0.0.1.svg" alt="KT.js Logo" width="150"/>
 
-> 📦 Part of [KT.js](https://raw.githubusercontent.com/baendlorel/kt.js/dev/README.md) - A simple and easy-to-use web framework that never re-renders.
+[![npm version](https://img.shields.io/npm/v/@ktjs/router.svg)](https://www.npmjs.com/package/@ktjs/router)
+
+> 📦 Part of [KT.js](https://github.com/baendlorel/kt.js) - A simple and easy-to-use web framework that never re-renders.
 
 Client-side router with navigation guards for KT.js.
 
+**Current Version:** 0.13.0
+
 ## Overview
 
 `@ktjs/router` is a lightweight, hash-based client-side router with powerful navigation guards and async/sync auto-adaptation. It provides all the essential routing features you need without the bloat.

package/dist/index.iife.js

@@ -1 +1,406 @@
-var __ktjs_router__=function(t){"use strict";const r=()=>!0,e=t=>{throw new Error(`@ktjs/router: ${t}`)},n=(...t)=>"/"+t.map(t=>t.split("/")).flat().filter(Boolean).join("/"),o=t=>{const r={};if(!t||"?"===t)return r;const e=t.replace(/^\?/,"").split("&");for(const t of e){const[e,n]=t.split("=");e&&(r[decodeURIComponent(e)]=n?decodeURIComponent(n):"")}return r},u=(t,r)=>{const e={},n=t.split("/"),o=r.split("/");if(n.length!==o.length)return null;for(let t=0;t<n.length;t++){const r=n[t],u=o[t];if(r.startsWith(":")){e[r.slice(1)]=u}else if(r!==u)return null}return e};return t.createRouter=t=>{const c=t.beforeEach??r,a=t.afterEach??r,s=t.onNotFound??r,i=t.onError??r,l=t.asyncGuards??!0,f=[],d=(t,e)=>t.map(t=>{const o=n(e,t.path),u={path:o,name:t.name??"",meta:t.meta??{},beforeEnter:t.beforeEnter??r,after:t.after??r,children:t.children?d(t.children,o):[]};return f.push(u),u});d(t.routes,"/");const{findByName:p,match:h}=(t=>{const r={};for(let n=0;n<t.length;n++){const o=t[n];void 0!==o.name&&(o.name in r&&e(`Duplicate route name detected: '${o.name}'`),r[o.name]=o)}const o=r=>{const e=[r],n=r.path;for(let o=0;o<t.length;o++){const u=t[o];u!==r&&n.startsWith(u.path)&&n!==u.path&&e.push(u)}return e.reverse()};return{findByName:t=>r[t]??null,match:r=>{const e=n(r);for(const r of t)if(r.path===e)return{route:r,params:{},result:o(r)};for(const r of t)if(r.path.includes(":")){const t=u(r.path,e);if(t)return{route:r,params:t,result:o(r)}}return null}}})(f);let w=null;const m=[],y=t=>{let r,o;t.name?(o=p(t.name),o||e(`Route not found: ${t.name}`),r=o.path):t.path?(r=n(t.path),o=h(r)?.route):e("Either path or name must be provided"),t.params&&(r=((t,r)=>{let e=t;for(const t in r)e=e.replace(`:${t}`,r[t]);return e})(r,t.params));const u=h(r);if(!u)return s(r),null;const c=r+(t.query?(t=>{const r=Object.keys(t);return 0===r.length?"":`?${r.map(r=>`${encodeURIComponent(r)}=${encodeURIComponent(t[r])}`).join("&")}`})(t.query):""),a={path:r,name:u.route.name,params:{...u.params,...t.params||{}},query:t.query||{},meta:u.route.meta||{},matched:u.result};return{guardLevel:t.guardLevel??15,replace:t.replace??!1,to:a,fullPath:c}},v=l?t=>{try{const r=y(t);if(!r)return!1;const{guardLevel:e,replace:n,to:o,fullPath:u}=r;if(!((t,r,e)=>{try{if(0===e)return!0;if(1&e&&!1===c(t,r))return!1;if(2&e){if(!1===t.matched[t.matched.length-1].beforeEnter(t))return!1}return!0}catch(t){return i(t),!1}})(o,w,e))return!1;const a=u;return n?window.history.replaceState({path:o.path},"",a):window.history.pushState({path:o.path},"",a),w=o,m.push(o),g(o,m[m.length-2]||null),!0}catch(t){return i(t),!1}}:async t=>{try{const r=y(t);if(!r)return!1;const{guardLevel:e,replace:n,to:o,fullPath:u}=r,a=await(async(t,r,e)=>{try{if(0===e)return!0;if(1&e&&!1===await c(t,r))return!1;if(2&e){return!1!==t.matched[t.matched.length-1].beforeEnter(t)}return!0}catch(t){return i(t),!1}})(o,w,e);if(!a)return!1;const s=u;return n?window.history.replaceState({path:o.path},"",s):window.history.pushState({path:o.path},"",s),$(o,m[m.length-2]||null),!0}catch(t){return i(t),!1}},g=(t,r)=>{t.matched[t.matched.length-1].after(t),a(t,r)},$=async(t,r)=>{const e=t.matched[t.matched.length-1];await e.after(t),await a(t,r)},L=t=>{if("string"==typeof t){const[r,e]=t.split("?");return{path:r,query:e?o(e):void 0}}return t};return window.addEventListener("popstate",t=>{t.state?.path&&v({path:t.state.path,guardLevel:1,replace:!0})}),{get current(){return w},get history(){return m.concat()},push(t){const r=L(t);return v(r)},silentPush(t){const r=L(t);return v({...r,guardLevel:2})},replace(t){const r=L(t);return v({...r,replace:!0})},back(){window.history.back()},forward(){window.history.forward()}}},t}({});
+var __ktjs_router__ = (function (exports) {
+    'use strict';
+
+    /**
+     * Default guard that always returns true
+     */
+    const defaultHook = () => true;
+    const throws = (m) => {
+        throw new Error(`@ktjs/router: ${m}`);
+    };
+    const normalizePath = (...paths) => {
+        const p = paths
+            .map((p) => p.split('/'))
+            .flat()
+            .filter(Boolean);
+        return '/' + p.join('/');
+    };
+    /**
+     * Parse query string into object
+     */
+    const parseQuery = (queryString) => {
+        const query = {};
+        if (!queryString || queryString === '?') {
+            return query;
+        }
+        const params = queryString.replace(/^\?/, '').split('&');
+        for (const param of params) {
+            const [key, value] = param.split('=');
+            if (key) {
+                query[decodeURIComponent(key)] = value ? decodeURIComponent(value) : '';
+            }
+        }
+        return query;
+    };
+    /**
+     * Build query string from object
+     */
+    const buildQuery = (query) => {
+        const keys = Object.keys(query);
+        if (keys.length === 0)
+            return '';
+        const params = keys.map((key) => `${encodeURIComponent(key)}=${encodeURIComponent(query[key])}`).join('&');
+        return `?${params}`;
+    };
+    /**
+     * Substitute params into path pattern
+     * @example '/user/:id' + {id: '123'} => '/user/123'
+     */
+    const emplaceParams = (path, params) => {
+        let result = path;
+        for (const key in params) {
+            result = result.replace(`:${key}`, params[key]);
+        }
+        return result;
+    };
+    /**
+     * Extract dynamic params from path using pattern
+     * @example pattern: '/user/:id', path: '/user/123' => {id: '123'}
+     */
+    const extractParams = (pattern, path) => {
+        const params = {};
+        const patternParts = pattern.split('/');
+        const pathParts = path.split('/');
+        if (patternParts.length !== pathParts.length) {
+            return null;
+        }
+        for (let i = 0; i < patternParts.length; i++) {
+            const patternPart = patternParts[i];
+            const pathPart = pathParts[i];
+            if (patternPart.startsWith(':')) {
+                const paramName = patternPart.slice(1);
+                params[paramName] = pathPart;
+            }
+            else if (patternPart !== pathPart) {
+                return null;
+            }
+        }
+        return params;
+    };
+
+    /**
+     * Route matcher for finding matching routes and extracting params
+     */
+    const createMatcher = (routes) => {
+        const nameMap = {};
+        for (let i = 0; i < routes.length; i++) {
+            const route = routes[i];
+            if (route.name !== undefined) {
+                if (route.name in nameMap) {
+                    throws(`Duplicate route name detected: '${route.name}'`);
+                }
+                nameMap[route.name] = route;
+            }
+        }
+        /**
+         * Find route by name
+         */
+        const findByName = (name) => {
+            return nameMap[name] ?? null;
+        };
+        /**
+         * Match path against all routes
+         */
+        const match = (path) => {
+            const normalizedPath = normalizePath(path);
+            // Try exact match first
+            for (const route of routes) {
+                if (route.path === normalizedPath) {
+                    return {
+                        route,
+                        params: {},
+                        result: getMatchedChain(route),
+                    };
+                }
+            }
+            // Try dynamic routes
+            for (const route of routes) {
+                if (route.path.includes(':')) {
+                    const params = extractParams(route.path, normalizedPath);
+                    if (params) {
+                        return {
+                            route,
+                            params,
+                            result: getMatchedChain(route),
+                        };
+                    }
+                }
+            }
+            return null;
+        };
+        /**
+         * Get chain of matched routes (for nested routes)
+         * - parent roots ahead
+         */
+        const getMatchedChain = (route) => {
+            const matched = [route];
+            const path = route.path;
+            // Find parent routes by path prefix matching
+            for (let i = 0; i < routes.length; i++) {
+                const r = routes[i];
+                if (r !== route && path.startsWith(r.path) && path !== r.path) {
+                    matched.push(r);
+                }
+            }
+            return matched.reverse();
+        };
+        return {
+            findByName,
+            match,
+        };
+    };
+
+    /**
+     * Create a new router instance
+     */
+    const createRouter = (config) => {
+        // # default configs
+        const beforeEach = config.beforeEach ?? defaultHook;
+        const afterEach = config.afterEach ?? defaultHook;
+        const onNotFound = config.onNotFound ?? defaultHook;
+        const onError = config.onError ?? defaultHook;
+        const asyncGuards = config.asyncGuards ?? true;
+        // # private values
+        const routes = [];
+        /**
+         * Normalize routes by adding default guards
+         */
+        const normalize = (rawRoutes, parentPath) => rawRoutes.map((route) => {
+            const path = normalizePath(parentPath, route.path);
+            const normalized = {
+                path,
+                name: route.name ?? '',
+                meta: route.meta ?? {},
+                beforeEnter: route.beforeEnter ?? defaultHook,
+                after: route.after ?? defaultHook,
+                children: route.children ? normalize(route.children, path) : [],
+            };
+            // directly push the normalized route to the list
+            // avoid flatten them again
+            routes.push(normalized);
+            return normalized;
+        });
+        // Normalize routes with default guards
+        normalize(config.routes, '/');
+        const { findByName, match } = createMatcher(routes);
+        let current = null;
+        const history = [];
+        // # methods
+        const executeGuardsSync = (to, from, guardLevel) => {
+            try {
+                if (guardLevel === 0 /* GuardLevel.None */) {
+                    return true;
+                }
+                if (guardLevel & 1 /* GuardLevel.Global */) {
+                    const result = beforeEach(to, from);
+                    if (result === false) {
+                        return false;
+                    }
+                }
+                if (guardLevel & 2 /* GuardLevel.Route */) {
+                    const targetRoute = to.matched[to.matched.length - 1];
+                    const result = targetRoute.beforeEnter(to);
+                    if (result === false) {
+                        return false;
+                    }
+                }
+                return true;
+            }
+            catch (error) {
+                onError(error);
+                return false;
+            }
+        };
+        const executeGuards = async (to, from, guardLevel) => {
+            try {
+                if (guardLevel === 0 /* GuardLevel.None */) {
+                    return true;
+                }
+                if (guardLevel & 1 /* GuardLevel.Global */) {
+                    const result = await beforeEach(to, from);
+                    if (result === false) {
+                        return false;
+                    }
+                }
+                if (guardLevel & 2 /* GuardLevel.Route */) {
+                    const targetRoute = to.matched[to.matched.length - 1];
+                    const result = targetRoute.beforeEnter(to);
+                    return result !== false;
+                }
+                return true;
+            }
+            catch (error) {
+                onError(error);
+                return false;
+            }
+        };
+        const navigatePrepare = (options) => {
+            // Resolve target route
+            let targetPath;
+            let targetRoute;
+            if (options.name) {
+                targetRoute = findByName(options.name);
+                if (!targetRoute) {
+                    throws(`Route not found: ${options.name}`);
+                }
+                targetPath = targetRoute.path;
+            }
+            else if (options.path) {
+                targetPath = normalizePath(options.path);
+                targetRoute = match(targetPath)?.route;
+            }
+            else {
+                throws(`Either path or name must be provided`);
+            }
+            // Substitute params
+            if (options.params) {
+                targetPath = emplaceParams(targetPath, options.params);
+            }
+            // Match final path
+            const matched = match(targetPath);
+            if (!matched) {
+                onNotFound(targetPath);
+                return null;
+            }
+            // Build route context
+            const queryString = options.query ? buildQuery(options.query) : '';
+            const fullPath = targetPath + queryString;
+            const to = {
+                path: targetPath,
+                name: matched.route.name,
+                params: { ...matched.params, ...(options.params ?? {}) },
+                query: options.query ?? {},
+                meta: matched.route.meta ?? {},
+                matched: matched.result,
+            };
+            return {
+                guardLevel: options.guardLevel ?? 15 /* GuardLevel.Default */,
+                replace: options.replace ?? false,
+                to,
+                fullPath,
+            };
+        };
+        const navigateSync = (options) => {
+            try {
+                const prep = navigatePrepare(options);
+                if (!prep) {
+                    return false;
+                }
+                const { guardLevel, replace, to, fullPath } = prep;
+                // Execute guards
+                if (!executeGuardsSync(to, current, guardLevel)) {
+                    return false;
+                }
+                // Update browser history
+                const url = fullPath;
+                if (replace) {
+                    window.history.replaceState({ path: to.path }, '', url);
+                }
+                else {
+                    window.history.pushState({ path: to.path }, '', url);
+                }
+                // Update current route
+                current = to;
+                history.push(to);
+                // Execute after hooks
+                executeAfterHooksSync(to, history[history.length - 2] ?? null);
+                return true;
+            }
+            catch (error) {
+                onError(error);
+                return false;
+            }
+        };
+        const navigateAsync = async (options) => {
+            try {
+                const prep = navigatePrepare(options);
+                if (!prep) {
+                    return false;
+                }
+                const { guardLevel, replace, to, fullPath } = prep;
+                const passed = await executeGuards(to, current, guardLevel);
+                if (!passed) {
+                    return false;
+                }
+                // ---- Guards passed ----
+                const url = fullPath;
+                if (replace) {
+                    window.history.replaceState({ path: to.path }, '', url);
+                }
+                else {
+                    window.history.pushState({ path: to.path }, '', url);
+                }
+                executeAfterHooks(to, history[history.length - 2] ?? null);
+                return true;
+            }
+            catch (error) {
+                onError(error);
+                return false;
+            }
+        };
+        const navigate = asyncGuards ? navigateSync : navigateAsync;
+        const executeAfterHooksSync = (to, from) => {
+            const targetRoute = to.matched[to.matched.length - 1];
+            targetRoute.after(to);
+            afterEach(to, from);
+        };
+        const executeAfterHooks = async (to, from) => {
+            const targetRoute = to.matched[to.matched.length - 1];
+            await targetRoute.after(to);
+            await afterEach(to, from);
+        };
+        /**
+         * Normalize navigation argument
+         */
+        const normalizeLocation = (loc) => {
+            if (typeof loc === 'string') {
+                // Parse path and query
+                const [path, queryString] = loc.split('?');
+                return {
+                    path,
+                    query: queryString ? parseQuery(queryString) : undefined,
+                };
+            }
+            return loc;
+        };
+        // # register events
+        // Listen to browser back/forward
+        window.addEventListener('popstate', (event) => {
+            if (event.state?.path) {
+                navigate({ path: event.state.path, guardLevel: 1 /* GuardLevel.Global */, replace: true });
+            }
+        });
+        // Router instance
+        return {
+            get current() {
+                return current;
+            },
+            get history() {
+                return history.concat();
+            },
+            push(location) {
+                const options = normalizeLocation(location);
+                return navigate(options);
+            },
+            silentPush(location) {
+                const options = normalizeLocation(location);
+                return navigate({ ...options, guardLevel: 2 /* GuardLevel.Route */ });
+            },
+            replace(location) {
+                const options = normalizeLocation(location);
+                return navigate({ ...options, replace: true });
+            },
+            back() {
+                window.history.back();
+            },
+            forward() {
+                window.history.forward();
+            },
+        };
+    };
+
+    exports.createRouter = createRouter;
+
+    return exports;
+
+})({});

package/dist/index.legacy.js

@@ -1 +1,520 @@
-var __ktjs_router__=function(r){"use strict";var n=function(){return n=Object.assign||function(r){for(var n,t=1,e=arguments.length;t<e;t++)for(var u in n=arguments[t])Object.prototype.hasOwnProperty.call(n,u)&&(r[u]=n[u]);return r},n.apply(this,arguments)};function t(r,n,t,e){return new(t||(t=Promise))(function(u,o){function i(r){try{c(e.next(r))}catch(r){o(r)}}function a(r){try{c(e.throw(r))}catch(r){o(r)}}function c(r){var n;r.done?u(r.value):(n=r.value,n instanceof t?n:new t(function(r){r(n)})).then(i,a)}c((e=e.apply(r,n||[])).next())})}function e(r,n){var t,e,u,o={label:0,sent:function(){if(1&u[0])throw u[1];return u[1]},trys:[],ops:[]},i=Object.create(("function"==typeof Iterator?Iterator:Object).prototype);return i.next=a(0),i.throw=a(1),i.return=a(2),"function"==typeof Symbol&&(i[Symbol.iterator]=function(){return this}),i;function a(a){return function(c){return function(a){if(t)throw new TypeError("Generator is already executing.");for(;i&&(i=0,a[0]&&(o=0)),o;)try{if(t=1,e&&(u=2&a[0]?e.return:a[0]?e.throw||((u=e.return)&&u.call(e),0):e.next)&&!(u=u.call(e,a[1])).done)return u;switch(e=0,u&&(a=[2&a[0],u.value]),a[0]){case 0:case 1:u=a;break;case 4:return o.label++,{value:a[1],done:!1};case 5:o.label++,e=a[1],a=[0];continue;case 7:a=o.ops.pop(),o.trys.pop();continue;default:if(!(u=o.trys,(u=u.length>0&&u[u.length-1])||6!==a[0]&&2!==a[0])){o=0;continue}if(3===a[0]&&(!u||a[1]>u[0]&&a[1]<u[3])){o.label=a[1];break}if(6===a[0]&&o.label<u[1]){o.label=u[1],u=a;break}if(u&&o.label<u[2]){o.label=u[2],o.ops.push(a);break}u[2]&&o.ops.pop(),o.trys.pop();continue}a=n.call(r,o)}catch(r){a=[6,r],e=0}finally{t=u=0}if(5&a[0])throw a[1];return{value:a[0]?a[1]:void 0,done:!0}}([a,c])}}}"function"==typeof SuppressedError&&SuppressedError;var u=function(){return!0},o=function(r){throw new Error("@ktjs/router: ".concat(r))},i=function(){for(var r=[],n=0;n<arguments.length;n++)r[n]=arguments[n];return"/"+r.map(function(r){return r.split("/")}).flat().filter(Boolean).join("/")},a=function(r){var n={};if(!r||"?"===r)return n;for(var t=0,e=r.replace(/^\?/,"").split("&");t<e.length;t++){var u=e[t].split("="),o=u[0],i=u[1];o&&(n[decodeURIComponent(o)]=i?decodeURIComponent(i):"")}return n},c=function(r,n){var t={},e=r.split("/"),u=n.split("/");if(e.length!==u.length)return null;for(var o=0;o<e.length;o++){var i=e[o],a=u[o];if(i.startsWith(":"))t[i.slice(1)]=a;else if(i!==a)return null}return t};return r.createRouter=function(r){var f,v,l,d,s,h=null!==(f=r.beforeEach)&&void 0!==f?f:u,p=null!==(v=r.afterEach)&&void 0!==v?v:u,w=null!==(l=r.onNotFound)&&void 0!==l?l:u,m=null!==(d=r.onError)&&void 0!==d?d:u,y=null===(s=r.asyncGuards)||void 0===s||s,b=[],g=function(r,n){return r.map(function(r){var t,e,o,a,c=i(n,r.path),f={path:c,name:null!==(t=r.name)&&void 0!==t?t:"",meta:null!==(e=r.meta)&&void 0!==e?e:{},beforeEnter:null!==(o=r.beforeEnter)&&void 0!==o?o:u,after:null!==(a=r.after)&&void 0!==a?a:u,children:r.children?g(r.children,c):[]};return b.push(f),f})};g(r.routes,"/");var j=function(r){for(var n={},t=0;t<r.length;t++){var e=r[t];void 0!==e.name&&(e.name in n&&o("Duplicate route name detected: '".concat(e.name,"'")),n[e.name]=e)}var u=function(n){for(var t=[n],e=n.path,u=0;u<r.length;u++){var o=r[u];o!==n&&e.startsWith(o.path)&&e!==o.path&&t.push(o)}return t.reverse()};return{findByName:function(r){var t;return null!==(t=n[r])&&void 0!==t?t:null},match:function(n){for(var t=i(n),e=0,o=r;e<o.length;e++)if((v=o[e]).path===t)return{route:v,params:{},result:u(v)};for(var a=0,f=r;a<f.length;a++){var v;if((v=f[a]).path.includes(":")){var l=c(v.path,t);if(l)return{route:v,params:l,result:u(v)}}}return null}}}(b),k=j.findByName,E=j.match,I=null,O=[],R=function(r,n,u){return t(void 0,void 0,void 0,function(){var t,o;return e(this,function(e){switch(e.label){case 0:return e.trys.push([0,3,,4]),0===u?[2,!0]:1&u?[4,h(r,n)]:[3,2];case 1:if(!1===e.sent())return[2,!1];e.label=2;case 2:return 2&u?(t=r.matched[r.matched.length-1],[2,!1!==t.beforeEnter(r)]):[2,!0];case 3:return o=e.sent(),m(o),[2,!1];case 4:return[2]}})})},_=function(r){var t,e,u,a,c;r.name?((c=k(r.name))||o("Route not found: ".concat(r.name)),a=c.path):r.path?(a=i(r.path),c=null===(t=E(a))||void 0===t?void 0:t.route):o("Either path or name must be provided"),r.params&&(a=function(r,n){var t=r;for(var e in n)t=t.replace(":".concat(e),n[e]);return t}(a,r.params));var f=E(a);if(!f)return w(a),null;var v=a+(r.query?function(r){var n=Object.keys(r);if(0===n.length)return"";var t=n.map(function(n){return"".concat(encodeURIComponent(n),"=").concat(encodeURIComponent(r[n]))}).join("&");return"?".concat(t)}(r.query):""),l={path:a,name:f.route.name,params:n(n({},f.params),r.params||{}),query:r.query||{},meta:f.route.meta||{},matched:f.result};return{guardLevel:null!==(e=r.guardLevel)&&void 0!==e?e:15,replace:null!==(u=r.replace)&&void 0!==u&&u,to:l,fullPath:v}},C=y?function(r){try{var n=_(r);if(!n)return!1;var t=n.guardLevel,e=n.replace,u=n.to,o=n.fullPath;if(!function(r,n,t){try{return 0===t||!(1&t&&!1===h(r,n))&&!(2&t&&!1===r.matched[r.matched.length-1].beforeEnter(r))}catch(r){return m(r),!1}}(u,I,t))return!1;var i=o;return e?window.history.replaceState({path:u.path},"",i):window.history.pushState({path:u.path},"",i),I=u,O.push(u),S(u,O[O.length-2]||null),!0}catch(r){return m(r),!1}}:function(r){return t(void 0,void 0,void 0,function(){var n,t,u,o,i,a,c;return e(this,function(e){switch(e.label){case 0:return e.trys.push([0,2,,3]),(n=_(r))?(t=n.guardLevel,u=n.replace,o=n.to,i=n.fullPath,[4,R(o,I,t)]):[2,!1];case 1:return e.sent()?(a=i,u?window.history.replaceState({path:o.path},"",a):window.history.pushState({path:o.path},"",a),U(o,O[O.length-2]||null),[2,!0]):[2,!1];case 2:return c=e.sent(),m(c),[2,!1];case 3:return[2]}})})},S=function(r,n){r.matched[r.matched.length-1].after(r),p(r,n)},U=function(r,n){return t(void 0,void 0,void 0,function(){return e(this,function(t){switch(t.label){case 0:return[4,r.matched[r.matched.length-1].after(r)];case 1:return t.sent(),[4,p(r,n)];case 2:return t.sent(),[2]}})})},L=function(r){if("string"==typeof r){var n=r.split("?"),t=n[0],e=n[1];return{path:t,query:e?a(e):void 0}}return r};return window.addEventListener("popstate",function(r){var n;(null===(n=r.state)||void 0===n?void 0:n.path)&&C({path:r.state.path,guardLevel:1,replace:!0})}),{get current(){return I},get history(){return O.concat()},push:function(r){var n=L(r);return C(n)},silentPush:function(r){var t=L(r);return C(n(n({},t),{guardLevel:2}))},replace:function(r){var t=L(r);return C(n(n({},t),{replace:!0}))},back:function(){window.history.back()},forward:function(){window.history.forward()}}},r}({});
+var __ktjs_router__ = (function (exports) {
+    'use strict';
+
+    /******************************************************************************
+    Copyright (c) Microsoft Corporation.
+
+    Permission to use, copy, modify, and/or distribute this software for any
+    purpose with or without fee is hereby granted.
+
+    THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+    REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+    AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+    INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+    LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+    OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+    PERFORMANCE OF THIS SOFTWARE.
+    ***************************************************************************** */
+    /* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+
+    var __assign = function() {
+        __assign = Object.assign || function __assign(t) {
+            for (var s, i = 1, n = arguments.length; i < n; i++) {
+                s = arguments[i];
+                for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
+            }
+            return t;
+        };
+        return __assign.apply(this, arguments);
+    };
+
+    function __awaiter(thisArg, _arguments, P, generator) {
+        function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+        return new (P || (P = Promise))(function (resolve, reject) {
+            function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+            function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+            function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+            step((generator = generator.apply(thisArg, _arguments || [])).next());
+        });
+    }
+
+    function __generator(thisArg, body) {
+        var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+        return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+        function verb(n) { return function (v) { return step([n, v]); }; }
+        function step(op) {
+            if (f) throw new TypeError("Generator is already executing.");
+            while (g && (g = 0, op[0] && (_ = 0)), _) try {
+                if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+                if (y = 0, t) op = [op[0] & 2, t.value];
+                switch (op[0]) {
+                    case 0: case 1: t = op; break;
+                    case 4: _.label++; return { value: op[1], done: false };
+                    case 5: _.label++; y = op[1]; op = [0]; continue;
+                    case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                    default:
+                        if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                        if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                        if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                        if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                        if (t[2]) _.ops.pop();
+                        _.trys.pop(); continue;
+                }
+                op = body.call(thisArg, _);
+            } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+            if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+        }
+    }
+
+    typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+        var e = new Error(message);
+        return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+    };
+
+    /**
+     * Default guard that always returns true
+     */
+    var defaultHook = function () { return true; };
+    var throws = function (m) {
+        throw new Error("@ktjs/router: ".concat(m));
+    };
+    var normalizePath = function () {
+        var paths = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            paths[_i] = arguments[_i];
+        }
+        var p = paths
+            .map(function (p) { return p.split('/'); })
+            .flat()
+            .filter(Boolean);
+        return '/' + p.join('/');
+    };
+    /**
+     * Parse query string into object
+     */
+    var parseQuery = function (queryString) {
+        var query = {};
+        if (!queryString || queryString === '?') {
+            return query;
+        }
+        var params = queryString.replace(/^\?/, '').split('&');
+        for (var _i = 0, params_1 = params; _i < params_1.length; _i++) {
+            var param = params_1[_i];
+            var _a = param.split('='), key = _a[0], value = _a[1];
+            if (key) {
+                query[decodeURIComponent(key)] = value ? decodeURIComponent(value) : '';
+            }
+        }
+        return query;
+    };
+    /**
+     * Build query string from object
+     */
+    var buildQuery = function (query) {
+        var keys = Object.keys(query);
+        if (keys.length === 0)
+            return '';
+        var params = keys.map(function (key) { return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(query[key])); }).join('&');
+        return "?".concat(params);
+    };
+    /**
+     * Substitute params into path pattern
+     * @example '/user/:id' + {id: '123'} => '/user/123'
+     */
+    var emplaceParams = function (path, params) {
+        var result = path;
+        for (var key in params) {
+            result = result.replace(":".concat(key), params[key]);
+        }
+        return result;
+    };
+    /**
+     * Extract dynamic params from path using pattern
+     * @example pattern: '/user/:id', path: '/user/123' => {id: '123'}
+     */
+    var extractParams = function (pattern, path) {
+        var params = {};
+        var patternParts = pattern.split('/');
+        var pathParts = path.split('/');
+        if (patternParts.length !== pathParts.length) {
+            return null;
+        }
+        for (var i = 0; i < patternParts.length; i++) {
+            var patternPart = patternParts[i];
+            var pathPart = pathParts[i];
+            if (patternPart.startsWith(':')) {
+                var paramName = patternPart.slice(1);
+                params[paramName] = pathPart;
+            }
+            else if (patternPart !== pathPart) {
+                return null;
+            }
+        }
+        return params;
+    };
+
+    /**
+     * Route matcher for finding matching routes and extracting params
+     */
+    var createMatcher = function (routes) {
+        var nameMap = {};
+        for (var i = 0; i < routes.length; i++) {
+            var route = routes[i];
+            if (route.name !== undefined) {
+                if (route.name in nameMap) {
+                    throws("Duplicate route name detected: '".concat(route.name, "'"));
+                }
+                nameMap[route.name] = route;
+            }
+        }
+        /**
+         * Find route by name
+         */
+        var findByName = function (name) {
+            var _a;
+            return (_a = nameMap[name]) !== null && _a !== void 0 ? _a : null;
+        };
+        /**
+         * Match path against all routes
+         */
+        var match = function (path) {
+            var normalizedPath = normalizePath(path);
+            // Try exact match first
+            for (var _i = 0, routes_1 = routes; _i < routes_1.length; _i++) {
+                var route = routes_1[_i];
+                if (route.path === normalizedPath) {
+                    return {
+                        route: route,
+                        params: {},
+                        result: getMatchedChain(route),
+                    };
+                }
+            }
+            // Try dynamic routes
+            for (var _a = 0, routes_2 = routes; _a < routes_2.length; _a++) {
+                var route = routes_2[_a];
+                if (route.path.includes(':')) {
+                    var params = extractParams(route.path, normalizedPath);
+                    if (params) {
+                        return {
+                            route: route,
+                            params: params,
+                            result: getMatchedChain(route),
+                        };
+                    }
+                }
+            }
+            return null;
+        };
+        /**
+         * Get chain of matched routes (for nested routes)
+         * - parent roots ahead
+         */
+        var getMatchedChain = function (route) {
+            var matched = [route];
+            var path = route.path;
+            // Find parent routes by path prefix matching
+            for (var i = 0; i < routes.length; i++) {
+                var r = routes[i];
+                if (r !== route && path.startsWith(r.path) && path !== r.path) {
+                    matched.push(r);
+                }
+            }
+            return matched.reverse();
+        };
+        return {
+            findByName: findByName,
+            match: match,
+        };
+    };
+
+    /**
+     * Create a new router instance
+     */
+    var createRouter = function (config) {
+        var _a, _b, _c, _d, _e;
+        // # default configs
+        var beforeEach = (_a = config.beforeEach) !== null && _a !== void 0 ? _a : defaultHook;
+        var afterEach = (_b = config.afterEach) !== null && _b !== void 0 ? _b : defaultHook;
+        var onNotFound = (_c = config.onNotFound) !== null && _c !== void 0 ? _c : defaultHook;
+        var onError = (_d = config.onError) !== null && _d !== void 0 ? _d : defaultHook;
+        var asyncGuards = (_e = config.asyncGuards) !== null && _e !== void 0 ? _e : true;
+        // # private values
+        var routes = [];
+        /**
+         * Normalize routes by adding default guards
+         */
+        var normalize = function (rawRoutes, parentPath) {
+            return rawRoutes.map(function (route) {
+                var _a, _b, _c, _d;
+                var path = normalizePath(parentPath, route.path);
+                var normalized = {
+                    path: path,
+                    name: (_a = route.name) !== null && _a !== void 0 ? _a : '',
+                    meta: (_b = route.meta) !== null && _b !== void 0 ? _b : {},
+                    beforeEnter: (_c = route.beforeEnter) !== null && _c !== void 0 ? _c : defaultHook,
+                    after: (_d = route.after) !== null && _d !== void 0 ? _d : defaultHook,
+                    children: route.children ? normalize(route.children, path) : [],
+                };
+                // directly push the normalized route to the list
+                // avoid flatten them again
+                routes.push(normalized);
+                return normalized;
+            });
+        };
+        // Normalize routes with default guards
+        normalize(config.routes, '/');
+        var _f = createMatcher(routes), findByName = _f.findByName, match = _f.match;
+        var current = null;
+        var history = [];
+        // # methods
+        var executeGuardsSync = function (to, from, guardLevel) {
+            try {
+                if (guardLevel === 0 /* GuardLevel.None */) {
+                    return true;
+                }
+                if (guardLevel & 1 /* GuardLevel.Global */) {
+                    var result = beforeEach(to, from);
+                    if (result === false) {
+                        return false;
+                    }
+                }
+                if (guardLevel & 2 /* GuardLevel.Route */) {
+                    var targetRoute = to.matched[to.matched.length - 1];
+                    var result = targetRoute.beforeEnter(to);
+                    if (result === false) {
+                        return false;
+                    }
+                }
+                return true;
+            }
+            catch (error) {
+                onError(error);
+                return false;
+            }
+        };
+        var executeGuards = function (to, from, guardLevel) { return __awaiter(void 0, void 0, void 0, function () {
+            var result, targetRoute, result, error_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 3, , 4]);
+                        if (guardLevel === 0 /* GuardLevel.None */) {
+                            return [2 /*return*/, true];
+                        }
+                        if (!(guardLevel & 1 /* GuardLevel.Global */)) return [3 /*break*/, 2];
+                        return [4 /*yield*/, beforeEach(to, from)];
+                    case 1:
+                        result = _a.sent();
+                        if (result === false) {
+                            return [2 /*return*/, false];
+                        }
+                        _a.label = 2;
+                    case 2:
+                        if (guardLevel & 2 /* GuardLevel.Route */) {
+                            targetRoute = to.matched[to.matched.length - 1];
+                            result = targetRoute.beforeEnter(to);
+                            return [2 /*return*/, result !== false];
+                        }
+                        return [2 /*return*/, true];
+                    case 3:
+                        error_1 = _a.sent();
+                        onError(error_1);
+                        return [2 /*return*/, false];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        }); };
+        var navigatePrepare = function (options) {
+            var _a, _b, _c, _d, _e, _f;
+            // Resolve target route
+            var targetPath;
+            var targetRoute;
+            if (options.name) {
+                targetRoute = findByName(options.name);
+                if (!targetRoute) {
+                    throws("Route not found: ".concat(options.name));
+                }
+                targetPath = targetRoute.path;
+            }
+            else if (options.path) {
+                targetPath = normalizePath(options.path);
+                targetRoute = (_a = match(targetPath)) === null || _a === void 0 ? void 0 : _a.route;
+            }
+            else {
+                throws("Either path or name must be provided");
+            }
+            // Substitute params
+            if (options.params) {
+                targetPath = emplaceParams(targetPath, options.params);
+            }
+            // Match final path
+            var matched = match(targetPath);
+            if (!matched) {
+                onNotFound(targetPath);
+                return null;
+            }
+            // Build route context
+            var queryString = options.query ? buildQuery(options.query) : '';
+            var fullPath = targetPath + queryString;
+            var to = {
+                path: targetPath,
+                name: matched.route.name,
+                params: __assign(__assign({}, matched.params), ((_b = options.params) !== null && _b !== void 0 ? _b : {})),
+                query: (_c = options.query) !== null && _c !== void 0 ? _c : {},
+                meta: (_d = matched.route.meta) !== null && _d !== void 0 ? _d : {},
+                matched: matched.result,
+            };
+            return {
+                guardLevel: (_e = options.guardLevel) !== null && _e !== void 0 ? _e : 15 /* GuardLevel.Default */,
+                replace: (_f = options.replace) !== null && _f !== void 0 ? _f : false,
+                to: to,
+                fullPath: fullPath,
+            };
+        };
+        var navigateSync = function (options) {
+            var _a;
+            try {
+                var prep = navigatePrepare(options);
+                if (!prep) {
+                    return false;
+                }
+                var guardLevel = prep.guardLevel, replace = prep.replace, to = prep.to, fullPath = prep.fullPath;
+                // Execute guards
+                if (!executeGuardsSync(to, current, guardLevel)) {
+                    return false;
+                }
+                // Update browser history
+                var url = fullPath;
+                if (replace) {
+                    window.history.replaceState({ path: to.path }, '', url);
+                }
+                else {
+                    window.history.pushState({ path: to.path }, '', url);
+                }
+                // Update current route
+                current = to;
+                history.push(to);
+                // Execute after hooks
+                executeAfterHooksSync(to, (_a = history[history.length - 2]) !== null && _a !== void 0 ? _a : null);
+                return true;
+            }
+            catch (error) {
+                onError(error);
+                return false;
+            }
+        };
+        var navigateAsync = function (options) { return __awaiter(void 0, void 0, void 0, function () {
+            var prep, guardLevel, replace, to, fullPath, passed, url, error_2;
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _b.trys.push([0, 2, , 3]);
+                        prep = navigatePrepare(options);
+                        if (!prep) {
+                            return [2 /*return*/, false];
+                        }
+                        guardLevel = prep.guardLevel, replace = prep.replace, to = prep.to, fullPath = prep.fullPath;
+                        return [4 /*yield*/, executeGuards(to, current, guardLevel)];
+                    case 1:
+                        passed = _b.sent();
+                        if (!passed) {
+                            return [2 /*return*/, false];
+                        }
+                        url = fullPath;
+                        if (replace) {
+                            window.history.replaceState({ path: to.path }, '', url);
+                        }
+                        else {
+                            window.history.pushState({ path: to.path }, '', url);
+                        }
+                        executeAfterHooks(to, (_a = history[history.length - 2]) !== null && _a !== void 0 ? _a : null);
+                        return [2 /*return*/, true];
+                    case 2:
+                        error_2 = _b.sent();
+                        onError(error_2);
+                        return [2 /*return*/, false];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        }); };
+        var navigate = asyncGuards ? navigateSync : navigateAsync;
+        var executeAfterHooksSync = function (to, from) {
+            var targetRoute = to.matched[to.matched.length - 1];
+            targetRoute.after(to);
+            afterEach(to, from);
+        };
+        var executeAfterHooks = function (to, from) { return __awaiter(void 0, void 0, void 0, function () {
+            var targetRoute;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        targetRoute = to.matched[to.matched.length - 1];
+                        return [4 /*yield*/, targetRoute.after(to)];
+                    case 1:
+                        _a.sent();
+                        return [4 /*yield*/, afterEach(to, from)];
+                    case 2:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        }); };
+        /**
+         * Normalize navigation argument
+         */
+        var normalizeLocation = function (loc) {
+            if (typeof loc === 'string') {
+                // Parse path and query
+                var _a = loc.split('?'), path = _a[0], queryString = _a[1];
+                return {
+                    path: path,
+                    query: queryString ? parseQuery(queryString) : undefined,
+                };
+            }
+            return loc;
+        };
+        // # register events
+        // Listen to browser back/forward
+        window.addEventListener('popstate', function (event) {
+            var _a;
+            if ((_a = event.state) === null || _a === void 0 ? void 0 : _a.path) {
+                navigate({ path: event.state.path, guardLevel: 1 /* GuardLevel.Global */, replace: true });
+            }
+        });
+        // Router instance
+        return {
+            get current() {
+                return current;
+            },
+            get history() {
+                return history.concat();
+            },
+            push: function (location) {
+                var options = normalizeLocation(location);
+                return navigate(options);
+            },
+            silentPush: function (location) {
+                var options = normalizeLocation(location);
+                return navigate(__assign(__assign({}, options), { guardLevel: 2 /* GuardLevel.Route */ }));
+            },
+            replace: function (location) {
+                var options = normalizeLocation(location);
+                return navigate(__assign(__assign({}, options), { replace: true }));
+            },
+            back: function () {
+                window.history.back();
+            },
+            forward: function () {
+                window.history.forward();
+            },
+        };
+    };
+
+    exports.createRouter = createRouter;
+
+    return exports;
+
+})({});

package/dist/index.mjs

@@ -1 +1,399 @@
-const t=()=>!0,r=t=>{throw new Error(`@ktjs/router: ${t}`)},e=(...t)=>"/"+t.map(t=>t.split("/")).flat().filter(Boolean).join("/"),n=t=>{const r={};if(!t||"?"===t)return r;const e=t.replace(/^\?/,"").split("&");for(const t of e){const[e,n]=t.split("=");e&&(r[decodeURIComponent(e)]=n?decodeURIComponent(n):"")}return r},o=(t,r)=>{const e={},n=t.split("/"),o=r.split("/");if(n.length!==o.length)return null;for(let t=0;t<n.length;t++){const r=n[t],u=o[t];if(r.startsWith(":")){e[r.slice(1)]=u}else if(r!==u)return null}return e},u=u=>{const c=u.beforeEach??t,a=u.afterEach??t,s=u.onNotFound??t,l=u.onError??t,i=u.asyncGuards??!0,f=[],d=(r,n)=>r.map(r=>{const o=e(n,r.path),u={path:o,name:r.name??"",meta:r.meta??{},beforeEnter:r.beforeEnter??t,after:r.after??t,children:r.children?d(r.children,o):[]};return f.push(u),u});d(u.routes,"/");const{findByName:p,match:h}=(t=>{const n={};for(let e=0;e<t.length;e++){const o=t[e];void 0!==o.name&&(o.name in n&&r(`Duplicate route name detected: '${o.name}'`),n[o.name]=o)}const u=r=>{const e=[r],n=r.path;for(let o=0;o<t.length;o++){const u=t[o];u!==r&&n.startsWith(u.path)&&n!==u.path&&e.push(u)}return e.reverse()};return{findByName:t=>n[t]??null,match:r=>{const n=e(r);for(const r of t)if(r.path===n)return{route:r,params:{},result:u(r)};for(const r of t)if(r.path.includes(":")){const t=o(r.path,n);if(t)return{route:r,params:t,result:u(r)}}return null}}})(f);let w=null;const m=[],y=t=>{let n,o;t.name?(o=p(t.name),o||r(`Route not found: ${t.name}`),n=o.path):t.path?(n=e(t.path),o=h(n)?.route):r("Either path or name must be provided"),t.params&&(n=((t,r)=>{let e=t;for(const t in r)e=e.replace(`:${t}`,r[t]);return e})(n,t.params));const u=h(n);if(!u)return s(n),null;const c=n+(t.query?(t=>{const r=Object.keys(t);return 0===r.length?"":`?${r.map(r=>`${encodeURIComponent(r)}=${encodeURIComponent(t[r])}`).join("&")}`})(t.query):""),a={path:n,name:u.route.name,params:{...u.params,...t.params||{}},query:t.query||{},meta:u.route.meta||{},matched:u.result};return{guardLevel:t.guardLevel??15,replace:t.replace??!1,to:a,fullPath:c}},g=i?t=>{try{const r=y(t);if(!r)return!1;const{guardLevel:e,replace:n,to:o,fullPath:u}=r;if(!((t,r,e)=>{try{if(0===e)return!0;if(1&e&&!1===c(t,r))return!1;if(2&e){if(!1===t.matched[t.matched.length-1].beforeEnter(t))return!1}return!0}catch(t){return l(t),!1}})(o,w,e))return!1;const a=u;return n?window.history.replaceState({path:o.path},"",a):window.history.pushState({path:o.path},"",a),w=o,m.push(o),v(o,m[m.length-2]||null),!0}catch(t){return l(t),!1}}:async t=>{try{const r=y(t);if(!r)return!1;const{guardLevel:e,replace:n,to:o,fullPath:u}=r,a=await(async(t,r,e)=>{try{if(0===e)return!0;if(1&e&&!1===await c(t,r))return!1;if(2&e){return!1!==t.matched[t.matched.length-1].beforeEnter(t)}return!0}catch(t){return l(t),!1}})(o,w,e);if(!a)return!1;const s=u;return n?window.history.replaceState({path:o.path},"",s):window.history.pushState({path:o.path},"",s),$(o,m[m.length-2]||null),!0}catch(t){return l(t),!1}},v=(t,r)=>{t.matched[t.matched.length-1].after(t),a(t,r)},$=async(t,r)=>{const e=t.matched[t.matched.length-1];await e.after(t),await a(t,r)},L=t=>{if("string"==typeof t){const[r,e]=t.split("?");return{path:r,query:e?n(e):void 0}}return t};return window.addEventListener("popstate",t=>{t.state?.path&&g({path:t.state.path,guardLevel:1,replace:!0})}),{get current(){return w},get history(){return m.concat()},push(t){const r=L(t);return g(r)},silentPush(t){const r=L(t);return g({...r,guardLevel:2})},replace(t){const r=L(t);return g({...r,replace:!0})},back(){window.history.back()},forward(){window.history.forward()}}};export{u as createRouter};
+/**
+ * Default guard that always returns true
+ */
+const defaultHook = () => true;
+const throws = (m) => {
+    throw new Error(`@ktjs/router: ${m}`);
+};
+const normalizePath = (...paths) => {
+    const p = paths
+        .map((p) => p.split('/'))
+        .flat()
+        .filter(Boolean);
+    return '/' + p.join('/');
+};
+/**
+ * Parse query string into object
+ */
+const parseQuery = (queryString) => {
+    const query = {};
+    if (!queryString || queryString === '?') {
+        return query;
+    }
+    const params = queryString.replace(/^\?/, '').split('&');
+    for (const param of params) {
+        const [key, value] = param.split('=');
+        if (key) {
+            query[decodeURIComponent(key)] = value ? decodeURIComponent(value) : '';
+        }
+    }
+    return query;
+};
+/**
+ * Build query string from object
+ */
+const buildQuery = (query) => {
+    const keys = Object.keys(query);
+    if (keys.length === 0)
+        return '';
+    const params = keys.map((key) => `${encodeURIComponent(key)}=${encodeURIComponent(query[key])}`).join('&');
+    return `?${params}`;
+};
+/**
+ * Substitute params into path pattern
+ * @example '/user/:id' + {id: '123'} => '/user/123'
+ */
+const emplaceParams = (path, params) => {
+    let result = path;
+    for (const key in params) {
+        result = result.replace(`:${key}`, params[key]);
+    }
+    return result;
+};
+/**
+ * Extract dynamic params from path using pattern
+ * @example pattern: '/user/:id', path: '/user/123' => {id: '123'}
+ */
+const extractParams = (pattern, path) => {
+    const params = {};
+    const patternParts = pattern.split('/');
+    const pathParts = path.split('/');
+    if (patternParts.length !== pathParts.length) {
+        return null;
+    }
+    for (let i = 0; i < patternParts.length; i++) {
+        const patternPart = patternParts[i];
+        const pathPart = pathParts[i];
+        if (patternPart.startsWith(':')) {
+            const paramName = patternPart.slice(1);
+            params[paramName] = pathPart;
+        }
+        else if (patternPart !== pathPart) {
+            return null;
+        }
+    }
+    return params;
+};
+
+/**
+ * Route matcher for finding matching routes and extracting params
+ */
+const createMatcher = (routes) => {
+    const nameMap = {};
+    for (let i = 0; i < routes.length; i++) {
+        const route = routes[i];
+        if (route.name !== undefined) {
+            if (route.name in nameMap) {
+                throws(`Duplicate route name detected: '${route.name}'`);
+            }
+            nameMap[route.name] = route;
+        }
+    }
+    /**
+     * Find route by name
+     */
+    const findByName = (name) => {
+        return nameMap[name] ?? null;
+    };
+    /**
+     * Match path against all routes
+     */
+    const match = (path) => {
+        const normalizedPath = normalizePath(path);
+        // Try exact match first
+        for (const route of routes) {
+            if (route.path === normalizedPath) {
+                return {
+                    route,
+                    params: {},
+                    result: getMatchedChain(route),
+                };
+            }
+        }
+        // Try dynamic routes
+        for (const route of routes) {
+            if (route.path.includes(':')) {
+                const params = extractParams(route.path, normalizedPath);
+                if (params) {
+                    return {
+                        route,
+                        params,
+                        result: getMatchedChain(route),
+                    };
+                }
+            }
+        }
+        return null;
+    };
+    /**
+     * Get chain of matched routes (for nested routes)
+     * - parent roots ahead
+     */
+    const getMatchedChain = (route) => {
+        const matched = [route];
+        const path = route.path;
+        // Find parent routes by path prefix matching
+        for (let i = 0; i < routes.length; i++) {
+            const r = routes[i];
+            if (r !== route && path.startsWith(r.path) && path !== r.path) {
+                matched.push(r);
+            }
+        }
+        return matched.reverse();
+    };
+    return {
+        findByName,
+        match,
+    };
+};
+
+/**
+ * Create a new router instance
+ */
+const createRouter = (config) => {
+    // # default configs
+    const beforeEach = config.beforeEach ?? defaultHook;
+    const afterEach = config.afterEach ?? defaultHook;
+    const onNotFound = config.onNotFound ?? defaultHook;
+    const onError = config.onError ?? defaultHook;
+    const asyncGuards = config.asyncGuards ?? true;
+    // # private values
+    const routes = [];
+    /**
+     * Normalize routes by adding default guards
+     */
+    const normalize = (rawRoutes, parentPath) => rawRoutes.map((route) => {
+        const path = normalizePath(parentPath, route.path);
+        const normalized = {
+            path,
+            name: route.name ?? '',
+            meta: route.meta ?? {},
+            beforeEnter: route.beforeEnter ?? defaultHook,
+            after: route.after ?? defaultHook,
+            children: route.children ? normalize(route.children, path) : [],
+        };
+        // directly push the normalized route to the list
+        // avoid flatten them again
+        routes.push(normalized);
+        return normalized;
+    });
+    // Normalize routes with default guards
+    normalize(config.routes, '/');
+    const { findByName, match } = createMatcher(routes);
+    let current = null;
+    const history = [];
+    // # methods
+    const executeGuardsSync = (to, from, guardLevel) => {
+        try {
+            if (guardLevel === 0 /* GuardLevel.None */) {
+                return true;
+            }
+            if (guardLevel & 1 /* GuardLevel.Global */) {
+                const result = beforeEach(to, from);
+                if (result === false) {
+                    return false;
+                }
+            }
+            if (guardLevel & 2 /* GuardLevel.Route */) {
+                const targetRoute = to.matched[to.matched.length - 1];
+                const result = targetRoute.beforeEnter(to);
+                if (result === false) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        catch (error) {
+            onError(error);
+            return false;
+        }
+    };
+    const executeGuards = async (to, from, guardLevel) => {
+        try {
+            if (guardLevel === 0 /* GuardLevel.None */) {
+                return true;
+            }
+            if (guardLevel & 1 /* GuardLevel.Global */) {
+                const result = await beforeEach(to, from);
+                if (result === false) {
+                    return false;
+                }
+            }
+            if (guardLevel & 2 /* GuardLevel.Route */) {
+                const targetRoute = to.matched[to.matched.length - 1];
+                const result = targetRoute.beforeEnter(to);
+                return result !== false;
+            }
+            return true;
+        }
+        catch (error) {
+            onError(error);
+            return false;
+        }
+    };
+    const navigatePrepare = (options) => {
+        // Resolve target route
+        let targetPath;
+        let targetRoute;
+        if (options.name) {
+            targetRoute = findByName(options.name);
+            if (!targetRoute) {
+                throws(`Route not found: ${options.name}`);
+            }
+            targetPath = targetRoute.path;
+        }
+        else if (options.path) {
+            targetPath = normalizePath(options.path);
+            targetRoute = match(targetPath)?.route;
+        }
+        else {
+            throws(`Either path or name must be provided`);
+        }
+        // Substitute params
+        if (options.params) {
+            targetPath = emplaceParams(targetPath, options.params);
+        }
+        // Match final path
+        const matched = match(targetPath);
+        if (!matched) {
+            onNotFound(targetPath);
+            return null;
+        }
+        // Build route context
+        const queryString = options.query ? buildQuery(options.query) : '';
+        const fullPath = targetPath + queryString;
+        const to = {
+            path: targetPath,
+            name: matched.route.name,
+            params: { ...matched.params, ...(options.params ?? {}) },
+            query: options.query ?? {},
+            meta: matched.route.meta ?? {},
+            matched: matched.result,
+        };
+        return {
+            guardLevel: options.guardLevel ?? 15 /* GuardLevel.Default */,
+            replace: options.replace ?? false,
+            to,
+            fullPath,
+        };
+    };
+    const navigateSync = (options) => {
+        try {
+            const prep = navigatePrepare(options);
+            if (!prep) {
+                return false;
+            }
+            const { guardLevel, replace, to, fullPath } = prep;
+            // Execute guards
+            if (!executeGuardsSync(to, current, guardLevel)) {
+                return false;
+            }
+            // Update browser history
+            const url = fullPath;
+            if (replace) {
+                window.history.replaceState({ path: to.path }, '', url);
+            }
+            else {
+                window.history.pushState({ path: to.path }, '', url);
+            }
+            // Update current route
+            current = to;
+            history.push(to);
+            // Execute after hooks
+            executeAfterHooksSync(to, history[history.length - 2] ?? null);
+            return true;
+        }
+        catch (error) {
+            onError(error);
+            return false;
+        }
+    };
+    const navigateAsync = async (options) => {
+        try {
+            const prep = navigatePrepare(options);
+            if (!prep) {
+                return false;
+            }
+            const { guardLevel, replace, to, fullPath } = prep;
+            const passed = await executeGuards(to, current, guardLevel);
+            if (!passed) {
+                return false;
+            }
+            // ---- Guards passed ----
+            const url = fullPath;
+            if (replace) {
+                window.history.replaceState({ path: to.path }, '', url);
+            }
+            else {
+                window.history.pushState({ path: to.path }, '', url);
+            }
+            executeAfterHooks(to, history[history.length - 2] ?? null);
+            return true;
+        }
+        catch (error) {
+            onError(error);
+            return false;
+        }
+    };
+    const navigate = asyncGuards ? navigateSync : navigateAsync;
+    const executeAfterHooksSync = (to, from) => {
+        const targetRoute = to.matched[to.matched.length - 1];
+        targetRoute.after(to);
+        afterEach(to, from);
+    };
+    const executeAfterHooks = async (to, from) => {
+        const targetRoute = to.matched[to.matched.length - 1];
+        await targetRoute.after(to);
+        await afterEach(to, from);
+    };
+    /**
+     * Normalize navigation argument
+     */
+    const normalizeLocation = (loc) => {
+        if (typeof loc === 'string') {
+            // Parse path and query
+            const [path, queryString] = loc.split('?');
+            return {
+                path,
+                query: queryString ? parseQuery(queryString) : undefined,
+            };
+        }
+        return loc;
+    };
+    // # register events
+    // Listen to browser back/forward
+    window.addEventListener('popstate', (event) => {
+        if (event.state?.path) {
+            navigate({ path: event.state.path, guardLevel: 1 /* GuardLevel.Global */, replace: true });
+        }
+    });
+    // Router instance
+    return {
+        get current() {
+            return current;
+        },
+        get history() {
+            return history.concat();
+        },
+        push(location) {
+            const options = normalizeLocation(location);
+            return navigate(options);
+        },
+        silentPush(location) {
+            const options = normalizeLocation(location);
+            return navigate({ ...options, guardLevel: 2 /* GuardLevel.Route */ });
+        },
+        replace(location) {
+            const options = normalizeLocation(location);
+            return navigate({ ...options, replace: true });
+        },
+        back() {
+            window.history.back();
+        },
+        forward() {
+            window.history.forward();
+        },
+    };
+};
+
+export { createRouter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ktjs/router",
-  "version": "0.6.6",
+  "version": "0.13.0",
   "description": "Router for kt.js - client-side routing with navigation guards",
   "type": "module",
   "module": "./dist/index.mjs",
@@ -31,7 +31,7 @@
     "directory": "packages/router"
   },
   "dependencies": {
-    "@ktjs/core": "0.6.6"
+    "@ktjs/core": "0.13.0"
   },
   "scripts": {
     "build": "rollup -c rollup.config.mjs",