@fukict/router 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fukict Team
+
+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/dist/Link.d.ts

@@ -0,0 +1,38 @@
+import { Fukict, type VNode } from '@fukict/basic';
+import type { LinkProps } from './types';
+/**
+ * Link 组件
+ *
+ * 路由导航链接组件
+ */
+export declare class Link extends Fukict<LinkProps> {
+    /**
+     * 获取 Router 实例
+     */
+    private getRouter;
+    /**
+     * 构建完整路径
+     */
+    private buildPath;
+    /**
+     * 构建 href 属性（根据路由模式）
+     */
+    private buildHref;
+    /**
+     * 检查路径是否激活
+     */
+    private isActive;
+    /**
+     * 检查路径是否精确激活
+     */
+    private isExactActive;
+    /**
+     * 处理点击事件
+     */
+    private handleClick;
+    /**
+     * 渲染方法
+     */
+    render(): VNode;
+}
+//# sourceMappingURL=Link.d.ts.map

package/dist/Link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../src/Link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,EAAK,MAAM,eAAe,CAAC;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;GAIG;AACH,qBAAa,IAAK,SAAQ,MAAM,CAAC,SAAS,CAAC;IACzC;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAkCjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAqBjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAahB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,WAAW,CAiBjB;IAEF;;OAEG;IACH,MAAM,IAAI,KAAK;CAuChB"}

package/dist/Link.js

@@ -0,0 +1,138 @@
+import { Fukict, h } from '@fukict/basic';
+import { Router } from './Router';
+/**
+ * Link 组件
+ *
+ * 路由导航链接组件
+ */
+export class Link extends Fukict {
+    /**
+     * 获取 Router 实例
+     */
+    getRouter() {
+        return Router.getInstance();
+    }
+    /**
+     * 构建完整路径
+     */
+    buildPath() {
+        const { to } = this.props;
+        if (typeof to === 'string') {
+            return to;
+        }
+        const router = this.getRouter();
+        if (!router) {
+            return '/';
+        }
+        let path = to.path || router.currentRoute.path;
+        // 添加查询参数
+        if (to.query) {
+            const params = new URLSearchParams();
+            for (const [key, value] of Object.entries(to.query)) {
+                params.append(key, value);
+            }
+            const queryString = params.toString();
+            if (queryString) {
+                path += '?' + queryString;
+            }
+        }
+        // 添加 hash
+        if (to.hash) {
+            path += to.hash;
+        }
+        return path;
+    }
+    /**
+     * 构建 href 属性（根据路由模式）
+     */
+    buildHref() {
+        const path = this.buildPath();
+        const router = this.getRouter();
+        if (!router) {
+            return path;
+        }
+        // 获取路由模式（通过 router 的 history 实例判断）
+        // @ts-ignore - 访问私有属性
+        const history = router.history;
+        // 如果是 HashHistory，则在路径前加 #
+        if (history && history.constructor.name === 'HashHistory') {
+            return `#${path}`;
+        }
+        // history 模式直接返回路径
+        return path;
+    }
+    /**
+     * 检查路径是否激活
+     */
+    isActive() {
+        const router = this.getRouter();
+        if (!router) {
+            return false;
+        }
+        const targetPath = this.buildPath();
+        const currentPath = router.currentRoute.path;
+        // 简单的路径匹配（可以优化为更精确的匹配）
+        return currentPath.startsWith(targetPath);
+    }
+    /**
+     * 检查路径是否精确激活
+     */
+    isExactActive() {
+        const router = this.getRouter();
+        if (!router) {
+            return false;
+        }
+        const targetPath = this.buildPath();
+        const currentPath = router.currentRoute.path;
+        return currentPath === targetPath;
+    }
+    /**
+     * 处理点击事件
+     */
+    handleClick = (e) => {
+        // 阻止默认行为
+        e.preventDefault();
+        const router = this.getRouter();
+        if (!router) {
+            return;
+        }
+        const { to, replace } = this.props;
+        // 导航
+        if (replace) {
+            router.replace(to);
+        }
+        else {
+            router.push(to);
+        }
+    };
+    /**
+     * 渲染方法
+     */
+    render() {
+        const { activeClass = 'router-link-active', exactActiveClass = 'router-link-exact-active', } = this.props;
+        const href = this.buildHref();
+        const isActive = this.isActive();
+        const isExactActive = this.isExactActive();
+        // 构建 class 列表
+        const classes = ['router-link'];
+        if (this.props.class) {
+            classes.push(this.props.class);
+        }
+        if (isActive) {
+            classes.push(activeClass);
+        }
+        if (isExactActive) {
+            classes.push(exactActiveClass);
+        }
+        return h('a', {
+            href,
+            class: classes.join(' '),
+            'on:click': this.handleClick,
+        }, Array.isArray(this.slots.default)
+            ? this.slots.default
+            : this.slots.default
+                ? [this.slots.default]
+                : []);
+    }
+}
+//# sourceMappingURL=Link.js.map

package/dist/Link.js.map

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

package/dist/RouteComponent.d.ts

@@ -0,0 +1,85 @@
+import { Fukict, type VNode } from '@fukict/basic';
+import type { Router } from './Router';
+import type { Location, Route, RouteConfig, RouteMeta, RouteProps } from './types';
+/**
+ * 路由组件基类
+ *
+ * 提供路由相关的上下文和工具方法
+ */
+export declare abstract class RouteComponent extends Fukict<RouteProps> {
+    /**
+     * Router 实例
+     */
+    get router(): Router;
+    /**
+     * 当前匹配的路由配置
+     */
+    get matched(): RouteConfig | null;
+    /**
+     * 当前路由对象
+     */
+    get route(): Route;
+    /**
+     * 路由参数（如 { id: '123' }）
+     */
+    get params(): Record<string, string>;
+    /**
+     * 查询参数（如 { page: '1' }）
+     */
+    get query(): Record<string, string>;
+    /**
+     * 路由元信息
+     */
+    get 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;
+    /**
+     * 重写 update 方法，添加参数变化检测
+     */
+    update(props: RouteProps): void;
+    /**
+     * 比较两个参数对象是否相等
+     */
+    private isParamsEqual;
+    /**
+     * 比较两个查询参数对象是否相等
+     */
+    private isQueryEqual;
+    /**
+     * 渲染方法（子类必须实现）
+     */
+    abstract render(): VNode;
+}
+//# sourceMappingURL=RouteComponent.d.ts.map

package/dist/RouteComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteComponent.d.ts","sourceRoot":"","sources":["../src/RouteComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EACV,QAAQ,EACR,KAAK,EACL,WAAW,EAEX,SAAS,EACT,UAAU,EACX,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,8BAAsB,cAAe,SAAQ,MAAM,CAAC,UAAU,CAAC;IAC7D;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,WAAW,GAAG,IAAI,CAEhC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAElC;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,SAAS,CAEpB;IAED;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAIvC;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAI1C;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAWhD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAmBlD;;;OAGG;IACH,kBAAkB,CAAC,CACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,IAAI;IAEP;;;OAGG;IACH,iBAAiB,CAAC,CAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,IAAI;IAEP;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAsB/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,QAAQ,CAAC,MAAM,IAAI,KAAK;CACzB"}

package/dist/RouteComponent.js

@@ -0,0 +1,153 @@
+import { Fukict } from '@fukict/basic';
+/**
+ * 路由组件基类
+ *
+ * 提供路由相关的上下文和工具方法
+ */
+export class RouteComponent extends Fukict {
+    /**
+     * Router 实例
+     */
+    get router() {
+        return this.props.router;
+    }
+    /**
+     * 当前匹配的路由配置
+     */
+    get matched() {
+        return this.router.matched;
+    }
+    /**
+     * 当前路由对象
+     */
+    get route() {
+        return this.router.currentRoute;
+    }
+    /**
+     * 路由参数（如 { id: '123' }）
+     */
+    get params() {
+        return this.route.params;
+    }
+    /**
+     * 查询参数（如 { page: '1' }）
+     */
+    get query() {
+        return this.route.query;
+    }
+    /**
+     * 路由元信息
+     */
+    get meta() {
+        return this.route.meta;
+    }
+    /**
+     * 导航到指定路径（添加历史记录）
+     */
+    push(location) {
+        this.router.push(location);
+    }
+    /**
+     * 替换当前路由（不添加历史记录）
+     */
+    replace(location) {
+        this.router.replace(location);
+    }
+    /**
+     * 返回上一页
+     */
+    back() {
+        this.router.back();
+    }
+    /**
+     * 前进到下一页
+     */
+    forward() {
+        this.router.forward();
+    }
+    /**
+     * 更新查询参数（保留其他参数）
+     */
+    updateQuery(query) {
+        this.push({
+            path: this.route.path,
+            query: {
+                ...this.route.query,
+                ...query,
+            },
+            hash: this.route.hash,
+        });
+    }
+    /**
+     * 更新路由参数
+     */
+    updateParams(params) {
+        const matched = this.matched;
+        if (!matched) {
+            return;
+        }
+        // 使用新参数构建路径
+        let path = matched.path;
+        for (const [key, value] of Object.entries(params)) {
+            path = path.replace(`:${key}`, value);
+        }
+        this.push({
+            path,
+            query: this.route.query,
+            hash: this.route.hash,
+        });
+    }
+    /**
+     * 重写 update 方法，添加参数变化检测
+     */
+    update(props) {
+        const oldParams = this.params;
+        const oldQuery = this.query;
+        // 调用父类的 update
+        super.update(props);
+        // 检测参数变化
+        const newParams = this.params;
+        const newQuery = this.query;
+        // 检测路由参数变化
+        if (this.routeParamsChanged && !this.isParamsEqual(oldParams, newParams)) {
+            this.routeParamsChanged(newParams, oldParams);
+        }
+        // 检测查询参数变化
+        if (this.routeQueryChanged && !this.isQueryEqual(oldQuery, newQuery)) {
+            this.routeQueryChanged(newQuery, oldQuery);
+        }
+    }
+    /**
+     * 比较两个参数对象是否相等
+     */
+    isParamsEqual(params1, params2) {
+        const keys1 = Object.keys(params1);
+        const keys2 = Object.keys(params2);
+        if (keys1.length !== keys2.length) {
+            return false;
+        }
+        for (const key of keys1) {
+            if (params1[key] !== params2[key]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * 比较两个查询参数对象是否相等
+     */
+    isQueryEqual(query1, query2) {
+        const keys1 = Object.keys(query1);
+        const keys2 = Object.keys(query2);
+        if (keys1.length !== keys2.length) {
+            return false;
+        }
+        for (const key of keys1) {
+            if (query1[key] !== query2[key]) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=RouteComponent.js.map

package/dist/RouteComponent.js.map

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

package/dist/Router.d.ts

@@ -0,0 +1,128 @@
+import type { Location, NavigationGuard, Route, RouteConfig, RouterOptions } from './types';
+/**
+ * 路由变化监听器类型
+ */
+type RouteListener = () => void;
+/**
+ * Router 类
+ */
+export declare class Router {
+    /**
+     * 全局单例
+     */
+    private static instance;
+    /**
+     * History 管理器
+     */
+    private history;
+    /**
+     * 路由匹配器
+     */
+    private matcher;
+    /**
+     * 当前路由
+     */
+    currentRoute: Route;
+    /**
+     * 路由变化监听器列表
+     */
+    private listeners;
+    /**
+     * 全局前置守卫
+     */
+    private beforeEachGuards;
+    /**
+     * 全局后置钩子
+     */
+    private afterEachHooks;
+    /**
+     * 路由深度（用于嵌套路由）
+     */
+    private depth;
+    /**
+     * 配置选项
+     */
+    private options;
+    /**
+     * 构造函数
+     * @param options 路由配置选项
+     * @param depth 路由深度（用于嵌套路由，内部使用）
+     */
+    constructor(options: RouterOptions, depth?: number);
+    /**
+     * 获取全局 Router 实例
+     */
+    static getInstance(): Router | null;
+    /**
+     * 获取当前深度匹配的路由配置
+     */
+    get matched(): RouteConfig | null;
+    /**
+     * 创建子路由（depth + 1）
+     */
+    createChild(): Router;
+    /**
+     * 清理资源
+     */
+    destroy(): void;
+    /**
+     * 导航到指定路径（由 RouterProvider 调用）
+     * 包含守卫逻辑
+     */
+    navigate(path: string): Promise<void>;
+    /**
+     * 更新路由状态（由 history 监听器调用）
+     * 不修改 history，只更新内部状态和执行守卫
+     */
+    updateRoute(path: string): Promise<void>;
+    /**
+     * 创建路由对象
+     */
+    private createRoute;
+    /**
+     * 解析 Location 字符串
+     */
+    private parseLocation;
+    /**
+     * 构建完整路径
+     */
+    private buildPath;
+    /**
+     * 序列化查询参数
+     */
+    private stringifyQuery;
+    /**
+     * 导航到指定路径（添加历史记录）
+     */
+    push(location: string | Location): void;
+    /**
+     * 替换当前路由（不添加历史记录）
+     */
+    replace(location: string | Location): void;
+    /**
+     * 返回上一页
+     */
+    back(): void;
+    /**
+     * 前进到下一页
+     */
+    forward(): void;
+    /**
+     * 注册前置守卫
+     */
+    beforeEach(guard: NavigationGuard): void;
+    /**
+     * 注册后置钩子
+     */
+    afterEach(hook: (to: Route, from: Route) => void): void;
+    /**
+     * 订阅路由变化
+     */
+    subscribe(listener: RouteListener): () => void;
+    /**
+     * 通知监听器
+     */
+    private notify;
+}
+export {};
+//# sourceMappingURL=Router.d.ts.map

package/dist/Router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Router.d.ts","sourceRoot":"","sources":["../src/Router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,KAAK,EACL,WAAW,EACX,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,KAAK,aAAa,GAAG,MAAM,IAAI,CAAC;AAEhC;;GAEG;AACH,qBAAa,MAAM;IACjB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuB;IAE9C;;OAEG;IACH,OAAO,CAAC,OAAO,CAAW;IAE1B;;OAEG;IACH,OAAO,CAAC,OAAO,CAAe;IAE9B;;OAEG;IACI,YAAY,EAAE,KAAK,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,SAAS,CAAiC;IAElD;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAAyB;IAEjD;;OAEG;IACH,OAAO,CAAC,cAAc,CAA+C;IAErE;;OAEG;IACH,OAAO,CAAC,KAAK,CAAS;IAEtB;;OAEG;IACH,OAAO,CAAC,OAAO,CAAgB;IAE/B;;;;OAIG;gBACS,OAAO,EAAE,aAAa,EAAE,KAAK,GAAE,MAAU;IAyCrD;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,IAAI,OAAO,IAAI,WAAW,GAAG,IAAI,CAEhC;IAED;;OAEG;IACH,WAAW,IAAI,MAAM;IASrB;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6E3C;;;OAGG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6E9C;;OAEG;IACH,OAAO,CAAC,WAAW;IAkDnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiCrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAuBjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAKvC;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAK1C;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAIxC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAIvD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAS9C;;OAEG;IACH,OAAO,CAAC,MAAM;CAKf"}