vitarx-router 1.0.2 → 2.0.0-beta.1

package/README.md

@@ -1,6 +1,6 @@
 # VitarxRouter
 
-Vitarx前端框架的配套路由器，[文档地址](https://router.vitarx.cn)
+`Vitarx` 前端框架的配套路由器[文档地址](https://vitarx.cn/router)
 ________________________________________________________________________
 
 ## 安装
@@ -9,3 +9,37 @@ ________________________________________________________________________
 npm install vitarx-router
 ```
 
+## 简单示例
+
+```js
+import { defineRoutes, useRouter } from 'vitarx-router'
+import AppHomePage from '@/pages/Home/index.js'
+
+// 定义路由线路
+const routes = defineRoutes(
+  {
+    path: '/',
+    name: 'home',
+    widget: AppHomePage
+  },
+  {
+    path: '/about',
+    name: 'about',
+    widget: () => import('@/pages/About/index.js') // 懒加载
+  }
+)
+
+// 创建路由器
+const router = createRouter({
+  routes: Routes,
+  mode: 'path', // 使用路径模式，除了此模式还支持 hash , memory 模式，path和hash模式只能在浏览器端使用，依赖 window.history Api
+  /** 其他配置查看文档 */
+})
+
+// 导航
+useRouter().push('/about') // 导航到路径
+useRouter().push({ name: 'about' }) // 导航到路由名称
+useRouter().psuh('about') // 不以/开头的字符串，也会被认为是路由名称
+useRouter().replace('/about') // 替换路由，参数规则同push一致
+```
+

package/dist/scripts/type-make.d.ts

@@ -12,8 +12,8 @@ declare interface Route {
  *
  * @param {Route[]} routes - 路由表
  * @param {string[]} custom - 自定义的名称或路径，例如['/home', 'home']
- * @param {string} [writePath] - 要写入的路径，完整的路径！例如'/Users/Vitarx/vitarx/route.type.d.ts'，默认为当前工作目录下的route.type.d.ts
+ * @param {string} [writePath] - 要写入的路径，绝对路径！例如'/Users/Vitarx/vitarx/route.type.d.ts'，默认为当前工作目录下的route.type.d.ts
  * @return {void}
  */
-export default function make(routes: Route[], custom?: string[], writePath?: string): void;
+export default function makeTypeRoute(routes: Route[], custom?: string[], writePath?: string): void;
 export {};

package/dist/scripts/type-make.js

@@ -52,10 +52,10 @@ function buildRouteIndex(routes) {
  *
  * @param {Route[]} routes - 路由表
  * @param {string[]} custom - 自定义的名称或路径，例如['/home', 'home']
- * @param {string} [writePath] - 要写入的路径，完整的路径！例如'/Users/Vitarx/vitarx/route.type.d.ts'，默认为当前工作目录下的route.type.d.ts
+ * @param {string} [writePath] - 要写入的路径，绝对路径！例如'/Users/Vitarx/vitarx/route.type.d.ts'，默认为当前工作目录下的route.type.d.ts
  * @return {void}
  */
-export default function make(routes, custom = [], writePath = '') {
+export default function makeTypeRoute(routes, custom = [], writePath = '') {
     const { paths, names } = buildRouteIndex(routes);
     const all = [...paths, ...names, ...custom];
     // 构造类型声明字符串

package/dist/vitarx-router.d.ts

@@ -1,9 +1,10 @@
+import { App } from 'vitarx';
+import { AppObjectPlugin } from 'vitarx';
 import { Computed } from 'vitarx';
 import { Element as Element_2 } from 'vitarx';
 import { HTMLClassProperties } from 'vitarx';
 import { HTMLProperties } from 'vitarx';
 import { HTMLStyleProperties } from 'vitarx';
-import { LazyLoader } from 'vitarx';
 import { RouteLocation as RouteLocation_2 } from '../index.js';
 import { VNode } from 'vitarx';
 import { Widget } from 'vitarx';
@@ -17,6 +18,7 @@ import { WidgetType } from 'vitarx';
  * @param this - 路由器实例
  * @param to - 即将要进入的目标路由对象
  * @param from - 当前导航正要离开的路由对象
+ * @returns {void}
  */
 export declare type AfterEnterCallback = (this: Router, to: ReadonlyRouteLocation, from: ReadonlyRouteLocation) => void;
 
@@ -32,10 +34,11 @@ export declare type AllowedRouteWidget = RouteWidget | NamedRouteWidget;
  *
  * - boolean: true继续导航,false阻止导航
  * - RouteTarget: 重定向到新的目标
+ * - string: 重定向到新的path/name
  * - void: 继续导航
  * - Promise: 异步处理,resolve的值同上
  */
-export declare type BeforeEachCallbackResult = boolean | RouteTarget | void | Promise<boolean | RouteTarget | void>;
+export declare type BeforeEachCallbackResult = boolean | RouteTarget | RouteIndex | void | Promise<boolean | RouteTarget | RouteIndex | void>;
 
 /**
  * 路由前置钩子
@@ -45,6 +48,7 @@ export declare type BeforeEachCallbackResult = boolean | RouteTarget | void | Pr
  * @param this - 路由器实例
  * @param to - 即将要进入的目标路由对象
  * @param from - 当前导航正要离开的路由对象
+ * @returns {BeforeEachCallbackResult} 返回false可以取消导航
  */
 export declare type BeforeEnterCallback = (this: Router, to: ReadonlyRouteLocation, from: ReadonlyRouteLocation) => BeforeEachCallbackResult;
 
@@ -56,26 +60,54 @@ export declare type BeforeEnterCallback = (this: Router, to: ReadonlyRouteLocati
  * 你必须调用一次`router.replace(target)`方法来跳转到目标路由。
  *
  * @param {RouterOptions} options - 配置
- * @return {RouterMemory} - 内存路由器实例
+ * @return {RouterMemory} - `RouterMemory`内存路由器实例
  */
-export declare function createRouter(options: RouterOptions & {
-    mode: 'memory';
-}): MemoryRouter;
+export declare function createRouter(options: MakeRequired<RouterOptions<'memory'>, 'mode'>): MemoryRouter;
 
 /**
- * 创建History路由器
+ * 创建WebHistory路由器，path模式
  *
  * 基于History API实现路由功能，支持浏览器前进后退、刷新等操作。
  *
- * 它与`MemoryRouter`路由不同的是，它不需要初始化过后调用`router.replace(target)`方法来替换默认路由，
- * 内部会自动根据`window.location`去匹配路由。
+ * @remarks
+ * 部署到服务器上时需要配置重定向，否则会出现404错误。
+ *
+ * nginx
+ * ```nginx
+ * location / {
+ *   try_files $uri $uri/ /index.html;
+ * }
+ * ```
+ * Apache
+ * ```Apache
+ * <IfModule mod_negotiation.c>
+ *   Options -MultiViews
+ * </IfModule>
+ *
+ * <IfModule mod_rewrite.c>
+ *   RewriteEngine On
+ *   RewriteBase /
+ *   RewriteRule ^index\.html$ - [L]
+ *   RewriteCond %{REQUEST_FILENAME} !-f
+ *   RewriteCond %{REQUEST_FILENAME} !-d
+ *   RewriteRule . /index.html [L]
+ * </IfModule>
+ * ```
  *
  * @param {RouterOptions} options - 路由配置
- * @return {RouterHistory} - HistoryRouter实例
+ * @return {RouterHistory} - `RouterHistory`路由器实例
  */
-export declare function createRouter(options: RouterOptions | (RouterOptions & {
-    mode: 'path' | 'hash';
-})): HistoryRouter;
+export declare function createRouter(options: MakeRequired<RouterOptions<'path'>, 'mode'>): HistoryRouter;
+
+/**
+ * 创建history路由器，hash模式
+ *
+ * 基于History API实现路由功能，支持浏览器前进后退、刷新等操作。
+ *
+ * @param {RouterOptions} options - 路由配置
+ * @return {RouterHistory} - `RouterHistory`路由器实例
+ */
+export declare function createRouter(options: RouterOptions<'hash'>): HistoryRouter;
 
 /**
  * 定义路由
@@ -103,6 +135,8 @@ export declare interface DynamicRouteRecord {
     route: RouteNormalized;
 }
 
+declare type Hash = `#${string}`;
+
 /**
  * hash字符串类型
  *
@@ -126,6 +160,14 @@ export declare type HistoryMode = 'hash' | 'path' | 'memory';
  */
 export declare class HistoryRouter extends Router {
     constructor(options: RouterOptions<'path' | 'hash'>);
+    /**
+     * @inheritDoc
+     */
+    updateHash(hash: `#${string}` | ''): void;
+    /**
+     * @inheritDoc
+     */
+    updateQuery(query: Record<string, string>): void;
     /**
      * 当前路由目标
      *
@@ -204,40 +246,10 @@ export declare type InjectProps = boolean | Record<string, any> | InjectPropsHan
  * 注入参数处理函数
  *
  * @param {ReadonlyRouteLocation} location 路由匹配的位置信息
- * @return {Record<string, any>} 注入的参数
+ * @return {Record<string, any>} 注入的参数，必须是可JSON序列化的对象
  */
 export declare type InjectPropsHandler = (location: ReadonlyRouteLocation) => Record<string, any>;
 
-/**
- * ## 标记延迟加载
- *
- * 由于直接定义`() => import('./xxx.js')`会导致类型与函数式组件冲突，
- * 在未执行函数之前难以有效判断其类型，所以这里使用Symbol标记懒加载器。
- *
- * @example
- * lazy(() => import('./xxx.js'))
- *
- * @template T - WidgetType
- * @param {LazyLoader<T>} lazyLoader - 函数返回的import即是惰性加载器
- */
-export declare function lazy<T extends WidgetType>(lazyLoader: LazyLoader<T>): LazyLoad<T>;
-
-declare const LAZY_LOADER_SYMBOL: unique symbol;
-
-declare type LAZY_LOADER_SYMBOL = typeof LAZY_LOADER_SYMBOL;
-
-/**
- * 延迟加载/惰性加载
- *
- * 用于实现代码分块和懒加载功能
- */
-export declare interface LazyLoad<T> {
-    [LAZY_LOADER_SYMBOL]: boolean;
-    (): Promise<{
-        default: T;
-    }>;
-}
-
 /**
  * 路由匹配结果
  */
@@ -413,7 +425,6 @@ export declare interface Route<T extends AllowedRouteWidget = AllowedRouteWidget
      * 路由对应的视图组件
      *
      * 支持命名视图
-     *
      * @example
      * ```ts
      * {
@@ -425,6 +436,15 @@ export declare interface Route<T extends AllowedRouteWidget = AllowedRouteWidget
      *   }
      * }
      * ```
+     *
+     * 支持懒加载
+     * @example
+     * ```ts
+     * {
+     *   path: '/user/{id}',
+     *   widget: () => import('./User.js')
+     * }
+     * ```
      */
     widget?: T;
     /**
@@ -568,7 +588,7 @@ export declare type RoutePath = `/${string}`;
  * 继承自 RouterRegistry，负责处理路由导航、历史记录管理、生命周期等核心功能。
  * 采用单例模式，确保全局只有一个路由器实例。
  */
-export declare abstract class Router extends RouterRegistry {
+export declare abstract class Router extends RouterRegistry implements AppObjectPlugin<{}> {
     private _currentTaskId;
     private _taskCounter;
     /**
@@ -744,7 +764,7 @@ export declare abstract class Router extends RouterRegistry {
      * @param {RouteTarget} target - 导航目标
      * @return {Promise<NavigateResult>} 导航结果
      */
-    navigate(target: RouteTarget): Promise<NavigateResult>;
+    navigate(target: RouteTarget | RouteLocation): Promise<NavigateResult>;
     /**
      * 更新当前导航数据中的query参数
      *
@@ -763,6 +783,14 @@ export declare abstract class Router extends RouterRegistry {
      * @protected
      */
     updateHash(hash: `#${string}` | ''): void;
+    /**
+     * 创建路由视图的props
+     *
+     * @param {ReadonlyRouteNormalized} route - 路由记录
+     * @param {string} name - 视图名称
+     * @returns {Record<string, any>} - 需要传递给路由视图的props
+     */
+    createViewProps(route: ReadonlyRouteNormalized, name: string): Record<string, any>;
     /**
      * 创建路由元素
      *
@@ -854,6 +882,26 @@ export declare abstract class Router extends RouterRegistry {
      * @inheritDoc
      */
     removeRoute(index: RouteIndex): RouteNormalized | undefined;
+    /**
+     * 安装路由器
+     *
+     * 此方法用于安装路由器，将路由器实例添加到应用程序中。
+     *
+     * 安装路由器后，应用程序就可以使用`app.get('router')`访问路由器实例。
+     *
+     * @example
+     * import { createApp } from 'vitarx'
+     * import { createRouter } from 'vitarx'
+     * import AppHome from './App.js'
+     *
+     * const router = createRouter({// 相关配置})
+     * const app = createApp('#root').use(router)
+     * app.render(AppHome)
+     *
+     * @param {App} app - 应用程序实例
+     * @returns {void}
+     */
+    install(app: App): void;
 }
 
 /**
@@ -870,7 +918,7 @@ export declare class RouterLink extends Widget<RouterLinkProps> {
      *
      * @protected
      */
-    protected target: Computed<RouteTarget | HttpUrl | undefined>;
+    protected target: Computed<RouteTarget | HttpUrl | Hash | undefined>;
     /**
      * 路由目标对应的`RouteLocation`对象
      *
@@ -916,7 +964,7 @@ export declare interface RouterLinkProps {
      *
      * 可以是路由目标对象，也可以是路由索引
      */
-    to: RouteTarget | RouteIndex;
+    to: RouteTarget | RouteIndex | HttpUrl | Hash | `${RouteIndex}${HashStr}`;
     /**
      * 子节点插槽
      */
@@ -1044,13 +1092,21 @@ export declare interface RouterOptions<T extends HistoryMode = HistoryMode> {
      */
     pattern?: RegExp;
     /**
-     * 定义滚动行为
+     * 切换页面时的滚动行为
      *
      * 可以是一个函数或行为标识符，决定了当路由变化时如何滚动页面
      *
-     * @default 'smooth'
+     * @default 'auto'
      */
     scrollBehavior?: _ScrollBehavior | ScrollBehaviorHandler;
+    /**
+     * 锚点跳转时的滚动行为
+     *
+     * 仅支持 'auto' | 'smooth' | 'instant'
+     *
+     * @default 'auto'
+     */
+    anchorsScrollBehavior?: _ScrollBehavior;
     /**
      * 在每个路由进入之前调用的钩子函数
      * 允许用户在路由激活之前执行逻辑检查或重定向
@@ -1275,7 +1331,7 @@ export declare class RouterView extends Widget<RouteOptions> {
      * ```tsx
      * protected build() {
      *   // 使用空片段节点占位
-     *   if (!this.currentElement) return <></> // 不可省略，因为`KeepAlive`不能渲染非组件节点。
+     *   if (!this.currentElement) return null // 不可省略，因为`KeepAlive`不能渲染非组件节点。
      *
      *   // 将当前要进行展示的小部件构造函数传递给`KeepAlive`插槽，会在切换页面时缓存当前页面状态。
      *   return <KeepAlive>{this.currentElement}</KeepAlive>
@@ -1325,7 +1381,7 @@ export declare interface RouteTarget {
  *
  * 可以是普通组件或懒加载组件
  */
-export declare type RouteWidget = WidgetType | LazyLoad<WidgetType>;
+export declare type RouteWidget = WidgetType;
 
 /**
  * 滚动行为

package/dist/vitarx-router.es.js

@@ -1,9 +1,8 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: !0, configurable: !0, writable: !0, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key != "symbol" ? key + "" : key, value);
-import { createElement, LazyWidget, deepClone, reactive, markRaw, shallowReactive, readonly, isDeepEqual, isRecordObject, isObject, Widget, shallowRef, inject, provide, watch, Fragment, Computed, isString } from "vitarx";
+import { deepClone, reactive, markRaw, shallowReactive, readonly, createElement, isDeepEqual, isRecordObject, isObject, Widget, shallowRef, inject, provide, watch, toRaw, Observers, Fragment, Computed, isString } from "vitarx";
 var NavigateStatus = /* @__PURE__ */ ((NavigateStatus2) => (NavigateStatus2[NavigateStatus2.success = 0] = "success", NavigateStatus2[NavigateStatus2.aborted = 1] = "aborted", NavigateStatus2[NavigateStatus2.cancelled = 2] = "cancelled", NavigateStatus2[NavigateStatus2.duplicated = 3] = "duplicated", NavigateStatus2[NavigateStatus2.not_matched = 4] = "not_matched", NavigateStatus2[NavigateStatus2.exception = 5] = "exception", NavigateStatus2))(NavigateStatus || {});
-const LAZY_LOADER_SYMBOL = Symbol("LazyLoader");
 function isVariablePath(path) {
   return /\{[^}]+}/.test(path);
 }
@@ -51,9 +50,6 @@ function mergePathParams(path, params) {
     return String(params[paramName]).replace(/\s+/g, "_");
   }), formatPath(path);
 }
-function isLazyLoad(lazyLoader) {
-  return typeof lazyLoader == "function" && lazyLoader[LAZY_LOADER_SYMBOL];
-}
 function formatHash(hash, addHashPrefix) {
   return typeof hash != "string" || !hash ? "" : (hash = hash.trim(), hash.startsWith("#") ? hash : `#${hash}`);
 }
@@ -104,14 +100,11 @@ function isRouteLocationTypeObject(obj) {
   return !0;
 }
 function validateSuffix(suffix, allowSuffix, inputPath, routePath) {
-  return allowSuffix === "*" ? !0 : allowSuffix === !1 ? inputPath === routePath : Array.isArray(allowSuffix) ? allowSuffix.includes(suffix) : suffix === allowSuffix;
+  return inputPath === "/" || allowSuffix === "*" ? !0 : allowSuffix === !1 ? inputPath === routePath : Array.isArray(allowSuffix) ? allowSuffix.includes(suffix) : suffix === allowSuffix;
 }
 function addPathSuffix(path, suffix) {
   return suffix && !path.endsWith("/") && !path.includes(".") && (path += suffix.startsWith(".") ? suffix : `.${suffix}`), path;
 }
-function createViewElement(widget, props) {
-  return isLazyLoad(widget) ? createElement(LazyWidget, { children: widget, ...props }) : createElement(widget, props);
-}
 function cloneRouteLocation(route) {
   const { matched, ...other } = route;
   return Object.assign(deepClone(other), { matched: Array.from(matched) });
@@ -188,7 +181,8 @@ class RouterRegistry {
       base: "/",
       strict: !1,
       mode: "path",
-      scrollBehavior: "smooth",
+      scrollBehavior: "auto",
+      anchorsScrollBehavior: "auto",
       suffix: "*",
       pattern: /[\w.]+/,
       defaultSuffix: "",
@@ -492,6 +486,15 @@ function diffUpdateObjects(a, b) {
   for (const key of aKeys)
     delete a[key];
 }
+function diffUpdateProps(oldProps, newProps) {
+  const removeKeys = new Set(Object.keys(oldProps)), bKeys = Object.keys(newProps), changes = [];
+  for (const key of bKeys)
+    key !== "key" && (oldProps[key] !== newProps[key] && (oldProps[key] = newProps[key], changes.push(key)), removeKeys.delete(key));
+  changes.push(...removeKeys);
+  for (const key of removeKeys)
+    delete oldProps[key];
+  return changes;
+}
 const _RouterCore = class _RouterCore extends RouterRegistry {
   /**
    * 路由器构造函数
@@ -642,16 +645,14 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
   /**
    * 路由视图
    *
-   * 内部方法，用于获取路由线路对应的视图元素虚拟节点。
-   *
-   * @internal
+   * @internal 内部核心方法，用于获取路由线路对应的视图元素虚拟节点。
    * @param {ReadonlyRouteNormalized} route - 路由对象
    * @param {string} name - 视图名称
    * @param {number} index - `RouterView`的索引
    * @return {VNode<WidgetType> | undefined} - 视图元素虚拟节点
    */
   static routeViewElement(route, name, index) {
-    return route ? this.instance.createRouteViewElement(route, name) : index === 0 && name === "default" && this.instance.missing && !this.instance.isPendingNavigation ? createViewElement(this.instance.missing, {}) : void 0;
+    return route ? this.instance.createRouteViewElement(route, name) : index === 0 && name === "default" && this.instance.missing && !this.instance.isPendingNavigation ? createElement(this.instance.missing) : void 0;
   }
   /**
    * 后退到上一个历史记录
@@ -752,7 +753,25 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
     const taskId = ++this._taskCounter;
     this._currentTaskId = taskId;
     const isCurrentTask = () => this._currentTaskId === taskId, from = cloneRouteLocation(this.currentRouteLocation), performNavigation = async (_target, isRedirect) => {
-      const to = this.createRouteLocation(_target), matched = to.matched.at(-1);
+      const createNavigateResult = (overrides = {}) => ({
+        from,
+        to,
+        status: NavigateStatus.success,
+        message: "导航成功",
+        redirectFrom: isRedirect ? target : void 0,
+        ...overrides
+      }), to = this.createRouteLocation(_target);
+      if (to.fullPath === this.currentRouteLocation.fullPath && isDeepEqual(to.params, this.currentRouteLocation.params))
+        return createNavigateResult({
+          status: NavigateStatus.duplicated,
+          message: "导航到相同的路由，被系统阻止！"
+        });
+      if (to.matched.at(-1) === this._currentRouteLocation.matched.at(-1) && to.path === this._currentRouteLocation.path && isDeepEqual(to.query, this._currentRouteLocation.query) && to.hash !== this._currentRouteLocation.hash)
+        return this.updateHash(to.hash), createNavigateResult({
+          status: NavigateStatus.success,
+          message: "仅hash变化，导航成功！"
+        });
+      const matched = to.matched.at(-1);
       if (matched != null && matched.redirect) {
         let redirectTarget;
         if (typeof matched.redirect == "object" && matched.redirect.index)
@@ -765,28 +784,15 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
         }
         if (redirectTarget != null && redirectTarget.index) return performNavigation(redirectTarget, !0);
       }
-      const createNavigateResult = (overrides = {}) => ({
-        from,
-        to,
-        status: NavigateStatus.success,
-        message: "导航成功",
-        redirectFrom: isRedirect ? target : void 0,
-        ...overrides
-      });
-      if (to.fullPath === this.currentRouteLocation.fullPath)
-        return createNavigateResult({
-          status: NavigateStatus.duplicated,
-          message: "导航到相同的路由，被系统阻止！"
-        });
       try {
         const result = await this.onBeforeEach(to, from);
         return result === !1 ? createNavigateResult({
           status: NavigateStatus.aborted,
           message: `导航到${to.index}目标时被前置守卫钩子阻止！`
-        }) : isCurrentTask() ? typeof result == "object" && result.index !== _target.index ? (result.isReplace ?? (result.isReplace = !1), performNavigation(result, !0)) : !to.matched.length && !this.missing ? createNavigateResult({
+        }) : isCurrentTask() ? typeof result == "object" && result.index !== _target.index ? (result.isReplace ?? (result.isReplace = !1), performNavigation(result, !0)) : typeof result == "string" && result !== _target.index ? performNavigation({ index: result, isReplace: !1 }, !0) : !to.matched.length && !this.missing ? createNavigateResult({
           status: NavigateStatus.not_matched,
           message: `未匹配到任何路由规则，被系统阻止！请检测目标索引(${to.index})是否已注册路由。`
-        }) : (_target.isReplace ? (this._pendingReplace = to, this.replaceHistory(to)) : (this._pendingPush = to, this.pushHistory(to)), createNavigateResult(
+        }) : ("isReplace" in _target && _target.isReplace ? (this._pendingReplace = to, this.replaceHistory(to)) : (this._pendingPush = to, this.pushHistory(to)), createNavigateResult(
           !to.matched.length && this.missing ? {
             status: NavigateStatus.not_matched,
             message: `${to.fullPath}未匹配到任何路由规则，被系统允许访问，因为系统定义了missing视图。`
@@ -830,7 +836,8 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
    * @protected
    */
   updateHash(hash) {
-    typeof hash != "string" && console.warn(`[Vitarx.Router.updateHash][WARN]：hash值只能是字符串类型，给定${hash}`);
+    if (typeof hash != "string")
+      throw new TypeError(`[Vitarx.Router.updateHash][WARN]：hash值只能是字符串类型，给定${hash}`);
     const newHash = formatHash(hash);
     newHash !== this._currentRouteLocation.hash && (this._currentRouteLocation.hash = newHash, this._currentRouteLocation.fullPath = this.makeFullPath(
       this._currentRouteLocation.path,
@@ -839,6 +846,19 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
       this._currentRouteLocation.suffix
     ));
   }
+  /**
+   * 创建路由视图的props
+   *
+   * @param {ReadonlyRouteNormalized} route - 路由记录
+   * @param {string} name - 视图名称
+   * @returns {Record<string, any>} - 需要传递给路由视图的props
+   */
+  createViewProps(route, name) {
+    var _a;
+    const injectProps = (_a = route.injectProps) == null ? void 0 : _a[name];
+    let props;
+    return injectProps === !0 ? props = JSON.parse(JSON.stringify(this._currentRouteLocation.params)) : injectProps === !1 ? props = {} : typeof injectProps == "function" ? props = injectProps(this.currentRouteLocation) : isRecordObject(injectProps) ? props = injectProps : props = {}, props;
+  }
   /**
    * 创建路由元素
    *
@@ -847,12 +867,11 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
    * @protected
    */
   createRouteViewElement(route, name) {
-    var _a, _b;
+    var _a;
     const widget = (_a = route.widget) == null ? void 0 : _a[name];
     if (!widget) return;
-    const injectPropsConfig = (_b = route.injectProps) == null ? void 0 : _b[name];
-    let props;
-    return injectPropsConfig === !0 ? props = this._currentRouteLocation.params : injectPropsConfig === !1 ? props = {} : typeof injectPropsConfig == "function" ? props = injectPropsConfig(this.currentRouteLocation) : isRecordObject(injectPropsConfig) ? props = injectPropsConfig : props = {}, props.key = route.path, createViewElement(widget, props);
+    const props = this.createViewProps(route, name);
+    return props.key = route.path, createElement(widget, props);
   }
   /**
    * 该方法提供给`RouterView`完成渲染时调用
@@ -955,6 +974,28 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
     }
     return removed;
   }
+  /**
+   * 安装路由器
+   *
+   * 此方法用于安装路由器，将路由器实例添加到应用程序中。
+   *
+   * 安装路由器后，应用程序就可以使用`app.get('router')`访问路由器实例。
+   *
+   * @example
+   * import { createApp } from 'vitarx'
+   * import { createRouter } from 'vitarx'
+   * import AppHome from './App.js'
+   *
+   * const router = createRouter({// 相关配置})
+   * const app = createApp('#root').use(router)
+   * app.render(AppHome)
+   *
+   * @param {App} app - 应用程序实例
+   * @returns {void}
+   */
+  install(app) {
+    app.register("router", this);
+  }
 };
 /**
  * 路由器单例实例
@@ -966,6 +1007,36 @@ class RouterHistory extends RouterCore {
   constructor(options) {
     ["path", "hash"].includes(options.mode) || (options.mode = "hash"), super(options), options.mode === "hash" && this.ensureHash();
   }
+  /**
+   * @inheritDoc
+   */
+  updateHash(hash) {
+    if (super.updateHash(hash), this.saveCurrentScrollPosition(), this.webHistory.pushState(
+      this.createState(this.currentRouteLocation),
+      "",
+      this.currentRouteLocation.fullPath
+    ), !hash.trim())
+      window.scrollTo(0, 0);
+    else {
+      const anchorId = hash.startsWith("#") ? hash.slice(1) : hash;
+      try {
+        const element = window.document.getElementById(anchorId);
+        element && element.scrollIntoView({ behavior: this.options.anchorsScrollBehavior });
+      } catch (e) {
+        console.error(`滚动到目标锚点${hash}失败`, e);
+      }
+    }
+  }
+  /**
+   * @inheritDoc
+   */
+  updateQuery(query) {
+    super.updateQuery(query), this.webHistory.pushState(
+      this.createState(this.currentRouteLocation),
+      "",
+      this.currentRouteLocation.fullPath
+    );
+  }
   /**
    * 当前路由目标
    *
@@ -1059,11 +1130,7 @@ class RouterHistory extends RouterCore {
         if (res.status === NavigateStatus.not_matched) {
           if (res.to.index.startsWith("/")) {
             const anchorId = res.to.index.slice(1), element = window.document.getElementById(anchorId);
-            element && element.scrollIntoView({ behavior: this.scrollBehavior }), this.updateHash(`#${anchorId}`), this.webHistory.replaceState(
-              this.createState(this.currentRouteLocation),
-              "",
-              this.currentRouteLocation.fullPath
-            );
+            element && element.scrollIntoView({ behavior: this.scrollBehavior }), this.updateHash(`#${anchorId}`);
           }
         } else res.status === NavigateStatus.duplicated && this.webHistory.replaceState(
           this.createState(this.currentRouteLocation),
@@ -1162,7 +1229,7 @@ function defineRoute(route) {
 }
 function createRouter(options) {
   let router;
-  return !(window != null && window.location) && options.mode !== "memory" ? (console.warn("当前环境非浏览器端，强制使用内存模式路由"), options.mode = "memory", new RouterMemory(options).initialize()) : (options.mode === "memory" ? router = new RouterMemory(options) : router = new RouterHistory(options), router.initialize());
+  return typeof window > "u" && options.mode !== "memory" ? (console.warn("当前环境非浏览器端，强制使用内存模式路由"), options.mode = "memory", new RouterMemory(options).initialize()) : (options.mode === "memory" ? router = new RouterMemory(options) : router = new RouterHistory(options), router.initialize());
 }
 function useRouter() {
   return RouterCore.instance;
@@ -1170,11 +1237,6 @@ function useRouter() {
 function useRoute() {
   return RouterCore.instance.currentRouteLocation;
 }
-function lazy(lazyLoader) {
-  return Object.defineProperty(lazyLoader, LAZY_LOADER_SYMBOL, {
-    value: !0
-  }), lazyLoader;
-}
 const INDEX_SYMBOL = Symbol("RouterViewCounter");
 class RouterView extends Widget {
   constructor(props) {
@@ -1190,9 +1252,20 @@ class RouterView extends Widget {
       this._$currentRoute,
       this.name,
       this._$index
-    ), watch(this.location.matched, (_c, o) => {
+    );
+    const router = useRouter();
+    let paramStr = JSON.stringify(this.location.params);
+    watch(this.location.matched, (_c, o) => {
       const newRoute = o[this.index];
       newRoute !== this._$currentRoute && (this._$currentRoute = newRoute, this._$currentElement.value = RouterCore.routeViewElement(newRoute, this.name, this._$index));
+    }), watch(this.location.params, () => {
+      if (!this._$currentRoute) return;
+      const newParams = JSON.stringify(this.location.params);
+      if (newParams !== paramStr) {
+        paramStr = newParams;
+        const newProps = router.createViewProps(this._$currentRoute, this.name), oldProps = toRaw(this._$currentElement.value.props), changes = diffUpdateProps(oldProps, newProps);
+        changes.length > 0 && Observers.trigger(this._$currentElement.value.props, changes);
+      }
     });
   }
   /**
@@ -1273,7 +1346,7 @@ class RouterView extends Widget {
    * ```tsx
    * protected build() {
    *   // 使用空片段节点占位
-   *   if (!this.currentElement) return <></> // 不可省略，因为`KeepAlive`不能渲染非组件节点。
+   *   if (!this.currentElement) return null // 不可省略，因为`KeepAlive`不能渲染非组件节点。
    *
    *   // 将当前要进行展示的小部件构造函数传递给`KeepAlive`插槽，会在切换页面时缓存当前页面状态。
    *   return <KeepAlive>{this.currentElement}</KeepAlive>
@@ -1323,8 +1396,14 @@ class RouterLink extends Widget {
     __publicField(this, "htmlProps");
     this.target = new Computed(() => {
       if (!this.props.to) return;
-      const to = isString(props.to) ? { index: props.to } : props.to;
-      return RouterLink.isHttpOrHttpsUrl(to.index) ? to.index : to;
+      const to = isString(props.to) ? { index: decodeURIComponent(props.to) } : props.to;
+      if (RouterLink.isHttpOrHttpsUrl(to.index) || to.index.startsWith("#"))
+        return to.index;
+      if (to.index.includes("#")) {
+        const [index, hash] = to.index.split("#", 2);
+        to.index = index, to.hash = `#${hash}`;
+      }
+      return to;
     }), this.location = new Computed(() => {
       if (!this.target.value || typeof this.target.value == "string") return;
       const location = RouterCore.instance.createRouteLocation(this.target.value);
@@ -1409,7 +1488,6 @@ export {
   createRouter,
   defineRoute,
   defineRoutes,
-  lazy,
   useRoute,
   useRouter
 };

package/dist/vitarx-router.umd.js

@@ -1 +1 @@
-(function(global,factory){typeof exports=="object"&&typeof module<"u"?factory(exports,require("vitarx")):typeof define=="function"&&define.amd?define(["exports","vitarx"],factory):(global=typeof globalThis<"u"?globalThis:global||self,factory(global.VitarxRouter={},global.Vitarx))})(this,function(exports2,vitarx){"use strict";var __defProp=Object.defineProperty;var __defNormalProp=(obj,key,value)=>key in obj?__defProp(obj,key,{enumerable:!0,configurable:!0,writable:!0,value}):obj[key]=value;var __publicField=(obj,key,value)=>__defNormalProp(obj,typeof key!="symbol"?key+"":key,value);var NavigateStatus=(NavigateStatus2=>(NavigateStatus2[NavigateStatus2.success=0]="success",NavigateStatus2[NavigateStatus2.aborted=1]="aborted",NavigateStatus2[NavigateStatus2.cancelled=2]="cancelled",NavigateStatus2[NavigateStatus2.duplicated=3]="duplicated",NavigateStatus2[NavigateStatus2.not_matched=4]="not_matched",NavigateStatus2[NavigateStatus2.exception=5]="exception",NavigateStatus2))(NavigateStatus||{});const LAZY_LOADER_SYMBOL=Symbol("LazyLoader");function isVariablePath(path){return/\{[^}]+}/.test(path)}function optionalVariableCount(path){const pathWithoutSpaces=path.replace(/\s+/g,""),regex=/\{[\w-]+\?}/g,matches=pathWithoutSpaces.match(regex);return matches?matches.length:0}function isRouteGroup(route){return"children"in route&&route.children!==void 0&&route.children.length>0}function createDynamicPattern(path,pattern,strict,defaultPattern){let optional=0;const processVariable=(varName,isOptional)=>{const regex=pattern[varName];if(regex?regex instanceof RegExp||(console.warn(`[Vitarx.Router][WARN]：${path} 动态路径${varName}变量的自定义正则表达式必须是 RegExp 类型`),pattern[varName]=defaultPattern):pattern[varName]=defaultPattern,isOptional)return optional++,`(?:(${pattern[varName].source}))?`;if(optional)throw new Error(`[Vitarx.Router][ERROR]：动态路径 ${path} 中，可选变量 ${varName} 后不能存在任何必填变量`);return`(${pattern[varName].source})`},processedPath=path.replace(/{([^}?]+)\?}/g,(_,varName)=>processVariable(varName,!0)).replace(/{([^}]+)}/g,(_,varName)=>processVariable(varName,!1)).replace(/\//g,"\\/").replace(/\/?$/,"/?"),flags=strict?"":"i",segments=path.replace(/^\/|\/$/g,"").split("/").length;return{regex:new RegExp(`^${processedPath}$`,flags),length:segments,optional}}function formatPath(path){return path=`/${path}`.replace(/\s+/g,"").replace(/\/+/g,"/"),path.length?path==="/"||path==="/#/"?path:path.replace(/\/$/,""):"/"}function mergePathParams(path,params){if(!isVariablePath(path))return path;const oldPath=path;return path=path.replace(/{([^}]+)\?*}/g,(_match,paramName)=>{const isOptional=paramName.endsWith("?");if(isOptional&&(paramName=paramName.slice(0,-1)),params[paramName]===void 0){if(isOptional)return"";throw new TypeError(`[Vitarx.Router.mergePathParams] 访问路由${oldPath}时缺少参数：${paramName}`)}return String(params[paramName]).replace(/\s+/g,"_")}),formatPath(path)}function isLazyLoad(lazyLoader){return typeof lazyLoader=="function"&&lazyLoader[LAZY_LOADER_SYMBOL]}function formatHash(hash,addHashPrefix){return typeof hash!="string"||!hash?"":(hash=hash.trim(),hash.startsWith("#")?hash:`#${hash}`)}function queryStringToObject(queryString){queryString=decodeURIComponent(queryString);const params=new URLSearchParams(queryString.startsWith("?")?queryString.substring(1):queryString),obj={};return params.forEach((value,key)=>obj[key]=value),obj}function objectToQueryString(obj){const queryString=new URLSearchParams(obj).toString();return queryString?`?${queryString}`:""}function urlToRouteTarget(url,mode,base){let path=decodeURIComponent(url.pathname),hash=decodeURIComponent(url.hash),query=queryStringToObject(url.search);if(path=formatPath(path.startsWith(base)?path.slice(base.length):path),mode==="hash"&&hash.includes("#/")){const hashPart=hash.slice(1),[fullPath,anchor]=hashPart.split("#");path=formatPath(fullPath||"/"),hash=anchor?`#${anchor}`:""}return{index:path,hash,query}}function splitPathAndSuffix(path){const suffix=getPathSuffix(path);return suffix&&(path=path.slice(0,-suffix.length)),{path,suffix:suffix.substring(1)}}function getPathSuffix(path){const lastDotIndex=path.lastIndexOf(".");return lastDotIndex!==-1&&lastDotIndex<path.length-1?`.${path.substring(lastDotIndex+1)}`:""}function isRouteLocationTypeObject(obj){if(typeof obj!="object"||obj===null)return!1;const keys=["index","fullPath","path","hash","params","query","matched","meta"];for(const key of keys)if(!Object.prototype.hasOwnProperty.call(obj,key))return!1;return!0}function validateSuffix(suffix,allowSuffix,inputPath,routePath){return allowSuffix==="*"?!0:allowSuffix===!1?inputPath===routePath:Array.isArray(allowSuffix)?allowSuffix.includes(suffix):suffix===allowSuffix}function addPathSuffix(path,suffix){return suffix&&!path.endsWith("/")&&!path.includes(".")&&(path+=suffix.startsWith(".")?suffix:`.${suffix}`),path}function createViewElement(widget,props){return isLazyLoad(widget)?vitarx.createElement(vitarx.LazyWidget,{children:widget,...props}):vitarx.createElement(widget,props)}function cloneRouteLocation(route){const{matched,...other}=route;return Object.assign(vitarx.deepClone(other),{matched:Array.from(matched)})}const validInjectProps=props=>["boolean","function"].includes(typeof props);function normalizeInjectProps(route){if(!route.widget)return;const injectProps={},inputValue=route.injectProps??!0,type=typeof inputValue;if(type==="object")for(const name in route.widget){const value=inputValue[name];if(value&&!validInjectProps(value))throw new TypeError(`[Vitarx.Router][ERROR]：请检查 ${route.path} 路由线路配置，injectProps.${name}值错误，仅支持boolean、function类型`);injectProps[name]=value??!0}else if(type==="function"||type==="boolean")for(const name in route.widget)injectProps[name]=inputValue;else throw new TypeError(`[Vitarx.Router][ERROR]：请检查 ${route.path} 路由线路配置，injectProps属性配置错误，仅支持boolean、{key:boolean|function}、function类型`);route.injectProps=injectProps}const validWidgetType=(widget,path)=>{const type=typeof widget;if(type!=="function"){if(type==="object"){if(!widget.default)throw new TypeError(`[Vitarx.Router][ERROR]：请检查 ${path} 路由配置，widget传入对象时则认为是命名视图，命名视图必须具有default视图`);for(const k in widget)validWidgetType(widget[k],path);return}throw new TypeError(`[Vitarx.Router][ERROR]：请检查 ${path} 路由配置，widget配置无效`)}};function normalizeRouteWidget(route){const isGroup=route.children.length;if(route.widget)validWidgetType(route.widget,route.path);else if(!isGroup)throw new TypeError(`[Vitarx.Router][ERROR]：请检查 ${route.path} 路由配置，widget和children不能同时为空。`);typeof route.widget=="function"&&(route.widget={default:route.widget})}function normalizeRoute(route,group,suffix){if(route.meta=route.meta||{},route.pattern=route.pattern||{},route.children=route.children||[],!Array.isArray(route.children))throw new TypeError(`[Vitarx.Router][TYPE_ERROR]：${route.path} 路由线路配置 children 类型错误，它必须是数组类型。`);if(!route.path.trim())throw new TypeError("[Vitarx.Router][TYPE_ERROR]：路由线路配置 path 不能为空");return route.path=formatPath(group?`${group.path}/${route.path}`:route.path),normalizeRouteWidget(route),normalizeInjectProps(route),route.suffix??(route.suffix=(group==null?void 0:group.suffix)??suffix),route.afterEnter??(route.afterEnter=group==null?void 0:group.afterEnter),route.beforeEnter??(route.beforeEnter=group==null?void 0:group.beforeEnter),route}class RouterRegistry{constructor(options){__publicField(this,"_options");__publicField(this,"_namedRoutes",new Map);__publicField(this,"_dynamicRoutes",new Map);__publicField(this,"_pathRoutes",new Map);__publicField(this,"_parentRoute",new WeakMap);const config={base:"/",strict:!1,mode:"path",scrollBehavior:"smooth",suffix:"*",pattern:/[\w.]+/,defaultSuffix:"",...options};if(config.base=`/${config.base.replace(/^\/+|\/+$/g,"")}`,typeof config.suffix=="string"?config.suffix=config.suffix.replace(/\./g,""):Array.isArray(config.suffix)&&(config.suffix=config.suffix.map(item=>item.replace(/\./g,""))),config.defaultSuffix&&(config.defaultSuffix=config.defaultSuffix.replace(/\./g,"")),config.missing&&typeof config.missing!="function")throw new TypeError("[VitarxRouter][ERROR]：missing配置无效");this._options=config}get options(){return this._options}get mode(){return this._options.mode}get missing(){return this._options.missing}get pathRoutes(){return this._pathRoutes}get namedRoutes(){return this._namedRoutes}get dynamicRoutes(){return this._dynamicRoutes}get routes(){return this._options.routes}get basePath(){return this._options.base}get suffix(){return this._options.suffix}removeRoute(index){const deleteRoute=this.findRoute(index);if(deleteRoute)return this._pathRoutes.delete(deleteRoute.path),deleteRoute.name&&this._namedRoutes.delete(deleteRoute.name),this.removeDynamicRoute(deleteRoute.path),this.removedFromRoutes(deleteRoute),deleteRoute}addRoute(route,parent){if(parent){const parentRoute=this.findRoute(parent);if(!parentRoute)throw new Error(`[Vitarx.Router.addRoute][ERROR]：父路由${parent}不存在`);parentRoute.children.includes(parentRoute)||parentRoute.children.push(this.registerRoute(route,parentRoute))}else this.registerRoute(route),this._options.routes.push(route)}findRoute(target){const isRouterTarget=typeof target=="object",index=isRouterTarget?target.index:target;if(typeof index!="string")throw new TypeError(`[Vitarx.Router.getRoute][ERROR]：路由索引${target}类型错误，必须给定字符串类型`);if(index.startsWith("/")){const matched=this.matchRoute(index);return matched?(matched.params&&isRouterTarget&&(target.params=Object.assign(target.params||{},matched.params)),matched.route):void 0}return this.findNamedRoute(index)}findPathRoute(path){return this._options.strict||(path=path.toLowerCase()),this._pathRoutes.get(path)}findNamedRoute(name){return this._namedRoutes.get(name)}findParentRoute(route){return this._parentRoute.get(route)}matchRoute(path){let formattedPath=formatPath(path);this._options.strict||(formattedPath=formattedPath.toLowerCase());try{const{path:shortPath,suffix}=splitPathAndSuffix(formattedPath),staticRoute=this._pathRoutes.get(shortPath);if(staticRoute&&validateSuffix(suffix,staticRoute.suffix,formattedPath,staticRoute.path))return{route:staticRoute,params:void 0};const segmentCount=shortPath.split("/").filter(Boolean).length,candidates=this._dynamicRoutes.get(segmentCount);if(candidates){const normalizedPath=`${shortPath}/`,regexCache=new Map;for(const{regex,route}of candidates){const match=(regexCache.get(regex.source)||regex).exec(normalizedPath);if(!match)continue;const params={},keys=Object.keys(route.pattern);for(let i=0;i<keys.length;i++)params[keys[i]]=match[i+1];if(validateSuffix(suffix,route.suffix,formattedPath,formattedPath))return{route,params}}}if(!suffix&&!shortPath.endsWith("/index")){const indexRoute=this._pathRoutes.get(`${shortPath==="/"?"":shortPath}/index`);if(indexRoute&&validateSuffix(suffix,indexRoute.suffix,formattedPath,indexRoute.path))return{route:indexRoute,params:void 0}}else if(shortPath==="/index"){const indexRoute=this._pathRoutes.get("/");if(indexRoute&&validateSuffix(suffix,indexRoute.suffix,formattedPath,indexRoute.path))return{route:indexRoute,params:void 0}}}catch(error){console.error("Error in matchRoute:",error);return}}setupRoutes(routes){for(const route of routes)this.registerRoute(route)}removedFromRoutes(route){const parent=this.findParentRoute(route);if(parent!=null&&parent.children){const index2=parent.children.indexOf(route);index2!==-1&&parent.children.splice(index2,1)}const index=this._options.routes.indexOf(route);index!==-1&&this._options.routes.splice(index,1)}removeDynamicRoute(path){if(!isVariablePath(path))return;const length=path.split("/").filter(Boolean).length,removeRouteFromRecords=key=>{const records=this._dynamicRoutes.get(key);if(records){for(let i=0;i<records.length;i++)if(records[i].route.path===path){records.splice(i,1);break}}};removeRouteFromRecords(length);const count=optionalVariableCount(path);if(count>0)for(let i=1;i<=count;i++)removeRouteFromRecords(length-i)}registerRoute(route,group){const normalizedRoute=normalizeRoute(route,group,this.suffix);if(group&&this._parentRoute.set(normalizedRoute,group),isRouteGroup(normalizedRoute)){this.recordRoute(normalizedRoute);for(const child of normalizedRoute.children)this.registerRoute(child,normalizedRoute);normalizedRoute.redirect||(normalizedRoute.redirect=function(to){var _a;let first=normalizedRoute.children[0];for(;first;){if(first.redirect)return typeof first.redirect=="function"?first.redirect.call(this,to):first.redirect;if(first.widget)return{index:first.path};first=(_a=first.children)==null?void 0:_a[0]}console.error(`[Vitarx.Router][ERROR]：${normalizedRoute.path} 分组路由在没有配置重定向的情况下，它的第一个子路由必须具有widget或redirect，否则无法匹配视图`,normalizedRoute)})}else this.recordRoute(normalizedRoute);return normalizedRoute}strictPath(path){return this._options.strict?path:path.toLowerCase()}recordRoute(route){if(route.name){if(route.name.startsWith("/")&&(route.name=route.name.replace(/^\//,""),console.warn(`[Vitarx.Router][WARN]：命名路由(name)不要以/开头: ${route.name}，因为内部需要使用/区分path、name`)),this._namedRoutes.has(route.name))throw new Error(`[Vitarx.Router][ERROR]：检测到重复的路由名称(name): ${route.name}`);this._namedRoutes.set(route.name,route)}const path=this.strictPath(route.path);if(this._pathRoutes.has(path))throw new Error(`[Vitarx.Router][ERROR]：检测到重复的路由路径(path): ${route.path}`);this._pathRoutes.set(path,route),isVariablePath(route.path)&&this.recordDynamicRoute(route)}recordDynamicRoute(route){const{regex,length,optional}=createDynamicPattern(route.path,route.pattern,this.options.strict,this.options.pattern),addToLengthMap=len=>{this._dynamicRoutes.has(len)||this._dynamicRoutes.set(len,[]),this._dynamicRoutes.get(len).push({regex,route})};if(addToLengthMap(length),optional>0)for(let i=1;i<=optional;i++)addToLengthMap(length-i)}}const __stringValueKeys=["path","hash","index","fullPath"];function patchUpdate(location,newLocation){diffUpdateArrays(location.matched,newLocation.matched),diffUpdateObjects(location.params,newLocation.params),diffUpdateObjects(location.query,newLocation.query),diffUpdateObjects(location.meta,newLocation.meta);for(const key of __stringValueKeys)location[key]!==newLocation[key]&&(location[key]=newLocation[key])}function diffUpdateArrays(a,b){for(let i=0;i<b.length;i++)a[i]!==b[i]&&(a[i]=b[i]);a.length>b.length&&(a.length=b.length)}function diffUpdateObjects(a,b){const aKeys=new Set(Object.keys(a)),bKeys=Object.keys(b);for(const key of bKeys)a[key]=b[key],aKeys.delete(key);for(const key of aKeys)delete a[key]}const _RouterCore=class _RouterCore extends RouterRegistry{constructor(options){if(_RouterCore._instance)throw new Error("[Vitarx.Router.constructor]：路由器实例已存在，不能创建多个实例");super(options);__publicField(this,"_currentTaskId",null);__publicField(this,"_taskCounter",0);__publicField(this,"_pendingReplace",null);__publicField(this,"_pendingPush",null);__publicField(this,"_scrollBehaviorHandler");__publicField(this,"_currentRouteLocation");__publicField(this,"_readonlyRouteLocation");__publicField(this,"_isBrowser",typeof window<"u"&&typeof window.document<"u");__publicField(this,"_scrollBehavior","auto");this._currentRouteLocation=vitarx.reactive({index:this._options.base,path:this._options.base,hash:"",fullPath:"",params:{},query:{},matched:vitarx.shallowReactive([]),meta:vitarx.markRaw({}),suffix:""}),this._readonlyRouteLocation=vitarx.readonly(this._currentRouteLocation)}static get instance(){if(!_RouterCore._instance)throw new Error("[Vitarx.Router.instance]：路由器实例未初始化");return _RouterCore._instance}get initialized(){return _RouterCore._instance!==void 0}get isBrowser(){return this._isBrowser}get scrollBehavior(){return this._scrollBehavior}get options(){return this._options}get mode(){return this._options.mode}get currentRouteLocation(){return this._readonlyRouteLocation}get isPendingNavigation(){return!!(this._pendingReplace||this._pendingPush)}get pendingReplaceData(){return this._pendingReplace}get pendingPushData(){return this._pendingPush}static routeViewElement(route,name,index){return route?this.instance.createRouteViewElement(route,name):index===0&&name==="default"&&this.instance.missing&&!this.instance.isPendingNavigation?createViewElement(this.instance.missing,{}):void 0}back(){return this.go(-1)}forward(){return this.go(1)}replace(target){return typeof target=="string"?this.navigate({index:target,isReplace:!0}):(target.isReplace=!0,this.navigate(target))}push(target){return typeof target=="string"?this.navigate({index:target,isReplace:!1}):(target.isReplace=!1,this.navigate(target))}initialize(){return _RouterCore._instance?this:(this.setupRoutes(this._options.routes),typeof this.options.scrollBehavior=="function"?this._scrollBehaviorHandler=this.options.scrollBehavior:this._scrollBehavior=this.options.scrollBehavior,this.initializeRouter(),_RouterCore._instance=this,this)}scrollTo(scrollTarget){if(!(!this.isBrowser||!scrollTarget||typeof scrollTarget!="object"))try{if("el"in scrollTarget){const{el,...rest}=scrollTarget,element=typeof el=="string"?document.querySelector(el):el;element&&element instanceof Element&&(element.scrollIntoView?element.scrollIntoView({behavior:this.scrollBehavior,...rest}):window.scrollTo({behavior:this.scrollBehavior,top:element.getBoundingClientRect().top+window.scrollY,left:element.getBoundingClientRect().left+window.scrollX}));return}window.scrollTo({behavior:this.scrollBehavior,...scrollTarget})}catch(e){console.error("[Vitarx.Router.scrollTo][WARN]：滚动到指定位置时发生错误，请检查滚动目标参数是否正确",e)}}createRouteLocation(target){if(isRouteLocationTypeObject(target))return target;const route=this.findRoute(target),{index,query={},params={},hash=""}=target,path=route?mergePathParams(route.path,params):formatPath(index),matched=[];if(route){let parent=this.findParentRoute(route);for(;parent;)parent.widget&&matched.unshift(parent),parent=this.findParentRoute(parent);matched.push(route)}const meta=route!=null&&route.meta?vitarx.deepClone(route.meta):{},hashStr=formatHash(hash),suffix=getPathSuffix(index),fullPath=this.makeFullPath(path,query,hashStr,suffix);return{index,path,hash:hashStr,fullPath,params,query,matched,meta,suffix}}navigate(target){const taskId=++this._taskCounter;this._currentTaskId=taskId;const isCurrentTask=()=>this._currentTaskId===taskId,from=cloneRouteLocation(this.currentRouteLocation),performNavigation=async(_target,isRedirect)=>{const to=this.createRouteLocation(_target),matched=to.matched.at(-1);if(matched!=null&&matched.redirect){let redirectTarget;if(typeof matched.redirect=="object"&&matched.redirect.index)redirectTarget=matched.redirect;else if(typeof matched.redirect=="string")redirectTarget={index:matched.redirect};else if(typeof matched.redirect=="function"){const redirectHandleResult=matched.redirect.call(this,to);vitarx.isObject(redirectHandleResult)&&(redirectTarget=redirectHandleResult)}if(redirectTarget!=null&&redirectTarget.index)return performNavigation(redirectTarget,!0)}const createNavigateResult=(overrides={})=>({from,to,status:NavigateStatus.success,message:"导航成功",redirectFrom:isRedirect?target:void 0,...overrides});if(to.fullPath===this.currentRouteLocation.fullPath)return createNavigateResult({status:NavigateStatus.duplicated,message:"导航到相同的路由，被系统阻止！"});try{const result=await this.onBeforeEach(to,from);return result===!1?createNavigateResult({status:NavigateStatus.aborted,message:`导航到${to.index}目标时被前置守卫钩子阻止！`}):isCurrentTask()?typeof result=="object"&&result.index!==_target.index?(result.isReplace??(result.isReplace=!1),performNavigation(result,!0)):!to.matched.length&&!this.missing?createNavigateResult({status:NavigateStatus.not_matched,message:`未匹配到任何路由规则，被系统阻止！请检测目标索引(${to.index})是否已注册路由。`}):(_target.isReplace?(this._pendingReplace=to,this.replaceHistory(to)):(this._pendingPush=to,this.pushHistory(to)),createNavigateResult(!to.matched.length&&this.missing?{status:NavigateStatus.not_matched,message:`${to.fullPath}未匹配到任何路由规则，被系统允许访问，因为系统定义了missing视图。`}:void 0)):createNavigateResult({status:NavigateStatus.cancelled,message:"已被新的导航请求替代，取消此次导航！"})}catch(error){return console.error("[Vitarx.Router.navigate][ERROR]：导航时捕获到了异常",error),createNavigateResult({status:NavigateStatus.exception,message:"导航时捕获到了异常",error})}};return performNavigation(target,!1)}updateQuery(query){vitarx.isDeepEqual(this._currentRouteLocation.query,query)||(this._currentRouteLocation.query=query,this._currentRouteLocation.fullPath=this.makeFullPath(this._currentRouteLocation.path,query,this._currentRouteLocation.hash,this._currentRouteLocation.suffix))}updateHash(hash){typeof hash!="string"&&console.warn(`[Vitarx.Router.updateHash][WARN]：hash值只能是字符串类型，给定${hash}`);const newHash=formatHash(hash);newHash!==this._currentRouteLocation.hash&&(this._currentRouteLocation.hash=newHash,this._currentRouteLocation.fullPath=this.makeFullPath(this._currentRouteLocation.path,this._currentRouteLocation.query,newHash,this._currentRouteLocation.suffix))}createRouteViewElement(route,name){var _a,_b;const widget=(_a=route.widget)==null?void 0:_a[name];if(!widget)return;const injectPropsConfig=(_b=route.injectProps)==null?void 0:_b[name];let props;return injectPropsConfig===!0?props=this._currentRouteLocation.params:injectPropsConfig===!1?props={}:typeof injectPropsConfig=="function"?props=injectPropsConfig(this.currentRouteLocation):vitarx.isRecordObject(injectPropsConfig)?props=injectPropsConfig:props={},props.key=route.path,createViewElement(widget,props)}_completeViewRender(){}completeNavigation(savedPosition){const newData=this.pendingReplaceData||this.pendingPushData;if(!newData)throw new Error("[Vitarx.Router.completeNavigation][ERROR]：没有处于等待状态的导航请求。");const from=cloneRouteLocation(this.currentRouteLocation);this._completeViewRender=()=>{this.onScrollBehavior(this.currentRouteLocation,from,savedPosition).then(),this.onAfterEach(this.currentRouteLocation,from)},this.updateRouteLocation(newData),this._pendingReplace=null,this._pendingPush=null}makeFullPath(path,query,hash,suffix){return hash&&!hash.startsWith("#")&&(hash=`#${hash}`),typeof query=="object"&&(query=objectToQueryString(query)),path=addPathSuffix(path,suffix||this._options.defaultSuffix),this.mode==="hash"?formatPath(`${this.basePath}/${query}#${path}${hash}`):formatPath(`${this.basePath}${path}${query}${hash}`)}onBeforeEach(to,from){var _a;const matched=to.matched.at(-1);return matched&&"beforeEnter"in matched&&typeof matched.beforeEnter=="function"?matched.beforeEnter.call(this,to,from):(_a=this._options.beforeEach)==null?void 0:_a.call(this,to,from)}onAfterEach(to,from){var _a;const matched=to.matched.at(-1);if(matched)return"afterEnter"in matched&&typeof matched.afterEnter=="function"?matched.afterEnter.call(this,to,from):(_a=this._options.afterEach)==null?void 0:_a.call(this,to,from)}updateRouteLocation(newLocation){patchUpdate(this._currentRouteLocation,newLocation)}async onScrollBehavior(to,from,savedPosition){try{if(this._scrollBehaviorHandler){const scrollTarget=await this._scrollBehaviorHandler(to,from,savedPosition);scrollTarget&&this.scrollTo(scrollTarget)}else!savedPosition&&!to.hash?this.scrollTo({left:0,top:0}):this.scrollTo(savedPosition??{el:to.hash})}catch(e){console.error("[Vitarx.Router.onScrollBehavior]['ERROR']：处理滚动行为时捕获到了异常",e)}}removeRoute(index){const removed=super.removeRoute(index);if(removed){const index2=this._currentRouteLocation.matched.indexOf(removed);index2!==-1&&this._currentRouteLocation.matched.splice(index2,1)}return removed}};__publicField(_RouterCore,"_instance");let RouterCore=_RouterCore;class RouterHistory extends RouterCore{constructor(options){["path","hash"].includes(options.mode)||(options.mode="hash"),super(options),options.mode==="hash"&&this.ensureHash()}get currentRouteTarget(){return urlToRouteTarget(window.location,this.mode,this.basePath)}get webHistory(){return window.history}go(delta){this.webHistory.go(delta)}initializeRouter(){window.addEventListener("popstate",this.onPopState.bind(this)),this.replace(this.currentRouteTarget).then(res=>{res.status!==NavigateStatus.success&&console.warn(`[VitarxRouter.initializeRouter]：路由初始化匹配失败，${res.message}`)})}pushHistory(data){this.saveCurrentScrollPosition(),this.webHistory.pushState(this.createState(data),"",data.fullPath),this.completeNavigation()}replaceHistory(data){var _a;const scrollPosition=(_a=this.webHistory.state)==null?void 0:_a.scrollPosition;this.webHistory.replaceState(this.createState(data),"",data.fullPath),this.completeNavigation(scrollPosition)}saveCurrentScrollPosition(){const scrollPosition={left:window.scrollX,top:window.scrollY,behavior:this.scrollBehavior};this.webHistory.replaceState({...this.webHistory.state,scrollPosition},"",window.location.href)}createState(data,hash,query){const{matched,...state}=data;return typeof hash=="string"&&(state.hash=hash),typeof query=="object"&&(state.query=query),JSON.parse(JSON.stringify(state))}onPopState(event){var _a;let newTarget;(_a=event.state)!=null&&_a.index?newTarget={index:event.state.index,hash:event.state.hash,query:event.state.query}:newTarget=this.currentRouteTarget,this.replace(newTarget).then(res=>{if(!res.redirectFrom&&this.mode==="hash"&&res.status!==NavigateStatus.success)if(res.status===NavigateStatus.not_matched){if(res.to.index.startsWith("/")){const anchorId=res.to.index.slice(1),element=window.document.getElementById(anchorId);element&&element.scrollIntoView({behavior:this.scrollBehavior}),this.updateHash(`#${anchorId}`),this.webHistory.replaceState(this.createState(this.currentRouteLocation),"",this.currentRouteLocation.fullPath)}}else res.status===NavigateStatus.duplicated&&this.webHistory.replaceState(this.createState(this.currentRouteLocation),"",this.currentRouteLocation.fullPath)})}ensureHash(){const{pathname,search,hash}=window.location;if(!hash){const path=`${this.basePath}${search}#${pathname}`;window.location.replace(path)}}}class RouterMemory extends RouterCore{constructor(options){super(options);__publicField(this,"_history",[]);__publicField(this,"_pendingGo",null);__publicField(this,"_currentIndex",0);options.mode="memory"}get currentIndex(){return this._currentIndex}go(delta){if(!delta)return;const currentIndex=this.currentIndex,targetIndex=Math.max(0,Math.min(this._history.length-1,currentIndex+delta));if(targetIndex===currentIndex)return;const target=this._history[targetIndex];this._pendingGo=targetIndex,this.navigate(target).then(res=>{res.status!==NavigateStatus.success&&(this._pendingGo=null)})}initializeRouter(){this._history.push(this.currentRouteLocation)}pushHistory(data){this._updateHistory(data,!1)}replaceHistory(data){this._updateHistory(data,!0)}_updateHistory(data,isReplace){let newIndex;if(this._pendingGo!==null)this._history[this._pendingGo]=data,newIndex=this._pendingGo;else if(isReplace)this._history[this.currentIndex]=data,newIndex=this.currentIndex;else{const nextIndex=this.currentIndex+1;nextIndex<this._history.length?(this._history[nextIndex]=data,this._history.length=nextIndex+1,newIndex=nextIndex):(this._history.push(data),newIndex=this._history.length-1)}this._currentIndex=newIndex,this.completeNavigation(),this._pendingGo=null}}function defineRoutes(...routes){return routes}function defineRoute(route){return route}function createRouter(options){let router;return!(window!=null&&window.location)&&options.mode!=="memory"?(console.warn("当前环境非浏览器端，强制使用内存模式路由"),options.mode="memory",new RouterMemory(options).initialize()):(options.mode==="memory"?router=new RouterMemory(options):router=new RouterHistory(options),router.initialize())}function useRouter(){return RouterCore.instance}function useRoute(){return RouterCore.instance.currentRouteLocation}function lazy(lazyLoader){return Object.defineProperty(lazyLoader,LAZY_LOADER_SYMBOL,{value:!0}),lazyLoader}const INDEX_SYMBOL=Symbol("RouterViewCounter");class RouterView extends vitarx.Widget{constructor(props){super(props);__publicField(this,"_$index");__publicField(this,"_$currentRoute");__publicField(this,"_$currentElement",vitarx.shallowRef());const parentIndex=vitarx.inject(INDEX_SYMBOL,-1,this);this._$index=parentIndex+1,vitarx.provide(INDEX_SYMBOL,this._$index,this),this._$currentRoute=this.matchedRoute,this._$currentElement.value=RouterCore.routeViewElement(this._$currentRoute,this.name,this._$index),vitarx.watch(this.location.matched,(_c,o)=>{const newRoute=o[this.index];newRoute!==this._$currentRoute&&(this._$currentRoute=newRoute,this._$currentElement.value=RouterCore.routeViewElement(newRoute,this.name,this._$index))})}get index(){return this._$index}get isLastView(){return this.index===this.location.matched.length-1&&this.name==="default"}get name(){return this.props.name||"default"}get matchedRoute(){return this.location.matched[this.index]}get currentElement(){return this._$currentElement.value}get currentWidget(){var _a;return(_a=this._$currentElement.value)==null?void 0:_a.type}get location(){return RouterCore.instance.currentRouteLocation}onMounted(){this.completeViewRender()}onUpdated(){this.completeViewRender()}build(){return this.currentElement||vitarx.createElement(vitarx.Fragment)}completeViewRender(){this.isLastView&&RouterCore.instance._completeViewRender()}}class RouterLink extends vitarx.Widget{constructor(props){super(props);__publicField(this,"target");__publicField(this,"location");__publicField(this,"active");__publicField(this,"htmlProps");this.target=new vitarx.Computed(()=>{if(!this.props.to)return;const to=vitarx.isString(props.to)?{index:props.to}:props.to;return RouterLink.isHttpOrHttpsUrl(to.index)?to.index:to}),this.location=new vitarx.Computed(()=>{if(!this.target.value||typeof this.target.value=="string")return;const location=RouterCore.instance.createRouteLocation(this.target.value);return location.matched.length||console.warn(`[Vitarx.RouterLink][WARN]：索引：${this.target.value.index}，未匹配到任何有效的路由线路，请检查to属性是否配置正确！`),location}),props.active!==void 0&&props.active!=="none"&&(this.active=new vitarx.Computed(()=>!this.location.value||typeof this.target.value=="string"||!this.target.value?!1:this.target.value.index.startsWith("/")?props.active==="obscure"?this.location.value.path==="/"?RouterCore.instance.currentRouteLocation.path==="/":RouterCore.instance.currentRouteLocation.fullPath.startsWith(this.location.value.path):this.location.value.path===RouterCore.instance.currentRouteLocation.path:!!RouterCore.instance.currentRouteLocation.matched.find(route=>route.name===this.target.value.index))),this.htmlProps=new vitarx.Computed(()=>{var _a;const props2={href:this.href,onClick:e=>this.navigate(e),children:this.children??((_a=this.location.value)==null?void 0:_a.index),draggable:this.props.draggable??!1,"v-bind":[this.props,["to","children","href","disabled","active","callback","onClick","onclick","aria-current"]]};return this.isActive&&(props2["aria-current"]="page"),this.isDisabled&&(props2.disabled=!0),props2})}static isHttpOrHttpsUrl(url){return/^(https?):\/\/[^\s\/$.?#].\S*$/i.test(url)}get isActive(){var _a;return((_a=this.active)==null?void 0:_a.value)&&!this.isDisabled}get isDisabled(){return this.props.disabled??!1}get href(){var _a;return typeof this.target.value=="string"?this.target.value:((_a=this.location.value)==null?void 0:_a.fullPath)||"javascript:void(0)"}navigate(e){typeof this.target.value!="string"&&(e.preventDefault(),this.location.value&&!this.isDisabled&&RouterCore.instance.navigate(this.location.value).then(res=>{var _a;res.status!==NavigateStatus.success&&console.warn(`[Vitarx.RouterLink][WARN]：导航到索引：${(_a=this.target.value)==null?void 0:_a.index}失败，${res.message}`),this.props.callback&&this.props.callback(res)}))}build(){return vitarx.createElement("a",this.htmlProps.value)}}exports2.HistoryRouter=RouterHistory,exports2.MemoryRouter=RouterMemory,exports2.NavigateStatus=NavigateStatus,exports2.Router=RouterCore,exports2.RouterLink=RouterLink,exports2.RouterView=RouterView,exports2.createRouter=createRouter,exports2.defineRoute=defineRoute,exports2.defineRoutes=defineRoutes,exports2.lazy=lazy,exports2.useRoute=useRoute,exports2.useRouter=useRouter,Object.defineProperty(exports2,Symbol.toStringTag,{value:"Module"})});
+(function(global,factory){typeof exports=="object"&&typeof module<"u"?factory(exports,require("vitarx")):typeof define=="function"&&define.amd?define(["exports","vitarx"],factory):(global=typeof globalThis<"u"?globalThis:global||self,factory(global.VitarxRouter={},global.Vitarx))})(this,function(exports2,vitarx){"use strict";var __defProp=Object.defineProperty;var __defNormalProp=(obj,key,value)=>key in obj?__defProp(obj,key,{enumerable:!0,configurable:!0,writable:!0,value}):obj[key]=value;var __publicField=(obj,key,value)=>__defNormalProp(obj,typeof key!="symbol"?key+"":key,value);var NavigateStatus=(NavigateStatus2=>(NavigateStatus2[NavigateStatus2.success=0]="success",NavigateStatus2[NavigateStatus2.aborted=1]="aborted",NavigateStatus2[NavigateStatus2.cancelled=2]="cancelled",NavigateStatus2[NavigateStatus2.duplicated=3]="duplicated",NavigateStatus2[NavigateStatus2.not_matched=4]="not_matched",NavigateStatus2[NavigateStatus2.exception=5]="exception",NavigateStatus2))(NavigateStatus||{});function isVariablePath(path){return/\{[^}]+}/.test(path)}function optionalVariableCount(path){const pathWithoutSpaces=path.replace(/\s+/g,""),regex=/\{[\w-]+\?}/g,matches=pathWithoutSpaces.match(regex);return matches?matches.length:0}function isRouteGroup(route){return"children"in route&&route.children!==void 0&&route.children.length>0}function createDynamicPattern(path,pattern,strict,defaultPattern){let optional=0;const processVariable=(varName,isOptional)=>{const regex=pattern[varName];if(regex?regex instanceof RegExp||(console.warn(`[Vitarx.Router][WARN]：${path} 动态路径${varName}变量的自定义正则表达式必须是 RegExp 类型`),pattern[varName]=defaultPattern):pattern[varName]=defaultPattern,isOptional)return optional++,`(?:(${pattern[varName].source}))?`;if(optional)throw new Error(`[Vitarx.Router][ERROR]：动态路径 ${path} 中，可选变量 ${varName} 后不能存在任何必填变量`);return`(${pattern[varName].source})`},processedPath=path.replace(/{([^}?]+)\?}/g,(_,varName)=>processVariable(varName,!0)).replace(/{([^}]+)}/g,(_,varName)=>processVariable(varName,!1)).replace(/\//g,"\\/").replace(/\/?$/,"/?"),flags=strict?"":"i",segments=path.replace(/^\/|\/$/g,"").split("/").length;return{regex:new RegExp(`^${processedPath}$`,flags),length:segments,optional}}function formatPath(path){return path=`/${path}`.replace(/\s+/g,"").replace(/\/+/g,"/"),path.length?path==="/"||path==="/#/"?path:path.replace(/\/$/,""):"/"}function mergePathParams(path,params){if(!isVariablePath(path))return path;const oldPath=path;return path=path.replace(/{([^}]+)\?*}/g,(_match,paramName)=>{const isOptional=paramName.endsWith("?");if(isOptional&&(paramName=paramName.slice(0,-1)),params[paramName]===void 0){if(isOptional)return"";throw new TypeError(`[Vitarx.Router.mergePathParams] 访问路由${oldPath}时缺少参数：${paramName}`)}return String(params[paramName]).replace(/\s+/g,"_")}),formatPath(path)}function formatHash(hash,addHashPrefix){return typeof hash!="string"||!hash?"":(hash=hash.trim(),hash.startsWith("#")?hash:`#${hash}`)}function queryStringToObject(queryString){queryString=decodeURIComponent(queryString);const params=new URLSearchParams(queryString.startsWith("?")?queryString.substring(1):queryString),obj={};return params.forEach((value,key)=>obj[key]=value),obj}function objectToQueryString(obj){const queryString=new URLSearchParams(obj).toString();return queryString?`?${queryString}`:""}function urlToRouteTarget(url,mode,base){let path=decodeURIComponent(url.pathname),hash=decodeURIComponent(url.hash),query=queryStringToObject(url.search);if(path=formatPath(path.startsWith(base)?path.slice(base.length):path),mode==="hash"&&hash.includes("#/")){const hashPart=hash.slice(1),[fullPath,anchor]=hashPart.split("#");path=formatPath(fullPath||"/"),hash=anchor?`#${anchor}`:""}return{index:path,hash,query}}function splitPathAndSuffix(path){const suffix=getPathSuffix(path);return suffix&&(path=path.slice(0,-suffix.length)),{path,suffix:suffix.substring(1)}}function getPathSuffix(path){const lastDotIndex=path.lastIndexOf(".");return lastDotIndex!==-1&&lastDotIndex<path.length-1?`.${path.substring(lastDotIndex+1)}`:""}function isRouteLocationTypeObject(obj){if(typeof obj!="object"||obj===null)return!1;const keys=["index","fullPath","path","hash","params","query","matched","meta"];for(const key of keys)if(!Object.prototype.hasOwnProperty.call(obj,key))return!1;return!0}function validateSuffix(suffix,allowSuffix,inputPath,routePath){return inputPath==="/"||allowSuffix==="*"?!0:allowSuffix===!1?inputPath===routePath:Array.isArray(allowSuffix)?allowSuffix.includes(suffix):suffix===allowSuffix}function addPathSuffix(path,suffix){return suffix&&!path.endsWith("/")&&!path.includes(".")&&(path+=suffix.startsWith(".")?suffix:`.${suffix}`),path}function cloneRouteLocation(route){const{matched,...other}=route;return Object.assign(vitarx.deepClone(other),{matched:Array.from(matched)})}const validInjectProps=props=>["boolean","function"].includes(typeof props);function normalizeInjectProps(route){if(!route.widget)return;const injectProps={},inputValue=route.injectProps??!0,type=typeof inputValue;if(type==="object")for(const name in route.widget){const value=inputValue[name];if(value&&!validInjectProps(value))throw new TypeError(`[Vitarx.Router][ERROR]：请检查 ${route.path} 路由线路配置，injectProps.${name}值错误，仅支持boolean、function类型`);injectProps[name]=value??!0}else if(type==="function"||type==="boolean")for(const name in route.widget)injectProps[name]=inputValue;else throw new TypeError(`[Vitarx.Router][ERROR]：请检查 ${route.path} 路由线路配置，injectProps属性配置错误，仅支持boolean、{key:boolean|function}、function类型`);route.injectProps=injectProps}const validWidgetType=(widget,path)=>{const type=typeof widget;if(type!=="function"){if(type==="object"){if(!widget.default)throw new TypeError(`[Vitarx.Router][ERROR]：请检查 ${path} 路由配置，widget传入对象时则认为是命名视图，命名视图必须具有default视图`);for(const k in widget)validWidgetType(widget[k],path);return}throw new TypeError(`[Vitarx.Router][ERROR]：请检查 ${path} 路由配置，widget配置无效`)}};function normalizeRouteWidget(route){const isGroup=route.children.length;if(route.widget)validWidgetType(route.widget,route.path);else if(!isGroup)throw new TypeError(`[Vitarx.Router][ERROR]：请检查 ${route.path} 路由配置，widget和children不能同时为空。`);typeof route.widget=="function"&&(route.widget={default:route.widget})}function normalizeRoute(route,group,suffix){if(route.meta=route.meta||{},route.pattern=route.pattern||{},route.children=route.children||[],!Array.isArray(route.children))throw new TypeError(`[Vitarx.Router][TYPE_ERROR]：${route.path} 路由线路配置 children 类型错误，它必须是数组类型。`);if(!route.path.trim())throw new TypeError("[Vitarx.Router][TYPE_ERROR]：路由线路配置 path 不能为空");return route.path=formatPath(group?`${group.path}/${route.path}`:route.path),normalizeRouteWidget(route),normalizeInjectProps(route),route.suffix??(route.suffix=(group==null?void 0:group.suffix)??suffix),route.afterEnter??(route.afterEnter=group==null?void 0:group.afterEnter),route.beforeEnter??(route.beforeEnter=group==null?void 0:group.beforeEnter),route}class RouterRegistry{constructor(options){__publicField(this,"_options");__publicField(this,"_namedRoutes",new Map);__publicField(this,"_dynamicRoutes",new Map);__publicField(this,"_pathRoutes",new Map);__publicField(this,"_parentRoute",new WeakMap);const config={base:"/",strict:!1,mode:"path",scrollBehavior:"auto",anchorsScrollBehavior:"auto",suffix:"*",pattern:/[\w.]+/,defaultSuffix:"",...options};if(config.base=`/${config.base.replace(/^\/+|\/+$/g,"")}`,typeof config.suffix=="string"?config.suffix=config.suffix.replace(/\./g,""):Array.isArray(config.suffix)&&(config.suffix=config.suffix.map(item=>item.replace(/\./g,""))),config.defaultSuffix&&(config.defaultSuffix=config.defaultSuffix.replace(/\./g,"")),config.missing&&typeof config.missing!="function")throw new TypeError("[VitarxRouter][ERROR]：missing配置无效");this._options=config}get options(){return this._options}get mode(){return this._options.mode}get missing(){return this._options.missing}get pathRoutes(){return this._pathRoutes}get namedRoutes(){return this._namedRoutes}get dynamicRoutes(){return this._dynamicRoutes}get routes(){return this._options.routes}get basePath(){return this._options.base}get suffix(){return this._options.suffix}removeRoute(index){const deleteRoute=this.findRoute(index);if(deleteRoute)return this._pathRoutes.delete(deleteRoute.path),deleteRoute.name&&this._namedRoutes.delete(deleteRoute.name),this.removeDynamicRoute(deleteRoute.path),this.removedFromRoutes(deleteRoute),deleteRoute}addRoute(route,parent){if(parent){const parentRoute=this.findRoute(parent);if(!parentRoute)throw new Error(`[Vitarx.Router.addRoute][ERROR]：父路由${parent}不存在`);parentRoute.children.includes(parentRoute)||parentRoute.children.push(this.registerRoute(route,parentRoute))}else this.registerRoute(route),this._options.routes.push(route)}findRoute(target){const isRouterTarget=typeof target=="object",index=isRouterTarget?target.index:target;if(typeof index!="string")throw new TypeError(`[Vitarx.Router.getRoute][ERROR]：路由索引${target}类型错误，必须给定字符串类型`);if(index.startsWith("/")){const matched=this.matchRoute(index);return matched?(matched.params&&isRouterTarget&&(target.params=Object.assign(target.params||{},matched.params)),matched.route):void 0}return this.findNamedRoute(index)}findPathRoute(path){return this._options.strict||(path=path.toLowerCase()),this._pathRoutes.get(path)}findNamedRoute(name){return this._namedRoutes.get(name)}findParentRoute(route){return this._parentRoute.get(route)}matchRoute(path){let formattedPath=formatPath(path);this._options.strict||(formattedPath=formattedPath.toLowerCase());try{const{path:shortPath,suffix}=splitPathAndSuffix(formattedPath),staticRoute=this._pathRoutes.get(shortPath);if(staticRoute&&validateSuffix(suffix,staticRoute.suffix,formattedPath,staticRoute.path))return{route:staticRoute,params:void 0};const segmentCount=shortPath.split("/").filter(Boolean).length,candidates=this._dynamicRoutes.get(segmentCount);if(candidates){const normalizedPath=`${shortPath}/`,regexCache=new Map;for(const{regex,route}of candidates){const match=(regexCache.get(regex.source)||regex).exec(normalizedPath);if(!match)continue;const params={},keys=Object.keys(route.pattern);for(let i=0;i<keys.length;i++)params[keys[i]]=match[i+1];if(validateSuffix(suffix,route.suffix,formattedPath,formattedPath))return{route,params}}}if(!suffix&&!shortPath.endsWith("/index")){const indexRoute=this._pathRoutes.get(`${shortPath==="/"?"":shortPath}/index`);if(indexRoute&&validateSuffix(suffix,indexRoute.suffix,formattedPath,indexRoute.path))return{route:indexRoute,params:void 0}}else if(shortPath==="/index"){const indexRoute=this._pathRoutes.get("/");if(indexRoute&&validateSuffix(suffix,indexRoute.suffix,formattedPath,indexRoute.path))return{route:indexRoute,params:void 0}}}catch(error){console.error("Error in matchRoute:",error);return}}setupRoutes(routes){for(const route of routes)this.registerRoute(route)}removedFromRoutes(route){const parent=this.findParentRoute(route);if(parent!=null&&parent.children){const index2=parent.children.indexOf(route);index2!==-1&&parent.children.splice(index2,1)}const index=this._options.routes.indexOf(route);index!==-1&&this._options.routes.splice(index,1)}removeDynamicRoute(path){if(!isVariablePath(path))return;const length=path.split("/").filter(Boolean).length,removeRouteFromRecords=key=>{const records=this._dynamicRoutes.get(key);if(records){for(let i=0;i<records.length;i++)if(records[i].route.path===path){records.splice(i,1);break}}};removeRouteFromRecords(length);const count=optionalVariableCount(path);if(count>0)for(let i=1;i<=count;i++)removeRouteFromRecords(length-i)}registerRoute(route,group){const normalizedRoute=normalizeRoute(route,group,this.suffix);if(group&&this._parentRoute.set(normalizedRoute,group),isRouteGroup(normalizedRoute)){this.recordRoute(normalizedRoute);for(const child of normalizedRoute.children)this.registerRoute(child,normalizedRoute);normalizedRoute.redirect||(normalizedRoute.redirect=function(to){var _a;let first=normalizedRoute.children[0];for(;first;){if(first.redirect)return typeof first.redirect=="function"?first.redirect.call(this,to):first.redirect;if(first.widget)return{index:first.path};first=(_a=first.children)==null?void 0:_a[0]}console.error(`[Vitarx.Router][ERROR]：${normalizedRoute.path} 分组路由在没有配置重定向的情况下，它的第一个子路由必须具有widget或redirect，否则无法匹配视图`,normalizedRoute)})}else this.recordRoute(normalizedRoute);return normalizedRoute}strictPath(path){return this._options.strict?path:path.toLowerCase()}recordRoute(route){if(route.name){if(route.name.startsWith("/")&&(route.name=route.name.replace(/^\//,""),console.warn(`[Vitarx.Router][WARN]：命名路由(name)不要以/开头: ${route.name}，因为内部需要使用/区分path、name`)),this._namedRoutes.has(route.name))throw new Error(`[Vitarx.Router][ERROR]：检测到重复的路由名称(name): ${route.name}`);this._namedRoutes.set(route.name,route)}const path=this.strictPath(route.path);if(this._pathRoutes.has(path))throw new Error(`[Vitarx.Router][ERROR]：检测到重复的路由路径(path): ${route.path}`);this._pathRoutes.set(path,route),isVariablePath(route.path)&&this.recordDynamicRoute(route)}recordDynamicRoute(route){const{regex,length,optional}=createDynamicPattern(route.path,route.pattern,this.options.strict,this.options.pattern),addToLengthMap=len=>{this._dynamicRoutes.has(len)||this._dynamicRoutes.set(len,[]),this._dynamicRoutes.get(len).push({regex,route})};if(addToLengthMap(length),optional>0)for(let i=1;i<=optional;i++)addToLengthMap(length-i)}}const __stringValueKeys=["path","hash","index","fullPath"];function patchUpdate(location,newLocation){diffUpdateArrays(location.matched,newLocation.matched),diffUpdateObjects(location.params,newLocation.params),diffUpdateObjects(location.query,newLocation.query),diffUpdateObjects(location.meta,newLocation.meta);for(const key of __stringValueKeys)location[key]!==newLocation[key]&&(location[key]=newLocation[key])}function diffUpdateArrays(a,b){for(let i=0;i<b.length;i++)a[i]!==b[i]&&(a[i]=b[i]);a.length>b.length&&(a.length=b.length)}function diffUpdateObjects(a,b){const aKeys=new Set(Object.keys(a)),bKeys=Object.keys(b);for(const key of bKeys)a[key]=b[key],aKeys.delete(key);for(const key of aKeys)delete a[key]}function diffUpdateProps(oldProps,newProps){const removeKeys=new Set(Object.keys(oldProps)),bKeys=Object.keys(newProps),changes=[];for(const key of bKeys)key!=="key"&&(oldProps[key]!==newProps[key]&&(oldProps[key]=newProps[key],changes.push(key)),removeKeys.delete(key));changes.push(...removeKeys);for(const key of removeKeys)delete oldProps[key];return changes}const _RouterCore=class _RouterCore extends RouterRegistry{constructor(options){if(_RouterCore._instance)throw new Error("[Vitarx.Router.constructor]：路由器实例已存在，不能创建多个实例");super(options);__publicField(this,"_currentTaskId",null);__publicField(this,"_taskCounter",0);__publicField(this,"_pendingReplace",null);__publicField(this,"_pendingPush",null);__publicField(this,"_scrollBehaviorHandler");__publicField(this,"_currentRouteLocation");__publicField(this,"_readonlyRouteLocation");__publicField(this,"_isBrowser",typeof window<"u"&&typeof window.document<"u");__publicField(this,"_scrollBehavior","auto");this._currentRouteLocation=vitarx.reactive({index:this._options.base,path:this._options.base,hash:"",fullPath:"",params:{},query:{},matched:vitarx.shallowReactive([]),meta:vitarx.markRaw({}),suffix:""}),this._readonlyRouteLocation=vitarx.readonly(this._currentRouteLocation)}static get instance(){if(!_RouterCore._instance)throw new Error("[Vitarx.Router.instance]：路由器实例未初始化");return _RouterCore._instance}get initialized(){return _RouterCore._instance!==void 0}get isBrowser(){return this._isBrowser}get scrollBehavior(){return this._scrollBehavior}get options(){return this._options}get mode(){return this._options.mode}get currentRouteLocation(){return this._readonlyRouteLocation}get isPendingNavigation(){return!!(this._pendingReplace||this._pendingPush)}get pendingReplaceData(){return this._pendingReplace}get pendingPushData(){return this._pendingPush}static routeViewElement(route,name,index){return route?this.instance.createRouteViewElement(route,name):index===0&&name==="default"&&this.instance.missing&&!this.instance.isPendingNavigation?vitarx.createElement(this.instance.missing):void 0}back(){return this.go(-1)}forward(){return this.go(1)}replace(target){return typeof target=="string"?this.navigate({index:target,isReplace:!0}):(target.isReplace=!0,this.navigate(target))}push(target){return typeof target=="string"?this.navigate({index:target,isReplace:!1}):(target.isReplace=!1,this.navigate(target))}initialize(){return _RouterCore._instance?this:(this.setupRoutes(this._options.routes),typeof this.options.scrollBehavior=="function"?this._scrollBehaviorHandler=this.options.scrollBehavior:this._scrollBehavior=this.options.scrollBehavior,this.initializeRouter(),_RouterCore._instance=this,this)}scrollTo(scrollTarget){if(!(!this.isBrowser||!scrollTarget||typeof scrollTarget!="object"))try{if("el"in scrollTarget){const{el,...rest}=scrollTarget,element=typeof el=="string"?document.querySelector(el):el;element&&element instanceof Element&&(element.scrollIntoView?element.scrollIntoView({behavior:this.scrollBehavior,...rest}):window.scrollTo({behavior:this.scrollBehavior,top:element.getBoundingClientRect().top+window.scrollY,left:element.getBoundingClientRect().left+window.scrollX}));return}window.scrollTo({behavior:this.scrollBehavior,...scrollTarget})}catch(e){console.error("[Vitarx.Router.scrollTo][WARN]：滚动到指定位置时发生错误，请检查滚动目标参数是否正确",e)}}createRouteLocation(target){if(isRouteLocationTypeObject(target))return target;const route=this.findRoute(target),{index,query={},params={},hash=""}=target,path=route?mergePathParams(route.path,params):formatPath(index),matched=[];if(route){let parent=this.findParentRoute(route);for(;parent;)parent.widget&&matched.unshift(parent),parent=this.findParentRoute(parent);matched.push(route)}const meta=route!=null&&route.meta?vitarx.deepClone(route.meta):{},hashStr=formatHash(hash),suffix=getPathSuffix(index),fullPath=this.makeFullPath(path,query,hashStr,suffix);return{index,path,hash:hashStr,fullPath,params,query,matched,meta,suffix}}navigate(target){const taskId=++this._taskCounter;this._currentTaskId=taskId;const isCurrentTask=()=>this._currentTaskId===taskId,from=cloneRouteLocation(this.currentRouteLocation),performNavigation=async(_target,isRedirect)=>{const createNavigateResult=(overrides={})=>({from,to,status:NavigateStatus.success,message:"导航成功",redirectFrom:isRedirect?target:void 0,...overrides}),to=this.createRouteLocation(_target);if(to.fullPath===this.currentRouteLocation.fullPath&&vitarx.isDeepEqual(to.params,this.currentRouteLocation.params))return createNavigateResult({status:NavigateStatus.duplicated,message:"导航到相同的路由，被系统阻止！"});if(to.matched.at(-1)===this._currentRouteLocation.matched.at(-1)&&to.path===this._currentRouteLocation.path&&vitarx.isDeepEqual(to.query,this._currentRouteLocation.query)&&to.hash!==this._currentRouteLocation.hash)return this.updateHash(to.hash),createNavigateResult({status:NavigateStatus.success,message:"仅hash变化，导航成功！"});const matched=to.matched.at(-1);if(matched!=null&&matched.redirect){let redirectTarget;if(typeof matched.redirect=="object"&&matched.redirect.index)redirectTarget=matched.redirect;else if(typeof matched.redirect=="string")redirectTarget={index:matched.redirect};else if(typeof matched.redirect=="function"){const redirectHandleResult=matched.redirect.call(this,to);vitarx.isObject(redirectHandleResult)&&(redirectTarget=redirectHandleResult)}if(redirectTarget!=null&&redirectTarget.index)return performNavigation(redirectTarget,!0)}try{const result=await this.onBeforeEach(to,from);return result===!1?createNavigateResult({status:NavigateStatus.aborted,message:`导航到${to.index}目标时被前置守卫钩子阻止！`}):isCurrentTask()?typeof result=="object"&&result.index!==_target.index?(result.isReplace??(result.isReplace=!1),performNavigation(result,!0)):typeof result=="string"&&result!==_target.index?performNavigation({index:result,isReplace:!1},!0):!to.matched.length&&!this.missing?createNavigateResult({status:NavigateStatus.not_matched,message:`未匹配到任何路由规则，被系统阻止！请检测目标索引(${to.index})是否已注册路由。`}):("isReplace"in _target&&_target.isReplace?(this._pendingReplace=to,this.replaceHistory(to)):(this._pendingPush=to,this.pushHistory(to)),createNavigateResult(!to.matched.length&&this.missing?{status:NavigateStatus.not_matched,message:`${to.fullPath}未匹配到任何路由规则，被系统允许访问，因为系统定义了missing视图。`}:void 0)):createNavigateResult({status:NavigateStatus.cancelled,message:"已被新的导航请求替代，取消此次导航！"})}catch(error){return console.error("[Vitarx.Router.navigate][ERROR]：导航时捕获到了异常",error),createNavigateResult({status:NavigateStatus.exception,message:"导航时捕获到了异常",error})}};return performNavigation(target,!1)}updateQuery(query){vitarx.isDeepEqual(this._currentRouteLocation.query,query)||(this._currentRouteLocation.query=query,this._currentRouteLocation.fullPath=this.makeFullPath(this._currentRouteLocation.path,query,this._currentRouteLocation.hash,this._currentRouteLocation.suffix))}updateHash(hash){if(typeof hash!="string")throw new TypeError(`[Vitarx.Router.updateHash][WARN]：hash值只能是字符串类型，给定${hash}`);const newHash=formatHash(hash);newHash!==this._currentRouteLocation.hash&&(this._currentRouteLocation.hash=newHash,this._currentRouteLocation.fullPath=this.makeFullPath(this._currentRouteLocation.path,this._currentRouteLocation.query,newHash,this._currentRouteLocation.suffix))}createViewProps(route,name){var _a;const injectProps=(_a=route.injectProps)==null?void 0:_a[name];let props;return injectProps===!0?props=JSON.parse(JSON.stringify(this._currentRouteLocation.params)):injectProps===!1?props={}:typeof injectProps=="function"?props=injectProps(this.currentRouteLocation):vitarx.isRecordObject(injectProps)?props=injectProps:props={},props}createRouteViewElement(route,name){var _a;const widget=(_a=route.widget)==null?void 0:_a[name];if(!widget)return;const props=this.createViewProps(route,name);return props.key=route.path,vitarx.createElement(widget,props)}_completeViewRender(){}completeNavigation(savedPosition){const newData=this.pendingReplaceData||this.pendingPushData;if(!newData)throw new Error("[Vitarx.Router.completeNavigation][ERROR]：没有处于等待状态的导航请求。");const from=cloneRouteLocation(this.currentRouteLocation);this._completeViewRender=()=>{this.onScrollBehavior(this.currentRouteLocation,from,savedPosition).then(),this.onAfterEach(this.currentRouteLocation,from)},this.updateRouteLocation(newData),this._pendingReplace=null,this._pendingPush=null}makeFullPath(path,query,hash,suffix){return hash&&!hash.startsWith("#")&&(hash=`#${hash}`),typeof query=="object"&&(query=objectToQueryString(query)),path=addPathSuffix(path,suffix||this._options.defaultSuffix),this.mode==="hash"?formatPath(`${this.basePath}/${query}#${path}${hash}`):formatPath(`${this.basePath}${path}${query}${hash}`)}onBeforeEach(to,from){var _a;const matched=to.matched.at(-1);return matched&&"beforeEnter"in matched&&typeof matched.beforeEnter=="function"?matched.beforeEnter.call(this,to,from):(_a=this._options.beforeEach)==null?void 0:_a.call(this,to,from)}onAfterEach(to,from){var _a;const matched=to.matched.at(-1);if(matched)return"afterEnter"in matched&&typeof matched.afterEnter=="function"?matched.afterEnter.call(this,to,from):(_a=this._options.afterEach)==null?void 0:_a.call(this,to,from)}updateRouteLocation(newLocation){patchUpdate(this._currentRouteLocation,newLocation)}async onScrollBehavior(to,from,savedPosition){try{if(this._scrollBehaviorHandler){const scrollTarget=await this._scrollBehaviorHandler(to,from,savedPosition);scrollTarget&&this.scrollTo(scrollTarget)}else!savedPosition&&!to.hash?this.scrollTo({left:0,top:0}):this.scrollTo(savedPosition??{el:to.hash})}catch(e){console.error("[Vitarx.Router.onScrollBehavior]['ERROR']：处理滚动行为时捕获到了异常",e)}}removeRoute(index){const removed=super.removeRoute(index);if(removed){const index2=this._currentRouteLocation.matched.indexOf(removed);index2!==-1&&this._currentRouteLocation.matched.splice(index2,1)}return removed}install(app){app.register("router",this)}};__publicField(_RouterCore,"_instance");let RouterCore=_RouterCore;class RouterHistory extends RouterCore{constructor(options){["path","hash"].includes(options.mode)||(options.mode="hash"),super(options),options.mode==="hash"&&this.ensureHash()}updateHash(hash){if(super.updateHash(hash),this.saveCurrentScrollPosition(),this.webHistory.pushState(this.createState(this.currentRouteLocation),"",this.currentRouteLocation.fullPath),!hash.trim())window.scrollTo(0,0);else{const anchorId=hash.startsWith("#")?hash.slice(1):hash;try{const element=window.document.getElementById(anchorId);element&&element.scrollIntoView({behavior:this.options.anchorsScrollBehavior})}catch(e){console.error(`滚动到目标锚点${hash}失败`,e)}}}updateQuery(query){super.updateQuery(query),this.webHistory.pushState(this.createState(this.currentRouteLocation),"",this.currentRouteLocation.fullPath)}get currentRouteTarget(){return urlToRouteTarget(window.location,this.mode,this.basePath)}get webHistory(){return window.history}go(delta){this.webHistory.go(delta)}initializeRouter(){window.addEventListener("popstate",this.onPopState.bind(this)),this.replace(this.currentRouteTarget).then(res=>{res.status!==NavigateStatus.success&&console.warn(`[VitarxRouter.initializeRouter]：路由初始化匹配失败，${res.message}`)})}pushHistory(data){this.saveCurrentScrollPosition(),this.webHistory.pushState(this.createState(data),"",data.fullPath),this.completeNavigation()}replaceHistory(data){var _a;const scrollPosition=(_a=this.webHistory.state)==null?void 0:_a.scrollPosition;this.webHistory.replaceState(this.createState(data),"",data.fullPath),this.completeNavigation(scrollPosition)}saveCurrentScrollPosition(){const scrollPosition={left:window.scrollX,top:window.scrollY,behavior:this.scrollBehavior};this.webHistory.replaceState({...this.webHistory.state,scrollPosition},"",window.location.href)}createState(data,hash,query){const{matched,...state}=data;return typeof hash=="string"&&(state.hash=hash),typeof query=="object"&&(state.query=query),JSON.parse(JSON.stringify(state))}onPopState(event){var _a;let newTarget;(_a=event.state)!=null&&_a.index?newTarget={index:event.state.index,hash:event.state.hash,query:event.state.query}:newTarget=this.currentRouteTarget,this.replace(newTarget).then(res=>{if(!res.redirectFrom&&this.mode==="hash"&&res.status!==NavigateStatus.success)if(res.status===NavigateStatus.not_matched){if(res.to.index.startsWith("/")){const anchorId=res.to.index.slice(1),element=window.document.getElementById(anchorId);element&&element.scrollIntoView({behavior:this.scrollBehavior}),this.updateHash(`#${anchorId}`)}}else res.status===NavigateStatus.duplicated&&this.webHistory.replaceState(this.createState(this.currentRouteLocation),"",this.currentRouteLocation.fullPath)})}ensureHash(){const{pathname,search,hash}=window.location;if(!hash){const path=`${this.basePath}${search}#${pathname}`;window.location.replace(path)}}}class RouterMemory extends RouterCore{constructor(options){super(options);__publicField(this,"_history",[]);__publicField(this,"_pendingGo",null);__publicField(this,"_currentIndex",0);options.mode="memory"}get currentIndex(){return this._currentIndex}go(delta){if(!delta)return;const currentIndex=this.currentIndex,targetIndex=Math.max(0,Math.min(this._history.length-1,currentIndex+delta));if(targetIndex===currentIndex)return;const target=this._history[targetIndex];this._pendingGo=targetIndex,this.navigate(target).then(res=>{res.status!==NavigateStatus.success&&(this._pendingGo=null)})}initializeRouter(){this._history.push(this.currentRouteLocation)}pushHistory(data){this._updateHistory(data,!1)}replaceHistory(data){this._updateHistory(data,!0)}_updateHistory(data,isReplace){let newIndex;if(this._pendingGo!==null)this._history[this._pendingGo]=data,newIndex=this._pendingGo;else if(isReplace)this._history[this.currentIndex]=data,newIndex=this.currentIndex;else{const nextIndex=this.currentIndex+1;nextIndex<this._history.length?(this._history[nextIndex]=data,this._history.length=nextIndex+1,newIndex=nextIndex):(this._history.push(data),newIndex=this._history.length-1)}this._currentIndex=newIndex,this.completeNavigation(),this._pendingGo=null}}function defineRoutes(...routes){return routes}function defineRoute(route){return route}function createRouter(options){let router;return typeof window>"u"&&options.mode!=="memory"?(console.warn("当前环境非浏览器端，强制使用内存模式路由"),options.mode="memory",new RouterMemory(options).initialize()):(options.mode==="memory"?router=new RouterMemory(options):router=new RouterHistory(options),router.initialize())}function useRouter(){return RouterCore.instance}function useRoute(){return RouterCore.instance.currentRouteLocation}const INDEX_SYMBOL=Symbol("RouterViewCounter");class RouterView extends vitarx.Widget{constructor(props){super(props);__publicField(this,"_$index");__publicField(this,"_$currentRoute");__publicField(this,"_$currentElement",vitarx.shallowRef());const parentIndex=vitarx.inject(INDEX_SYMBOL,-1,this);this._$index=parentIndex+1,vitarx.provide(INDEX_SYMBOL,this._$index,this),this._$currentRoute=this.matchedRoute,this._$currentElement.value=RouterCore.routeViewElement(this._$currentRoute,this.name,this._$index);const router=useRouter();let paramStr=JSON.stringify(this.location.params);vitarx.watch(this.location.matched,(_c,o)=>{const newRoute=o[this.index];newRoute!==this._$currentRoute&&(this._$currentRoute=newRoute,this._$currentElement.value=RouterCore.routeViewElement(newRoute,this.name,this._$index))}),vitarx.watch(this.location.params,()=>{if(!this._$currentRoute)return;const newParams=JSON.stringify(this.location.params);if(newParams!==paramStr){paramStr=newParams;const newProps=router.createViewProps(this._$currentRoute,this.name),oldProps=vitarx.toRaw(this._$currentElement.value.props),changes=diffUpdateProps(oldProps,newProps);changes.length>0&&vitarx.Observers.trigger(this._$currentElement.value.props,changes)}})}get index(){return this._$index}get isLastView(){return this.index===this.location.matched.length-1&&this.name==="default"}get name(){return this.props.name||"default"}get matchedRoute(){return this.location.matched[this.index]}get currentElement(){return this._$currentElement.value}get currentWidget(){var _a;return(_a=this._$currentElement.value)==null?void 0:_a.type}get location(){return RouterCore.instance.currentRouteLocation}onMounted(){this.completeViewRender()}onUpdated(){this.completeViewRender()}build(){return this.currentElement||vitarx.createElement(vitarx.Fragment)}completeViewRender(){this.isLastView&&RouterCore.instance._completeViewRender()}}class RouterLink extends vitarx.Widget{constructor(props){super(props);__publicField(this,"target");__publicField(this,"location");__publicField(this,"active");__publicField(this,"htmlProps");this.target=new vitarx.Computed(()=>{if(!this.props.to)return;const to=vitarx.isString(props.to)?{index:decodeURIComponent(props.to)}:props.to;if(RouterLink.isHttpOrHttpsUrl(to.index)||to.index.startsWith("#"))return to.index;if(to.index.includes("#")){const[index,hash]=to.index.split("#",2);to.index=index,to.hash=`#${hash}`}return to}),this.location=new vitarx.Computed(()=>{if(!this.target.value||typeof this.target.value=="string")return;const location=RouterCore.instance.createRouteLocation(this.target.value);return location.matched.length||console.warn(`[Vitarx.RouterLink][WARN]：索引：${this.target.value.index}，未匹配到任何有效的路由线路，请检查to属性是否配置正确！`),location}),props.active!==void 0&&props.active!=="none"&&(this.active=new vitarx.Computed(()=>!this.location.value||typeof this.target.value=="string"||!this.target.value?!1:this.target.value.index.startsWith("/")?props.active==="obscure"?this.location.value.path==="/"?RouterCore.instance.currentRouteLocation.path==="/":RouterCore.instance.currentRouteLocation.fullPath.startsWith(this.location.value.path):this.location.value.path===RouterCore.instance.currentRouteLocation.path:!!RouterCore.instance.currentRouteLocation.matched.find(route=>route.name===this.target.value.index))),this.htmlProps=new vitarx.Computed(()=>{var _a;const props2={href:this.href,onClick:e=>this.navigate(e),children:this.children??((_a=this.location.value)==null?void 0:_a.index),draggable:this.props.draggable??!1,"v-bind":[this.props,["to","children","href","disabled","active","callback","onClick","onclick","aria-current"]]};return this.isActive&&(props2["aria-current"]="page"),this.isDisabled&&(props2.disabled=!0),props2})}static isHttpOrHttpsUrl(url){return/^(https?):\/\/[^\s\/$.?#].\S*$/i.test(url)}get isActive(){var _a;return((_a=this.active)==null?void 0:_a.value)&&!this.isDisabled}get isDisabled(){return this.props.disabled??!1}get href(){var _a;return typeof this.target.value=="string"?this.target.value:((_a=this.location.value)==null?void 0:_a.fullPath)||"javascript:void(0)"}navigate(e){typeof this.target.value!="string"&&(e.preventDefault(),this.location.value&&!this.isDisabled&&RouterCore.instance.navigate(this.location.value).then(res=>{var _a;res.status!==NavigateStatus.success&&console.warn(`[Vitarx.RouterLink][WARN]：导航到索引：${(_a=this.target.value)==null?void 0:_a.index}失败，${res.message}`),this.props.callback&&this.props.callback(res)}))}build(){return vitarx.createElement("a",this.htmlProps.value)}}exports2.HistoryRouter=RouterHistory,exports2.MemoryRouter=RouterMemory,exports2.NavigateStatus=NavigateStatus,exports2.Router=RouterCore,exports2.RouterLink=RouterLink,exports2.RouterView=RouterView,exports2.createRouter=createRouter,exports2.defineRoute=defineRoute,exports2.defineRoutes=defineRoutes,exports2.useRoute=useRoute,exports2.useRouter=useRouter,Object.defineProperty(exports2,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,11 +1,26 @@
 {
   "name": "vitarx-router",
-  "version": "1.0.2",
+  "version": "2.0.0-beta.1",
   "description": "Vitarx前端框架的配套路由器",
+  "author": "ZhuChongLin <8210856@qq.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vitarx-lib/router"
+  },
+  "homepage": "https://vitarx.cn/router",
+  "keywords": [
+    "vitarx",
+    "router",
+    "vitarx-router",
+    "vitarx-router-lib"
+  ],
   "type": "module",
-  "main": "dist/vitarx-router.umd.js",
-  "module": "dist/vitarx-router.es.js",
-  "types": "dist/vitarx-router.d.ts",
+  "main": "./dist/vitarx-router.umd.js",
+  "module": "./dist/vitarx-router.es.js",
+  "types": "./dist/vitarx-router.d.ts",
+  "unpkg": "./dist/vitarx-router.umd.js",
+  "jsdelivr": "./dist/vitarx-router.umd.js",
   "exports": {
     ".": {
       "require": {
@@ -30,7 +45,7 @@
     "push": "npm publish --access=public"
   },
   "peerDependencies": {
-    "vitarx": "^1.0.3"
+    "vitarx": "^2.0.0-beta.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",