[docs-infra] Replace handwritten source parsing with TypeScript

[brijeshb42]

Part of #1762

Summary

Replace handwritten JavaScript/TypeScript parsing with the TypeScript syntax tree for:

• create* factory discovery and source ranges
• factory arguments, objects, arrays, calls, generics, arrows, and assertions
• static imports, export-from statements, and dynamic imports

The existing structured output and legacy generic factory syntax remain supported. CSS and comment processing are unchanged. Direct utility imports keep the TypeScript parser out of unrelated Base UI bundles.

This reduces production code by 1,046 SLOC (+531 / -1,577). All 133 factory results and 520 import results in the Base UI demo corpus are byte-for-byte equivalent to master.

The corpus microbenchmark increases from 23 ms to 82 ms. The cold Base UI docs build still compiled in 37.8 seconds, generated all 193 pages, and reported no broken links or HTML issues. Across three alternating cold builds, median aggregate peak RSS was 4.32 GB on master and 4.24 GB on this branch—no measurable memory regression.

Validation

• 402 focused parser and integration tests
• Prettier, targeted ESLint, TypeScript, and release build
• Base UI production build and link check

[code-infra-dashboard]

Deploy preview

https://deploy-preview-1764--mui-internal.netlify.app/

Bundle size

Total Size Change: ▼-7.05KB^(-0.21%) - Total Gzip Change: ▼-1.87KB^(-0.20%)
Files: 69 total (0 added, 0 removed, 7 changed)

Show details for 69 more bundles

@mui/internal-docs-infra/useCode parsed: 🔺+13B^(+0.01%) gzip: 🔺+71B^(+0.20%)
@mui/internal-docs-infra/useDemo parsed: 🔺+5B^(0.00%) gzip: 🔺+27B^(+0.06%)
@mui/internal-docs-infra/cli parsed: ▼-4.47KB^(-0.54%) gzip: ▼-1.27KB^(-0.50%)
transpileSource parsed: ▼-2.59KB^(-1.20%) gzip: ▼-684B^(-1.37%)
loadIsomorphicCodeVariant parsed: ▼-1B^(0.00%) gzip: ▼-9B^(-0.10%)
@mui/internal-docs-infra/abstractCreateDemo parsed: 0B^(0.00%) gzip: ▼-5B^(-0.21%)
@mui/internal-docs-infra/abstractCreateDemoClient parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/abstractCreateStream parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/abstractCreateTypes parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/ChunkProvider parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/CodeControllerContext parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/CodeExternalsContext parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/CodeHighlighter parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/CodeHighlighter/errors parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/CodeHighlighter/types parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/CodeProvider parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/CoordinatedLazy parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/CoordinatedLazy/types parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/createDemoData parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/createDemoData/types parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/createSitemap parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/createSitemap/types parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useCodeWindow parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useCoordinated parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useCopier parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useCrossTabState parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useDemoController parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useErrors parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useLocalStorageState parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/usePreference parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useScrollAnchor parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useSearch parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useSearch/types parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useStream parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useStream/types parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useType parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useTypes parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/useUrlHashState parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/internal-docs-infra/withDocsInfra parsed: 0B^(0.00%) gzip: 0B^(0.00%)
addLineGutters parsed: 0B^(0.00%) gzip: 0B^(0.00%)
BuildEngine parsed: 0B^(0.00%) gzip: 0B^(0.00%)
CodeHighlighterChunk parsed: 0B^(0.00%) gzip: 0B^(0.00%)
CodeHighlighterClient parsed: 0B^(0.00%) gzip: 0B^(0.00%)
CodeInitialSourceLoader parsed: 0B^(0.00%) gzip: 🔺+1B^(+0.04%)
CodeSourceLoader parsed: 0B^(0.00%) gzip: 0B^(0.00%)
compileCssWithPostcss parsed: 0B^(0.00%) gzip: 0B^(0.00%)
createFrame parsed: 0B^(0.00%) gzip: 0B^(0.00%)
createParseSourceWorkerClient parsed: 0B^(0.00%) gzip: 0B^(0.00%)
EditingEngine parsed: 0B^(0.00%) gzip: 0B^(0.00%)
embedTransforms parsed: 0B^(0.00%) gzip: 0B^(0.00%)
enhanceCodeEmphasis parsed: 0B^(0.00%) gzip: 0B^(0.00%)
findExpandingRanges parsed: 0B^(0.00%) gzip: 0B^(0.00%)
getHastTextContent parsed: 0B^(0.00%) gzip: 0B^(0.00%)
grammarLoaders parsed: 0B^(0.00%) gzip: 0B^(0.00%)
grammars parsed: 0B^(0.00%) gzip: 0B^(0.00%)
isFrameSpan parsed: 0B^(0.00%) gzip: 0B^(0.00%)
parseSource parsed: 0B^(0.00%) gzip: 0B^(0.00%)
rolldown-runtime parsed: 0B^(0.00%) gzip: 0B^(0.00%)
source.css parsed: 0B^(0.00%) gzip: 0B^(0.00%)
source.js parsed: 0B^(0.00%) gzip: 0B^(0.00%)
source.json parsed: 0B^(0.00%) gzip: 0B^(0.00%)
source.mdx parsed: 0B^(0.00%) gzip: 0B^(0.00%)
source.shell parsed: 0B^(0.00%) gzip: 0B^(0.00%)
source.ts parsed: 0B^(0.00%) gzip: 0B^(0.00%)
source.tsx parsed: 0B^(0.00%) gzip: 0B^(0.00%)
source.yaml parsed: 0B^(0.00%) gzip: 0B^(0.00%)
text.html.basic parsed: 0B^(0.00%) gzip: 0B^(0.00%)
text.md parsed: 0B^(0.00%) gzip: 0B^(0.00%)
TransformEngine parsed: 0B^(0.00%) gzip: 0B^(0.00%)

Details of bundle changes

Performance

Total duration: 16.74 ms +0.69 ms^(+4.3%) | Renders: 5 ⁽⁺⁰⁾ | Paint: 57.74 ms -1.11 ms^(-1.9%)

Test	Duration	Renders
custom scalar + discrete metrics	0.00 ms	0 (+0)
sub-series via labels	0.00 ms	0 (+0)

5 tests within noise — details

Metric alarms

Test	Metric	Change
custom scalar + discrete metrics	fib_duration	🔺 +0.13 ms
sub-series via labels	fib_phase#small	🔺 +0.06 ms
sub-series via labels	fib_phase#large	🔺 +0.52 ms

---

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

[Janpot]

1. Is there a specific reason to parse with typescript over e.g. babel? When I think of typescript I think slow, and unstable API.
2. Does this affect dev mode page transitions performance?

[brijeshb42]

Is there a specific reason to parse with typescript over e.g. babel

Mainly because typescript is already installed and initialized. So there's no overhead there. It'll work till we have the lighter version with lezer based parsing.

Does this affect dev mode page transitions performance?

There's a very slight impact in perf (in 40ms range) here, mainly because a ts project is already initialized (for type generation). But nothing significant. We still get same build times but with less code.

[Janpot]

tbh, I'd be very careful relying on typescript API if all we do is parsing. It's really unstable, and non-existent in v7. There is barely an ecosystem for ts as a transpiler platform. I guess we could tolerate it if it's temporary