vitarx-router 1.0.3 → 2.0.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -12,7 +12,7 @@ npm install vitarx-router
12
12
  ## 简单示例
13
13
 
14
14
  ```js
15
- import { defineRoutes, lazy , useRouter } from 'vitarx-router'
15
+ import { defineRoutes, useRouter } from 'vitarx-router'
16
16
  import AppHomePage from '@/pages/Home/index.js'
17
17
 
18
18
  // 定义路由线路
@@ -25,7 +25,7 @@ const routes = defineRoutes(
25
25
  {
26
26
  path: '/about',
27
27
  name: 'about',
28
- widget: lazy(() => import('@/pages/About/index.js')) // 懒加载
28
+ widget: () => import('@/pages/About/index.js') // 懒加载
29
29
  }
30
30
  )
31
31
 
@@ -36,7 +36,7 @@ const router = createRouter({
36
36
  /** 其他配置查看文档 */
37
37
  })
38
38
 
39
- // 在组件中使用
39
+ // 导航
40
40
  useRouter().push('/about') // 导航到路径
41
41
  useRouter().push({ name: 'about' }) // 导航到路由名称
42
42
  useRouter().psuh('about') // 不以/开头的字符串,也会被认为是路由名称
@@ -12,8 +12,8 @@ declare interface Route {
12
12
  *
13
13
  * @param {Route[]} routes - 路由表
14
14
  * @param {string[]} custom - 自定义的名称或路径,例如['/home', 'home']
15
- * @param {string} [writePath] - 要写入的路径,完整的路径!例如'/Users/Vitarx/vitarx/route.type.d.ts',默认为当前工作目录下的route.type.d.ts
15
+ * @param {string} [writePath] - 要写入的路径,绝对路径!例如'/Users/Vitarx/vitarx/route.type.d.ts',默认为当前工作目录下的route.type.d.ts
16
16
  * @return {void}
17
17
  */
18
- export default function make(routes: Route[], custom?: string[], writePath?: string): void;
18
+ export default function makeTypeRoute(routes: Route[], custom?: string[], writePath?: string): void;
19
19
  export {};
@@ -52,10 +52,10 @@ function buildRouteIndex(routes) {
52
52
  *
53
53
  * @param {Route[]} routes - 路由表
54
54
  * @param {string[]} custom - 自定义的名称或路径,例如['/home', 'home']
55
- * @param {string} [writePath] - 要写入的路径,完整的路径!例如'/Users/Vitarx/vitarx/route.type.d.ts',默认为当前工作目录下的route.type.d.ts
55
+ * @param {string} [writePath] - 要写入的路径,绝对路径!例如'/Users/Vitarx/vitarx/route.type.d.ts',默认为当前工作目录下的route.type.d.ts
56
56
  * @return {void}
57
57
  */
58
- export default function make(routes, custom = [], writePath = '') {
58
+ export default function makeTypeRoute(routes, custom = [], writePath = '') {
59
59
  const { paths, names } = buildRouteIndex(routes);
60
60
  const all = [...paths, ...names, ...custom];
61
61
  // 构造类型声明字符串
@@ -1,9 +1,10 @@
1
+ import { App } from 'vitarx';
2
+ import { AppObjectPlugin } from 'vitarx';
1
3
  import { Computed } from 'vitarx';
2
4
  import { Element as Element_2 } from 'vitarx';
3
5
  import { HTMLClassProperties } from 'vitarx';
4
6
  import { HTMLProperties } from 'vitarx';
5
7
  import { HTMLStyleProperties } from 'vitarx';
6
- import { LazyLoader } from 'vitarx';
7
8
  import { RouteLocation as RouteLocation_2 } from '../index.js';
8
9
  import { VNode } from 'vitarx';
9
10
  import { Widget } from 'vitarx';
@@ -17,6 +18,7 @@ import { WidgetType } from 'vitarx';
17
18
  * @param this - 路由器实例
18
19
  * @param to - 即将要进入的目标路由对象
19
20
  * @param from - 当前导航正要离开的路由对象
21
+ * @returns {void}
20
22
  */
21
23
  export declare type AfterEnterCallback = (this: Router, to: ReadonlyRouteLocation, from: ReadonlyRouteLocation) => void;
22
24
 
@@ -32,10 +34,11 @@ export declare type AllowedRouteWidget = RouteWidget | NamedRouteWidget;
32
34
  *
33
35
  * - boolean: true继续导航,false阻止导航
34
36
  * - RouteTarget: 重定向到新的目标
37
+ * - string: 重定向到新的path/name
35
38
  * - void: 继续导航
36
39
  * - Promise: 异步处理,resolve的值同上
37
40
  */
38
- export declare type BeforeEachCallbackResult = boolean | RouteTarget | void | Promise<boolean | RouteTarget | void>;
41
+ export declare type BeforeEachCallbackResult = boolean | RouteTarget | RouteIndex | void | Promise<boolean | RouteTarget | RouteIndex | void>;
39
42
 
40
43
  /**
41
44
  * 路由前置钩子
@@ -45,6 +48,7 @@ export declare type BeforeEachCallbackResult = boolean | RouteTarget | void | Pr
45
48
  * @param this - 路由器实例
46
49
  * @param to - 即将要进入的目标路由对象
47
50
  * @param from - 当前导航正要离开的路由对象
51
+ * @returns {BeforeEachCallbackResult} 返回false可以取消导航
48
52
  */
49
53
  export declare type BeforeEnterCallback = (this: Router, to: ReadonlyRouteLocation, from: ReadonlyRouteLocation) => BeforeEachCallbackResult;
50
54
 
@@ -56,26 +60,54 @@ export declare type BeforeEnterCallback = (this: Router, to: ReadonlyRouteLocati
56
60
  * 你必须调用一次`router.replace(target)`方法来跳转到目标路由。
57
61
  *
58
62
  * @param {RouterOptions} options - 配置
59
- * @return {RouterMemory} - 内存路由器实例
63
+ * @return {RouterMemory} - `RouterMemory`内存路由器实例
60
64
  */
61
- export declare function createRouter(options: RouterOptions & {
62
- mode: 'memory';
63
- }): MemoryRouter;
65
+ export declare function createRouter(options: MakeRequired<RouterOptions<'memory'>, 'mode'>): MemoryRouter;
64
66
 
65
67
  /**
66
- * 创建History路由器
68
+ * 创建WebHistory路由器,path模式
67
69
  *
68
70
  * 基于History API实现路由功能,支持浏览器前进后退、刷新等操作。
69
71
  *
70
- * 它与`MemoryRouter`路由不同的是,它不需要初始化过后调用`router.replace(target)`方法来替换默认路由,
71
- * 内部会自动根据`window.location`去匹配路由。
72
+ * @remarks
73
+ * 部署到服务器上时需要配置重定向,否则会出现404错误。
74
+ *
75
+ * nginx
76
+ * ```nginx
77
+ * location / {
78
+ * try_files $uri $uri/ /index.html;
79
+ * }
80
+ * ```
81
+ * Apache
82
+ * ```Apache
83
+ * <IfModule mod_negotiation.c>
84
+ * Options -MultiViews
85
+ * </IfModule>
86
+ *
87
+ * <IfModule mod_rewrite.c>
88
+ * RewriteEngine On
89
+ * RewriteBase /
90
+ * RewriteRule ^index\.html$ - [L]
91
+ * RewriteCond %{REQUEST_FILENAME} !-f
92
+ * RewriteCond %{REQUEST_FILENAME} !-d
93
+ * RewriteRule . /index.html [L]
94
+ * </IfModule>
95
+ * ```
72
96
  *
73
97
  * @param {RouterOptions} options - 路由配置
74
- * @return {RouterHistory} - HistoryRouter实例
98
+ * @return {RouterHistory} - `RouterHistory`路由器实例
75
99
  */
76
- export declare function createRouter(options: RouterOptions | (RouterOptions & {
77
- mode: 'path' | 'hash';
78
- })): HistoryRouter;
100
+ export declare function createRouter(options: MakeRequired<RouterOptions<'path'>, 'mode'>): HistoryRouter;
101
+
102
+ /**
103
+ * 创建history路由器,hash模式
104
+ *
105
+ * 基于History API实现路由功能,支持浏览器前进后退、刷新等操作。
106
+ *
107
+ * @param {RouterOptions} options - 路由配置
108
+ * @return {RouterHistory} - `RouterHistory`路由器实例
109
+ */
110
+ export declare function createRouter(options: RouterOptions<'hash'>): HistoryRouter;
79
111
 
80
112
  /**
81
113
  * 定义路由
@@ -214,40 +246,10 @@ export declare type InjectProps = boolean | Record<string, any> | InjectPropsHan
214
246
  * 注入参数处理函数
215
247
  *
216
248
  * @param {ReadonlyRouteLocation} location 路由匹配的位置信息
217
- * @return {Record<string, any>} 注入的参数
249
+ * @return {Record<string, any>} 注入的参数,必须是可JSON序列化的对象
218
250
  */
219
251
  export declare type InjectPropsHandler = (location: ReadonlyRouteLocation) => Record<string, any>;
220
252
 
221
- /**
222
- * ## 标记延迟加载
223
- *
224
- * 由于直接定义`() => import('./xxx.js')`会导致类型与函数式组件冲突,
225
- * 在未执行函数之前难以有效判断其类型,所以这里使用Symbol标记懒加载器。
226
- *
227
- * @example
228
- * lazy(() => import('./xxx.js'))
229
- *
230
- * @template T - WidgetType
231
- * @param {LazyLoader<T>} lazyLoader - 函数返回的import即是惰性加载器
232
- */
233
- export declare function lazy<T extends WidgetType>(lazyLoader: LazyLoader<T>): LazyLoad<T>;
234
-
235
- declare const LAZY_LOADER_SYMBOL: unique symbol;
236
-
237
- declare type LAZY_LOADER_SYMBOL = typeof LAZY_LOADER_SYMBOL;
238
-
239
- /**
240
- * 延迟加载/惰性加载
241
- *
242
- * 用于实现代码分块和懒加载功能
243
- */
244
- export declare interface LazyLoad<T> {
245
- [LAZY_LOADER_SYMBOL]: boolean;
246
- (): Promise<{
247
- default: T;
248
- }>;
249
- }
250
-
251
253
  /**
252
254
  * 路由匹配结果
253
255
  */
@@ -423,7 +425,6 @@ export declare interface Route<T extends AllowedRouteWidget = AllowedRouteWidget
423
425
  * 路由对应的视图组件
424
426
  *
425
427
  * 支持命名视图
426
- *
427
428
  * @example
428
429
  * ```ts
429
430
  * {
@@ -435,6 +436,15 @@ export declare interface Route<T extends AllowedRouteWidget = AllowedRouteWidget
435
436
  * }
436
437
  * }
437
438
  * ```
439
+ *
440
+ * 支持懒加载
441
+ * @example
442
+ * ```ts
443
+ * {
444
+ * path: '/user/{id}',
445
+ * widget: () => import('./User.js')
446
+ * }
447
+ * ```
438
448
  */
439
449
  widget?: T;
440
450
  /**
@@ -578,7 +588,7 @@ export declare type RoutePath = `/${string}`;
578
588
  * 继承自 RouterRegistry,负责处理路由导航、历史记录管理、生命周期等核心功能。
579
589
  * 采用单例模式,确保全局只有一个路由器实例。
580
590
  */
581
- export declare abstract class Router extends RouterRegistry {
591
+ export declare abstract class Router extends RouterRegistry implements AppObjectPlugin<{}> {
582
592
  private _currentTaskId;
583
593
  private _taskCounter;
584
594
  /**
@@ -773,6 +783,14 @@ export declare abstract class Router extends RouterRegistry {
773
783
  * @protected
774
784
  */
775
785
  updateHash(hash: `#${string}` | ''): void;
786
+ /**
787
+ * 创建路由视图的props
788
+ *
789
+ * @param {ReadonlyRouteNormalized} route - 路由记录
790
+ * @param {string} name - 视图名称
791
+ * @returns {Record<string, any>} - 需要传递给路由视图的props
792
+ */
793
+ createViewProps(route: ReadonlyRouteNormalized, name: string): Record<string, any>;
776
794
  /**
777
795
  * 创建路由元素
778
796
  *
@@ -864,6 +882,26 @@ export declare abstract class Router extends RouterRegistry {
864
882
  * @inheritDoc
865
883
  */
866
884
  removeRoute(index: RouteIndex): RouteNormalized | undefined;
885
+ /**
886
+ * 安装路由器
887
+ *
888
+ * 此方法用于安装路由器,将路由器实例添加到应用程序中。
889
+ *
890
+ * 安装路由器后,应用程序就可以使用`app.get('router')`访问路由器实例。
891
+ *
892
+ * @example
893
+ * import { createApp } from 'vitarx'
894
+ * import { createRouter } from 'vitarx'
895
+ * import AppHome from './App.js'
896
+ *
897
+ * const router = createRouter({// 相关配置})
898
+ * const app = createApp('#root').use(router)
899
+ * app.render(AppHome)
900
+ *
901
+ * @param {App} app - 应用程序实例
902
+ * @returns {void}
903
+ */
904
+ install(app: App): void;
867
905
  }
868
906
 
869
907
  /**
@@ -926,7 +964,7 @@ export declare interface RouterLinkProps {
926
964
  *
927
965
  * 可以是路由目标对象,也可以是路由索引
928
966
  */
929
- to: RouteTarget | RouteIndex | HttpUrl | Hash;
967
+ to: RouteTarget | RouteIndex | HttpUrl | Hash | `${RouteIndex}${HashStr}`;
930
968
  /**
931
969
  * 子节点插槽
932
970
  */
@@ -1054,13 +1092,21 @@ export declare interface RouterOptions<T extends HistoryMode = HistoryMode> {
1054
1092
  */
1055
1093
  pattern?: RegExp;
1056
1094
  /**
1057
- * 定义滚动行为
1095
+ * 切换页面时的滚动行为
1058
1096
  *
1059
1097
  * 可以是一个函数或行为标识符,决定了当路由变化时如何滚动页面
1060
1098
  *
1061
- * @default 'smooth'
1099
+ * @default 'auto'
1062
1100
  */
1063
1101
  scrollBehavior?: _ScrollBehavior | ScrollBehaviorHandler;
1102
+ /**
1103
+ * 锚点跳转时的滚动行为
1104
+ *
1105
+ * 仅支持 'auto' | 'smooth' | 'instant'
1106
+ *
1107
+ * @default 'auto'
1108
+ */
1109
+ anchorsScrollBehavior?: _ScrollBehavior;
1064
1110
  /**
1065
1111
  * 在每个路由进入之前调用的钩子函数
1066
1112
  * 允许用户在路由激活之前执行逻辑检查或重定向
@@ -1285,7 +1331,7 @@ export declare class RouterView extends Widget<RouteOptions> {
1285
1331
  * ```tsx
1286
1332
  * protected build() {
1287
1333
  * // 使用空片段节点占位
1288
- * if (!this.currentElement) return <></> // 不可省略,因为`KeepAlive`不能渲染非组件节点。
1334
+ * if (!this.currentElement) return null // 不可省略,因为`KeepAlive`不能渲染非组件节点。
1289
1335
  *
1290
1336
  * // 将当前要进行展示的小部件构造函数传递给`KeepAlive`插槽,会在切换页面时缓存当前页面状态。
1291
1337
  * return <KeepAlive>{this.currentElement}</KeepAlive>
@@ -1335,7 +1381,7 @@ export declare interface RouteTarget {
1335
1381
  *
1336
1382
  * 可以是普通组件或懒加载组件
1337
1383
  */
1338
- export declare type RouteWidget = WidgetType | LazyLoad<WidgetType>;
1384
+ export declare type RouteWidget = WidgetType;
1339
1385
 
1340
1386
  /**
1341
1387
  * 滚动行为
@@ -1,9 +1,8 @@
1
1
  var __defProp = Object.defineProperty;
2
2
  var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: !0, configurable: !0, writable: !0, value }) : obj[key] = value;
3
3
  var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key != "symbol" ? key + "" : key, value);
4
- import { createElement, LazyWidget, deepClone, reactive, markRaw, shallowReactive, readonly, isDeepEqual, isRecordObject, isObject, Widget, shallowRef, inject, provide, watch, Fragment, Computed, isString } from "vitarx";
4
+ import { deepClone, reactive, markRaw, shallowReactive, readonly, createElement, isDeepEqual, isRecordObject, isObject, Widget, shallowRef, inject, provide, watch, toRaw, Observers, Fragment, Computed, isString } from "vitarx";
5
5
  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 || {});
6
- const LAZY_LOADER_SYMBOL = Symbol("LazyLoader");
7
6
  function isVariablePath(path) {
8
7
  return /\{[^}]+}/.test(path);
9
8
  }
@@ -51,9 +50,6 @@ function mergePathParams(path, params) {
51
50
  return String(params[paramName]).replace(/\s+/g, "_");
52
51
  }), formatPath(path);
53
52
  }
54
- function isLazyLoad(lazyLoader) {
55
- return typeof lazyLoader == "function" && lazyLoader[LAZY_LOADER_SYMBOL];
56
- }
57
53
  function formatHash(hash, addHashPrefix) {
58
54
  return typeof hash != "string" || !hash ? "" : (hash = hash.trim(), hash.startsWith("#") ? hash : `#${hash}`);
59
55
  }
@@ -104,14 +100,11 @@ function isRouteLocationTypeObject(obj) {
104
100
  return !0;
105
101
  }
106
102
  function validateSuffix(suffix, allowSuffix, inputPath, routePath) {
107
- return allowSuffix === "*" ? !0 : allowSuffix === !1 ? inputPath === routePath : Array.isArray(allowSuffix) ? allowSuffix.includes(suffix) : suffix === allowSuffix;
103
+ return inputPath === "/" || allowSuffix === "*" ? !0 : allowSuffix === !1 ? inputPath === routePath : Array.isArray(allowSuffix) ? allowSuffix.includes(suffix) : suffix === allowSuffix;
108
104
  }
109
105
  function addPathSuffix(path, suffix) {
110
106
  return suffix && !path.endsWith("/") && !path.includes(".") && (path += suffix.startsWith(".") ? suffix : `.${suffix}`), path;
111
107
  }
112
- function createViewElement(widget, props) {
113
- return isLazyLoad(widget) ? createElement(LazyWidget, { children: widget, ...props }) : createElement(widget, props);
114
- }
115
108
  function cloneRouteLocation(route) {
116
109
  const { matched, ...other } = route;
117
110
  return Object.assign(deepClone(other), { matched: Array.from(matched) });
@@ -188,7 +181,8 @@ class RouterRegistry {
188
181
  base: "/",
189
182
  strict: !1,
190
183
  mode: "path",
191
- scrollBehavior: "smooth",
184
+ scrollBehavior: "auto",
185
+ anchorsScrollBehavior: "auto",
192
186
  suffix: "*",
193
187
  pattern: /[\w.]+/,
194
188
  defaultSuffix: "",
@@ -492,6 +486,15 @@ function diffUpdateObjects(a, b) {
492
486
  for (const key of aKeys)
493
487
  delete a[key];
494
488
  }
489
+ function diffUpdateProps(oldProps, newProps) {
490
+ const removeKeys = new Set(Object.keys(oldProps)), bKeys = Object.keys(newProps), changes = [];
491
+ for (const key of bKeys)
492
+ key !== "key" && (oldProps[key] !== newProps[key] && (oldProps[key] = newProps[key], changes.push(key)), removeKeys.delete(key));
493
+ changes.push(...removeKeys);
494
+ for (const key of removeKeys)
495
+ delete oldProps[key];
496
+ return changes;
497
+ }
495
498
  const _RouterCore = class _RouterCore extends RouterRegistry {
496
499
  /**
497
500
  * 路由器构造函数
@@ -642,16 +645,14 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
642
645
  /**
643
646
  * 路由视图
644
647
  *
645
- * 内部方法,用于获取路由线路对应的视图元素虚拟节点。
646
- *
647
- * @internal
648
+ * @internal 内部核心方法,用于获取路由线路对应的视图元素虚拟节点。
648
649
  * @param {ReadonlyRouteNormalized} route - 路由对象
649
650
  * @param {string} name - 视图名称
650
651
  * @param {number} index - `RouterView`的索引
651
652
  * @return {VNode<WidgetType> | undefined} - 视图元素虚拟节点
652
653
  */
653
654
  static routeViewElement(route, name, index) {
654
- return route ? this.instance.createRouteViewElement(route, name) : index === 0 && name === "default" && this.instance.missing && !this.instance.isPendingNavigation ? createViewElement(this.instance.missing, {}) : void 0;
655
+ return route ? this.instance.createRouteViewElement(route, name) : index === 0 && name === "default" && this.instance.missing && !this.instance.isPendingNavigation ? createElement(this.instance.missing) : void 0;
655
656
  }
656
657
  /**
657
658
  * 后退到上一个历史记录
@@ -759,8 +760,8 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
759
760
  message: "导航成功",
760
761
  redirectFrom: isRedirect ? target : void 0,
761
762
  ...overrides
762
- }), to = "fullPath" in _target && "matched" in _target ? _target : this.createRouteLocation(_target);
763
- if (to.fullPath === this.currentRouteLocation.fullPath)
763
+ }), to = this.createRouteLocation(_target);
764
+ if (to.fullPath === this.currentRouteLocation.fullPath && isDeepEqual(to.params, this.currentRouteLocation.params))
764
765
  return createNavigateResult({
765
766
  status: NavigateStatus.duplicated,
766
767
  message: "导航到相同的路由,被系统阻止!"
@@ -788,7 +789,7 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
788
789
  return result === !1 ? createNavigateResult({
789
790
  status: NavigateStatus.aborted,
790
791
  message: `导航到${to.index}目标时被前置守卫钩子阻止!`
791
- }) : isCurrentTask() ? typeof result == "object" && result.index !== _target.index ? (result.isReplace ?? (result.isReplace = !1), performNavigation(result, !0)) : !to.matched.length && !this.missing ? createNavigateResult({
792
+ }) : 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({
792
793
  status: NavigateStatus.not_matched,
793
794
  message: `未匹配到任何路由规则,被系统阻止!请检测目标索引(${to.index})是否已注册路由。`
794
795
  }) : ("isReplace" in _target && _target.isReplace ? (this._pendingReplace = to, this.replaceHistory(to)) : (this._pendingPush = to, this.pushHistory(to)), createNavigateResult(
@@ -845,6 +846,19 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
845
846
  this._currentRouteLocation.suffix
846
847
  ));
847
848
  }
849
+ /**
850
+ * 创建路由视图的props
851
+ *
852
+ * @param {ReadonlyRouteNormalized} route - 路由记录
853
+ * @param {string} name - 视图名称
854
+ * @returns {Record<string, any>} - 需要传递给路由视图的props
855
+ */
856
+ createViewProps(route, name) {
857
+ var _a;
858
+ const injectProps = (_a = route.injectProps) == null ? void 0 : _a[name];
859
+ let props;
860
+ 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;
861
+ }
848
862
  /**
849
863
  * 创建路由元素
850
864
  *
@@ -853,12 +867,11 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
853
867
  * @protected
854
868
  */
855
869
  createRouteViewElement(route, name) {
856
- var _a, _b;
870
+ var _a;
857
871
  const widget = (_a = route.widget) == null ? void 0 : _a[name];
858
872
  if (!widget) return;
859
- const injectPropsConfig = (_b = route.injectProps) == null ? void 0 : _b[name];
860
- let props;
861
- 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);
873
+ const props = this.createViewProps(route, name);
874
+ return props.key = route.path, createElement(widget, props);
862
875
  }
863
876
  /**
864
877
  * 该方法提供给`RouterView`完成渲染时调用
@@ -961,6 +974,28 @@ const _RouterCore = class _RouterCore extends RouterRegistry {
961
974
  }
962
975
  return removed;
963
976
  }
977
+ /**
978
+ * 安装路由器
979
+ *
980
+ * 此方法用于安装路由器,将路由器实例添加到应用程序中。
981
+ *
982
+ * 安装路由器后,应用程序就可以使用`app.get('router')`访问路由器实例。
983
+ *
984
+ * @example
985
+ * import { createApp } from 'vitarx'
986
+ * import { createRouter } from 'vitarx'
987
+ * import AppHome from './App.js'
988
+ *
989
+ * const router = createRouter({// 相关配置})
990
+ * const app = createApp('#root').use(router)
991
+ * app.render(AppHome)
992
+ *
993
+ * @param {App} app - 应用程序实例
994
+ * @returns {void}
995
+ */
996
+ install(app) {
997
+ app.register("router", this);
998
+ }
964
999
  };
965
1000
  /**
966
1001
  * 路由器单例实例
@@ -983,8 +1018,13 @@ class RouterHistory extends RouterCore {
983
1018
  ), !hash.trim())
984
1019
  window.scrollTo(0, 0);
985
1020
  else {
986
- const anchorId = hash.startsWith("#") ? hash.slice(1) : hash, element = window.document.getElementById(anchorId);
987
- element && element.scrollIntoView({ behavior: this.scrollBehavior });
1021
+ const anchorId = hash.startsWith("#") ? hash.slice(1) : hash;
1022
+ try {
1023
+ const element = window.document.getElementById(anchorId);
1024
+ element && element.scrollIntoView({ behavior: this.options.anchorsScrollBehavior });
1025
+ } catch (e) {
1026
+ console.error(`滚动到目标锚点${hash}失败`, e);
1027
+ }
988
1028
  }
989
1029
  }
990
1030
  /**
@@ -1189,7 +1229,7 @@ function defineRoute(route) {
1189
1229
  }
1190
1230
  function createRouter(options) {
1191
1231
  let router;
1192
- 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());
1232
+ 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());
1193
1233
  }
1194
1234
  function useRouter() {
1195
1235
  return RouterCore.instance;
@@ -1197,11 +1237,6 @@ function useRouter() {
1197
1237
  function useRoute() {
1198
1238
  return RouterCore.instance.currentRouteLocation;
1199
1239
  }
1200
- function lazy(lazyLoader) {
1201
- return Object.defineProperty(lazyLoader, LAZY_LOADER_SYMBOL, {
1202
- value: !0
1203
- }), lazyLoader;
1204
- }
1205
1240
  const INDEX_SYMBOL = Symbol("RouterViewCounter");
1206
1241
  class RouterView extends Widget {
1207
1242
  constructor(props) {
@@ -1217,9 +1252,20 @@ class RouterView extends Widget {
1217
1252
  this._$currentRoute,
1218
1253
  this.name,
1219
1254
  this._$index
1220
- ), watch(this.location.matched, (_c, o) => {
1255
+ );
1256
+ const router = useRouter();
1257
+ let paramStr = JSON.stringify(this.location.params);
1258
+ watch(this.location.matched, (_c, o) => {
1221
1259
  const newRoute = o[this.index];
1222
1260
  newRoute !== this._$currentRoute && (this._$currentRoute = newRoute, this._$currentElement.value = RouterCore.routeViewElement(newRoute, this.name, this._$index));
1261
+ }), watch(this.location.params, () => {
1262
+ if (!this._$currentRoute) return;
1263
+ const newParams = JSON.stringify(this.location.params);
1264
+ if (newParams !== paramStr) {
1265
+ paramStr = newParams;
1266
+ const newProps = router.createViewProps(this._$currentRoute, this.name), oldProps = toRaw(this._$currentElement.value.props), changes = diffUpdateProps(oldProps, newProps);
1267
+ changes.length > 0 && Observers.trigger(this._$currentElement.value.props, changes);
1268
+ }
1223
1269
  });
1224
1270
  }
1225
1271
  /**
@@ -1300,7 +1346,7 @@ class RouterView extends Widget {
1300
1346
  * ```tsx
1301
1347
  * protected build() {
1302
1348
  * // 使用空片段节点占位
1303
- * if (!this.currentElement) return <></> // 不可省略,因为`KeepAlive`不能渲染非组件节点。
1349
+ * if (!this.currentElement) return null // 不可省略,因为`KeepAlive`不能渲染非组件节点。
1304
1350
  *
1305
1351
  * // 将当前要进行展示的小部件构造函数传递给`KeepAlive`插槽,会在切换页面时缓存当前页面状态。
1306
1352
  * return <KeepAlive>{this.currentElement}</KeepAlive>
@@ -1350,8 +1396,14 @@ class RouterLink extends Widget {
1350
1396
  __publicField(this, "htmlProps");
1351
1397
  this.target = new Computed(() => {
1352
1398
  if (!this.props.to) return;
1353
- const to = isString(props.to) ? { index: props.to } : props.to;
1354
- return RouterLink.isHttpOrHttpsUrl(to.index) || to.index.startsWith("#") ? to.index : to;
1399
+ const to = isString(props.to) ? { index: decodeURIComponent(props.to) } : props.to;
1400
+ if (RouterLink.isHttpOrHttpsUrl(to.index) || to.index.startsWith("#"))
1401
+ return to.index;
1402
+ if (to.index.includes("#")) {
1403
+ const [index, hash] = to.index.split("#", 2);
1404
+ to.index = index, to.hash = `#${hash}`;
1405
+ }
1406
+ return to;
1355
1407
  }), this.location = new Computed(() => {
1356
1408
  if (!this.target.value || typeof this.target.value == "string") return;
1357
1409
  const location = RouterCore.instance.createRouteLocation(this.target.value);
@@ -1436,7 +1488,6 @@ export {
1436
1488
  createRouter,
1437
1489
  defineRoute,
1438
1490
  defineRoutes,
1439
- lazy,
1440
1491
  useRoute,
1441
1492
  useRouter
1442
1493
  };
@@ -1 +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 createNavigateResult=(overrides={})=>({from,to,status:NavigateStatus.success,message:"导航成功",redirectFrom:isRedirect?target:void 0,...overrides}),to="fullPath"in _target&&"matched"in _target?_target:this.createRouteLocation(_target);if(to.fullPath===this.currentRouteLocation.fullPath)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)):!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))}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()}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,element=window.document.getElementById(anchorId);element&&element.scrollIntoView({behavior:this.scrollBehavior})}}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!(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.startsWith("#")?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"})});
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||{});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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vitarx-router",
3
- "version": "1.0.3",
3
+ "version": "2.0.0-beta.1",
4
4
  "description": "Vitarx前端框架的配套路由器",
5
5
  "author": "ZhuChongLin <8210856@qq.com>",
6
6
  "license": "MIT",
@@ -16,9 +16,11 @@
16
16
  "vitarx-router-lib"
17
17
  ],
18
18
  "type": "module",
19
- "main": "dist/vitarx-router.umd.js",
20
- "module": "dist/vitarx-router.es.js",
21
- "types": "dist/vitarx-router.d.ts",
19
+ "main": "./dist/vitarx-router.umd.js",
20
+ "module": "./dist/vitarx-router.es.js",
21
+ "types": "./dist/vitarx-router.d.ts",
22
+ "unpkg": "./dist/vitarx-router.umd.js",
23
+ "jsdelivr": "./dist/vitarx-router.umd.js",
22
24
  "exports": {
23
25
  ".": {
24
26
  "require": {
@@ -43,7 +45,7 @@
43
45
  "push": "npm publish --access=public"
44
46
  },
45
47
  "peerDependencies": {
46
- "vitarx": "^1.0.3"
48
+ "vitarx": "^2.0.0-beta.1"
47
49
  },
48
50
  "devDependencies": {
49
51
  "@types/node": "^22.10.0",