导入的类不会出现在 d.ts 文件中

Question

这和这个问题有关：Can I import a TypeScript class from my own module to global?

我已经制作了一个模块，我想将一个类公开给全局范围。

module Foo {
    export class Bar {
        x: number
    }

    /* Some more interfaces and classes to be used only in this module */
}

一开始我做了一个接口，定义了一个新的变量来实现这个。

interface Bar extends Foo.Bar {
}
var Bar = Foo.Bar;

生成的 JavaScript 将我的 Bar 作为变量。

var Foo;
(function (Foo) {
    var Bar = (function () {
        function Bar() {
        }
        return Bar;
    })();
    Foo.Bar = Bar;
})(Foo || (Foo = {}));

var Bar = Foo.Bar;
//# sourceMappingURL=app.js.map

d.ts 文件包含我的全局 Bar 接口和变量。

declare module Foo {
    class Bar {
        public x: number;
    }
}
interface Bar extends Foo.Bar {
}
declare var Bar: typeof Foo.Bar;

然后，我注意到我可以简单地使用 import 来公开我的类，我就这样做了。

import Bar = Foo.Bar;

生成的 JavaScript 文件完全相同。

var Foo;
(function (Foo) {
    var Bar = (function () {
        function Bar() {
        }
        return Bar;
    })();
    Foo.Bar = Bar;
})(Foo || (Foo = {}));
var Bar = Foo.Bar;
//# sourceMappingURL=app.js.map

但是，我的 d.ts 文件现在不包含有关全局 Bar 的任何信息。

declare module Foo {
    class Bar {
        public x: number;
    }
}

这是预期的结果吗？我认为这会导致错误，因为当我在其他项目中包含 JavaScript 文件和 d.ts 文件时，它允许声明具有相同名称的变量。

Answer 1

这原来是当前编译器中的一个错误，新的编译器似乎已经修复了这个问题。见：https://github.com/Microsoft/TypeScript/issues/346

更正声明：

declare module Foo {
    class Bar {
        x: number;
    }
}
import Bar = Foo.Bar;

Answer 2

当您使用 import 语句时，编译器假定定义在别处。

例如，如果您从fileA.ts 将某些内容导入fileB.ts，则生成的fileA.d.ts 将已经包含声明，如果它还包含声明，则会与fileB.d.ts 冲突。

所以我会说这种行为是故意的。