SuperAPI AI 工具集

build-free-types

通用与其它

查看项目

更新于 10-16 03:16

技能介绍

用途:在不需要编译(tsc/build)步骤的情况下为项目提供类型安全。浏览器端使用纯 .js 文件配合 JSDoc 注解,代码可直接在浏览器运行,同时保留 IDE 类型支持与错误检查;Node.js 端使用 .ts 文件并采用可擦除语法(Erasable Syntax),Node.js v24.11.0+ 可直接执行,前提是不使用 enum、namespace 等不可擦除特性。

主要能力与配置:package.json 中设置 "type": "module"、engines.node 为 ">=24.11.0",并添加脚本 "typecheck": "tsc --noEmit"。tsconfig.json 关键选项包括 target esnext、module nodenext、erasableSyntaxOnly、verbatimModuleSyntax、allowImportingTsExtensions、rewriteRelativeImportExtensions、noEmit、allowJs、checkJs、strict、skipLibCheck。

编码规则:浏览器 .js 文件用 JSDoc 定义变量类型、函数签名和复杂对象,避免 interface、类型别名等 TS 专有语法;类型导入使用 TS 5.5+ 风格 /** @import {User} from './types.js' */,不用旧式 typedef import。Node.js .ts 文件严格使用可擦除语法,禁用 enum、namespace、构造函数参数属性、experimentalDecorators;导入路径始终带 .ts 扩展名,类型导入用 import type。

使用方式:在项目文档或规范中注明,代理不应使用 npx tsx 或 ts-node 运行 Node 脚本,而应直接执行 node script.ts。示例文件 examples/tsconfig.json 提供完整类型检查配置。

限制:Node.js 直接执行 TS 依赖 v24.11.0 及以上版本;不可使用需要转换的 TypeScript 特性;资料未提供更多平台或收费信息。