router-core/type-safety
TanStack Router 的类型安全指南,核心是“完全类型推断”哲学:参数、搜索参数、上下文与 loader 数据都会沿路由树自动流转,因此不应再手动添加类型注解、类型断言或泛型参数。文档强调唯一必须的类型注解是 Register 模块声明,否则 Link、useNavigate、useSearch 等顶层导出将失去类型安全。内容涵盖路由钩子与 Link 的 from 收窄、strict:false 用于跨路由共享组件、getRouteApi 用于代码分割文件、以及提升 TypeScript 性能的写法(对象语法 addChildren、避免 loader 返回无用推断类型、as const satisfies 替代 LinkProps 变量类型)。还提供 ValidateLinkOptions、ValidateNavigateOptions、ValidateRedirectOptions 等类型工具用于泛型组件,并列出常见错误,包括误用 Next.js 或 React Router 的导入与文件结构。