Có lỗi “Tên 'mô-đun' giải quyết thành mô-đun không được định kiểu tại…” khi viết tệp định nghĩa TypeScript tùy chỉnh

Tôi không thể tìm thấy định nghĩa TypeScript @type/{name}cho một trong các gói NodeJS đã cài đặt của mình, vì vậy tôi cố gắng viết một d.tstệp cho nó và đặt tệp vào {project root}\typingsthư mục. Đây là cách tôi làm:

// 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;
}

Tuy nhiên, Visual Studio Code tiếp tục gây ra lỗi này và đặt dòng màu đỏ dưới declare module 'node-helper-lib':

[ts] Tên mô-đun không hợp lệ trong phần tăng thêm. Mô-đun 'node-helper-lib' phân giải thành mô-đun chưa được định kiểu tại '{project path} \ node_modules \ node-helper-lib \ index.js', không thể tăng thêm.

Không phải là hợp pháp vì thư viện chưa được định kiểu, vì vậy tôi nên được phép thêm nhập vào nó?

CẬP NHẬT:

Tôi đang dùng:

• TypeScript: 2.1.4
• Mã Visual Studio: 1.9.1
• Node JS: 6.9.4
• Windows 10 x64

Giải pháp thực tế được đưa ra trong một bình luận của @Paleo trong câu trả lời của @ hirikarate:

Nhập phải được khai báo bên trong khai báo mô-đun.

Thí dụ:

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

Sau một số lần thử và gặp lỗi, tôi thấy điều đó augmentationcó nghĩa là "khai báo một mô-đun trong cùng một tệp với (các) khai báo mô-đun khác".

Do đó, nếu chúng ta muốn viết tệp định nghĩa cho thư viện JavaScript của bên thứ 3 không được định kiểu, chúng ta phải CHỈ CÓ MỘT declare module 'lib-name'trong tệp đó và 'lib-name' phải khớp chính xác với tên thư viện (có thể tìm thấy trong package.json của nó, " tên "tài sản).

Mặt khác, nếu thư viện của bên thứ 3 đã .d.ts bao gồm tệp định nghĩa và chúng tôi muốn mở rộng các chức năng của nó, thì chúng tôi có thể đặt định nghĩa bổ sung vào tệp khác mà chúng tôi tạo. Cái này được gọi là augmenting.

Ví dụ:

// 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 '...' { ... }

Tôi để lại khám phá của mình ở đây chỉ trong trường hợp ai đó có cùng câu hỏi. Và xin vui lòng sửa cho tôi nếu tôi bỏ lỡ điều gì đó.

Tôi cũng nhận được thông báo lỗi đó. Vấn đề đối với tôi là tôi đang cố gắng khai báo một mô-đun khác trong tệp định nghĩa kiểu hiện có có khai báo mô-đun trong đó. Sau khi tôi di chuyển khai báo mô-đun mới sang tệp mới, lỗi đã biến mất.

Trong trường hợp của tôi, tôi chỉ sử dụng khai báo sau trong một trong các tệp kiểu của mình, vì vậy tôi có thể sử dụng tất cả các gói không phải typecript:

declare module '*'