Including typing definitions for virtual modules inside a package

[dburian]

Hi everybody,

I'm building a plugin (say with a name plugin-name), which intercepts imports of a virtual module and creates it dynamically (with resolveId and load hooks). The problem I am having is how to declare types for the virtual module or rather how to include them in my package.

So let's say I have a declaration of a virtual module:

declare module 'virtual:plugin-name/module' {
  import type {Graph} from 'plugin-name/types';
  let graph: Graph;
  export default graph;
}

The problem is, how to package this. I compile my code with Rollup with typescript plugin, but it gives me errors saying it cannot find the module plugin-name/types, where the definition of Graph lies in. This is intuitive as this module does not yet exist (the bundling creates this module). Similar exception occurs if I rewrite that import into a relative one - "Import or export declaration in an ambient module declaration cannot reference module through relative module name.".

Obviously one solution would be to let the user of the plugin define such declaration of manually include it in my dist/ folder. But I consider these a hacks since this declaration is part of my package and therefore should be bundled as such.

Do you have any advice on how to resolve this?

Thanks :).