[Salsa] Provide a JSDoc equivalent of `import { ..} from "mod"`

[mhegazy]

Given an implementation of a class:

// file.js

export default class File {
   ...
}

How can you use the type without importing the module:

// another
export default Util {
   /** @param {File} file  */
   getFile(file) {
   }
}

One option is to use @module
e.g.:

   /** @param {module:./file:File} file  */
   getFile(file) {
   }

[bobzhang]

I hit the same issue today, the idea is to not relying on transpiling on server side, for example, I want to define my own object type like this, below does not work:

/**
 * @typedef {Object} Watcher
 * @property {string} dir
 * @property {fs.FSWatcher} watcher
 */

The editor complains that it does not understand fs

[mhegazy]

We will proceed with #14056 for now, try to special case classes.

[ste2425]

Such a workflow would also be brilliant for Angular1 apps where you may have a main file that injects all your dependencies and a separate file that specifies your controller. The controller file exports a function/class. It receives its dependencies but does not inject them directly, being able to tag them using JSdoc as a type that was defined in a different file in your workspace would be invaluable there.

[drKnoxy]

@mhegazy did you ever get anything working along these lines? Trying to reference a js class from a typedef, sounds like the same problem.

[goodmind]

Any progress here?