microsoft / TypeScript-Website

The Website and web infrastructure for learning TypeScript

Home Page:https://www.typescriptlang.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

publishing deep-dive is out of date regarding "exports"

jason-ha opened this issue · comments

Page URL: https://www.typescriptlang.org/docs/handbook/declaration-files/publishing.html

publishing.html mentions "types" and "typings" fields but there are no comments about "exports" which I believe can supersede those. And I think they do not apply when there is a subpath based on documentation from https://www.typescriptlang.org/docs/handbook/modules/reference.html#packagejson-main-and-types.

https://www.typescriptlang.org/docs/handbook/modules/reference.html#packagejson-exports has good information about resolving; so, one could work backward if just given a reference there. But specific guidance on authoring is probably best.

"typings" is listed as an alias on publishing.html but is noted as legacy on modules/reference.html.