@ktjs/router 0.19.0 → 0.31.9

package/dist/index.mjs

@@ -1,92 +1,4 @@
-// Cached native methods for performance optimization
-
-// Error handling utilities
-const $throw = (message) => {
-    throw new Error('@ktjs/shared: ' + message);
-};
-
-// String manipulation utilities
-/**
- * Default empty function
- */
-const $emptyFn = (() => true);
-
-/**
- * Normalize path by joining parts and ensuring leading slash
- */
-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;
-};
-
-// Shared utilities and cached native methods for kt.js framework
-// Re-export all utilities
-Object.defineProperty(window, '@ktjs/shared', { value: '0.19.0' });
+import { normalizePath, extractParams, $emptyFn, parseQuery, emplaceParams, buildQuery } from '@ktjs/shared';
 
 /**
  * Route matcher for finding matching routes and extracting params
@@ -97,7 +9,7 @@ const createMatcher = (routes) => {
         const route = routes[i];
         if (route.name !== undefined) {
             if (route.name in nameMap) {
-                $throw(`Duplicate route name detected: '${route.name}'`);
+                throw new Error(`[@ktjs/router error] Duplicate route name detected: '${route.name}'`);
             }
             nameMap[route.name] = route;
         }
@@ -239,7 +151,7 @@ const createRouter = ({ beforeEach = $emptyFn, afterEach = $emptyFn, onNotFound
         if (options.name) {
             targetRoute = findByName(options.name);
             if (!targetRoute) {
-                $throw(`Route not found: ${options.name}`);
+                throw new Error(`[@ktjs/router error] Route not found: ${options.name}`);
             }
             targetPath = targetRoute.path;
         }
@@ -248,7 +160,7 @@ const createRouter = ({ beforeEach = $emptyFn, afterEach = $emptyFn, onNotFound
             targetRoute = match(targetPath)?.route;
         }
         else {
-            $throw(`Either path or name must be provided`);
+            throw new Error(`[@ktjs/router error] Either path or name must be provided`);
         }
         // Substitute params
         if (options.params) {
@@ -437,3 +349,4 @@ const createRouter = ({ beforeEach = $emptyFn, afterEach = $emptyFn, onNotFound
 };
 
 export { KTRouter, createRouter };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/core/matcher.ts","../src/core/kt-router.ts","../src/core/index.ts"],"sourcesContent":["import type { RouteConfig, RouteMatch } from '../types/router.js';\nimport { extractParams, normalizePath } from '@ktjs/shared';\n\n/**\n * Route matcher for finding matching routes and extracting params\n */\nexport const createMatcher = (routes: RouteConfig[]) => {\n  const nameMap: Record<string, RouteConfig> = {};\n\n  for (let i = 0; i < routes.length; i++) {\n    const route = routes[i];\n    if (route.name !== undefined) {\n      if (route.name in nameMap) {\n        $throw(`Duplicate route name detected: '${route.name}'`);\n      }\n      nameMap[route.name] = route;\n    }\n  }\n\n  /**\n   * Find route by name\n   */\n  const findByName = (name: string): RouteConfig | null => {\n    return nameMap[name] ?? null;\n  };\n\n  /**\n   * Match path against all routes\n   */\n  const match = (path: string): RouteMatch | null => {\n    const normalizedPath = normalizePath(path);\n\n    // Try exact match first\n    for (const route of routes) {\n      if (route.path === normalizedPath) {\n        return {\n          route,\n          params: {},\n          result: getMatchedChain(route),\n        };\n      }\n    }\n\n    // Try dynamic routes\n    for (const route of routes) {\n      if (route.path.includes(':')) {\n        const params = extractParams(route.path, normalizedPath);\n        if (params) {\n          return {\n            route,\n            params,\n            result: getMatchedChain(route),\n          };\n        }\n      }\n    }\n\n    return null;\n  };\n\n  /**\n   * Get chain of matched routes (for nested routes)\n   * - parent roots ahead\n   */\n  const getMatchedChain = (route: RouteConfig): RouteConfig[] => {\n    const matched: RouteConfig[] = [route];\n    const path = route.path;\n\n    // Find parent routes by path prefix matching\n    for (let i = 0; i < routes.length; i++) {\n      const r = routes[i];\n      if (r !== route && path.startsWith(r.path) && path !== r.path) {\n        matched.push(r);\n      }\n    }\n\n    return matched.reverse();\n  };\n\n  return {\n    findByName,\n    match,\n  };\n};\n","import { JSX } from '@ktjs/core/jsx-runtime';\nimport type { Router } from '../types/router.js';\n\n/**\n * Create a router view container that automatically renders route components\n */\nexport function KTRouter({ router }: { router: Router }): JSX.Element {\n  const view = document.createElement('kt-router-view');\n  router.setRouterView(view);\n  return view as JSX.Element;\n}\n","import { $emptyFn, buildQuery, normalizePath, parseQuery, emplaceParams } from '@ktjs/shared';\n\nimport type { Router, RouterConfig, RouteContext, NavOptions, RawRouteConfig, RouteConfig } from '../types/router.js';\nimport { GuardLevel } from './consts.js';\nimport { createMatcher } from './matcher.js';\n\n/**\n * Create a new router instance\n */\nexport const createRouter = ({\n  beforeEach = $emptyFn,\n  afterEach = $emptyFn,\n  onNotFound = $emptyFn,\n  onError = $emptyFn,\n  prefix = '',\n  routes: rawRoutes,\n}: RouterConfig): Router => {\n  // # private values\n  const routes: RouteConfig[] = [];\n  const history: RouteContext[] = [];\n  let routerView: HTMLElement | null = null;\n  let current: RouteContext | null = null;\n\n  // # methods\n  const normalize = (rawRoutes: RawRouteConfig[], parentPath: string): RouteConfig[] =>\n    rawRoutes.map((route) => {\n      const path = normalizePath(parentPath, route.path);\n      const normalized = {\n        path: prefix + path,\n        name: route.name ?? '',\n        meta: route.meta ?? {},\n        beforeEnter: route.beforeEnter ?? $emptyFn,\n        after: route.after ?? $emptyFn,\n        children: route.children ? normalize(route.children, path) : [],\n        component: route.component,\n      };\n\n      // directly push the normalized route to the list\n      // avoid flatten them again\n      routes.push(normalized);\n      return normalized;\n    });\n\n  const guard = async (\n    to: RouteContext,\n    from: RouteContext | null,\n    guardLevel: GuardLevel,\n  ): Promise<{ continue: boolean; redirectTo?: NavOptions }> => {\n    try {\n      if (guardLevel === GuardLevel.None) {\n        return { continue: true };\n      }\n\n      if (guardLevel & GuardLevel.Global) {\n        const result = await beforeEach(to, from);\n        if (result === false) {\n          return { continue: false };\n        }\n        if (typeof result === 'string') {\n          return { continue: false, redirectTo: { path: result } };\n        }\n        if (result && typeof result === 'object') {\n          return { continue: false, redirectTo: result };\n        }\n      }\n\n      if (guardLevel & GuardLevel.Route) {\n        const targetRoute = to.matched[to.matched.length - 1];\n        const result = await targetRoute.beforeEnter(to);\n        if (result === false) {\n          return { continue: false };\n        }\n        if (typeof result === 'string') {\n          return { continue: false, redirectTo: { path: result } };\n        }\n        if (result && typeof result === 'object') {\n          return { continue: false, redirectTo: result };\n        }\n      }\n\n      return { continue: true };\n    } catch (error) {\n      onError(error as Error);\n      return { continue: false };\n    }\n  };\n\n  const navigatePrepare = (options: NavOptions) => {\n    // Resolve target route\n    let targetPath: string;\n    let targetRoute;\n\n    if (options.name) {\n      targetRoute = findByName(options.name);\n      if (!targetRoute) {\n        $throw(`Route not found: ${options.name}`);\n      }\n      targetPath = targetRoute.path;\n    } else if (options.path) {\n      targetPath = normalizePath(options.path);\n      targetRoute = match(targetPath)?.route;\n    } else {\n      $throw(`Either path or name must be provided`);\n    }\n\n    // Substitute params\n    if (options.params) {\n      targetPath = emplaceParams(targetPath, options.params);\n    }\n\n    // Match final path\n    const matched = match(targetPath);\n    if (!matched) {\n      onNotFound(targetPath);\n      return null;\n    }\n\n    // Build route context\n    const queryString = options.query ? buildQuery(options.query) : '';\n    const fullPath = targetPath + queryString;\n\n    const to: RouteContext = {\n      path: targetPath,\n      name: matched.route.name,\n      params: { ...matched.params, ...(options.params ?? {}) },\n      query: options.query ?? {},\n      meta: matched.route.meta ?? {},\n      matched: matched.result,\n    };\n\n    return {\n      guardLevel: options.guardLevel ?? GuardLevel.Default,\n      replace: options.replace ?? false,\n      to,\n      fullPath,\n    };\n  };\n\n  const navigate = async (options: NavOptions, redirectCount = 0): Promise<boolean> => {\n    try {\n      // Prevent infinite redirect loop\n      if (redirectCount > 10) {\n        onError(new Error('Maximum redirect count exceeded'));\n        return false;\n      }\n\n      const prep = navigatePrepare(options);\n      if (!prep) {\n        return false;\n      }\n\n      const { guardLevel, replace, to, fullPath } = prep;\n\n      const guardResult = await guard(to, current, guardLevel);\n      if (!guardResult.continue) {\n        // Check if there's a redirect\n        if (guardResult.redirectTo) {\n          return await navigate(guardResult.redirectTo, redirectCount + 1);\n        }\n        return false;\n      }\n\n      // ---- Guards passed ----\n\n      const hashUrl = '#' + fullPath;\n      if (replace) {\n        window.location.replace(hashUrl);\n      } else {\n        window.location.hash = fullPath;\n      }\n\n      current = to;\n      if (replace) {\n        if (history.length > 0) {\n          history[history.length - 1] = to;\n        } else {\n          history.push(to);\n        }\n      } else {\n        history.push(to);\n      }\n\n      // Render component if routerView exists\n      if (routerView && to.matched.length > 0) {\n        const route = to.matched[to.matched.length - 1];\n        if (route.component) {\n          const element = await route.component();\n          routerView.innerHTML = '';\n          routerView.appendChild(element);\n        }\n      }\n\n      executeAfterHooks(to, history[history.length - 2] ?? null);\n      return true;\n    } catch (error) {\n      onError(error as Error);\n      return false;\n    }\n  };\n\n  const executeAfterHooks = async (to: RouteContext, from: RouteContext | null): Promise<void> => {\n    const targetRoute = to.matched[to.matched.length - 1];\n    await targetRoute.after(to);\n    await afterEach(to, from);\n  };\n\n  /**\n   * Normalize navigation argument\n   */\n  const normalizeLocation = (loc: string | NavOptions): NavOptions => {\n    if (typeof loc !== 'string') {\n      return loc;\n    }\n\n    const [path, queryString] = loc.split('?');\n    return {\n      path,\n      query: queryString ? parseQuery(queryString) : undefined,\n    };\n  };\n\n  // # register events\n  window.addEventListener('hashchange', () => {\n    const hash = window.location.hash.slice(1);\n    const [path] = hash.split('?');\n    const normalizedPath = normalizePath(path);\n    if (current && current.path === normalizedPath) {\n      return;\n    }\n    // render route for new hash without adding extra history entry\n    const matched = match(normalizedPath);\n    if (!matched) {\n      onNotFound(normalizedPath);\n      return;\n    }\n    const queryString = window.location.hash.slice(1).split('?')[1];\n    const to: RouteContext = {\n      path: normalizedPath,\n      name: matched.route.name,\n      params: matched.params,\n      query: queryString ? parseQuery(queryString) : {},\n      meta: matched.route.meta ?? {},\n      matched: matched.result,\n    };\n\n    // apply without modifying browser history\n    current = to;\n    history.push(to);\n\n    if (routerView && to.matched.length > 0) {\n      const route = to.matched[to.matched.length - 1];\n      if (route.component) {\n        const element = route.component();\n        if (element instanceof Promise) {\n          element.then((el) => {\n            routerView!.innerHTML = '';\n            routerView!.appendChild(el);\n          });\n        } else {\n          routerView.innerHTML = '';\n          routerView.appendChild(element);\n        }\n      }\n    }\n\n    executeAfterHooks(to, history[history.length - 2] ?? null);\n  });\n\n  // # initialize\n  const instance: Router = {\n    get current() {\n      return current;\n    },\n\n    get history() {\n      return history.concat();\n    },\n\n    setRouterView(view: HTMLElement) {\n      routerView = view;\n    },\n\n    push(location: string | NavOptions): boolean | Promise<boolean> {\n      const options = normalizeLocation(location);\n      return navigate(options);\n    },\n\n    silentPush(location: string | NavOptions): boolean | Promise<boolean> {\n      const options = normalizeLocation(location);\n      return navigate({ ...options, guardLevel: GuardLevel.Route });\n    },\n\n    replace(location: string | NavOptions): boolean | Promise<boolean> {\n      const options = normalizeLocation(location);\n      return navigate({ ...options, replace: true });\n    },\n\n    back() {\n      window.history.back();\n    },\n\n    forward() {\n      window.history.forward();\n    },\n  };\n  normalize(rawRoutes, '/');\n  const { findByName, match } = createMatcher(routes);\n  const currentHash = window.location.hash.slice(1);\n  if (currentHash) {\n    instance.push(currentHash);\n  }\n\n  return instance;\n};\n\nexport { GuardLevel };\nexport { KTRouter } from './kt-router.js';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@ktjs/router",
-  "version": "0.19.0",
+  "version": "0.31.9",
   "description": "Router for kt.js - client-side routing with navigation guards",
+  "description_zh": "kt.js 的路由库，支持前端路由与导航守卫。",
   "type": "module",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -31,11 +32,12 @@
     "directory": "packages/router"
   },
   "dependencies": {
-    "@ktjs/core": "0.19.0",
-    "@ktjs/shared": "0.19.0"
+    "@ktjs/core": "^*",
+    "@ktjs/shared": "^*"
   },
   "scripts": {
     "build": "rollup -c rollup.config.mjs",
-    "dev": "rollup -c rollup.config.mjs -w"
+    "dev": "rollup -c rollup.config.mjs -w",
+    "test": "vitest run"
   }
 }

package/dist/index.iife.js

@@ -1,447 +0,0 @@
-var __ktjs_router__ = (function (exports) {
-    'use strict';
-
-    // Cached native methods for performance optimization
-
-    // Error handling utilities
-    const $throw = (message) => {
-        throw new Error('@ktjs/shared: ' + message);
-    };
-
-    // String manipulation utilities
-    /**
-     * Default empty function
-     */
-    const $emptyFn = (() => true);
-
-    /**
-     * Normalize path by joining parts and ensuring leading slash
-     */
-    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;
-    };
-
-    // Shared utilities and cached native methods for kt.js framework
-    // Re-export all utilities
-    Object.defineProperty(window, '@ktjs/shared', { value: '0.19.0' });
-
-    /**
-     * 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) {
-                    $throw(`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 router view container that automatically renders route components
-     */
-    function KTRouter({ router }) {
-        const view = document.createElement('kt-router-view');
-        router.setRouterView(view);
-        return view;
-    }
-
-    /**
-     * Create a new router instance
-     */
-    const createRouter = ({ beforeEach = $emptyFn, afterEach = $emptyFn, onNotFound = $emptyFn, onError = $emptyFn, prefix = '', routes: rawRoutes, }) => {
-        // # private values
-        const routes = [];
-        const history = [];
-        let routerView = null;
-        let current = null;
-        // # methods
-        const normalize = (rawRoutes, parentPath) => rawRoutes.map((route) => {
-            const path = normalizePath(parentPath, route.path);
-            const normalized = {
-                path: prefix + path,
-                name: route.name ?? '',
-                meta: route.meta ?? {},
-                beforeEnter: route.beforeEnter ?? $emptyFn,
-                after: route.after ?? $emptyFn,
-                children: route.children ? normalize(route.children, path) : [],
-                component: route.component,
-            };
-            // directly push the normalized route to the list
-            // avoid flatten them again
-            routes.push(normalized);
-            return normalized;
-        });
-        const guard = async (to, from, guardLevel) => {
-            try {
-                if (guardLevel === 0 /* GuardLevel.None */) {
-                    return { continue: true };
-                }
-                if (guardLevel & 1 /* GuardLevel.Global */) {
-                    const result = await beforeEach(to, from);
-                    if (result === false) {
-                        return { continue: false };
-                    }
-                    if (typeof result === 'string') {
-                        return { continue: false, redirectTo: { path: result } };
-                    }
-                    if (result && typeof result === 'object') {
-                        return { continue: false, redirectTo: result };
-                    }
-                }
-                if (guardLevel & 2 /* GuardLevel.Route */) {
-                    const targetRoute = to.matched[to.matched.length - 1];
-                    const result = await targetRoute.beforeEnter(to);
-                    if (result === false) {
-                        return { continue: false };
-                    }
-                    if (typeof result === 'string') {
-                        return { continue: false, redirectTo: { path: result } };
-                    }
-                    if (result && typeof result === 'object') {
-                        return { continue: false, redirectTo: result };
-                    }
-                }
-                return { continue: true };
-            }
-            catch (error) {
-                onError(error);
-                return { continue: false };
-            }
-        };
-        const navigatePrepare = (options) => {
-            // Resolve target route
-            let targetPath;
-            let targetRoute;
-            if (options.name) {
-                targetRoute = findByName(options.name);
-                if (!targetRoute) {
-                    $throw(`Route not found: ${options.name}`);
-                }
-                targetPath = targetRoute.path;
-            }
-            else if (options.path) {
-                targetPath = normalizePath(options.path);
-                targetRoute = match(targetPath)?.route;
-            }
-            else {
-                $throw(`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 navigate = async (options, redirectCount = 0) => {
-            try {
-                // Prevent infinite redirect loop
-                if (redirectCount > 10) {
-                    onError(new Error('Maximum redirect count exceeded'));
-                    return false;
-                }
-                const prep = navigatePrepare(options);
-                if (!prep) {
-                    return false;
-                }
-                const { guardLevel, replace, to, fullPath } = prep;
-                const guardResult = await guard(to, current, guardLevel);
-                if (!guardResult.continue) {
-                    // Check if there's a redirect
-                    if (guardResult.redirectTo) {
-                        return await navigate(guardResult.redirectTo, redirectCount + 1);
-                    }
-                    return false;
-                }
-                // ---- Guards passed ----
-                const hashUrl = '#' + fullPath;
-                if (replace) {
-                    window.location.replace(hashUrl);
-                }
-                else {
-                    window.location.hash = fullPath;
-                }
-                current = to;
-                if (replace) {
-                    if (history.length > 0) {
-                        history[history.length - 1] = to;
-                    }
-                    else {
-                        history.push(to);
-                    }
-                }
-                else {
-                    history.push(to);
-                }
-                // Render component if routerView exists
-                if (routerView && to.matched.length > 0) {
-                    const route = to.matched[to.matched.length - 1];
-                    if (route.component) {
-                        const element = await route.component();
-                        routerView.innerHTML = '';
-                        routerView.appendChild(element);
-                    }
-                }
-                executeAfterHooks(to, history[history.length - 2] ?? null);
-                return true;
-            }
-            catch (error) {
-                onError(error);
-                return false;
-            }
-        };
-        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') {
-                return loc;
-            }
-            const [path, queryString] = loc.split('?');
-            return {
-                path,
-                query: queryString ? parseQuery(queryString) : undefined,
-            };
-        };
-        // # register events
-        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 {
-                        routerView.innerHTML = '';
-                        routerView.appendChild(element);
-                    }
-                }
-            }
-            executeAfterHooks(to, history[history.length - 2] ?? null);
-        });
-        // # initialize
-        const instance = {
-            get current() {
-                return current;
-            },
-            get history() {
-                return history.concat();
-            },
-            setRouterView(view) {
-                routerView = view;
-            },
-            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();
-            },
-        };
-        normalize(rawRoutes, '/');
-        const { findByName, match } = createMatcher(routes);
-        const currentHash = window.location.hash.slice(1);
-        if (currentHash) {
-            instance.push(currentHash);
-        }
-        return instance;
-    };
-
-    exports.KTRouter = KTRouter;
-    exports.createRouter = createRouter;
-
-    return exports;
-
-})({});