typedoc icon indicating copy to clipboard operation
typedoc copied to clipboard

Support packages entryPointStrategy in watch mode.

Open mokone91 opened this issue 3 years ago • 6 comments

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!

mokone91 avatar Oct 29 '21 16:10 mokone91

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.

Gerrit0 avatar Oct 31 '21 14:10 Gerrit0

Thanks for reply! got it, will keep subscription and follow the news Thanks!

mokone91 avatar Nov 02 '21 16:11 mokone91

We would also be interested! This would be very helpful for working on our docs site for a lerna based monorepo.

wilcoxmd avatar Mar 08 '22 18:03 wilcoxmd

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.Programs 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.

Gerrit0 avatar Mar 27 '22 13:03 Gerrit0

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! 🙏

wilcoxmd avatar Mar 28 '22 15:03 wilcoxmd

We are intersting at this feature. Hopes this day comes soon 🙏🙏🙏 Thanks

ziyziyziy888 avatar Jan 31 '23 07:01 ziyziyziy888