typescript

用途：在编写 TypeScript 代码（类型、接口、泛型等）时提供严格模式下的模式与最佳实践参考。主要能力与约定：一、常量类型模式（要求）：先定义 as const 常量对象，再通过 (typeof STATUS)[keyof typeof STATUS] 提取类型，避免直接书写字面量联合类型，以保证单一数据源、运行时取值、自动补全与重构便利。二、扁平接口（要求）：接口保持一层深度，嵌套对象拆为独立接口，通过引用而非内联嵌套；继承关系用 extends，如 Admin extends User 增加 permissions 字段。三、禁止使用 any：真正未知的类型用 unknown，配合类型守卫窄化；灵活类型用泛型，如 first<T>(arr: T[]): T | undefined。四、工具类型：Pick、Omit、Partial、Required、Readonly、Record、Extract、Exclude、NonNullable、ReturnType、Parameters 等常见用法。五、类型守卫：以 value is User 形式的函数，结合 typeof、null 检查与 in 运算符进行校验。六、类型导入：使用 import type 或内联 type 修饰符，如 import type { User } from "./types" 与 import { createUser, type Config } from "./utils"。适用场景：TypeScript 项目中的类型设计与代码审查，尤其需要强约束和统一风格的团队。限制：资料仅给出上述模式与约定，未提供安装方式、运行命令、依赖版本、平台或收费信息，这些暂未提供；示例代码保持原样，不应修改。