angular/adev/shared-docs/pipeline/api-gen/rendering/templates
Shuaib Hasan Akib 8bdd98ef41 fix(docs-infra): prevent duplicate description rendering for block API entries
Block entries (@if, @defer, @for,@let, @switch) were falling back to the generic
DocsReference template, causing the description to appear twice - once in
the header section and once in the main content area.

This commit adds a dedicated rendering path for block entries:
- Creates BlockEntryRenderable type and associated transforms
- Adds BlockReference template that uses RawHtml directly
- Modifies HeaderApi to accept hideDescription prop
- Updates processing and rendering pipelines to handle blocks

The fix ensures block documentation displays only one description section
while preserving the existing behavior for all other API entry types.

Update adev/shared-docs/pipeline/api-gen/rendering/transforms/block-transforms.mts

Co-authored-by: Matthieu Riegler <kyro38@gmail.com>
2026-01-12 13:37:54 -08:00
..
block-reference.tsx fix(docs-infra): prevent duplicate description rendering for block API entries 2026-01-12 13:37:54 -08:00
class-member-list.tsx build: migrate adev shared-docs package to use ts_project (#61193) 2025-05-09 16:30:05 +00:00
class-member.tsx docs(docs-infra): clean up TODO comment, unused imports, and helper function 2025-12-17 14:33:58 -08:00
class-method-info.tsx docs(docs-infra): prevent from showing duplicate usage blocks in functions API docs 2026-01-12 09:50:12 -08:00
class-reference.tsx refactor(docs-infra): use shiki for highlighting 2025-11-21 13:20:46 -05:00
cli-card.tsx fix(docs-infra): allow wrapping of types-and-default CLI options (#63211) 2025-08-18 12:52:03 +02:00
cli-reference.tsx docs: fix CLI reference layout (#62609) 2025-07-14 09:59:54 -07:00
code-line-group.tsx ci: reformat files 2025-12-16 14:44:19 -08:00
code-line.tsx ci: reformat files 2025-12-16 14:44:19 -08:00
code-symbols.tsx docs(docs-infra): share markdown rendering and highlighting code between api-gen and guides (#63357) 2025-08-25 15:33:55 -07:00
code-table-of-contents.tsx docs: improve docs generation for namespaces (#64747) 2025-11-05 22:42:59 +00:00
constant-reference.tsx docs: display deprecation message for top most symbol (#62427) 2025-07-03 08:35:01 +00:00
decorator-reference.tsx docs(docs-infra): Show API decorators docs 2026-01-12 09:41:25 -08:00
deprecated-label.tsx docs: display deprecation message for top most symbol (#62427) 2025-07-03 08:35:01 +00:00
deprecation-warning.tsx docs: display deprecation message for top most symbol (#62427) 2025-07-03 08:35:01 +00:00
docs-pill-row.tsx docs(docs-infra): renders inline code snippets in docs pills 2025-11-25 18:30:05 -05:00
docs-reference.tsx build: migrate adev shared-docs package to use ts_project (#61193) 2025-05-09 16:30:05 +00:00
enum-reference.tsx docs: display deprecation message for top most symbol (#62427) 2025-07-03 08:35:01 +00:00
function-reference.tsx docs(docs-infra): prevent from showing duplicate usage blocks in functions API docs 2026-01-12 09:50:12 -08:00
header-api.tsx fix(docs-infra): prevent duplicate description rendering for block API entries 2026-01-12 13:37:54 -08:00
header-cli.tsx ci: reformat files 2025-12-16 14:44:19 -08:00
highlight-ts.tsx refactor(docs-infra): use shiki for highlighting 2025-11-21 13:20:46 -05:00
initializer-api-function.tsx docs(docs-infra): prevent from showing duplicate usage blocks in functions API docs 2026-01-12 09:50:12 -08:00
parameter.tsx ci: reformat files 2025-12-16 14:44:19 -08:00
raw-html.tsx docs(docs-infra): use a custom scrollbar for the examples using HighlightTypeScript (#60981) 2025-04-23 17:24:29 +02:00
section-api.tsx build: migrate adev shared-docs package to use ts_project (#61193) 2025-05-09 16:30:05 +00:00
section-description.tsx build: migrate adev shared-docs package to use ts_project (#61193) 2025-05-09 16:30:05 +00:00
section-heading.tsx docs(docs-infra): Fixes the visibility of the copy link button in API documentation headings 2025-12-10 10:15:59 -08:00
section-usage-notes.tsx build: migrate adev shared-docs package to use ts_project (#61193) 2025-05-09 16:30:05 +00:00
type-alias-reference.tsx feat(docs-infra): add support for namespaces 2025-10-29 20:22:21 +00:00