Update ts-jsdoc.md

[Gozala]

Unfortunately TS still generates strange imports paths in various places e.g. 'multihashes' is turned in the generated types into multihashes/src/ which than is not caught by our types mapping. Which we could catch with additional mapping proposed by this pull request.

[hugomrdias]

maybe this import path issue is caused by this line ??

[Gozala]

This line works around microsoft/TypeScript#41284, but evidently src/* pattern does not match import paths lib/src/, hence workaround in this pull.

[hugomrdias]

maybe we should stop using the typesVersions workaround ?

if i remove typesVersions from cids this stops breaking.

We only have this workaround to deep import types, and the only package that should actually allow this is ipfs-utils because its just a collection of atomic utils that should be imported one by one.

/cc @vasco-santos

[vasco-santos]

maybe we should stop using the typesVersions workaround ?

Yes, I think that could be the way to go.

We only have this workaround to deep import types, and the only package that should actually allow this is ipfs-utils because its just a collection of atomic utils that should be imported one by one.

libp2p/js-libp2p-interfaces and libp2p/js-libp2p-utils also need to support this though

[hugomrdias]

maybe we should stop using the typesVersions workaround ?

Yes, I think that could be the way to go.

We only have this workaround to deep import types, and the only package that should actually allow this is ipfs-utils because its just a collection of atomic utils that should be imported one by one.

libp2p/js-libp2p-interfaces and libp2p/js-libp2p-utils also need to support this though

We keep the instructions on how to use typeVersions for these special repos and remove it from the default config. Sounds good ?

Also these repos in general dont have the problem with the index entry point because they shouldn't have one single entry point by definition.

[vasco-santos]

We keep the instructions on how to use typeVersions for these special repos and remove it from the default config. Sounds good ?

Yes!