Ошибка «Имя модуля разрешается в нетипизированный модуль в…» при записи пользовательского файла определения 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 продолжает выдавать эту ошибку и помещает красную линию под declare module 'node-helper-lib':

[ts] Недействительное имя модуля в дополнении. Модуль 'node-helper-lib' преобразуется в нетипизированный модуль в '{project path} \ 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'в этом файле, и «имя-библиотеки» должно точно соответствовать имени библиотеки (можно найти в ее 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 '...' { ... }

Я оставляю здесь свое открытие на случай, если у кого-то возникнут такие же вопросы. И, пожалуйста, поправьте меня, если я что-то упустил.

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

В моем случае я просто использовал следующее объявление в одном из моих файлов типов, поэтому я мог использовать все пакеты без машинописного текста:

declare module '*'