Помилка „Ім’я модуля“ перетворюється на нетипізований модуль о… ”під час написання власного файлу визначення TypeScript

Я не можу знайти визначення TypeScript @type/{name}для одного з моїх встановлених пакетів NodeJS, тому я намагаюся написати d.tsдля нього файл і помістити файл у {project root}\typingsпапку. Ось як я роблю:

// My source code: index.ts
import Helper from 'node-helper-lib';


// My definition: \typings\node-helper-lib.d.ts
declare....(something else)

declare module 'node-helper-lib' {
   class Helper { ... }
   export = Helper;
}

Однак Visual Studio Code продовжує видавати цю помилку і ставить червоний рядок під declare module 'node-helper-lib':

[ts] Неправильне ім'я модуля при збільшенні. Модуль 'node-helper-lib' перетворюється на нетипізований модуль за адресою '{шлях до проекту} \ node_modules \ node-helper-lib \ index.js', який не можна доповнити.

Чи не правомірно, що оскільки бібліотека нетипізована, то мені слід дозволити додавати до неї набір тексту?

ОНОВЛЕННЯ:

Я використовую:

• TypeScript: 2.1.4
• Код Visual Studio: 1.9.1
• Вузол JS: 6.9.4
• Windows 10 x64

Фактичне рішення наведено у коментарі @Paleo у відповіді @ hirikarate:

Імпорт повинен бути оголошений всередині декларації модуля.

Приклад:

declare module 'node-helper-lib' {
   import * as SomeThirdParty from 'node-helper-lib';
   interface Helper {
       new(opt: SomeThirdParty.Options): SomeThirdParty.Type
   }
   export = Helper;
}

Після деяких спроб та помилок я це виявив augmentation означає "оголошення модуля в одному файлі з іншими деклараціями модуля".

Тому, якщо ми хочемо написати файл визначення для нетипізованої сторонньої бібліотеки JavaScript, declare module 'lib-name'у цьому файлі повинен бути ТІЛЬКИ ОДИН , а 'lib-name' має точно відповідати імені бібліотеки (можна знайти в її package.json, " назва "властивість".

З іншого боку, якщо в сторонній бібліотеці вже є файл визначення .d.ts , і ми хочемо розширити його функціональні можливості, тоді ми можемо помістити додаткове визначення в інший створений нами файл. Це називається augmenting.

Наприклад:

// These module declarations are in same file, given that each of them already has their own definition file.
declare module 'events' {
   // Extended functionality
}

declare module 'querystring' {
   // Extended functionality        
}

declare module '...' { ... }

Я залишаю своє відкриття тут лише на той випадок, якщо хтось має таке саме запитання. І, будь ласка, виправте мене, якщо я щось пропустив.

Я теж отримував це повідомлення про помилку. Проблема для мене полягала в тому, що я намагався оголосити інший модуль у існуючому файлі визначення типу, який містив декларацію модуля. Після того, як я перемістив нову декларацію модуля до нового файлу, помилка зникла.

У моєму випадку я просто використав наступну декларацію в одному з моїх файлів типів, тому я зміг використати всі пакунки, не пов'язані з TypeScript:

declare module '*'