Skip to content

doc: update to package.exports docs #33074

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
MylesBorins wants to merge 24 commits into from
Closed

doc: update to package.exports docs #33074

Changes from 1 commit
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
4e4f086
doc: explicitly doc package.exports is breaking
MylesBorins Apr 26, 2020
1068cfb
Update doc/api/esm.md
MylesBorins Apr 27, 2020
c1f5310
Update doc/api/esm.md
MylesBorins Apr 27, 2020
dd2ba5b
Update doc/api/esm.md
MylesBorins Apr 27, 2020
0fc7b73
Update doc/api/esm.md
MylesBorins Apr 27, 2020
5508ad8
Update doc/api/esm.md
MylesBorins Apr 27, 2020
2acd426
Update doc/api/esm.md
MylesBorins Apr 28, 2020
d059abf
Update esm.md
MylesBorins Apr 29, 2020
3785420
fixup: lots of changes
MylesBorins Apr 29, 2020
c3b6f2f
Update doc/api/esm.md
MylesBorins May 1, 2020
e7937e8
Update doc/api/esm.md
MylesBorins May 1, 2020
7e1ac3a
Update doc/api/esm.md
MylesBorins May 1, 2020
a1f4781
Update doc/api/esm.md
MylesBorins May 1, 2020
c4ec3b1
Update doc/api/esm.md
MylesBorins May 1, 2020
fd65c2d
Update doc/api/esm.md
MylesBorins May 1, 2020
991af5d
Update doc/api/esm.md
MylesBorins May 4, 2020
33cdd05
Update doc/api/esm.md
MylesBorins May 4, 2020
a313dbc
fixup: remove note regarding tooling
MylesBorins May 4, 2020
68a09d5
fixup: explicitly enumerate
MylesBorins May 4, 2020
65cdd69
fixup: include folder example
MylesBorins May 4, 2020
a1614cc
fixup: be explicit about other limitations of ./ export
MylesBorins May 4, 2020
bab451c
fixup: fix lint
MylesBorins May 4, 2020
4f97c02
Update doc/api/esm.md
MylesBorins May 5, 2020
b15fc40
fixup: one more doc tweak
MylesBorins May 5, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Update doc/api/esm.md 
Co-Authored-By: Rob Palmer <rob.palmer2@gmail.com>
  • Loading branch information
@MylesBorins @robpalme
MylesBorins and robpalme authored Apr 28, 2020
commit 2acd4262109229266872d94e6fdf8f1a0a201e36
6 changes: 4 additions & 2 deletions doc/api/esm.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -194,8 +194,10 @@ environment, including whether the package is referenced via `require` or via
**Warning**: Introducing the `"exports"` field prevents consumers of a package
from using any entry points that are not defined, including the `package.json`.
This will likely be a breaking change. To make the introduction of `"exports"`
non-breaking, either ensure that every previously supported entry point is
exported or include an export of the root of the package `"./": "./"`.
non-breaking, ensure that every previously supported entry point is exported.
It is best to explicitly specify entry points so that the package's public API is
well-defined. As a last resort, package encapsulation can be disabled entirely by
Comment thread
MylesBorins marked this conversation as resolved.
Outdated
creating an export for the root of the package `"./": "./"` that will expose every file.

If both `"exports"` and `"main"` are defined, the `"exports"` field takes
precedence over `"main"`.
Expand Down