自动生成环境模块声明

给定这 2 个打字稿文件

api/Token.ts

interface Token { 
    code: string
}
export default Token

and index.ts

export * from './api/Token'

TSC 1.5 与--declarations开关会生成两个.d.ts文件（具有相似内容）

api/Token.d.ts

interface Token { 
    code: string;
}
export default Token;

and index.d.ts

export * from './api/Token';

Running grunt-dts-捆绑包有以下选项

    dts_bundle: {
        release: {
            options: {
                name: 'my-module',
                main: 'index.d.ts'
            }
        }
    }

将生成一个环境模块声明文件my-module.d.ts包含以下内容

declare module 'my-module' {
    export * from './api/Token';
}

然而，由于以下原因，该声明无法编译：Import or export declaration in an ambient module declaration cannot reference module through relative module name.

我怎么能够自动地为上面的两个打字稿文件生成环境模块声明？

EDIT

请关注最新更新https://github.com/Microsoft/TypeScript/issues/2262 https://github.com/Microsoft/TypeScript/issues/2262

我最近写了一个博客文章 http://blog.charto.net/node/Publishing-TypeScript-based-modules-on-npm/对这个。总而言之，您可以使用autodts https://www.npmjs.com/package/autodts如果你更换index.ts with api.ts，包含以下内容：

export {default as Token} from './api/Token';

确保api.ts与api目录（在它旁边，而不是在它里面）。

那么你需要一个package.json file:

{
  "name": "api",
  "version": "1.0.0",
  "main": "dist/api.js",
  "scripts": {
    "preinstall": "npm install autodts",
    "postinstall": "autodts link",
    "prepublish": "tsc && autodts generate"
  },
  "typescript": {
    "definition": "index.d.ts"
  },
  "dependencies": {
    "autodts": "~0.0.4"
  },
  "devDependencies": {
    "@lib/autodts-generator": "~0.0.1",
    "typescript": "~1.5.3"
  }
}

包名很重要api与文件匹配api.ts和目录api。这样，在使用您的包时，Node.js 和 TypeScript 编译器都会在相同的位置查找。

最后，你需要一个tsconfig.json file:

{
    "compilerOptions": {
        "declaration": true,
        "module": "CommonJS",
        "target": "es5",
        "outDir": "dist"
    },
    "files": [
        "api.ts"
    ]
}

Now npm install将编译您的包并生成捆绑包index.d.ts文件中定义的definition设置在package.json.

要使用您的包，您可以执行以下操作：

/// <reference path = "api/index.d.ts" />

import {Token} from 'api';

class foo {
    key: Token;
}

您可以使用autodts link保持reference path最新的，请查看博客文章和/或 autodts 文档。

所结果的index.d.ts包含：

/// <reference path="index.ref.d.ts" />
declare module 'api/Token' {
    interface Token {
        code: string;
    }
    export default Token;

}
declare module 'api' {
    export { default as Token } from 'api/Token';

}

index.ref.d.ts and api.js是空白的。