Expose stable machine-readable Angular build diagnostics
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 35/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Ít trao đổi
- Công nghệ
- angular, typescript
- Lĩnh vực
- build-system, cli, developer-experience
Hướng nghiên cứu
Bắt đầu với package compiler-cli và entry point ng build, sau đó lần theo để xác định nơi các diagnostic của Angular compiler và template được tạo và định dạng. Xác định và ghi lại một đầu ra ổn định, có thể đọc bằng máy, chứa các trường diagnostic được yêu cầu, đồng thời xác minh rằng một strict-check build có thể xuất đầu ra đó cho các công cụ baseline bên ngoài.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Which @angular/* package(s) are relevant/related to the feature request?
compiler-cli
Description
Large Angular codebases often want to enable stricter compiler checks, especially strictTemplates and extended diagnostics, but cannot fix all existing diagnostics in one migration.
Angular already supports category-based strictness ratcheting through template type-checking flags. That helps when a whole category of checks is too noisy.
It does not solve the case where a team wants a check enabled, but wants to treat existing diagnostics as migration debt while preventing new diagnostics from being introduced.
Teams can build this externally by parsing ng build output, but text output is not a stable API. Angular diagnostics can include template source spans and compiler-specific formatting, which makes external parsing fragile.
This is not a request for strictTemplates warning mode. A previous discussion in https://github.com/angular/angular/issues/55868 explained why warning mode is not a good fit for strictTemplates, especially because template type-checking often produces TypeScript diagnostics from generated template-checking code.
This request is only about exposing stable diagnostic output so external tooling can implement baseline/ratchet workflows reliably.
Proposed solution
Expose stable machine-readable diagnostics from Angular CLI builds.
For example:
ng build my-app --configuration strict-check --diagnostics-format json
or:
ng build my-app --configuration strict-check --diagnostics-output angular-diagnostics.json
The exact CLI/API shape is not important. The important part is that ng build can emit stable, machine-readable diagnostics.
Example shape:
{
"diagnostics": [
{
"code": "NG8002",
"category": "error",
"source": "angular-template",
"message": "Can't bind to ...",
"file": "libs/example/src/example.component.html",
"startLine": 12,
"startColumn": 7,
"endLine": 12,
"endColumn": 28,
"relatedInformation": []
}
]
}
The schema should include enough stable information for tools to compare diagnostics across runs, such as diagnostic code, category/severity, source, file, source span, message, and related information when available.
This would enable external workflows like:
ng build my-app --configuration strict-check --diagnostics-output angular-diagnostics.json
angular-baseline check angular-diagnostics.json
That allows teams to create a migration ratchet:
- Existing diagnostics are treated as migration debt.
- New diagnostics fail CI.
- Fixed diagnostics can be removed from the baseline.
- The codebase becomes stricter over time.
This is similar in spirit to tsc-baseline or ESLint bulk suppressions, but for Angular compiler and template diagnostics.
Alternatives considered
Use existing template strictness flags
Angular's existing strictness flags are useful for category-based rollout.
However, disabling a category allows both existing and new violations in that category.
A diagnostic baseline lets a team keep the check enabled while allowing only known existing diagnostics.
Parse ng build text output
Teams can parse ng build output today, but this is fragile because CLI text output is optimized for humans, not long-term machine consumption.
Add first-class Angular diagnostic baselines
Angular could provide a full diagnostic baseline feature directly, for example:
ng build my-app --configuration strict-check --update-diagnostic-baseline
ng build my-app --configuration strict-check --diagnostic-baseline angular-diagnostics.baseline.json
That would be useful, but stable machine-readable diagnostics would already allow the ecosystem to build this externally.
- Ngôn ngữ chính
- TypeScript
- Star
- 27k
- Fork
- 11.8k
- Merge trung bình
- 1 ngày 2 giờ
- Pull request đã merge (30 ngày)
- 225
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của angular/angular-cli
-
`@angular/[email protected]` depends on vulnerable Vite 7.3.7 - GHSA-p4f5-76q4-ffq7 (Critical RCE)Đang mởarea: @angular/build
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
angular/angular-cli#34764 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
ng add @angular/ssr fails with TypeError when an NgModule in the app module file has no bootstrap arrayCó thể đã có người làm @0z5a đã nhận hôm nay. Đang mởarea: @schematics/angular
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 90/100
angular/angular-cli#34761 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 72/100
angular/angular-cli#34760 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Angular SSR can crash `AngularAppEngine` servers with a single aborted request (22.2.6 regression)Có thể đã có người làm @SkyZeroZx đã nhận 1 ngày trước. Đang mởarea: @angular/ssr
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 20/100
angular/angular-cli#34754 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area: @schematics/angular
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 74/100
angular/angular-cli#34730 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của angular/angular-cli
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
milind-soni/OpenMausBot#6730 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
status/need-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
google-gemini/gemini-cli#30384 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
P2
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 84/100
Maintainer thường phản hồi trong vòng 1 ngày
-
area:image documentation good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
Maintainer thường phản hồi trong vòng 1 ngày
-
docs enhancement examples good first issue
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 88/100
Maintainer thường phản hồi trong vòng 1 ngày