Skip to content

[docs-infra] Improve Typedocs HTML Weight#4497

Draft
dav-is wants to merge 12 commits intomui:masterfrom
dav-is:docs-infra/improve-types-html-weight
Draft

[docs-infra] Improve Typedocs HTML Weight#4497
dav-is wants to merge 12 commits intomui:masterfrom
dav-is:docs-infra/improve-types-html-weight

Conversation

@dav-is
Copy link
Copy Markdown
Member

@dav-is dav-is commented Mar 31, 2026

Pairs with upstream PR: mui/mui-public#1269

Defers detailed type code highlighting until after hydration. Significantly decreases uncompressed HTML size, HTML parse time, RSC prop parse time, and render time.

Combobox Benchmark

Decreases the page's uncompressed HTML size by 30% with the tradeoff of increasing the compressed HTML by 5%. Brings it below the 2 MB limit for search engine crawlers.

Uncompressed HTML Compressed HTML
Before 2675 KB 276 KB
After 1886 KB 290 KB
Change -789 KB (30%) +14 KB (5%)

Improves first contentful paint and hydration time by 42 ms. Achieved by reducing HTML parse time by 34%, scripting time (to parse the RSC props) by 31%, and reducing time to calculate styles by 30% ("Recalculating Styles" in performance trace).

Parse Time Scripting Time Calculating Styles Total
Before 56ms 49ms 27ms = 132ms
After 37ms 34ms 19ms = 90ms
Change -19ms (34%) -15ms (31%) -8ms (30%) = -42ms (29%)

Before:
Screenshot From 2026-04-03 12-49-49

After:
Screenshot From 2026-04-03 12-49-57

changing network conditions resulted in slightly offset timing between the two runs

Preview Deployment

@dav-is dav-is added type: enhancement It’s an improvement, but we can’t make up our mind whether it's a bug fix or a new feature. scope: docs-infra Involves the docs-infra product (https://www.notion.so/mui-org/b9f676062eb94747b6768209f7751305). labels Mar 31, 2026
@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new bot commented Mar 31, 2026

commit: 25b2040

@dav-is dav-is changed the title [docs-infra] Improve Typedoc Html Weight [docs-infra] Improve Typedocs Html Weight Mar 31, 2026
@mui-bot
Copy link
Copy Markdown

mui-bot commented Mar 31, 2026

Bundle size report

Bundle Parsed size Gzip size
@base-ui/react 0B(0.00%) 0B(0.00%)

Details of bundle changes


Check out the code infra dashboard for more information about this PR.

@netlify
Copy link
Copy Markdown

netlify bot commented Mar 31, 2026

Deploy Preview for base-ui ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 41251c8
🔍 Latest deploy log https://app.netlify.com/projects/base-ui/deploys/69cc49ce5084f60008f30474
😎 Deploy Preview https://deploy-preview-4497--base-ui.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link
Copy Markdown

netlify bot commented Mar 31, 2026

Deploy Preview for base-ui ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 25b2040
🔍 Latest deploy log https://app.netlify.com/projects/base-ui/deploys/69d58e28a75aff0008fa2628
😎 Deploy Preview https://deploy-preview-4497--base-ui.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions bot added the PR: out-of-date The pull request has merge conflicts and can't be merged. label Apr 3, 2026
@github-actions github-actions bot removed the PR: out-of-date The pull request has merge conflicts and can't be merged. label Apr 3, 2026
@dav-is dav-is changed the title [docs-infra] Improve Typedocs Html Weight [docs-infra] Improve Typedocs HTML Weight Apr 3, 2026
@github-actions github-actions bot added the PR: out-of-date The pull request has merge conflicts and can't be merged. label Apr 6, 2026
@github-actions github-actions bot removed the PR: out-of-date The pull request has merge conflicts and can't be merged. label Apr 7, 2026
@github-actions github-actions bot added the PR: out-of-date The pull request has merge conflicts and can't be merged. label Apr 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

PR: out-of-date The pull request has merge conflicts and can't be merged. scope: docs-infra Involves the docs-infra product (https://www.notion.so/mui-org/b9f676062eb94747b6768209f7751305). type: enhancement It’s an improvement, but we can’t make up our mind whether it's a bug fix or a new feature.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants