javascript - 这个 VSCODE 智能感知从哪里来？

Question

在 VSCODE 中，我看到以下智能感知:

探索时node_modules/sanctuary/index.js ，我找到一个函数toMaybe ，但定义似乎不是来自这里，因为它们不匹配

//# toMaybe :: a? -> Maybe a
//.
//. Takes a value and returns Nothing if the value is `null` or `undefined`;
//. Just the value otherwise.
//.
//. ```javascript
//. > S.toMaybe (null)
//. Nothing
//.
//. > S.toMaybe (42)
//. Just (42)
//. ```

这与通常显示的其他功能形成对比:

两个问题:

1. 接下来我应该看哪里？
2. 我怎样才能像这样记录我自己的函数？

更新:

卢卡斯·巴赫 (Lukas Bach) 和 ippi 指出，其中一部分是 Sanctuary.Static.toMaybe<A>(p: A): Maybe<A>来自自动类型获取功能。

即使删除了所有 @types来自~/Library/Caches/typescript/2.9/node_modules/types-registry ，我仍然看到一些文档。

我也找不到文本toMaybe :: a -> Maybe a在 @types/sanctuary/index.d.ts文件或 @types 中的任何位置目录。

Answer 1

编程语言 TypeScript 是 JavaScript 的超集，允许定义函数和变量的正确类型。 TypeScript 可以编译为 JavaScript，从而删除所有类型注释，并且可以在转译过程中导出单独的类型定义文件 (*.d.ts)。如今，TypeScript 类型定义通常直接在模块存储库本身中或作为 DefinitelyTyped 的一部分为 JS 模块提供。存储库。

要为自己的代码获取此类类型注释，您可以首先使用 TypeScript 编写代码，或者自己编写其他自定义类型定义文件。

这不是编写类型定义的唯一方法，但目前是最突出的一种。

编辑:好吧，我并没有真正研究过您之前提到的软件包。但我已经尝试过了，这就是它给我的 IntelliSense 注释。

这似乎来自 TS 键入:

toMaybe<A>(p: A | null | undefined): Maybe<A>;

这些输入位于 https://www.npmjs.com/package/@types/sanctuary .