typedoc
typedoc copied to clipboard
Support packages entryPointStrategy in watch mode.
Hi,
When i going to build docs for my lerna project using with '--watch' i getting next error:
Error: The packages option of entryPointStrategy is not supported in watch mode.
Do you have a plans to adding support for packages strategy?
Thanks!
Considering this is the first request for it I've seen packages mode was introduced 4 months ago, it's not very high on my priority list... it is something I'd like to have eventually.
Thanks for reply! got it, will keep subscription and follow the news Thanks!
We would also be interested! This would be very helpful for working on our docs site for a lerna based monorepo.
I spent a bit of time looking at this today, and it's unfortunately a very thorny problem. TypeDoc already has memory issues when running in packages mode with moderately sized monorepos due to the number of ts.Program
s that are concurrently created. Watch mode would make this worse, since it requires keeping two copies of each ts.Program
in memory. Watch mode works by keeping track of the previous program and, when a change is detected, creating a new program from the changes and the original program.
I suspect this can be mitigated by only keeping the last program (or few) to rebuild in memory, since most of the time users will be making incremental changes to just one or two packages, but doing this means that TypeDoc needs some major architectural work to be able to rebuild parts of the project without access to a program. It's something I've wanted for a long while anyways, and it's getting closer with #1890 and others, but it's still a ways off.
Understood. We're not in urgent need of this or anything, but is a definite nice to have if you can work your way there over time! Appreciate you looking into it and the detailed update! 🙏
We are intersting at this feature. Hopes this day comes soon 🙏🙏🙏 Thanks