@wuipkg/tsconfig
v1.0.1
Published
集中管理和抽象剥离出不同运行场景中规范使用的 TypeScript 配置基线字典集合保障体系,防止业务出现由于环境差异配比产生的各种推断类型诊断失效的潜在雷点灾难。
Readme
@wuipkg/tsconfig
集中管理和抽象剥离出不同运行场景中规范使用的 TypeScript 配置基线字典集合保障体系,防止业务出现由于环境差异配比产生的各种推断类型诊断失效的潜在雷点灾难。
安装
pnpm install @wuipkg/tsconfig -D导出配置与约束层划分
通过本包提供的特定 JSON 环境配集能够安全覆盖绝大多数常规情况支持选项引用继承依赖。
1. base.json (核心底层 Web 前端容器约束预案)
作为给 Web/前端为主框架渲染结构引擎的工程构建底层引指的 compilerOptions 载体环境集合包(通常主程序使用该基准扩展支持)。
自带主要环境强制点:
- Target & Module: 绑定及抛挂至
ESNext,拒绝使用无意义及历史负担旧类型输出与挂载规范化判定。 - JSX 转化解析保留策略: 开启并且将
jsx形保留设置为preserve以便于配合例如 Vue 或其它具备高阶函数层等渲染模块再次做中间手流接管转换过滤使用。 - 强制忽略外部组件包污染检测项:
skipLibCheck: true防止大量 node_modules 等多类型推演校验造成的死限冲突错误。 - 挂载特有预声明化路径识别机制: 在 Path 里代理声明挂实配置了将
@/*会导播隐射至工程src/*, 而#/*向解析挂接去types/*。
2. node.json (针对脚本和微构服务的后端侧节点选项声明配置)
继承扩展出针对属于跑在纯服务器态诸如提供包部署分流运行等能力要求的脱 web 的工作空间组件集合选项使用需求。
业务接引标准范例
直接处于您需控规范下项目的工程根目录下寻找或自建 tsconfig.json:
通过内部支持利用原生的 extends 指引并使用本包下的配置资源作重写补注:
{
"extends": "@wuipkg/tsconfig/base.json",
"compilerOptions": {
"baseUrl": ".",
// 我们同样允许业务自己基于某些非 Node 支持插件体系外接库(例如测试工具、平台特殊指令集挂钩等补充依赖)加载外部环境类型挂置
"types": ["node", "vite/client"]
},
// 在这控制项目业务里仅希望被 TypeScript Server 处理与解析的挂测读取源
"include": [
"src/**/*.ts",
"src/**/*.d.ts",
"src/**/*.tsx",
"src/**/*.vue"
],
"exclude": ["node_modules", "dist"]
}