@ktjs/router 0.20.0 → 0.31.9

package/README.md

@@ -40,6 +40,14 @@ Client-side router with navigation guards for KT.js.
 
 ## Installation
 
+### Create a KT.js project
+
+```bash
+pnpm create kt.js my-app
+```
+
+### Add router to an existing project
+
 ```bash
 pnpm add @ktjs/router @ktjs/core
 ```

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { JSX } from '@ktjs/core/jsx-runtime';
+
 /**
  * Guard level that determines which guards to apply during navigation
  * - there are global and route-level guards

package/dist/index.mjs

@@ -1,93 +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);
-const { get: $buttonDisabledGetter, set: $buttonDisabledSetter } = Object.getOwnPropertyDescriptor(HTMLButtonElement.prototype, 'disabled');
-
-/**
- * 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.20.0' });
+import { normalizePath, extractParams, $emptyFn, parseQuery, emplaceParams, buildQuery } from '@ktjs/shared';
 
 /**
  * Route matcher for finding matching routes and extracting params
@@ -98,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;
         }
@@ -240,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;
         }
@@ -249,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) {
@@ -438,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.20.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.20.0",
-    "@ktjs/shared": "0.20.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,448 +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);
-    const { get: $buttonDisabledGetter, set: $buttonDisabledSetter } = Object.getOwnPropertyDescriptor(HTMLButtonElement.prototype, 'disabled');
-
-    /**
-     * 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.20.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;
-
-})({});

package/dist/index.legacy.js

@@ -1,576 +0,0 @@
-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 };
-        }
-    }
-
-    function __spreadArray(to, from, pack) {
-        if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-            if (ar || !(i in from)) {
-                if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-                ar[i] = from[i];
-            }
-        }
-        return to.concat(ar || Array.prototype.slice.call(from));
-    }
-
-    typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
-        var e = new Error(message);
-        return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
-    };
-
-    // 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);
-    const { get: $buttonDisabledGetter, set: $buttonDisabledSetter } = Object.getOwnPropertyDescriptor(HTMLButtonElement.prototype, 'disabled');
-
-    /**
-     * 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.20.0' });
-
-    /**
-     * 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) {
-                    $throw("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 router view container that automatically renders route components
-     */
-    function KTRouter(_a) {
-        var router = _a.router;
-        var view = document.createElement('kt-router-view');
-        router.setRouterView(view);
-        return view;
-    }
-
-    /**
-     * Create a new router instance
-     */
-    var createRouter = function (_a) {
-        var _b = _a.beforeEach, beforeEach = _b === void 0 ? $emptyFn : _b, _c = _a.afterEach, afterEach = _c === void 0 ? $emptyFn : _c, _d = _a.onNotFound, onNotFound = _d === void 0 ? $emptyFn : _d, _e = _a.onError, onError = _e === void 0 ? $emptyFn : _e, _f = _a.prefix, prefix = _f === void 0 ? '' : _f, rawRoutes = _a.routes;
-        // # private values
-        var routes = [];
-        var history = [];
-        var routerView = null;
-        var current = null;
-        // # methods
-        var normalize = function (rawRoutes, parentPath) {
-            return rawRoutes.map(function (route) {
-                var _a, _b, _c, _d;
-                var path = normalizePath(parentPath, route.path);
-                var normalized = {
-                    path: prefix + 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 : $emptyFn,
-                    after: (_d = route.after) !== null && _d !== void 0 ? _d : $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;
-            });
-        };
-        var guard = 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, 5, , 6]);
-                        if (guardLevel === 0 /* GuardLevel.None */) {
-                            return [2 /*return*/, { continue: 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*/, { continue: false }];
-                        }
-                        if (typeof result === 'string') {
-                            return [2 /*return*/, { continue: false, redirectTo: { path: result } }];
-                        }
-                        if (result && typeof result === 'object') {
-                            return [2 /*return*/, { continue: false, redirectTo: result }];
-                        }
-                        _a.label = 2;
-                    case 2:
-                        if (!(guardLevel & 2 /* GuardLevel.Route */)) return [3 /*break*/, 4];
-                        targetRoute = to.matched[to.matched.length - 1];
-                        return [4 /*yield*/, targetRoute.beforeEnter(to)];
-                    case 3:
-                        result = _a.sent();
-                        if (result === false) {
-                            return [2 /*return*/, { continue: false }];
-                        }
-                        if (typeof result === 'string') {
-                            return [2 /*return*/, { continue: false, redirectTo: { path: result } }];
-                        }
-                        if (result && typeof result === 'object') {
-                            return [2 /*return*/, { continue: false, redirectTo: result }];
-                        }
-                        _a.label = 4;
-                    case 4: return [2 /*return*/, { continue: true }];
-                    case 5:
-                        error_1 = _a.sent();
-                        onError(error_1);
-                        return [2 /*return*/, { continue: false }];
-                    case 6: 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) {
-                    $throw("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 {
-                $throw("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 navigate = function (options_1) {
-            var args_1 = [];
-            for (var _i = 1; _i < arguments.length; _i++) {
-                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, hashUrl, route, element, error_2;
-                var _a;
-                if (redirectCount === void 0) { redirectCount = 0; }
-                return __generator(this, function (_b) {
-                    switch (_b.label) {
-                        case 0:
-                            _b.trys.push([0, 7, , 8]);
-                            // Prevent infinite redirect loop
-                            if (redirectCount > 10) {
-                                onError(new Error('Maximum redirect count exceeded'));
-                                return [2 /*return*/, false];
-                            }
-                            prep = navigatePrepare(options);
-                            if (!prep) {
-                                return [2 /*return*/, false];
-                            }
-                            guardLevel = prep.guardLevel, replace = prep.replace, to = prep.to, fullPath = prep.fullPath;
-                            return [4 /*yield*/, guard(to, current, guardLevel)];
-                        case 1:
-                            guardResult = _b.sent();
-                            if (!!guardResult.continue) return [3 /*break*/, 4];
-                            if (!guardResult.redirectTo) return [3 /*break*/, 3];
-                            return [4 /*yield*/, navigate(guardResult.redirectTo, redirectCount + 1)];
-                        case 2: return [2 /*return*/, _b.sent()];
-                        case 3: return [2 /*return*/, false];
-                        case 4:
-                            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);
-                            }
-                            if (!(routerView && to.matched.length > 0)) return [3 /*break*/, 6];
-                            route = to.matched[to.matched.length - 1];
-                            if (!route.component) return [3 /*break*/, 6];
-                            return [4 /*yield*/, route.component()];
-                        case 5:
-                            element = _b.sent();
-                            routerView.innerHTML = '';
-                            routerView.appendChild(element);
-                            _b.label = 6;
-                        case 6:
-                            executeAfterHooks(to, (_a = history[history.length - 2]) !== null && _a !== void 0 ? _a : null);
-                            return [2 /*return*/, true];
-                        case 7:
-                            error_2 = _b.sent();
-                            onError(error_2);
-                            return [2 /*return*/, false];
-                        case 8: return [2 /*return*/];
-                    }
-                });
-            });
-        };
-        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') {
-                return loc;
-            }
-            var _a = loc.split('?'), path = _a[0], queryString = _a[1];
-            return {
-                path: path,
-                query: queryString ? parseQuery(queryString) : undefined,
-            };
-        };
-        // # register events
-        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 {
-                        routerView.innerHTML = '';
-                        routerView.appendChild(element);
-                    }
-                }
-            }
-            executeAfterHooks(to, (_b = history[history.length - 2]) !== null && _b !== void 0 ? _b : null);
-        });
-        // # initialize
-        var instance = {
-            get current() {
-                return current;
-            },
-            get history() {
-                return history.concat();
-            },
-            setRouterView: function (view) {
-                routerView = view;
-            },
-            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();
-            },
-        };
-        normalize(rawRoutes, '/');
-        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;
-    exports.createRouter = createRouter;
-
-    return exports;
-
-})({});