SkyZeroZx
44fc79b7f7
docs(docs-infra): Adds anchor links to class member headers for linking
...
Adds anchor links to class member headers for direct linking.
Add test to ensure anchors render correctly.
Fixes angular#67970
2026-04-06 11:05:20 -07:00
SkyZeroZx
1af0db5742
docs(docs-infra): replace non-interactive buttons with spans
...
These elements are not interactive, so using <button> is misleading for accessibility
(screen readers and keyboard navigation expect an action).
(cherry picked from commit ad3991cd0b )
2026-03-23 10:24:13 -07:00
SkyZeroZx
522c5ba868
docs(docs-infra): ensure code preview copy preserves spaces
...
Preserve whitespace when copying code examples from the docs. Fixes the copy handler so copied snippets keep original spacing.
Fixes #66790
2026-02-02 10:09:35 -08:00
Matthieu Riegler
72dfb4d92a
docs(docs-infra): wrap getTextOfJSDocComment
...
This commits adds a wrapper around `ts.getTextOfJSDocComment` because of bugs that won't be fixed by the TS team (see microsoft/TypeScript#63027 )
2026-01-29 13:16:00 -08:00
Matthieu Riegler
4ca2722d6f
docs(docs-infra): fix regression on docs-tabs
2026-01-21 12:43:04 -08:00
Matthieu Riegler
f0b1061791
docs(docs-infra): Handle additional description format
...
Ex: https://angular.dev/api/router/withExperimentalPlatformNavigation
2026-01-21 11:37:08 -08:00
Joey Perrott
a88f353a45
fix(docs-infra): support providing links to multiple symbols within a single line of a code block
...
Previously our system only found the first matching symboling to link to within a code block on each line, now we set up a link for all of the discovered symbols on each line
Fixes #65403
2026-01-20 09:35:33 -08:00
Matthieu Riegler
c09f5352f6
docs(docs-infra): Throw build error on invalid guide links
...
The list of valid links is generated from navigation data configuration in the ADEV app.
Redirections are knowingly exclude so we stop referencing them.
2026-01-12 13:38:20 -08:00
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
Matthieu Riegler
b22835579e
docs(docs-infra): prevent from showing duplicate usage blocks in functions API docs
...
fixes #66398
2026-01-12 09:50:12 -08:00
Matthieu Riegler
a056413520
docs(docs-infra): Show API decorators docs
...
fixes #66129
2026-01-12 09:41:25 -08:00
Shuaib Hasan Akib
e9d1c6478a
docs(docs-infra): clean up TODO comment, unused imports, and helper function
2025-12-17 14:33:58 -08:00
Matthieu Riegler
6270bba056
ci: reformat files
...
This is after we've slightly changed a rule in #66056
2025-12-16 14:44:19 -08:00
Shuaib Hasan Akib
3ff20a58d3
refactor(docs-infra): remove deprecated h.JSX.HTMLAttributes usage
...
Import HTMLAttributes directly from preact to address deprecation warning in header-api.tsx
2025-12-15 17:44:24 -08:00
Alan Agius
2a5c6919d0
build: remove API doc generation for localize/init and add mnemonic to API rendering rule.
...
The removed target was not used and was generating an empty output which causes `java.io.IOException: mandatory output packages/localize/init/localize_docs_html was not created`
2025-12-15 11:41:43 -08:00
SkyZeroZx
15e3407dab
docs(docs-infra): Fixes the visibility of the copy link button in API documentation headings
...
Fixes the visibility of the copy link button in API documentation headings.
The button now appears on hover, improving the user experience.
2025-12-10 10:15:59 -08:00
Matthieu Riegler
8199945637
refactor(core): add dedicated deprecated signatures for providedIn: any / NgModule.
...
Those were deprecated by #47616 back in v15.
fixes #65923
2025-12-09 10:38:09 -08:00
Matthieu Riegler
a784995a98
docs(docs-infra): Show examples on function overloads
2025-12-02 12:13:11 +01:00
SkyZeroZx
2d854e01bc
docs(docs-infra): Improves symbol linking for Angular Aria selectors
...
Improves the symbol linking logic to handle Angular component selectors (e.g., ngCombobox). It attempts to convert Angular selector patterns to their corresponding class names, improving navigation to Angular API documentation.
2025-12-01 18:47:19 +01:00
SkyZeroZx
ef034c15c1
docs(docs-infra): renders inline code snippets in docs pills
...
Improves the rendering of `DocsPillRow` to correctly display inline code snippets (using backticks) within the pill labels.
2025-11-25 18:30:05 -05:00
Joey Perrott
fee79e37d5
refactor(docs-infra): use shiki for highlighting
...
Use shiki to perform highlighting instead of a postprocessing action
2025-11-21 13:20:46 -05:00
cexbrayat
c137f1fe91
docs: ExperimentalIsolatedShadowDom mentions
2025-11-14 08:41:13 -08:00
Matthieu Riegler
f737a9dd5c
docs(docs-infra): Add support for metadata on fenced code blocks
...
This will help us replace `docs-code` with inline code usages and prevent future indentation issues
2025-11-13 09:36:13 -08:00
Matthieu Riegler
16e61f5dd0
docs(docs-infra): Add support for experimental enum entries
2025-11-11 08:46:06 -08:00
Miles Malerba
59635bba34
docs: improve docs generation for namespaces ( #64747 )
...
Improves docs epxerience for interfaces / type aliases that are merged
with a namespace.
PR Close #64747
2025-11-05 22:42:59 +00:00
Miles Malerba
662f0e5c00
feat(docs-infra): add support for namespaces
...
Adds support for generating docs for namespaces (and merged declarations
of namespace + type)
2025-10-29 20:22:21 +00:00
SkyZeroZx
f3d056a065
docs(docs-infra): Prevent empty extends clause in interface documentation
...
Interfaces with no extends clause were incorrectly rendered with a trailing extends keyword followed by nothing, resulting in invalid TypeScript syntax
2025-10-29 18:48:30 +01:00
Matthieu Riegler
54636eacca
docs(docs-infra): Extract multiple extends statements for interfaces ( #64539 )
...
fixes #64528
PR Close #64539
2025-10-20 21:18:13 +00:00
SkyZeroZx
ecb2507c8b
docs(docs-infra): Corrects repo name typo in entry parsing logic ( #64487 )
...
Ensures the repository reference uses the correct name to prevent confusion and maintain consistency across generated documentation entries.
PR Close #64487
2025-10-17 14:52:24 +00:00
Matthieu Riegler
1ffc643737
docs(docs-infra): fix @example in class members ( #64249 )
...
eg: ApplicationRef
PR Close #64249
2025-10-06 15:11:31 -04:00
Matthieu Riegler
5eb9f57ae8
docs: Introduce API category sorting ( #63914 )
...
PR Close #63914
2025-09-19 14:44:10 +00:00
Matthieu Riegler
31c689a5f4
docs(docs-infra): highlight & parse api descriptions. ( #63536 )
...
The prevent future regression of this, this commit introduces additional tests.
PR Close #63536
2025-09-02 16:49:10 +00:00
Joey Perrott
b4ae94d5ef
refactor: remove TODOs which have been corrected ( #63421 )
...
Remove TODOs which were addressed but the comment was not removed
PR Close #63421
2025-08-27 11:23:57 -07:00
Joey Perrott
c15b8ed631
build: enable strict deps enforcement for ts_project ( #63375 )
...
Enable strict_deps testings for all ts_project and ng_project targets in the repo
PR Close #63375
2025-08-26 09:46:30 -07:00
Matthieu Riegler
47dc4ffd1a
docs(docs-infra): share markdown rendering and highlighting code between api-gen and guides ( #63357 )
...
This reduces code duplication and improves the maintability.
PR Close #63357
2025-08-25 15:33:55 -07:00
Matthieu Riegler
da06239a41
docs(docs-infra): Add exemption list for linking symbols. ( #63309 )
...
PR Close #63309
2025-08-21 10:05:55 -07:00
Matthieu Riegler
2aa9775078
docs(docs-infra): remove temporary shiki dts ( #63253 )
...
The tooling now supports reading `d.mts` typing files
PR Close #63253
2025-08-20 09:26:17 +00:00
Alan Agius
494385cac0
fix(docs-infra): allow wrapping of types-and-default CLI options ( #63211 )
...
This change fixes an issue where long lists of enum values would display on a single line, running off the screen, especially on mobile devices.
PR Close #63211
2025-08-18 12:52:03 +02:00
Alan Agius
1714e9ea0e
fix(docs-infra): display value type in CLI pages ( #63211 )
...
The value type was not being displayed when a value had an enum, which was misleading. This change ensures the value type is always shown, so users know whether to expect a single value or an array of values.
PR Close #63211
2025-08-18 12:52:03 +02:00
Matthieu Riegler
93c735cae7
docs: fix edit links for block/element api entries ( #62766 )
...
PR Close #62766
2025-08-14 13:03:00 +02:00
Joey Perrott
c4dcfdf644
build: update to the latest version of devinfra and rename npm2 workspace ( #63093 )
...
Rename the npm2 workspace to npm and use the latest version of devinfra which drops rules_nodejs
PR Close #63093
2025-08-11 10:35:32 -07:00
Ryan Bendel
d24d5742db
feat(platform-browser): Add IsolatedShadowDom encapsulation method ( #62723 )
...
IsolatedShadowDom encapsulation fixes style leakage in Shadowdom encapsulation by removing sharedstyleshost from dom-renderer IsolatedShadowdom class. Updates docs.
PR Close #62723
2025-08-06 16:48:37 +02:00
Joey Perrott
cbc258eec8
build: remove ts_project_interop infrastructure ( #62908 )
...
Remove the interop macros and final usages
PR Close #62908
2025-07-31 09:12:58 +00:00
Joey Perrott
008ed216d3
build: remove usages of runtime_rnjs_interop ( #62908 )
...
Remove all usages of the runtime_rnjs_interop feature
PR Close #62908
2025-07-31 09:12:58 +00:00
Joey Perrott
49b7729e88
build: remove usages of rules_nodejs ( #62885 )
...
Remove rules_nodejs usages with direct migrations to rule_js alternatives
PR Close #62885
2025-07-30 08:51:27 +00:00
Joey Perrott
32c00ab416
build: standardize usage of js_binary ( #62860 )
...
Remove usages of nodejs_binary and use a commonly defined js_binary macro
PR Close #62860
2025-07-29 06:43:44 +02:00
Joey Perrott
caee6ff8e7
build: remove all usages of @bazel/runfiles ( #62804 )
...
Remove usages of @bazel/runfiles throughout the repository
PR Close #62804
2025-07-25 10:04:55 +02:00
Joey Perrott
8bf97d1370
build: remove all usages of the interop_deps attr for ts_project and ng_project ( #62732 )
...
Remove all of the usages of interop_deps as attributes in the repo
PR Close #62732
2025-07-21 13:03:09 -04:00
Joey Perrott
e8c5603126
build: move all rule/macro loading into adev/defaults.bzl and fix intellisense loading ( #62627 )
...
Move all of our loading into a local defaults.bzl file instead of mixed loading via tools/defaults and adev/defaults
PR Close #62627
2025-07-14 15:47:05 -07:00
Matthieu Riegler
2d048d5520
test(docs-infra): Use the zoneless testing rule ( #62596 )
...
This will spare use the warning logs when the tests run.
```
NG0914: The application is using zoneless change detection, but is still loading Zone.js. Consider removing Zone.js to get the full benefits of zoneless. In applications using the Angular CLI, Zone.js is typically included in the "polyfills" section of the angular.json file.
```
PR Close #62596
2025-07-14 11:36:43 -07:00