现在我们已经按照指南里的步骤写好一个声明文件，是时候把它发布到npm了。有两种主要方式用来发布声明文件到npm：

  1. 与你的npm包捆绑在一起，或
  2. 发布到npm上的@types organization。

如果你能控制要使用你发布的声明文件的那个npm包的话，推荐第一种方式。这样的话，你的声明文件与JavaScript总是在一起传递。

包含声明文件到你的npm包

如果你的包有一个主.js文件，你还是需要在package.json里指定主声明文件。设置types属性指向捆绑在一起的声明文件。比如：

  1. {
  2.     "name": "awesome",
  3.     "author": "Vandelay Industries",
  4.     "version": "1.0.0",
  5.     "main": "./lib/main.js",
  6.     "types": "./lib/main.d.ts"
  7. }

注意"typings"与"types"具有相同的意义，也可以使用它。

同样要注意的是如果主声明文件名是index.d.ts并且位置在包的根目录里（与index.js并列），你就不需要使用"types"属性指定了。

依赖

所有的依赖是由npm管理的。确保所依赖的声明包都在package.json的"dependencies"里指明了比如，假设我们写了一个包它依赖于Browserify和TypeScript。

  1. {
  2.     "name": "browserify-typescript-extension",
  3.     "author": "Vandelay Industries",
  4.     "version": "1.0.0",
  5.     "main": "./lib/main.js",
  6.     "types": "./lib/main.d.ts",
  7.     "dependencies": {
  8.         "browserify": "latest",
  9.         "@types/browserify": "latest",
  10.         "typescript": "next"
  11.     }
  12. }

这里，我们的包依赖于browserify和typescript包。browserify没有把它的声明文件捆绑在它的npm包里，所以我们需要依赖于@types/browserify得到它的声明文件。typescript相反，它把声明文件放在了npm包里，因此我们不需要依赖额外的包。

我们的包要从这两个包里暴露出声明文件，因此browserify-typescript-extension的用户也需要这些依赖。正因此，我们使用"dependencies"而不是"devDependencies"，否则用户将需要手动安装那些包。如果我们只是在写一个命令行应用，并且我们的包不会被当做一个库使用的话，那么我就可以使用devDependencies。

危险信号

/// <reference path="..." />

不要在声明文件里使用/// <reference path="..." />。

  1. /// <reference path="../typescript/lib/typescriptServices.d.ts" />
  2. ....

应该使用/// <reference types="..." />代替

  1. /// <reference types="typescript" />
  2. ....

务必阅读使用依赖一节了解详情。

打包所依赖的声明

如果你的类型声明依赖于另一个包：

  • 不要把依赖的包放进你的包里，保持它们在各自的文件里。
  • 不要将声明拷贝到你的包里。
  • 应该依赖于npm类型声明包，如果依赖包没包含它自己的声明的话。

公布你的声明文件

在发布声明文件包之后，确保在DefinitelyTyped外部包列表里面添加一条引用。这可以让查找工具知道你的包提供了自己的声明文件。

发布到@types

@types下面的包是从DefinitelyTyped里自动发布的，通过types-publisher工具。如果想让你的包发布为@types包，提交一个pull request到https://github.com/DefinitelyTyped/DefinitelyTyped。在这里查看详细信息contribution guidelines page。