-
Notifications
You must be signed in to change notification settings - Fork 421
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.
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
docs(compiler): add type docs for esmLoaderPath
#1364
Conversation
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
*default: `/dist/loader`* | ||
|
||
Provide a custom path for the ESM loader directory, containing files you can import in an initiation script within your application to register all your components for lazy loading. | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can we expand on this? I'm not sure that as a user, I'd know enough here to start using this flag. To start, it might be worthwhile to include an example directory structure, setting with a custom value for esmLoaderPath
, and explaining how setting esmLoaderPath
affects the output of Stencil.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Agree. Maybe we need an additional section that talks about lazy loading and what the loader does? We could pull some of this out of the "How is this different from "dist-custom-elements" output target?" section.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I added a section to the loader script and also added an example how modifying the option has an impact on the user of a stencil library.
*default: `/dist/loader`* | ||
|
||
Provide a custom path for the ESM loader directory, containing files you can import in an initiation script within your application to register all your components for lazy loading. | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Agree. Maybe we need an additional section that talks about lazy loading and what the loader does? We could pull some of this out of the "How is this different from "dist-custom-elements" output target?" section.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
One non-block ask
Co-authored-by: Ryan Waskiewicz <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
👍
Co-authored-by: Tanner Reits <[email protected]>
Thanks for the review folks, I applied the changes to all other docs versions (except v2). |
Adding docs for
esmLoaderPath
.See also ionic-team/stencil#5418