12. 术语表
| 术语 | 定义 |
|---|---|
| SusRouter | 导航核心：路由注册、Push/Replace/Back/Forward、guard 管道 |
| SusRouteRecord | 已注册的路由：Path、ScreenType、Config（KeepAlive、Guard、Transition 等） |
| SusRouteConfig | 路由设置：Name、KeepAlive、Alias、Children、Redirect、DefaultProps、PropsFn、LazyFactory、Guard、BeforeEnter、Transition、Meta、CaseSensitive、Strict |
| SusRoute | 栈上的活动路由：Record、FullPath、Params、Query、Screen、Props、IsActive |
| SusScreen | 所有 screen/modal 的基类：Router、Props、BeforeEnter、Entered、BeforeLeave、Left |
| SusRouterModal | 模态对话框基类：Build()、Shown()、BeforeDismiss()、Dismissed()、Dismiss() |
| SusRouteView | 视觉容器：渲染 SusScreen，管理 KeepAlive LRU 缓存，嵌套视图 |
| SusRouteLink | 链接组件：通过 Bind(router) 自动高亮 router-link-active/exact-active |
| SusModalService | 通过 OverlayHost 管理模态栈：Show/Close/CloseAll + dismissOnClickOutside |
| SusTransitionService | 过渡之间的暗幕/幕布：通过 OverlayHost 实现 FadeOut/FadeIn |
| SusRouteTransition | 基于代码的过渡动画：Fade/SlideLeft/SlideRight/None，PlayIn/PlayOut |
| SusOverlayServices | 聚合类：Host、Modal、Transition — overlay 服务的统一访问入口 |
| ISusRouteGuard | 单路由 guard 接口：CanEnter(from, to)、CanLeave(from, to) |
| KeepAlive | 路由模式（SusRouteConfig.KeepAlive=true）：screen 被分离，并由 SusRouteView/SusScreenOutlet 缓存在 off-DOM（不是 core 的 SusKeepAlive） |
| LRU cache | 最近最少使用（Least Recently Used）：当超过 MaxKeepAlive 时，最旧的非活动 screen 会被淘汰（Left()） |
| Re-entrancy protection | _isNavigating 标志；并发导航会返回 NavigationResult.Busy 并被丢弃（没有等待队列） |
| Busy | NavigationResult.Busy — 路由器已在导航中；请求被丢弃 |
| MaxHistory | 历史栈条目上限（默认 100）；溢出时 Push 会淘汰最旧的条目 |
| UseRouter | SusApp 扩展方法（SusAppRouterExtensions）：配置，并在正确的收尾阶段执行 Mount |
| OverlayHost | 来自 sus-core 的容器，用于管理 overlay 的 Z 轴顺序（Modal、Transition、Tooltip 等） |
| Named route | 具有 SusRouteConfig.Name 的路由 — 通过 PushNamed("name", pathParams) 导航 |
| Nested route | 子路由（SusRouteConfig.Children），其 Parent = 父路径 |
| Redirect | 导航前自动替换路径（SusRouteConfig.Redirect） |
| Alias | 指向同一路由的备用路径（SusRouteConfig.Alias） |
| Query params | 路径中 ? 之后的参数，可通过 SusRoute.Query 获取 |
| Lazy loading | 通过 SusRouteConfig.LazyFactory 延迟创建 screen |
| Props | Dictionary<string,object> — 导航时传递给 screen 的参数 |
| FullPath | 包含 query 的完整路径："/battle/42?mode=ranked" |
| PathParams | 具名路径参数：对应 "/battle/:id" 的 |