从 jsDoc 引用一个 TS 接口

Question

由于 jsDoc 表示法和 tsconfig.json 文件，使用 VSCode 几乎可以从 Typescript 中获得纯 .js 的好处：

{
  "compileOnSave": false,
  "compilerOptions": {
    "noEmit": true,
    "allowJs": true,
    "checkJs": true,
    "target": "es6",
    "resolveJsonModule": true,
    "moduleResolution": "node",

  },
  "include": ["index.js", "./src"]
}

/**
 * @return {Promise<string>}
 */
const foo = Promise.resolve('hi');
module.exports = foo;

现在，是否可以在node_modules 处引用d.ts 中定义的接口？特别是我正在返回一个 -let's call- "my_dependency.Storage" 对象，但我无法使用纯 javascript 引用它：

/**
 * @param {Storage} storage
 */
const goo = storage => ...

会明白我指的是来自lib.dom.d.ts的Web Storage API

• 等效的打字稿是：

import {Storage} from "my_dependency"

• 我尝试使用 triple slash directives 失败

///<reference path="node_modules/my_dependency/lib/index.d.ts" />

• 我期待类似（伪代码）

/**
 * @param {my_module.Storage} storage
 */

Answer 1

正如@Akxe 提到的，这是从库中引用类型的方法：

/**
 * @param {import("my_dependency").Storage} storage
 */
const goo = storage => ...

现在，我发现自己一遍又一遍地重复这句话，所以我创建了一个环境别名，如下所示：

types.d.ts

declare namespace MyProject {
  type St = import("my_dependency").Storage; // alias: reference my_dependency.Storage from plain js code
}

index.js

/// <reference path="types.d.ts"/>
...

src/foo.js

/**
 * @param {MyProject.St} storage
 */
const goo = storage => ...