@docusaurus/theme-common

[slorber]

Motivation

• need to share code across multiple themes, so that we can create implement same ux on multiple themes (Theme gallery #3522)
• need to protect theme implementation details from swizzling, and only expose a subset of comps (mostly design/layout-related components)
• need to address import issues when swizzling a component that imports internal theme code (#3394 appears to have broken swizzle #3747)

Solution: @docusaurus/theme-common package for shared client-side theme code.

• independent from a specific theme/styling
• its code is considered internal (but we must avoid api breaking changes to avoid breaking swizzled comps anyway)

Have you read the Contributing Guidelines on pull requests?

yes

Test Plan

Tests + preview + build keeps working as usual

Related PRs

#3752
#2714

[netlify]

Deploy preview for docusaurus-2 ready!

Built with commit d5aecf5

https://deploy-preview-3775--docusaurus-2.netlify.app

[github-actions]

Size Change: +19 B (0%)

Total Size: 152 kB

ℹ️ View Unchanged

Filename	Size	Change
website/build/blog/2017/12/14/introducing-docusaurus/index.html	20.7 kB	0 B
website/build/docs/introduction/index.html	180 B	0 B
website/build/index.html	5.84 kB	-2 B (0%)
website/build/main.********.js	108 kB	+21 B (0%)
website/build/styles.********.css	17.4 kB	0 B

_{compressed-size-action}

[netlify]

Deploy preview for docusaurus-2 ready!

Built with commit 7ed3122

https://deploy-preview-3775--docusaurus-2.netlify.app

[lex111]

Awesome!