@ktjs/router 0.14.5 → 0.14.8

package/dist/index.d.ts

@@ -124,10 +124,6 @@ interface RouterConfig {
    * Default is `true`
    */
   asyncGuards?: boolean;
-  /**
-   * Router mode: 'history' uses HTML5 history API, 'hash' uses URL hash. Default is 'hash'.
-   */
-  mode?: 'history' | 'hash';
 }
 
 /**
@@ -157,8 +153,6 @@ interface Router {
 
   /** Navigate forward in history */
   forward(): void;
-
-  initCurrentRoute(): void;
 }
 
 interface RouteMatch {

package/dist/index.iife.js

@@ -169,15 +169,13 @@ var __ktjs_router__ = (function (exports) {
         const onNotFound = config.onNotFound ?? defaultHook;
         const onError = config.onError ?? defaultHook;
         const asyncGuards = config.asyncGuards ?? true;
-        // default to 'hash' mode
-        const mode = config.mode ?? 'hash';
         const baseUrl = config.baseUrl ?? '';
         // # private values
         const routes = [];
+        const history = [];
         let routerView = null;
-        /**
-         * Normalize routes by adding default guards
-         */
+        let current = null;
+        // # methods
         const normalize = (rawRoutes, parentPath) => rawRoutes.map((route) => {
             const path = normalizePath(parentPath, route.path);
             const normalized = {
@@ -194,56 +192,6 @@ var __ktjs_router__ = (function (exports) {
             routes.push(normalized);
             return normalized;
         });
-        // Normalize routes with default guards
-        normalize(config.routes, '/');
-        const { findByName, match } = createMatcher(routes);
-        /**
-         * Initialize current route from URL
-         */
-        const initCurrentRoute = () => {
-            if (mode === 'hash') {
-                const hash = window.location.hash.slice(1); // Remove '#'
-                if (!hash) {
-                    return (current = null);
-                }
-                // Parse path and query
-                const [path, queryString] = hash.split('?');
-                const normalizedPath = normalizePath(path);
-                // Match route
-                const matched = match(normalizedPath);
-                if (!matched) {
-                    return (current = null);
-                }
-                // Build route context
-                return (current = {
-                    path: normalizedPath,
-                    name: matched.route.name,
-                    params: matched.params,
-                    query: queryString ? parseQuery(queryString) : {},
-                    meta: matched.route.meta ?? {},
-                    matched: matched.result,
-                });
-            }
-            // history mode
-            const pathWithQuery = window.location.pathname + window.location.search;
-            const [path, queryString] = pathWithQuery.split('?');
-            const normalizedPath = normalizePath(path);
-            const matched = match(normalizedPath);
-            if (!matched) {
-                return (current = null);
-            }
-            return (current = {
-                path: normalizedPath,
-                name: matched.route.name,
-                params: matched.params,
-                query: queryString ? parseQuery(queryString) : {},
-                meta: matched.route.meta ?? {},
-                matched: matched.result,
-            });
-        };
-        let current = null;
-        const history = current ? [current] : [];
-        // # methods
         const executeGuardsSync = (to, from, guardLevel) => {
             try {
                 if (guardLevel === 0 /* GuardLevel.None */) {
@@ -387,22 +335,12 @@ var __ktjs_router__ = (function (exports) {
                 }
                 // Update browser history depending on mode
                 const url = fullPath;
-                if (mode === 'history') {
-                    if (replace) {
-                        window.history.replaceState({ path: to.path }, '', url);
-                    }
-                    else {
-                        window.history.pushState({ path: to.path }, '', url);
-                    }
+                const hashUrl = '#' + fullPath;
+                if (replace) {
+                    window.location.replace(hashUrl);
                 }
                 else {
-                    const hashUrl = '#' + fullPath;
-                    if (replace) {
-                        window.location.replace(hashUrl);
-                    }
-                    else {
-                        window.location.hash = fullPath;
-                    }
+                    window.location.hash = fullPath;
                 }
                 // Update current route in memory
                 current = to;
@@ -464,23 +402,12 @@ var __ktjs_router__ = (function (exports) {
                     return false;
                 }
                 // ---- Guards passed ----
-                const url = fullPath;
-                if (mode === 'history') {
-                    if (replace) {
-                        window.history.replaceState({ path: to.path }, '', url);
-                    }
-                    else {
-                        window.history.pushState({ path: to.path }, '', url);
-                    }
+                const hashUrl = '#' + fullPath;
+                if (replace) {
+                    window.location.replace(hashUrl);
                 }
                 else {
-                    const hashUrl = '#' + fullPath;
-                    if (replace) {
-                        window.location.replace(hashUrl);
-                    }
-                    else {
-                        window.location.hash = fullPath;
-                    }
+                    window.location.hash = fullPath;
                 }
                 current = to;
                 if (replace) {
@@ -526,74 +453,61 @@ var __ktjs_router__ = (function (exports) {
          * 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,
-                };
+            if (typeof loc !== 'string') {
+                return loc;
             }
-            return loc;
+            const [path, queryString] = loc.split('?');
+            return {
+                path,
+                query: queryString ? parseQuery(queryString) : undefined,
+            };
         };
         // # register events
-        if (mode === 'history') {
-            // Listen to browser back/forward for history mode
-            window.addEventListener('popstate', (event) => {
-                if (event.state?.path) {
-                    // navigate without pushing new history entry
-                    navigate({ path: event.state.path, guardLevel: 1 /* GuardLevel.Global */, replace: true });
-                }
-            });
-        }
-        else {
-            // hash mode: listen to hashchange
-            window.addEventListener('hashchange', () => {
-                const hash = window.location.hash.slice(1);
-                const [path] = hash.split('?');
-                const normalizedPath = normalizePath(path);
-                if (current && current.path === normalizedPath) {
-                    return;
-                }
-                // render route for new hash without adding extra history entry
-                const matched = match(normalizedPath);
-                if (!matched) {
-                    onNotFound(normalizedPath);
-                    return;
-                }
-                const queryString = window.location.hash.slice(1).split('?')[1];
-                const to = {
-                    path: normalizedPath,
-                    name: matched.route.name,
-                    params: matched.params,
-                    query: queryString ? parseQuery(queryString) : {},
-                    meta: matched.route.meta ?? {},
-                    matched: matched.result,
-                };
-                // apply without modifying browser history
-                current = to;
-                history.push(to);
-                if (routerView && to.matched.length > 0) {
-                    const route = to.matched[to.matched.length - 1];
-                    if (route.component) {
-                        const element = route.component();
-                        if (element instanceof Promise) {
-                            element.then((el) => {
-                                routerView.innerHTML = '';
-                                routerView.appendChild(el);
-                            });
-                        }
-                        else {
+        window.addEventListener('hashchange', () => {
+            const hash = window.location.hash.slice(1);
+            const [path] = hash.split('?');
+            const normalizedPath = normalizePath(path);
+            if (current && current.path === normalizedPath) {
+                return;
+            }
+            // render route for new hash without adding extra history entry
+            const matched = match(normalizedPath);
+            if (!matched) {
+                onNotFound(normalizedPath);
+                return;
+            }
+            const queryString = window.location.hash.slice(1).split('?')[1];
+            const to = {
+                path: normalizedPath,
+                name: matched.route.name,
+                params: matched.params,
+                query: queryString ? parseQuery(queryString) : {},
+                meta: matched.route.meta ?? {},
+                matched: matched.result,
+            };
+            // apply without modifying browser history
+            current = to;
+            history.push(to);
+            if (routerView && to.matched.length > 0) {
+                const route = to.matched[to.matched.length - 1];
+                if (route.component) {
+                    const element = route.component();
+                    if (element instanceof Promise) {
+                        element.then((el) => {
                             routerView.innerHTML = '';
-                            routerView.appendChild(element);
-                        }
+                            routerView.appendChild(el);
+                        });
+                    }
+                    else {
+                        routerView.innerHTML = '';
+                        routerView.appendChild(element);
                     }
                 }
-                executeAfterHooksSync(to, history[history.length - 2] ?? null);
-            });
-        }
-        // Router instance
-        return {
+            }
+            executeAfterHooksSync(to, history[history.length - 2] ?? null);
+        });
+        // # initialize
+        const instance = {
             get current() {
                 return current;
             },
@@ -621,8 +535,14 @@ var __ktjs_router__ = (function (exports) {
             forward() {
                 window.history.forward();
             },
-            initCurrentRoute,
         };
+        normalize(config.routes, '/');
+        const { findByName, match } = createMatcher(routes);
+        const currentHash = window.location.hash.slice(1);
+        if (currentHash) {
+            instance.push(currentHash);
+        }
+        return instance;
     };
 
     exports.KTRouter = KTRouter;

package/dist/index.legacy.js

@@ -253,22 +253,20 @@ var __ktjs_router__ = (function (exports) {
      * Create a new router instance
      */
     var createRouter = function (config) {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e, _f;
         // # 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;
-        // default to 'hash' mode
-        var mode = (_f = config.mode) !== null && _f !== void 0 ? _f : 'hash';
-        var baseUrl = (_g = config.baseUrl) !== null && _g !== void 0 ? _g : '';
+        var baseUrl = (_f = config.baseUrl) !== null && _f !== void 0 ? _f : '';
         // # private values
         var routes = [];
+        var history = [];
         var routerView = null;
-        /**
-         * Normalize routes by adding default guards
-         */
+        var current = null;
+        // # methods
         var normalize = function (rawRoutes, parentPath) {
             return rawRoutes.map(function (route) {
                 var _a, _b, _c, _d;
@@ -288,57 +286,6 @@ var __ktjs_router__ = (function (exports) {
                 return normalized;
             });
         };
-        // Normalize routes with default guards
-        normalize(config.routes, '/');
-        var _h = createMatcher(routes), findByName = _h.findByName, match = _h.match;
-        /**
-         * Initialize current route from URL
-         */
-        var initCurrentRoute = function () {
-            var _a, _b;
-            if (mode === 'hash') {
-                var hash = window.location.hash.slice(1); // Remove '#'
-                if (!hash) {
-                    return (current = null);
-                }
-                // Parse path and query
-                var _c = hash.split('?'), path_1 = _c[0], queryString_1 = _c[1];
-                var normalizedPath_1 = normalizePath(path_1);
-                // Match route
-                var matched_1 = match(normalizedPath_1);
-                if (!matched_1) {
-                    return (current = null);
-                }
-                // Build route context
-                return (current = {
-                    path: normalizedPath_1,
-                    name: matched_1.route.name,
-                    params: matched_1.params,
-                    query: queryString_1 ? parseQuery(queryString_1) : {},
-                    meta: (_a = matched_1.route.meta) !== null && _a !== void 0 ? _a : {},
-                    matched: matched_1.result,
-                });
-            }
-            // history mode
-            var pathWithQuery = window.location.pathname + window.location.search;
-            var _d = pathWithQuery.split('?'), path = _d[0], queryString = _d[1];
-            var normalizedPath = normalizePath(path);
-            var matched = match(normalizedPath);
-            if (!matched) {
-                return (current = null);
-            }
-            return (current = {
-                path: normalizedPath,
-                name: matched.route.name,
-                params: matched.params,
-                query: queryString ? parseQuery(queryString) : {},
-                meta: (_b = matched.route.meta) !== null && _b !== void 0 ? _b : {},
-                matched: matched.result,
-            });
-        };
-        var current = null;
-        var history = current ? [current] : [];
-        // # methods
         var executeGuardsSync = function (to, from, guardLevel) {
             try {
                 if (guardLevel === 0 /* GuardLevel.None */) {
@@ -496,22 +443,12 @@ var __ktjs_router__ = (function (exports) {
                 }
                 // Update browser history depending on mode
                 var url = fullPath;
-                if (mode === 'history') {
-                    if (replace) {
-                        window.history.replaceState({ path: to.path }, '', url);
-                    }
-                    else {
-                        window.history.pushState({ path: to.path }, '', url);
-                    }
+                var hashUrl = '#' + fullPath;
+                if (replace) {
+                    window.location.replace(hashUrl);
                 }
                 else {
-                    var hashUrl = '#' + fullPath;
-                    if (replace) {
-                        window.location.replace(hashUrl);
-                    }
-                    else {
-                        window.location.hash = fullPath;
-                    }
+                    window.location.hash = fullPath;
                 }
                 // Update current route in memory
                 current = to;
@@ -558,7 +495,7 @@ var __ktjs_router__ = (function (exports) {
                 args_1[_i - 1] = arguments[_i];
             }
             return __awaiter(void 0, __spreadArray([options_1], args_1, true), void 0, function (options, redirectCount) {
-                var prep, guardLevel, replace, to, fullPath, guardResult, url, hashUrl, route, element, error_2;
+                var prep, guardLevel, replace, to, fullPath, guardResult, hashUrl, route, element, error_2;
                 var _a;
                 if (redirectCount === void 0) { redirectCount = 0; }
                 return __generator(this, function (_b) {
@@ -585,23 +522,12 @@ var __ktjs_router__ = (function (exports) {
                                 }
                                 return [2 /*return*/, false];
                             }
-                            url = fullPath;
-                            if (mode === 'history') {
-                                if (replace) {
-                                    window.history.replaceState({ path: to.path }, '', url);
-                                }
-                                else {
-                                    window.history.pushState({ path: to.path }, '', url);
-                                }
+                            hashUrl = '#' + fullPath;
+                            if (replace) {
+                                window.location.replace(hashUrl);
                             }
                             else {
-                                hashUrl = '#' + fullPath;
-                                if (replace) {
-                                    window.location.replace(hashUrl);
-                                }
-                                else {
-                                    window.location.hash = fullPath;
-                                }
+                                window.location.hash = fullPath;
                             }
                             current = to;
                             if (replace) {
@@ -662,76 +588,62 @@ var __ktjs_router__ = (function (exports) {
          * 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,
-                };
+            if (typeof loc !== 'string') {
+                return loc;
             }
-            return loc;
+            var _a = loc.split('?'), path = _a[0], queryString = _a[1];
+            return {
+                path: path,
+                query: queryString ? parseQuery(queryString) : undefined,
+            };
         };
         // # register events
-        if (mode === 'history') {
-            // Listen to browser back/forward for history mode
-            window.addEventListener('popstate', function (event) {
-                var _a;
-                if ((_a = event.state) === null || _a === void 0 ? void 0 : _a.path) {
-                    // navigate without pushing new history entry
-                    navigate({ path: event.state.path, guardLevel: 1 /* GuardLevel.Global */, replace: true });
-                }
-            });
-        }
-        else {
-            // hash mode: listen to hashchange
-            window.addEventListener('hashchange', function () {
-                var _a, _b;
-                var hash = window.location.hash.slice(1);
-                var path = hash.split('?')[0];
-                var normalizedPath = normalizePath(path);
-                if (current && current.path === normalizedPath) {
-                    return;
-                }
-                // render route for new hash without adding extra history entry
-                var matched = match(normalizedPath);
-                if (!matched) {
-                    onNotFound(normalizedPath);
-                    return;
-                }
-                var queryString = window.location.hash.slice(1).split('?')[1];
-                var to = {
-                    path: normalizedPath,
-                    name: matched.route.name,
-                    params: matched.params,
-                    query: queryString ? parseQuery(queryString) : {},
-                    meta: (_a = matched.route.meta) !== null && _a !== void 0 ? _a : {},
-                    matched: matched.result,
-                };
-                // apply without modifying browser history
-                current = to;
-                history.push(to);
-                if (routerView && to.matched.length > 0) {
-                    var route = to.matched[to.matched.length - 1];
-                    if (route.component) {
-                        var element = route.component();
-                        if (element instanceof Promise) {
-                            element.then(function (el) {
-                                routerView.innerHTML = '';
-                                routerView.appendChild(el);
-                            });
-                        }
-                        else {
+        window.addEventListener('hashchange', function () {
+            var _a, _b;
+            var hash = window.location.hash.slice(1);
+            var path = hash.split('?')[0];
+            var normalizedPath = normalizePath(path);
+            if (current && current.path === normalizedPath) {
+                return;
+            }
+            // render route for new hash without adding extra history entry
+            var matched = match(normalizedPath);
+            if (!matched) {
+                onNotFound(normalizedPath);
+                return;
+            }
+            var queryString = window.location.hash.slice(1).split('?')[1];
+            var to = {
+                path: normalizedPath,
+                name: matched.route.name,
+                params: matched.params,
+                query: queryString ? parseQuery(queryString) : {},
+                meta: (_a = matched.route.meta) !== null && _a !== void 0 ? _a : {},
+                matched: matched.result,
+            };
+            // apply without modifying browser history
+            current = to;
+            history.push(to);
+            if (routerView && to.matched.length > 0) {
+                var route = to.matched[to.matched.length - 1];
+                if (route.component) {
+                    var element = route.component();
+                    if (element instanceof Promise) {
+                        element.then(function (el) {
                             routerView.innerHTML = '';
-                            routerView.appendChild(element);
-                        }
+                            routerView.appendChild(el);
+                        });
+                    }
+                    else {
+                        routerView.innerHTML = '';
+                        routerView.appendChild(element);
                     }
                 }
-                executeAfterHooksSync(to, (_b = history[history.length - 2]) !== null && _b !== void 0 ? _b : null);
-            });
-        }
-        // Router instance
-        return {
+            }
+            executeAfterHooksSync(to, (_b = history[history.length - 2]) !== null && _b !== void 0 ? _b : null);
+        });
+        // # initialize
+        var instance = {
             get current() {
                 return current;
             },
@@ -759,8 +671,14 @@ var __ktjs_router__ = (function (exports) {
             forward: function () {
                 window.history.forward();
             },
-            initCurrentRoute: initCurrentRoute,
         };
+        normalize(config.routes, '/');
+        var _g = createMatcher(routes), findByName = _g.findByName, match = _g.match;
+        var currentHash = window.location.hash.slice(1);
+        if (currentHash) {
+            instance.push(currentHash);
+        }
+        return instance;
     };
 
     exports.KTRouter = KTRouter;

package/dist/index.mjs

@@ -166,15 +166,13 @@ const createRouter = (config) => {
     const onNotFound = config.onNotFound ?? defaultHook;
     const onError = config.onError ?? defaultHook;
     const asyncGuards = config.asyncGuards ?? true;
-    // default to 'hash' mode
-    const mode = config.mode ?? 'hash';
     const baseUrl = config.baseUrl ?? '';
     // # private values
     const routes = [];
+    const history = [];
     let routerView = null;
-    /**
-     * Normalize routes by adding default guards
-     */
+    let current = null;
+    // # methods
     const normalize = (rawRoutes, parentPath) => rawRoutes.map((route) => {
         const path = normalizePath(parentPath, route.path);
         const normalized = {
@@ -191,56 +189,6 @@ const createRouter = (config) => {
         routes.push(normalized);
         return normalized;
     });
-    // Normalize routes with default guards
-    normalize(config.routes, '/');
-    const { findByName, match } = createMatcher(routes);
-    /**
-     * Initialize current route from URL
-     */
-    const initCurrentRoute = () => {
-        if (mode === 'hash') {
-            const hash = window.location.hash.slice(1); // Remove '#'
-            if (!hash) {
-                return (current = null);
-            }
-            // Parse path and query
-            const [path, queryString] = hash.split('?');
-            const normalizedPath = normalizePath(path);
-            // Match route
-            const matched = match(normalizedPath);
-            if (!matched) {
-                return (current = null);
-            }
-            // Build route context
-            return (current = {
-                path: normalizedPath,
-                name: matched.route.name,
-                params: matched.params,
-                query: queryString ? parseQuery(queryString) : {},
-                meta: matched.route.meta ?? {},
-                matched: matched.result,
-            });
-        }
-        // history mode
-        const pathWithQuery = window.location.pathname + window.location.search;
-        const [path, queryString] = pathWithQuery.split('?');
-        const normalizedPath = normalizePath(path);
-        const matched = match(normalizedPath);
-        if (!matched) {
-            return (current = null);
-        }
-        return (current = {
-            path: normalizedPath,
-            name: matched.route.name,
-            params: matched.params,
-            query: queryString ? parseQuery(queryString) : {},
-            meta: matched.route.meta ?? {},
-            matched: matched.result,
-        });
-    };
-    let current = null;
-    const history = current ? [current] : [];
-    // # methods
     const executeGuardsSync = (to, from, guardLevel) => {
         try {
             if (guardLevel === 0 /* GuardLevel.None */) {
@@ -384,22 +332,12 @@ const createRouter = (config) => {
             }
             // Update browser history depending on mode
             const url = fullPath;
-            if (mode === 'history') {
-                if (replace) {
-                    window.history.replaceState({ path: to.path }, '', url);
-                }
-                else {
-                    window.history.pushState({ path: to.path }, '', url);
-                }
+            const hashUrl = '#' + fullPath;
+            if (replace) {
+                window.location.replace(hashUrl);
             }
             else {
-                const hashUrl = '#' + fullPath;
-                if (replace) {
-                    window.location.replace(hashUrl);
-                }
-                else {
-                    window.location.hash = fullPath;
-                }
+                window.location.hash = fullPath;
             }
             // Update current route in memory
             current = to;
@@ -461,23 +399,12 @@ const createRouter = (config) => {
                 return false;
             }
             // ---- Guards passed ----
-            const url = fullPath;
-            if (mode === 'history') {
-                if (replace) {
-                    window.history.replaceState({ path: to.path }, '', url);
-                }
-                else {
-                    window.history.pushState({ path: to.path }, '', url);
-                }
+            const hashUrl = '#' + fullPath;
+            if (replace) {
+                window.location.replace(hashUrl);
             }
             else {
-                const hashUrl = '#' + fullPath;
-                if (replace) {
-                    window.location.replace(hashUrl);
-                }
-                else {
-                    window.location.hash = fullPath;
-                }
+                window.location.hash = fullPath;
             }
             current = to;
             if (replace) {
@@ -523,74 +450,61 @@ const createRouter = (config) => {
      * 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,
-            };
+        if (typeof loc !== 'string') {
+            return loc;
         }
-        return loc;
+        const [path, queryString] = loc.split('?');
+        return {
+            path,
+            query: queryString ? parseQuery(queryString) : undefined,
+        };
     };
     // # register events
-    if (mode === 'history') {
-        // Listen to browser back/forward for history mode
-        window.addEventListener('popstate', (event) => {
-            if (event.state?.path) {
-                // navigate without pushing new history entry
-                navigate({ path: event.state.path, guardLevel: 1 /* GuardLevel.Global */, replace: true });
-            }
-        });
-    }
-    else {
-        // hash mode: listen to hashchange
-        window.addEventListener('hashchange', () => {
-            const hash = window.location.hash.slice(1);
-            const [path] = hash.split('?');
-            const normalizedPath = normalizePath(path);
-            if (current && current.path === normalizedPath) {
-                return;
-            }
-            // render route for new hash without adding extra history entry
-            const matched = match(normalizedPath);
-            if (!matched) {
-                onNotFound(normalizedPath);
-                return;
-            }
-            const queryString = window.location.hash.slice(1).split('?')[1];
-            const to = {
-                path: normalizedPath,
-                name: matched.route.name,
-                params: matched.params,
-                query: queryString ? parseQuery(queryString) : {},
-                meta: matched.route.meta ?? {},
-                matched: matched.result,
-            };
-            // apply without modifying browser history
-            current = to;
-            history.push(to);
-            if (routerView && to.matched.length > 0) {
-                const route = to.matched[to.matched.length - 1];
-                if (route.component) {
-                    const element = route.component();
-                    if (element instanceof Promise) {
-                        element.then((el) => {
-                            routerView.innerHTML = '';
-                            routerView.appendChild(el);
-                        });
-                    }
-                    else {
+    window.addEventListener('hashchange', () => {
+        const hash = window.location.hash.slice(1);
+        const [path] = hash.split('?');
+        const normalizedPath = normalizePath(path);
+        if (current && current.path === normalizedPath) {
+            return;
+        }
+        // render route for new hash without adding extra history entry
+        const matched = match(normalizedPath);
+        if (!matched) {
+            onNotFound(normalizedPath);
+            return;
+        }
+        const queryString = window.location.hash.slice(1).split('?')[1];
+        const to = {
+            path: normalizedPath,
+            name: matched.route.name,
+            params: matched.params,
+            query: queryString ? parseQuery(queryString) : {},
+            meta: matched.route.meta ?? {},
+            matched: matched.result,
+        };
+        // apply without modifying browser history
+        current = to;
+        history.push(to);
+        if (routerView && to.matched.length > 0) {
+            const route = to.matched[to.matched.length - 1];
+            if (route.component) {
+                const element = route.component();
+                if (element instanceof Promise) {
+                    element.then((el) => {
                         routerView.innerHTML = '';
-                        routerView.appendChild(element);
-                    }
+                        routerView.appendChild(el);
+                    });
+                }
+                else {
+                    routerView.innerHTML = '';
+                    routerView.appendChild(element);
                 }
             }
-            executeAfterHooksSync(to, history[history.length - 2] ?? null);
-        });
-    }
-    // Router instance
-    return {
+        }
+        executeAfterHooksSync(to, history[history.length - 2] ?? null);
+    });
+    // # initialize
+    const instance = {
         get current() {
             return current;
         },
@@ -618,8 +532,14 @@ const createRouter = (config) => {
         forward() {
             window.history.forward();
         },
-        initCurrentRoute,
     };
+    normalize(config.routes, '/');
+    const { findByName, match } = createMatcher(routes);
+    const currentHash = window.location.hash.slice(1);
+    if (currentHash) {
+        instance.push(currentHash);
+    }
+    return instance;
 };
 
 export { KTRouter, createRouter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ktjs/router",
-  "version": "0.14.5",
+  "version": "0.14.8",
   "description": "Router for kt.js - client-side routing with navigation guards",
   "type": "module",
   "module": "./dist/index.mjs",