@fukict/router 0.1.0

package/dist/matcher.js

@@ -0,0 +1,213 @@
+/**
+ * 路由匹配器
+ */
+export class RouteMatcher {
+    /**
+     * 编译后的路由列表
+     */
+    compiledRoutes = [];
+    /**
+     * 原始路由配置（保留用于构建匹配链）
+     */
+    routes;
+    /**
+     * 构造函数
+     * @param routes 路由配置列表
+     * @param parentPath 父路径（用于嵌套路由）
+     */
+    constructor(routes, parentPath = '') {
+        this.routes = routes;
+        this.compile(routes, parentPath);
+    }
+    /**
+     * 编译路由配置
+     */
+    compile(routes, parentPath) {
+        for (const route of routes) {
+            const fullPath = this.normalizePath(parentPath + route.path);
+            const compiled = this.compileRoute(route, fullPath);
+            this.compiledRoutes.push(compiled);
+            // 递归编译子路由
+            if (route.children && route.children.length > 0) {
+                const childMatcher = new RouteMatcher(route.children, fullPath);
+                // 将子路由的编译结果合并到当前列表
+                this.compiledRoutes.push(...childMatcher.compiledRoutes);
+            }
+        }
+    }
+    /**
+     * 编译单个路由配置
+     */
+    compileRoute(config, fullPath) {
+        const segments = [];
+        const paramNames = [];
+        // 分割路径为段
+        const parts = fullPath.split('/').filter(part => part !== '');
+        for (const part of parts) {
+            if (part === '*') {
+                // 通配符
+                segments.push({ isDynamic: false, isWildcard: true });
+            }
+            else if (part.startsWith(':')) {
+                // 动态参数
+                const paramName = part.slice(1);
+                segments.push({ isDynamic: true, paramName, isWildcard: false });
+                paramNames.push(paramName);
+            }
+            else {
+                // 静态段
+                segments.push({ isDynamic: false, value: part, isWildcard: false });
+            }
+        }
+        // 构建正则表达式
+        const regex = this.buildRegex(segments);
+        return {
+            config,
+            segments,
+            regex,
+            paramNames,
+        };
+    }
+    /**
+     * 构建路由匹配的正则表达式
+     */
+    buildRegex(segments) {
+        if (segments.length === 0) {
+            // 根路径
+            return /^\/$/;
+        }
+        let pattern = '^';
+        for (const segment of segments) {
+            pattern += '\\/';
+            if (segment.isWildcard) {
+                // 通配符匹配任意内容
+                pattern += '.*';
+            }
+            else if (segment.isDynamic) {
+                // 动态参数匹配非 / 字符
+                pattern += '([^/]+)';
+            }
+            else {
+                // 静态段精确匹配
+                pattern += this.escapeRegex(segment.value);
+            }
+        }
+        // 如果最后一个段是通配符，不需要 $
+        const lastSegment = segments[segments.length - 1];
+        if (!lastSegment?.isWildcard) {
+            pattern += '\\/?$';
+        }
+        return new RegExp(pattern);
+    }
+    /**
+     * 转义正则表达式特殊字符
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    /**
+     * 规范化路径
+     */
+    normalizePath(path) {
+        // 确保路径以 / 开头
+        if (!path.startsWith('/')) {
+            path = '/' + path;
+        }
+        // 移除末尾的 /（除非是根路径）
+        if (path.length > 1 && path.endsWith('/')) {
+            path = path.slice(0, -1);
+        }
+        // 移除重复的 /
+        path = path.replace(/\/+/g, '/');
+        return path;
+    }
+    /**
+     * 匹配路径
+     * @param path 要匹配的路径
+     * @returns 匹配结果列表（从顶层到当前层级）
+     */
+    match(path) {
+        path = this.normalizePath(path);
+        for (const compiled of this.compiledRoutes) {
+            const match = compiled.regex.exec(path);
+            if (match) {
+                // 提取参数
+                const params = {};
+                for (let i = 0; i < compiled.paramNames.length; i++) {
+                    const paramName = compiled.paramNames[i];
+                    const paramValue = match[i + 1];
+                    params[paramName] = decodeURIComponent(paramValue);
+                }
+                // 构建匹配结果
+                const matches = this.buildMatchChain(compiled.config, path, params);
+                return matches;
+            }
+        }
+        return null;
+    }
+    /**
+     * 构建匹配链（从顶层到当前层级）
+     */
+    buildMatchChain(config, path, params) {
+        const matches = [];
+        // 递归查找父路由链
+        const findParentChain = (targetConfig, routes) => {
+            for (const route of routes) {
+                if (route === targetConfig) {
+                    return [route];
+                }
+                if (route.children && route.children.length > 0) {
+                    const childChain = findParentChain(targetConfig, route.children);
+                    if (childChain) {
+                        return [route, ...childChain];
+                    }
+                }
+            }
+            return null;
+        };
+        // 从根路由开始查找匹配链
+        const chain = findParentChain(config, this.routes);
+        if (chain) {
+            // 构建每个层级的 RouteMatch
+            for (const routeConfig of chain) {
+                matches.push({
+                    config: routeConfig,
+                    params,
+                    path,
+                });
+            }
+        }
+        else {
+            // 如果找不到完整链，至少返回当前匹配
+            matches.push({
+                config,
+                params,
+                path,
+            });
+        }
+        return matches;
+    }
+    /**
+     * 根据路由名称查找路由配置
+     */
+    findByName(name) {
+        for (const compiled of this.compiledRoutes) {
+            if (compiled.config.name === name) {
+                return compiled.config;
+            }
+        }
+        return null;
+    }
+    /**
+     * 生成路径（根据路由配置和参数）
+     */
+    buildPath(config, params = {}) {
+        let path = config.path;
+        // 替换动态参数
+        for (const [key, value] of Object.entries(params)) {
+            path = path.replace(`:${key}`, encodeURIComponent(value));
+        }
+        return this.normalizePath(path);
+    }
+}
+//# sourceMappingURL=matcher.js.map

package/dist/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"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"}

package/dist/metadata.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Package metadata
+ * Auto-generated by extract-metadata.ts - DO NOT EDIT MANUALLY
+ */
+export declare const METADATA: {
+    readonly name: "@fukict/router";
+    readonly version: "0.1.0";
+    readonly description: "Router for Fukict framework with nested routing and lazy loading";
+    readonly author: "Fukict Team";
+    readonly license: "MIT";
+    readonly homepage: "";
+    readonly repository: "https://github.com/fukict/fukict.git";
+};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,QAAQ;;;;;;;;CAQX,CAAC"}

package/dist/metadata.js

@@ -0,0 +1,14 @@
+/**
+ * Package metadata
+ * Auto-generated by extract-metadata.ts - DO NOT EDIT MANUALLY
+ */
+export const METADATA = {
+    name: '@fukict/router',
+    version: '0.1.0',
+    description: 'Router for Fukict framework with nested routing and lazy loading',
+    author: 'Fukict Team',
+    license: 'MIT',
+    homepage: '',
+    repository: 'https://github.com/fukict/fukict.git',
+};
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,kEAAkE;IAC/E,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,sCAAsC;CAC1C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,331 @@
+import type { VNode } from '@fukict/basic';
+import type { Router } from './Router';
+/**
+ * 路由配置
+ */
+export interface RouteConfig {
+    /**
+     * 路由路径（支持动态参数，如 /users/:id）
+     */
+    path: string;
+    /**
+     * 路由组件（可选，与 loader 二选一）
+     */
+    component?: RouteComponentClass;
+    /**
+     * 懒加载函数（可选，与 component 二选一）
+     * 返回 Promise<{ default: RouteComponentClass }>
+     */
+    loader?: () => Promise<{
+        default: RouteComponentClass;
+    }>;
+    /**
+     * 子路由配置
+     */
+    children?: RouteConfig[];
+    /**
+     * 路由元信息
+     */
+    meta?: RouteMeta;
+    /**
+     * 路由级别的导航守卫
+     */
+    beforeEnter?: NavigationGuard;
+    /**
+     * 路由名称（可选）
+     */
+    name?: string;
+    /**
+     * 重定向路径（可选）
+     */
+    redirect?: string;
+}
+/**
+ * 匹配的路由信息
+ */
+export interface RouteMatch {
+    /**
+     * 匹配的路由配置
+     */
+    config: RouteConfig;
+    /**
+     * 路由参数（如 { id: '123' }）
+     */
+    params: Record<string, string>;
+    /**
+     * 完整路径
+     */
+    path: string;
+}
+/**
+ * 路由元信息基础接口
+ *
+ * 这是一个空接口，允许用户通过模块扩展来定义项目特定的 meta 类型。
+ *
+ * @example 在项目的全局类型文件中扩展（例如 src/types/global.d.ts）：
+ * ```typescript
+ * declare module '@fukict/router' {
+ *   interface RouteMeta {
+ *     title?: string;
+ *     description?: string;
+ *     requiresAuth?: boolean;
+ *   }
+ * }
+ * ```
+ *
+ * 扩展后，所有路由的 meta 都会自动获得这些类型，无需手动导入。
+ */
+export interface RouteMeta {
+    /**
+     * 内部重定向标记（不应该由用户直接使用）
+     * @internal
+     */
+    __redirect__?: string;
+}
+/**
+ * 当前路由对象
+ */
+export interface Route {
+    /**
+     * 当前完整路径
+     */
+    path: string;
+    /**
+     * 查询参数
+     */
+    query: Record<string, string>;
+    /**
+     * 路由参数
+     */
+    params: Record<string, string>;
+    /**
+     * 路由元信息
+     */
+    meta: RouteMeta;
+    /**
+     * 匹配的路由配置列表（从顶层到当前层级）
+     */
+    matched: RouteConfig[];
+    /**
+     * hash 值（如 #section1）
+     */
+    hash: string;
+}
+/**
+ * Location 对象（用于导航）
+ */
+export interface Location {
+    /**
+     * 目标路径
+     */
+    path?: string;
+    /**
+     * 查询参数
+     */
+    query?: Record<string, string>;
+    /**
+     * hash 值
+     */
+    hash?: string;
+    /**
+     * 路由名称
+     */
+    name?: string;
+    /**
+     * 路由参数
+     */
+    params?: Record<string, string>;
+}
+/**
+ * 导航守卫函数类型
+ */
+export type NavigationGuard = (to: Route, from: Route, next: (path?: string | false) => void) => void;
+/**
+ * 路由模式
+ */
+export type RouterMode = 'hash' | 'history';
+/**
+ * Router 配置选项
+ */
+export interface RouterOptions {
+    /**
+     * 路由配置列表
+     */
+    routes: RouteConfig[];
+    /**
+     * 路由模式（默认 'hash'）
+     */
+    mode?: RouterMode;
+    /**
+     * 基础路径（默认 '/'）
+     */
+    base?: string;
+    /**
+     * 全局前置守卫
+     */
+    beforeEach?: NavigationGuard;
+    /**
+     * 全局后置钩子
+     */
+    afterEach?: (to: Route, from: Route) => void;
+    /**
+     * History 实例（可选，如果提供则使用传入的实例）
+     */
+    history?: import('./history').IHistory;
+}
+/**
+ * 路由组件类的构造函数类型
+ */
+export interface RouteComponentClass {
+    new (props: RouteProps): RouteComponent;
+}
+/**
+ * 路由组件的 props 类型
+ */
+export interface RouteProps {
+    /**
+     * Router 实例（可能是子路由）
+     */
+    router: Router;
+}
+/**
+ * 路由组件基类的抽象接口
+ */
+export interface RouteComponent {
+    /**
+     * Router 实例
+     */
+    router: Router;
+    /**
+     * 当前匹配的路由配置
+     */
+    matched: RouteConfig | null;
+    /**
+     * 当前路由对象
+     */
+    route: Route;
+    /**
+     * 路由参数
+     */
+    params: Record<string, string>;
+    /**
+     * 查询参数
+     */
+    query: Record<string, string>;
+    /**
+     * 路由元信息
+     */
+    meta: RouteMeta;
+    /**
+     * 导航到指定路径（添加历史记录）
+     */
+    push(location: string | Location): void;
+    /**
+     * 替换当前路由（不添加历史记录）
+     */
+    replace(location: string | Location): void;
+    /**
+     * 返回上一页
+     */
+    back(): void;
+    /**
+     * 前进到下一页
+     */
+    forward(): void;
+    /**
+     * 更新查询参数（保留其他参数）
+     */
+    updateQuery(query: Record<string, string>): void;
+    /**
+     * 更新路由参数
+     */
+    updateParams(params: Record<string, string>): void;
+    /**
+     * 路由参数变化时的钩子
+     */
+    routeParamsChanged?(newParams: Record<string, string>, oldParams: Record<string, string>): void;
+    /**
+     * 查询参数变化时的钩子
+     */
+    routeQueryChanged?(newQuery: Record<string, string>, oldQuery: Record<string, string>): void;
+    /**
+     * 组件更新方法（由 Router 调用）
+     */
+    update(props: Partial<RouteProps>): void;
+    /**
+     * 渲染方法
+     */
+    render(): VNode;
+}
+/**
+ * RouterProvider 组件的 props
+ */
+export interface RouterProviderProps {
+    /**
+     * 路由配置列表
+     */
+    routes: RouteConfig[];
+    /**
+     * 路由模式
+     */
+    mode?: RouterMode;
+    /**
+     * 基础路径
+     */
+    base?: string;
+    /**
+     * 全局前置守卫
+     */
+    beforeEach?: NavigationGuard;
+    /**
+     * 全局后置钩子
+     */
+    afterEach?: (to: Route, from: Route) => void;
+    /**
+     * 未匹配路由时的后备内容
+     */
+    fallback?: VNode;
+}
+/**
+ * RouterView 组件的 props
+ */
+export interface RouterViewProps {
+    /**
+     * Router 实例
+     */
+    router: Router;
+    /**
+     * 未匹配路由时的后备内容
+     */
+    fallback?: VNode;
+}
+/**
+ * Link 组件的 props
+ */
+export interface LinkProps {
+    /**
+     * 目标路径或 Location 对象
+     */
+    to: string | Location;
+    /**
+     * 是否使用 replace 模式（默认 false）
+     */
+    replace?: boolean;
+    /**
+     * CSS 类名
+     */
+    class?: string;
+    /**
+     * 激活时的 CSS 类名
+     */
+    activeClass?: string;
+    /**
+     * 精确匹配时的 CSS 类名
+     */
+    exactActiveClass?: string;
+    /**
+     * 其他 HTML 属性（如 class, style 等）
+     */
+    [key: string]: any;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,mBAAmB,CAAA;KAAE,CAAC,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,WAAW,EAAE,CAAC;IAEvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,EAAE,EAAE,KAAK,EACT,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,KAAK,IAAI,KAClC,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;IAE7C;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,WAAW,EAAE,QAAQ,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,KAAK,EAAE,UAAU,GAAG,cAAc,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAEjD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,kBAAkB,CAAC,CACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,IAAI,CAAC;IAER;;OAEG;IACH,iBAAiB,CAAC,CAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,IAAI,CAAC;IAER;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,MAAM,IAAI,KAAK,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@fukict/router",
+  "version": "0.1.0",
+  "description": "Router for Fukict framework with nested routing and lazy loading",
+  "keywords": [
+    "fukict",
+    "router",
+    "routing",
+    "spa",
+    "single-page-application",
+    "navigation"
+  ],
+  "bugs": {
+    "url": "https://github.com/fukict/fukict/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fukict/fukict.git",
+    "directory": "packages/router"
+  },
+  "license": "MIT",
+  "author": "Fukict Team",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@fukict/basic": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "tsx ../../scripts/build-package.ts --pkg-name router --no-watch",
+    "dev": "tsx ../../scripts/build-package.ts --pkg-name router --watch",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
+  }
+}