@ktjs/router 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kasukabe tsumugi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,242 @@
+# @ktjs/router
+
+<img src="https://raw.githubusercontent.com/baendlorel/kt.js/dev/.assets/ktjs-0.0.1.svg" alt="KT.js Logo" width="150"/>
+
+> 📦 Part of [KT.js](https://raw.githubusercontent.com/baendlorel/kt.js/dev/README.md) - A simple and easy-to-use web framework that never re-renders.
+
+Client-side router with navigation guards for KT.js.
+
+## Overview
+
+`@ktjs/router` is a lightweight, hash-based client-side router with powerful navigation guards and async/sync auto-adaptation. It provides all the essential routing features you need without the bloat.
+
+## Features
+
+- **Hash-Based Routing**: Uses URL hash for client-side navigation (`#/path`)
+- **Path Matching**: Static and dynamic route matching with parameter extraction
+  - Dynamic segments: `/user/:id`
+  - Wildcard matching support
+  - Optimized matching algorithm with pre-flattened routes
+- **Navigation Guards**: Control navigation flow with powerful guard system
+  - `beforeEach`: Global guard before every navigation
+  - `beforeEnter`: Per-route guard for specific routes
+  - `afterEach`: Global hook after successful navigation
+  - Guard-level control with bitwise operations for fine-grained execution
+- **Async/Sync Support**: Automatically adapts to environment
+  - Uses async guards when `Promise` is available
+  - Falls back to synchronous mode in older browsers
+  - No configuration needed - it just works
+- **Named Routes**: Navigate using route names instead of paths
+- **Query Parameters**: Built-in query string parsing and handling
+- **Route Context**: Access route information in handlers
+  - Current route path and name
+  - Dynamic parameters (`params`)
+  - Query string parameters (`query`)
+- **Error Handling**: Comprehensive error handling with `onError` callback
+- **Type-Safe**: Full TypeScript support with intelligent type inference
+- **Zero Dependencies**: Fully self-contained implementation (does **not** require `@ktjs/core` for runtime, only for TypeScript types)
+- **ES5 Compatible**: Works in IE9+ and all modern browsers
+
+## Installation
+
+```bash
+pnpm add @ktjs/router @ktjs/core
+```
+
+## Basic Usage
+
+```typescript
+import { createRouter } from '@ktjs/router';
+import { div, h1 } from '@ktjs/core';
+
+const router = createRouter({
+  routes: [
+    {
+      path: '/',
+      name: 'home',
+      beforeEnter: (to) => {
+        // Render your home page
+        const app = document.getElementById('app')!;
+        app.innerHTML = '';
+        app.appendChild(div({}, [h1({}, 'Home Page')]));
+      },
+    },
+    {
+      path: '/about',
+      name: 'about',
+      beforeEnter: (to) => {
+        // Render your about page
+        const app = document.getElementById('app')!;
+        app.innerHTML = '';
+        app.appendChild(div({}, [h1({}, 'About Page')]));
+      },
+    },
+    {
+      path: '/user/:id',
+      name: 'user',
+      beforeEnter: (to) => {
+        // Render user profile with params
+        const app = document.getElementById('app')!;
+        app.innerHTML = '';
+        app.appendChild(
+          div({}, [
+            h1({}, `User Profile`),
+            div({}, `User ID: ${to.params.id}`),
+            div({}, `Query: ${JSON.stringify(to.query)}`),
+          ])
+        );
+      },
+    },
+  ],
+});
+
+// Navigate programmatically
+router.push('/user/123?tab=profile');
+```
+
+## Advanced Usage
+
+### Navigation Guards
+
+```typescript
+import { createRouter, GuardLevel } from '@ktjs/router';
+
+const router = createRouter({
+  routes: [
+    {
+      path: '/admin',
+      name: 'admin',
+      beforeEnter: (to) => {
+        // Route-specific guard and rendering
+        if (!isAuthenticated()) {
+          console.log('Access denied');
+          return false; // Block navigation
+        }
+
+        // Render admin panel
+        const app = document.getElementById('app')!;
+        app.innerHTML = '';
+        app.appendChild(div({}, 'Admin Panel'));
+        return true;
+      },
+      after: (to) => {
+        // Called after this route is successfully entered
+        console.log('Admin page rendered');
+      },
+    },
+  ],
+  beforeEach: async (to, from) => {
+    // Global guard - can be async
+    console.log(`Navigating from ${from?.path} to ${to.path}`);
+
+    // You can return false to block navigation
+    if (to.path.includes('forbidden')) {
+      return false;
+    }
+
+    // Or return true to allow
+    return true;
+  },
+  afterEach: (to, from) => {
+    // Called after successful navigation
+    document.title = to.name || to.path;
+
+    // Track page views
+    analytics.track('pageview', { path: to.path });
+  },
+  onError: (error) => {
+    console.error('Navigation error:', error);
+  },
+  onNotFound: (path) => {
+    console.log('404:', path);
+    // You can render a 404 page here
+  },
+});
+```
+
+### Named Route Navigation
+
+```typescript
+// Navigate by route name with parameters
+router.push({
+  name: 'user',
+  params: { id: '456' },
+  query: { tab: 'settings' },
+});
+
+// Equivalent to: router.push('/user/456?tab=settings');
+```
+
+### Accessing Current Route
+
+```typescript
+const current = router.current;
+
+if (current) {
+  console.log('Path:', current.path); // e.g., '/user/123'
+  console.log('Name:', current.name); // e.g., 'user'
+  console.log('Params:', current.params); // e.g., { id: '123' }
+  console.log('Query:', current.query); // e.g., { tab: 'profile' }
+}
+```
+
+## API Reference
+
+### `createRouter(config)`
+
+Creates and returns a router instance.
+
+**Config Options:**
+
+- `routes` (Array): Array of route configurations
+  - `path` (string): Route path with optional dynamic segments (`:param`)
+  - `name` (string, optional): Route name for named navigation
+  - `meta` (object, optional): Metadata attached to the route
+  - `beforeEnter` (function, optional): Route-specific guard, receives `(to: RouteContext) => boolean | void | Promise<boolean | void>`
+  - `after` (function, optional): Route-specific hook after navigation
+  - `children` (array, optional): Nested child routes
+- `beforeEach` (function, optional): Global guard before every navigation, receives `(to: RouteContext, from: RouteContext | null)`
+- `afterEach` (function, optional): Global hook after successful navigation, receives `(to: RouteContext, from: RouteContext | null)`
+- `onNotFound` (function, optional): Handler for 404 errors, receives `(path: string)`
+- `onError` (function, optional): Error handler for navigation failures, receives `(error: Error, route?: RouteConfig)`
+- `asyncGuards` (boolean, optional): Enable async guards (default: `true`)
+
+**Router Instance Properties:**
+
+- `current` (property): Current active route context (or `null`)
+- `history` (property): Array of navigation history
+
+**Router Instance Methods:**
+
+- `push(location)`: Navigate to a new location (string path or route object)
+- `silentPush(location)`: Navigate without global guards (`beforeEach` guards)
+- `replace(location)`: Replace current history entry
+- `back()`: Navigate back in history
+- `forward()`: Navigate forward in history
+
+### Route Context
+
+Guards and hooks receive a `RouteContext` object with:
+
+- `params`: Object containing dynamic route parameters
+- `query`: Object containing query string parameters
+- `path`: Current route path
+- `name`: Current route name (if defined)
+
+## Performance Optimizations
+
+The router includes several performance optimizations:
+
+- **Pre-flattened Routes**: Nested routes are flattened during initialization
+- **Efficient Matching**: Optimized regex-based path matching
+- **Cached Methods**: Native DOM methods are cached
+- **Minimal Re-renders**: Only updates DOM when route actually changes
+- **Guard Level Control**: Fine-grained control over guard execution using bitwise operations
+
+## Browser Compatibility
+
+Works in all modern browsers and IE9+ with ES5 transpilation. In environments without `Promise` support, navigation guards run synchronously.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Guard level that determines which guards to apply during navigation
+ * - there are global and route-level guards
+ */
+declare const enum GuardLevel {
+    /**
+     * Ignores all guards
+     */
+    None = 0,
+    /**
+     * Only applies global guards
+     */
+    Global = 1,
+    /**
+     * Only applies guards of routes(`beforeEnter` guards)
+     */
+    Route = 2,
+    /**
+     * Applies all guards
+     */
+    Default = 15
+}
+
+/**
+ * Route configuration for defining application routes
+ */
+interface RawRouteConfig {
+  /** Route path pattern (e.g., '/user/:id') */
+  path: string;
+  /** Optional unique route name for named navigation */
+  name?: string;
+  /** Optional metadata attached to the route */
+  meta?: Record<string, any>;
+  /** Route-level guard executed before entering this route */
+  beforeEnter?: (context: RouteContext) => boolean | void | Promise<boolean | void>;
+  /** Route-level hook executed after navigation */
+  after?: (context: RouteContext) => void | Promise<void>;
+  /** Nested child routes */
+  children?: RawRouteConfig[];
+}
+
+type RouteConfig = Required<Omit<RawRouteConfig, 'children'>> & { children: RouteConfig[] };
+
+/**
+ * Current route context information
+ */
+interface RouteContext {
+  /** Full matched path */
+  path: string;
+
+  /** Route name if defined */
+  name: string;
+
+  /** Dynamic parameters extracted from path */
+  params: Record<string, string>;
+
+  /** Query string parameters */
+  query: Record<string, string>;
+
+  /** Route metadata */
+  meta: Record<string, any>;
+
+  /** Array of matched route configs (for nested routes) */
+  matched: RouteConfig[];
+}
+
+/**
+ * Base navigation options containing target information
+ */
+interface NavBaseOptions {
+  /** Target path (alternative to name) */
+  path?: string;
+
+  /** Target route name (alternative to path) */
+  name?: string;
+
+  /** Parameters to substitute in path */
+  params?: Record<string, string>;
+
+  /** Query parameters to append */
+  query?: Record<string, string>;
+}
+
+/**
+ * Complete navigation options including control flags
+ */
+interface NavOptions extends NavBaseOptions {
+  guardLevel?: GuardLevel;
+  replace?: boolean;
+}
+
+/**
+ * Router configuration
+ */
+interface RouterConfig {
+  /** Array of route definitions */
+  routes: RawRouteConfig[];
+
+  /** Global guard executed before each navigation (except silentPush) */
+  beforeEach?: (to: RouteContext, from: RouteContext | null) => boolean | void | Promise<boolean | void>;
+
+  /** Global hook executed after each navigation */
+  afterEach?: (to: RouteContext, from: RouteContext | null) => void | Promise<void>;
+
+  /** Handler for 404 errors - return false to prevent default behavior */
+  onNotFound?: (path: string) => void | false;
+
+  /** Handler for routing errors */
+  onError?: (error: Error, route?: RouteConfig) => void;
+
+  // # options
+  /**
+   * Default is `true`
+   */
+  asyncGuards?: boolean;
+}
+
+/**
+ * Router instance
+ */
+interface Router {
+  /** Current active route context */
+  current: RouteContext | null;
+
+  /** Navigation history */
+  history: RouteContext[];
+
+  /** Navigate with guards */
+  push(location: string | NavOptions): boolean | Promise<boolean>;
+
+  /** Navigate without global guards(`beforeEach` guards) */
+  silentPush(location: string | NavOptions): boolean | Promise<boolean>;
+
+  /** Replace current history entry */
+  replace(location: string | NavOptions): boolean | Promise<boolean>;
+
+  /** Navigate back in history */
+  back(): void;
+
+  /** Navigate forward in history */
+  forward(): void;
+}
+
+interface RouteMatch {
+  route: RouteConfig;
+  params: Record<string, string>;
+  result: RouteConfig[];
+}
+
+/**
+ * Create a new router instance
+ */
+declare const createRouter: (config: RouterConfig) => Router;
+
+export { GuardLevel, createRouter };
+export type { NavOptions, RawRouteConfig, RouteConfig, RouteContext, RouteMatch, Router, RouterConfig };

package/dist/index.iife.js

@@ -0,0 +1 @@
+var __ktjs_router__=function(t){"use strict";const r=()=>!0,e=t=>{throw new Error(`@ktjs/router: ${t}`)},n=(...t)=>"/"+t.map(t=>t.split("/")).flat().filter(Boolean).join("/"),o=t=>{const r={};if(!t||"?"===t)return r;const e=t.replace(/^\?/,"").split("&");for(const t of e){const[e,n]=t.split("=");e&&(r[decodeURIComponent(e)]=n?decodeURIComponent(n):"")}return r},u=(t,r)=>{const e={},n=t.split("/"),o=r.split("/");if(n.length!==o.length)return null;for(let t=0;t<n.length;t++){const r=n[t],u=o[t];if(r.startsWith(":")){e[r.slice(1)]=u}else if(r!==u)return null}return e};return t.createRouter=t=>{const c=t.beforeEach??r,a=t.afterEach??r,s=t.onNotFound??r,i=t.onError??r,l=t.asyncGuards??!0,f=[],d=(t,e)=>t.map(t=>{const o=n(e,t.path),u={path:o,name:t.name??"",meta:t.meta??{},beforeEnter:t.beforeEnter??r,after:t.after??r,children:t.children?d(t.children,o):[]};return f.push(u),u});d(t.routes,"/");const{findByName:p,match:h}=(t=>{const r={};for(let n=0;n<t.length;n++){const o=t[n];void 0!==o.name&&(o.name in r&&e(`Duplicate route name detected: '${o.name}'`),r[o.name]=o)}const o=r=>{const e=[r],n=r.path;for(let o=0;o<t.length;o++){const u=t[o];u!==r&&n.startsWith(u.path)&&n!==u.path&&e.push(u)}return e.reverse()};return{findByName:t=>r[t]??null,match:r=>{const e=n(r);for(const r of t)if(r.path===e)return{route:r,params:{},result:o(r)};for(const r of t)if(r.path.includes(":")){const t=u(r.path,e);if(t)return{route:r,params:t,result:o(r)}}return null}}})(f);let w=null;const m=[],y=t=>{let r,o;t.name?(o=p(t.name),o||e(`Route not found: ${t.name}`),r=o.path):t.path?(r=n(t.path),o=h(r)?.route):e("Either path or name must be provided"),t.params&&(r=((t,r)=>{let e=t;for(const t in r)e=e.replace(`:${t}`,r[t]);return e})(r,t.params));const u=h(r);if(!u)return s(r),null;const c=r+(t.query?(t=>{const r=Object.keys(t);return 0===r.length?"":`?${r.map(r=>`${encodeURIComponent(r)}=${encodeURIComponent(t[r])}`).join("&")}`})(t.query):""),a={path:r,name:u.route.name,params:{...u.params,...t.params||{}},query:t.query||{},meta:u.route.meta||{},matched:u.result};return{guardLevel:t.guardLevel??15,replace:t.replace??!1,to:a,fullPath:c}},v=l?t=>{try{const r=y(t);if(!r)return!1;const{guardLevel:e,replace:n,to:o,fullPath:u}=r;if(!((t,r,e)=>{try{if(0===e)return!0;if(1&e&&!1===c(t,r))return!1;if(2&e){if(!1===t.matched[t.matched.length-1].beforeEnter(t))return!1}return!0}catch(t){return i(t),!1}})(o,w,e))return!1;const a=u;return n?window.history.replaceState({path:o.path},"",a):window.history.pushState({path:o.path},"",a),w=o,m.push(o),g(o,m[m.length-2]||null),!0}catch(t){return i(t),!1}}:async t=>{try{const r=y(t);if(!r)return!1;const{guardLevel:e,replace:n,to:o,fullPath:u}=r,a=await(async(t,r,e)=>{try{if(0===e)return!0;if(1&e&&!1===await c(t,r))return!1;if(2&e){return!1!==t.matched[t.matched.length-1].beforeEnter(t)}return!0}catch(t){return i(t),!1}})(o,w,e);if(!a)return!1;const s=u;return n?window.history.replaceState({path:o.path},"",s):window.history.pushState({path:o.path},"",s),$(o,m[m.length-2]||null),!0}catch(t){return i(t),!1}},g=(t,r)=>{t.matched[t.matched.length-1].after(t),a(t,r)},$=async(t,r)=>{const e=t.matched[t.matched.length-1];await e.after(t),await a(t,r)},L=t=>{if("string"==typeof t){const[r,e]=t.split("?");return{path:r,query:e?o(e):void 0}}return t};return window.addEventListener("popstate",t=>{t.state?.path&&v({path:t.state.path,guardLevel:1,replace:!0})}),{get current(){return w},get history(){return m.concat()},push(t){const r=L(t);return v(r)},silentPush(t){const r=L(t);return v({...r,guardLevel:2})},replace(t){const r=L(t);return v({...r,replace:!0})},back(){window.history.back()},forward(){window.history.forward()}}},t}({});

package/dist/index.legacy.js

@@ -0,0 +1 @@
+var __ktjs_router__=function(r){"use strict";var n=function(){return n=Object.assign||function(r){for(var n,t=1,e=arguments.length;t<e;t++)for(var u in n=arguments[t])Object.prototype.hasOwnProperty.call(n,u)&&(r[u]=n[u]);return r},n.apply(this,arguments)};function t(r,n,t,e){return new(t||(t=Promise))(function(u,o){function i(r){try{c(e.next(r))}catch(r){o(r)}}function a(r){try{c(e.throw(r))}catch(r){o(r)}}function c(r){var n;r.done?u(r.value):(n=r.value,n instanceof t?n:new t(function(r){r(n)})).then(i,a)}c((e=e.apply(r,n||[])).next())})}function e(r,n){var t,e,u,o={label:0,sent:function(){if(1&u[0])throw u[1];return u[1]},trys:[],ops:[]},i=Object.create(("function"==typeof Iterator?Iterator:Object).prototype);return i.next=a(0),i.throw=a(1),i.return=a(2),"function"==typeof Symbol&&(i[Symbol.iterator]=function(){return this}),i;function a(a){return function(c){return function(a){if(t)throw new TypeError("Generator is already executing.");for(;i&&(i=0,a[0]&&(o=0)),o;)try{if(t=1,e&&(u=2&a[0]?e.return:a[0]?e.throw||((u=e.return)&&u.call(e),0):e.next)&&!(u=u.call(e,a[1])).done)return u;switch(e=0,u&&(a=[2&a[0],u.value]),a[0]){case 0:case 1:u=a;break;case 4:return o.label++,{value:a[1],done:!1};case 5:o.label++,e=a[1],a=[0];continue;case 7:a=o.ops.pop(),o.trys.pop();continue;default:if(!(u=o.trys,(u=u.length>0&&u[u.length-1])||6!==a[0]&&2!==a[0])){o=0;continue}if(3===a[0]&&(!u||a[1]>u[0]&&a[1]<u[3])){o.label=a[1];break}if(6===a[0]&&o.label<u[1]){o.label=u[1],u=a;break}if(u&&o.label<u[2]){o.label=u[2],o.ops.push(a);break}u[2]&&o.ops.pop(),o.trys.pop();continue}a=n.call(r,o)}catch(r){a=[6,r],e=0}finally{t=u=0}if(5&a[0])throw a[1];return{value:a[0]?a[1]:void 0,done:!0}}([a,c])}}}"function"==typeof SuppressedError&&SuppressedError;var u=function(){return!0},o=function(r){throw new Error("@ktjs/router: ".concat(r))},i=function(){for(var r=[],n=0;n<arguments.length;n++)r[n]=arguments[n];return"/"+r.map(function(r){return r.split("/")}).flat().filter(Boolean).join("/")},a=function(r){var n={};if(!r||"?"===r)return n;for(var t=0,e=r.replace(/^\?/,"").split("&");t<e.length;t++){var u=e[t].split("="),o=u[0],i=u[1];o&&(n[decodeURIComponent(o)]=i?decodeURIComponent(i):"")}return n},c=function(r,n){var t={},e=r.split("/"),u=n.split("/");if(e.length!==u.length)return null;for(var o=0;o<e.length;o++){var i=e[o],a=u[o];if(i.startsWith(":"))t[i.slice(1)]=a;else if(i!==a)return null}return t};return r.createRouter=function(r){var f,v,l,d,s,h=null!==(f=r.beforeEach)&&void 0!==f?f:u,p=null!==(v=r.afterEach)&&void 0!==v?v:u,w=null!==(l=r.onNotFound)&&void 0!==l?l:u,m=null!==(d=r.onError)&&void 0!==d?d:u,y=null===(s=r.asyncGuards)||void 0===s||s,b=[],g=function(r,n){return r.map(function(r){var t,e,o,a,c=i(n,r.path),f={path:c,name:null!==(t=r.name)&&void 0!==t?t:"",meta:null!==(e=r.meta)&&void 0!==e?e:{},beforeEnter:null!==(o=r.beforeEnter)&&void 0!==o?o:u,after:null!==(a=r.after)&&void 0!==a?a:u,children:r.children?g(r.children,c):[]};return b.push(f),f})};g(r.routes,"/");var j=function(r){for(var n={},t=0;t<r.length;t++){var e=r[t];void 0!==e.name&&(e.name in n&&o("Duplicate route name detected: '".concat(e.name,"'")),n[e.name]=e)}var u=function(n){for(var t=[n],e=n.path,u=0;u<r.length;u++){var o=r[u];o!==n&&e.startsWith(o.path)&&e!==o.path&&t.push(o)}return t.reverse()};return{findByName:function(r){var t;return null!==(t=n[r])&&void 0!==t?t:null},match:function(n){for(var t=i(n),e=0,o=r;e<o.length;e++)if((v=o[e]).path===t)return{route:v,params:{},result:u(v)};for(var a=0,f=r;a<f.length;a++){var v;if((v=f[a]).path.includes(":")){var l=c(v.path,t);if(l)return{route:v,params:l,result:u(v)}}}return null}}}(b),k=j.findByName,E=j.match,I=null,O=[],R=function(r,n,u){return t(void 0,void 0,void 0,function(){var t,o;return e(this,function(e){switch(e.label){case 0:return e.trys.push([0,3,,4]),0===u?[2,!0]:1&u?[4,h(r,n)]:[3,2];case 1:if(!1===e.sent())return[2,!1];e.label=2;case 2:return 2&u?(t=r.matched[r.matched.length-1],[2,!1!==t.beforeEnter(r)]):[2,!0];case 3:return o=e.sent(),m(o),[2,!1];case 4:return[2]}})})},_=function(r){var t,e,u,a,c;r.name?((c=k(r.name))||o("Route not found: ".concat(r.name)),a=c.path):r.path?(a=i(r.path),c=null===(t=E(a))||void 0===t?void 0:t.route):o("Either path or name must be provided"),r.params&&(a=function(r,n){var t=r;for(var e in n)t=t.replace(":".concat(e),n[e]);return t}(a,r.params));var f=E(a);if(!f)return w(a),null;var v=a+(r.query?function(r){var n=Object.keys(r);if(0===n.length)return"";var t=n.map(function(n){return"".concat(encodeURIComponent(n),"=").concat(encodeURIComponent(r[n]))}).join("&");return"?".concat(t)}(r.query):""),l={path:a,name:f.route.name,params:n(n({},f.params),r.params||{}),query:r.query||{},meta:f.route.meta||{},matched:f.result};return{guardLevel:null!==(e=r.guardLevel)&&void 0!==e?e:15,replace:null!==(u=r.replace)&&void 0!==u&&u,to:l,fullPath:v}},C=y?function(r){try{var n=_(r);if(!n)return!1;var t=n.guardLevel,e=n.replace,u=n.to,o=n.fullPath;if(!function(r,n,t){try{return 0===t||!(1&t&&!1===h(r,n))&&!(2&t&&!1===r.matched[r.matched.length-1].beforeEnter(r))}catch(r){return m(r),!1}}(u,I,t))return!1;var i=o;return e?window.history.replaceState({path:u.path},"",i):window.history.pushState({path:u.path},"",i),I=u,O.push(u),S(u,O[O.length-2]||null),!0}catch(r){return m(r),!1}}:function(r){return t(void 0,void 0,void 0,function(){var n,t,u,o,i,a,c;return e(this,function(e){switch(e.label){case 0:return e.trys.push([0,2,,3]),(n=_(r))?(t=n.guardLevel,u=n.replace,o=n.to,i=n.fullPath,[4,R(o,I,t)]):[2,!1];case 1:return e.sent()?(a=i,u?window.history.replaceState({path:o.path},"",a):window.history.pushState({path:o.path},"",a),U(o,O[O.length-2]||null),[2,!0]):[2,!1];case 2:return c=e.sent(),m(c),[2,!1];case 3:return[2]}})})},S=function(r,n){r.matched[r.matched.length-1].after(r),p(r,n)},U=function(r,n){return t(void 0,void 0,void 0,function(){return e(this,function(t){switch(t.label){case 0:return[4,r.matched[r.matched.length-1].after(r)];case 1:return t.sent(),[4,p(r,n)];case 2:return t.sent(),[2]}})})},L=function(r){if("string"==typeof r){var n=r.split("?"),t=n[0],e=n[1];return{path:t,query:e?a(e):void 0}}return r};return window.addEventListener("popstate",function(r){var n;(null===(n=r.state)||void 0===n?void 0:n.path)&&C({path:r.state.path,guardLevel:1,replace:!0})}),{get current(){return I},get history(){return O.concat()},push:function(r){var n=L(r);return C(n)},silentPush:function(r){var t=L(r);return C(n(n({},t),{guardLevel:2}))},replace:function(r){var t=L(r);return C(n(n({},t),{replace:!0}))},back:function(){window.history.back()},forward:function(){window.history.forward()}}},r}({});

package/dist/index.mjs

@@ -0,0 +1 @@
+const t=()=>!0,r=t=>{throw new Error(`@ktjs/router: ${t}`)},e=(...t)=>"/"+t.map(t=>t.split("/")).flat().filter(Boolean).join("/"),n=t=>{const r={};if(!t||"?"===t)return r;const e=t.replace(/^\?/,"").split("&");for(const t of e){const[e,n]=t.split("=");e&&(r[decodeURIComponent(e)]=n?decodeURIComponent(n):"")}return r},o=(t,r)=>{const e={},n=t.split("/"),o=r.split("/");if(n.length!==o.length)return null;for(let t=0;t<n.length;t++){const r=n[t],u=o[t];if(r.startsWith(":")){e[r.slice(1)]=u}else if(r!==u)return null}return e},u=u=>{const c=u.beforeEach??t,a=u.afterEach??t,s=u.onNotFound??t,l=u.onError??t,i=u.asyncGuards??!0,f=[],d=(r,n)=>r.map(r=>{const o=e(n,r.path),u={path:o,name:r.name??"",meta:r.meta??{},beforeEnter:r.beforeEnter??t,after:r.after??t,children:r.children?d(r.children,o):[]};return f.push(u),u});d(u.routes,"/");const{findByName:p,match:h}=(t=>{const n={};for(let e=0;e<t.length;e++){const o=t[e];void 0!==o.name&&(o.name in n&&r(`Duplicate route name detected: '${o.name}'`),n[o.name]=o)}const u=r=>{const e=[r],n=r.path;for(let o=0;o<t.length;o++){const u=t[o];u!==r&&n.startsWith(u.path)&&n!==u.path&&e.push(u)}return e.reverse()};return{findByName:t=>n[t]??null,match:r=>{const n=e(r);for(const r of t)if(r.path===n)return{route:r,params:{},result:u(r)};for(const r of t)if(r.path.includes(":")){const t=o(r.path,n);if(t)return{route:r,params:t,result:u(r)}}return null}}})(f);let w=null;const m=[],y=t=>{let n,o;t.name?(o=p(t.name),o||r(`Route not found: ${t.name}`),n=o.path):t.path?(n=e(t.path),o=h(n)?.route):r("Either path or name must be provided"),t.params&&(n=((t,r)=>{let e=t;for(const t in r)e=e.replace(`:${t}`,r[t]);return e})(n,t.params));const u=h(n);if(!u)return s(n),null;const c=n+(t.query?(t=>{const r=Object.keys(t);return 0===r.length?"":`?${r.map(r=>`${encodeURIComponent(r)}=${encodeURIComponent(t[r])}`).join("&")}`})(t.query):""),a={path:n,name:u.route.name,params:{...u.params,...t.params||{}},query:t.query||{},meta:u.route.meta||{},matched:u.result};return{guardLevel:t.guardLevel??15,replace:t.replace??!1,to:a,fullPath:c}},g=i?t=>{try{const r=y(t);if(!r)return!1;const{guardLevel:e,replace:n,to:o,fullPath:u}=r;if(!((t,r,e)=>{try{if(0===e)return!0;if(1&e&&!1===c(t,r))return!1;if(2&e){if(!1===t.matched[t.matched.length-1].beforeEnter(t))return!1}return!0}catch(t){return l(t),!1}})(o,w,e))return!1;const a=u;return n?window.history.replaceState({path:o.path},"",a):window.history.pushState({path:o.path},"",a),w=o,m.push(o),v(o,m[m.length-2]||null),!0}catch(t){return l(t),!1}}:async t=>{try{const r=y(t);if(!r)return!1;const{guardLevel:e,replace:n,to:o,fullPath:u}=r,a=await(async(t,r,e)=>{try{if(0===e)return!0;if(1&e&&!1===await c(t,r))return!1;if(2&e){return!1!==t.matched[t.matched.length-1].beforeEnter(t)}return!0}catch(t){return l(t),!1}})(o,w,e);if(!a)return!1;const s=u;return n?window.history.replaceState({path:o.path},"",s):window.history.pushState({path:o.path},"",s),$(o,m[m.length-2]||null),!0}catch(t){return l(t),!1}},v=(t,r)=>{t.matched[t.matched.length-1].after(t),a(t,r)},$=async(t,r)=>{const e=t.matched[t.matched.length-1];await e.after(t),await a(t,r)},L=t=>{if("string"==typeof t){const[r,e]=t.split("?");return{path:r,query:e?n(e):void 0}}return t};return window.addEventListener("popstate",t=>{t.state?.path&&g({path:t.state.path,guardLevel:1,replace:!0})}),{get current(){return w},get history(){return m.concat()},push(t){const r=L(t);return g(r)},silentPush(t){const r=L(t);return g({...r,guardLevel:2})},replace(t){const r=L(t);return g({...r,replace:!0})},back(){window.history.back()},forward(){window.history.forward()}}};export{u as createRouter};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@ktjs/router",
+  "version": "0.5.0",
+  "description": "Router for kt.js - client-side routing with navigation guards",
+  "type": "module",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "import": "./dist/index.mjs",
+    "default": "./dist/index.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "router",
+    "routing",
+    "navigation",
+    "spa",
+    "web"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Kasukabe Tsumugi",
+    "email": "futami16237@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/baendlorel/kt.js",
+    "directory": "packages/router"
+  },
+  "dependencies": {
+    "@ktjs/core": "0.5.0"
+  },
+  "scripts": {
+    "build": "rollup -c rollup.config.mjs",
+    "dev": "rollup -c rollup.config.mjs -w"
+  }
+}