在 TypeScript 中拥有自己的 @types 样式声明

Question

我想在 browserify/tsify 包中使用 assert 模块。请参阅 https://www.npmjs.com/package/assert 和 https://github.com/substack/browserify-handbook#builtins 和 https://nodejs.org/api/assert.html。简而言之，它是浏览器中node-js 兼容的assert 模块，即browserify builtin。

所以我将@types/assert 添加到我的package.json。但是声明模块无法识别（似乎有问题）。所以我想做一个等效的node_modules/@types/assert 但在node_modules 之外，因为node_modules 不应该在源代码管理中。

有可能吗？如果没有，我可以/应该使用/// <reference 老式语法或declare module "assert" 还是什么？

Answer 1

澄清@Bruno Grieder 的答案。

tsc 如何查找.d.ts 文件在https://www.typescriptlang.org/docs/handbook/module-resolution.html 中进行了说明

declare module 'assert'的机制称为环境模块：

https://www.typescriptlang.org/docs/handbook/modules.html#ambient-modules

Answer 2

乍一看，声明模块看起来不错（没有彻底的测试），但无论如何，假设你在谈论this library

创建一个typings/assert/assert.d.ts 目录/子目录/文件，它将受源代码控制

assert.d.ts 必须构造为外部模块定义，它导出单个符号 assert。内容几乎是在@types/assert 中找到的内容的直接副本（带有您提到的所需更正）

declare module 'assert' {

    function assert(value:any, message?:string):void;

    namespace assert {

         export function fail(actual?:any, expected?:any, message?:string, operator?:string):void;

         ...

    }

    export = assert

}

在tsconfig.json 中，只需确保typings 目录的内容包含（即不排除）编译。