从打字稿类型定义文件中导出枚举

Question

我正在为我正在使用的库编写类型定义。库中的一个函数标识了一个整数单击的鼠标按钮：

 //index.d.ts
 export as namespace myLib;
 // activates the library listening for a specific mouse button
 function activate(button : number ) : void 

我引入了一个枚举来使它更好：

//index.d.ts
export as namespace myLib;
export enum MouseButton {
    LEFT = 1,
    MIDDLE = 2,
    RIGHT = 4
}

export function activate(button : MouseButton ) : void;

现在，当我导入这个函数并使用它时，一切都会编译，但我猜想枚举在浏览器中执行时会被剥离和未定义。错误消息显示Cannot read property 'LEFT' of undefined。

因此我像这样重新排列文件：

//MouseButton.ts
export enum MouseButton {
    LEFT = 1,
    MIDDLE = 2,
    RIGHT = 4
}

//index.d.ts
export as namespace myLib;
import {MouseButton} from MouseButton;
export {MouseButton} from MouseButton;
export function activate(button : MouseButton ) : void;

现在我可以import {MouseButton} from "myLib/MouseButton"; import * as myLib from "myLib"。但这需要两次导入。引用 myLib.MouseButton 仍然可以编译但不会运行。

有没有办法通过myLib 导入和引用MouseButton 枚举，通过import * as myLib 语句导入？我不仅在寻找解释如何做的答案，而且在寻找解释为什么我的解决方案不起作用或为什么不可能的答案。对解释问题所在的资源提示也表示赞赏

PS：我也尝试了这里建议的语法re-export Typescript enum from namespace?，但这也没有用。

PPS：有问题的模块是 Angular 6 项目中使用的基石项目 (https://github.com/cornerstonejs/cornerstone) 中的 UMD 模块。

Answer 1

（完成 t.animal 自己的答案）

声明文件很难制作：见长documentation。有时查看现有的 .d.ts 文件会有所帮助。

关于enum，将它们声明为const enum 是一种简洁明了的方法。它是 例如，为 jquery 做了什么，请参阅 @types/jquery/index.d.ts 的 Mouse 和 Key。这很方便，因为标准枚举在 JavaScript 中编译为数组，而 const enum 成员直接编译为值；见TypeScript Playground。

Answer 2

在上面Romain Denau's comment 的帮助下解决了这个问题。它把我推向了正确的方向：typescript 编译器从枚举生成什么代码（参见https://www.typescriptlang.org/docs/handbook/enums.html#enums-at-runtime）？声明枚举 const 允许打字稿编译器将标识符与相应的值完全交换，有效地内联它。不再将枚举泄漏到生产代码中。谢谢！

//index.d.ts
export as namespace myLib;

export const enum MouseButton {
    LEFT = 1,
    MIDDLE = 2,
    RIGHT = 4
}

export function activate(button : MouseButton ) : void;

Answer 3

从我对该主题的简短研究中，我注意到使用 export enum const 从类型定义文件中导出枚举是一个坏主意。由于您必须启用 --isolatedModules 标志，这在 create-react-app 中甚至是不可能的，它可能会变得混乱。

相反，我自己在shared.d.ts 文件中使用了正常语法：

  export enum EReviewStatus {
    PENDING = 'PENDING',
    SENT = 'SENT'
  }

然后我有一个.js 文件，它被导入到package.json 主块中，例如：

"main": "shared.js",

我在哪里（使用 CommonJS 导出使其在 Node.js 和前端兼容）：

module.exports.EReviewStatus = {
  PENDING: 'PENDING',
  SENT: 'SENT'
}

哪个有效，我认为更好的做法，因为现在您的代码明显与类型分开。