{
  // tsconfig.lib.json
  // 直接复制本文件内容到子项目的 tsconfig.json 即可，不要用 entends 继承本文件
  "extends": "../../tsconfig.base.json",
  "compilerOptions": {
    /**
     * Browser api，需要加 "DOM"，"DOM.Iterable"
     * Node api，需要加 "ES2025"，始终使用带版本号的最新版本
     * NextJs api，属于同构，server 端会预处理 DOM，计算url，三个都需要 "ES2025", "DOM", "DOM.Iterable"
     */
    "lib": ["ES2025", "DOM", "DOM.Iterable"],

    /**
     * React JSX 编译模式
     * - 使用 React 17+ 新 JSX Transform
     * - 不需要手动 import React
     */
    "jsx": "react-jsx",

    /**
     * 编译输出目录
     * - tsc / tsc -b 都会用到
     */
    "outDir": "./dist",

    /**
     * 源码根目录
     * - 确保 dist 结构与 src 一致
     * - 对 declaration 路径至关重要
     */
    "rootDir": "./src",

    /**
     * 生成 .d.ts 类型声明文件
     * - 组件库 / npm 包发布必需
     * - 对应用项目无害，仅影响类型输出
     */
    "declaration": true,

    /**
     * 只做类型检查，不生成 JS 输出
     * - 适用于 Vite / Next / Nuxt 等 bundler 场景
     * - 防止 tsc 与构建工具重复 emit
     */
    "noEmit": true,

    /**
     * 强制单文件可独立编译
     * - 适配 esbuild / SWC / bundler 编译模型
     * - 禁止依赖跨文件类型推断（enum / namespace 等）
     */
    "isolatedModules": true,

    /**
     * 允许在 import 中显式使用 .ts / .tsx 后缀
     * - 兼容 Node ESM / bundler 对文件扩展名的严格要求
     * - 避免 `import './foo'` 在 TS + ESM 下歧义
     */
    "allowImportingTsExtensions": true
  },
  /**
   * 参与类型检查和编译的文件
   * - 只扫描 src
   * - 其它目录通过 exclude 排除
   */
  "include": ["src", "scripts"],

  /**
   * 明确排除非源码内容
   * - 避免污染类型系统
   * - 防止误入 dist / test / config
   * - 保证发布包干净
   */
  "exclude": [
    "scripts",
    "node_modules",
    "dist",

    // ---------- build / cache ----------
    ".turbo/**/*",
    ".cache/**/*",
    ".vite/**/*",

    // ---------- 配置文件 ----------
    "vite.config.ts",
    "*.config.ts",
    "*.config.js",
    "tsconfig.*.json",

    // ---------- 测试相关 ----------
    "__tests__/**/*",
    "test/**/*",
    "tests/**/*",
    "**/*.test.ts",
    "**/*.test.tsx",
    "**/*.spec.ts",
    "**/*.spec.tsx",

    // ---------- Storybook ----------
    ".storybook/**/*",
    "stories/**/*",

    // ---------- 示例 / 脚本 ----------
    "example/**/*",
    "examples/**/*",
    "scripts/**/*",

    // ---------- 环境与静态资源 ----------
    ".env",
    ".env.*",
    "public/**/*",

    // ---------- 文档 ----------
    "docs/**/*",
    "README.md",
    "LICENSE"
  ]
}