⚡ Sangsakala Proxy 🏠 Home
Skip to content

feat(compiler-cli): support API documentation extraction in preprocessor - #71773

Draft
JeanMeche wants to merge 1 commit into
angular:mainfrom
JeanMeche:feat/ngp-api-extraction
Draft

JeanMeche wants to merge 1 commit into
angular:mainfrom
JeanMeche:feat/ngp-api-extraction

Conversation

@JeanMeche

@JeanMeche JeanMeche commented Nov 2, 2026 •

Copy link
Copy Markdown
Member

Summary

  • Decouples DocsExtractor from ngtsc's internal MetadataReader via a minimal DocsMetadataReader interface exported from @angular/compiler-cli/private/hybrid_analysis.
  • Implements getApiDocumentation and getApiDocumentationSync in @angular/compiler-cli/preprocessor (and exposes them on HybridCompiler), backed by analyzer class metadata.
  • Unplugs legacy getApiDocumentation from NgCompiler and NgtscProgram, and removes unused metadata dependency from ngtsc/docs.
  • Migrates adev's API extraction pipeline (extract_api_to_json) to use HybridCompiler / getApiDocumentation.
  • Unconditionally routes docs extraction in NgtscTestEnvironment through the preprocessor, enabling all 118 docs extraction specs across both suites and removing them from NGP_KNOWN_NGTSC_FAILURES.

@angular-robot angular-robot Bot added detected: feature PR contains a feature commit area: compiler Issues related to `ngc`, Angular's template compiler labels Nov 2, 2026
@ngbot ngbot Bot added this to the Backlog milestone Nov 2, 2026
@github-actions

github-actions Bot commented Nov 3, 2026 •

Copy link
Copy Markdown

Deployed adev-preview for e385635 to: https://ng-dev-previews-fw--pr-angular-angular-71773-adev-prev-gafrpb8b.web.app

Note: As new commits are pushed to this pull request, this link is updated after the preview is rebuilt.

@JeanMeche
JeanMeche force-pushed the feat/ngp-api-extraction branch 2 times, most recently from 3478dd0 to 2ab6aba Compare November 3, 2026 20:22
Decouple `DocsExtractor` from ngtsc's internal `MetadataReader` via a minimal
`DocsMetadataReader` interface, and implement `getApiDocumentation` and
`getApiDocumentationSync` on `HybridCompiler` in `@angular/compiler-cli/preprocessor`.

Also unplug the legacy `getApiDocumentation` extraction code from `NgCompiler`
and `NgtscProgram`, switch `adev`'s extraction pipeline to `HybridCompiler`,
and route docs extraction specs unconditionally through the preprocessor.
@JeanMeche
JeanMeche force-pushed the feat/ngp-api-extraction branch from 2ab6aba to e385635 Compare November 3, 2026 21:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

adev: preview area: compiler Issues related to `ngc`, Angular's template compiler detected: feature PR contains a feature commit

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant