How can I let JSDoc reference to type in another module

[Thaina]

I have some d.ts files in my project and any files without module could be reference any class inside it directly. But some files is declare module and cannot be referred to it

This module also contain - sign in its name (it is aws-sdk from aws-sdk.d.ts)

[Thaina]

Just found that reference module just work fine. It just cannot reference module name with - sign in its name and awssdk module using declare module "aws-sdk"

Was JSDoc support reference module by ID?

[mhegazy]

I am having hard time piecing together the repro. Can you provide a self-contained sample we can look at?

[Thaina]

@mhegazy

I use tsd to pull aws-sdk.d.ts into typings folder

And then as you can see. the code in aws-sdk.d.ts is declare module "aws-sdk" { }

The module name is aws-sdk which is not possible to use at @type or @param for jsdoc

What I want is something like

/** @params {aws-sdk.DynamoDB} dynamo */
function DoWork(dynamo) {
    // dynamo will reference to DynamoDB class defined in aws-sdk.d.ts and can get intellisense
}

Current workaround I use is rename it in aws-sdk.d.ts as declare module awssdk { } but it not consistence with the original tsd

[mhegazy]

the module name shoudl not be used as an identifier. it works for some package, e.g. react, as they define a global variable React that has the same shape as the module. aws-sdk does not have that, so you need to import it.

import * as AWS from "aws-sdk";


/** @param {AWS.DynamoDB} dynamo */
function DoWork(dynamo) {

}

[Thaina]

@mhegazy That's work. But I still need to use it on node server under ES5 (AWS Lambda latest node version is nodejs 4) it cause error with reserved keyword import

So I try to find a way to have it work with only jsdoc comment

Also I have seen there are syntax like this

declare module A {
    export = a;
}

So I made my own ts file and write

import * as sdk from "aws-sdk"
declare module AWSSDK {
    export = sdk;
}

but it still didn't work

[mhegazy]

So aws-sdk can be used without being imported? if so this is an error in the declaration file, and should be reported on definitely typed.

[mhegazy]

For workarounds, neither or these would work. you want to use the new UMD module definition, (added in TS 2.0) #7125:

/// file: my-aws-sdk.d.ts
export * from "aws-sdk"
export as namespace AWS;

/// file: app.js

/// <reference path="my-aws-sdk.d.ts" />

/** @param {AWS.DynamoDB} dynamo */
function DoWork(dynamo) {

}

[Thaina]

@mhegazy No it's not. I mean I already try using import and it make intellisense work. But it cannot use in my target server so I can't use your solution

That's that. so I need to wait for TS 2.0

Thank you very much for your help

[Thaina]

@mhegazy Also I would like to suggest that, in addition to yours export as namespace syntax. There should be something like /** @import a as b */ for pure JSDoc style too

[tjtaill]

Is there any support to pull in a type defined in a jsdoc from another file yet ?
file1.js
/** @typedef {Object} TypeA */

I want to use that type in another file file2.js how can I do that in typescript ?

[mhegazy]

Tracked by #14377