Matthieu Riegler
44782beea7
docs(docs-infra): fix & simplify scrolling for code blocks ( #62179 )
...
PR Close #62179
2025-06-23 14:19:34 +02:00
Joey Perrott
1182fe7053
build: migrate to usages of @devinfra// instead of @npm//@angular/build-tooling ( #62050 )
...
Use workspace imported devinfra deps instead of npm dep
PR Close #62050
2025-06-16 10:23:30 +02:00
Joey Perrott
9c0b41796e
build: migrate adev to use new jasmine_test ( #62034 )
...
Use jasmine_test instead of jasmine_node_test in adev
PR Close #62034
2025-06-13 12:30:15 +02:00
Paul Gschwendtner
fa123803b4
build: update api-gen to work with compiler as ts_project ( #61566 )
...
Compiler now would have `.js` files. Those aren't picked up as ESM,
unless we install the `package.json` with `type: module`. Sounds great
on paper, but doesn't work in reality because the way the compiler
packages are available to `api-gen/` is via the old `rules_nodejs`
linker, so the `packages/package.json` wouldn't work; nor do the
`package.json`s of the e.g. compiler-cli package work- because those
already contain the `exports` of the built npm package.
We fix this in a much more reasonable way, and the whole module
resolution problem by leveraging the pnpm linking here. This works as
expected.
PR Close #61566
2025-05-29 14:39:10 -04:00
Alan Agius
9832e72fc3
build: disable esbuild metadata file generation ( #61636 )
...
Disables creation of the esbuild meta.json file, which is not utilized in the build process. This streamlines the output and avoids generating unused artifacts.
PR Close #61636
2025-05-26 08:57:41 +00:00
Matthieu Riegler
f1f37896c5
docs(docs-infra): display CLI enum values for enums ( #61521 )
...
fixes #61516
PR Close #61521
2025-05-20 16:54:12 +00:00
Joey Perrott
ef0f1a4ca8
build: move ts_project and ng_project for adev into a macro ( #61319 )
...
Move ts_project and ng_project into a macro for adev/ instead of providing a custom
tsconfig on every target
PR Close #61319
2025-05-20 08:48:29 +00:00
Matthieu Riegler
ca700e1def
docs(docs-infra): Improve formatting of functions ( #61154 )
...
The commit introduce prettier to format some API entries.
For now we'll do only functions are other are a bit more complex because of the support of deprecation.
fixes #59211
PR Close #61154
2025-05-16 13:58:35 +00:00
Joey Perrott
5f1c08d75f
build: migrate adev shared-docs package to use ts_project ( #61193 )
...
Migrate the build rules for shared docs to use ts_project
PR Close #61193
2025-05-09 16:30:05 +00:00
Paul Gschwendtner
10bc80a788
build: migrate compiler-cli/src/ngtsc to ts_project ( #61181 )
...
Migrates all of `compiler-cli/src/ngtsc` to `ts_project`. This change
was generated using Gemini.
PR Close #61181
2025-05-09 15:59:46 +00:00
Paul Gschwendtner
54e785683a
build: prepare for compiler-cli to be using ts_project ( #61181 )
...
Prepare the compiler-cli package for being ready for migration
to `ts_project`.
PR Close #61181
2025-05-09 15:59:46 +00:00
Miles Malerba
47e44c8af0
docs: update rendering to use generated repo link ( #61130 )
...
PR Close #61130
2025-05-06 14:07:32 -07:00
Miles Malerba
72284bcda5
docs: update API generation to include repo name ( #61130 )
...
PR Close #61130
2025-05-06 14:07:31 -07:00
Miles Malerba
e0248aae6a
docs: hide entries that are marked @docs-private ( #61104 )
...
PR Close #61104
2025-05-05 08:43:30 -07:00
Matthieu Riegler
f580318411
docs(docs-infra): Add version of introduction for APIs ( #60814 )
...
For new APIs we'll mention since when a particular API is in its current status (experimental, devPreview, stable)
fixes #49668
PR Close #60814
2025-05-02 07:51:33 -07:00
Andrew Scott
344ea29f7a
refactor(docs-infra): remove 'experimental' from cli entry ( #61067 )
...
this removes the experimental prefix from zoneless entry in fake cli
PR Close #61067
2025-04-30 14:16:55 -07:00
hawkgs
d8204bf584
docs(docs-infra): fix function api ref header width ( #61022 )
...
Fix the width of the function API reference header when the viewport width is for-desktop-down.
PR Close #61022
2025-04-28 10:01:40 -07:00
hawkgs
3e293535e3
docs(docs-infra): use a custom scrollbar for the examples using HighlightTypeScript ( #60981 )
...
The examples used to render the native scrollbar.
PR Close #60981
2025-04-23 17:24:29 +02:00
Matthieu Riegler
c990265473
docs(docs-infra): Improve doc support for pipes. ( #60926 )
...
This commits adds the pipe usage and the impure pipe mention.
PR Close #60926
2025-04-23 08:46:11 +02:00
Matthieu Riegler
1339f06ebe
docs(docs-infra): Improve markdown generation for code examples. ( #60408 )
...
Markdown requires code blocks (```) to start without white spaces. With this change we ensure that `@example` blocks with leading spaces are well supported.
fixes #60407
PR Close #60408
2025-03-21 14:35:19 -07:00
Alan Agius
8e48bc9a82
docs(docs-infra): add support for @example ( #60443 )
...
In TSDoc, we currently handle the `@usageNotes` annotation, but this is not a standard TSDoc tag. Instead, the `@example` annotation is the correct standard, which is used in the Angular CLI repo and on the SSR package.
This change ensures that `@example` is treated the same as `@usageNotes` during the transform process and also handle multiple instances of `@example` on the same tag.
PR Close #60443
2025-03-18 18:14:10 +01:00
Matthieu Riegler
db5963797d
docs(docs-infra): Extract class constructors ( #60302 )
...
fixes #59180
PR Close #60302
2025-03-10 16:05:02 -07:00
Matthieu Riegler
aa1ab41e6c
docs(docs-infra): enable & fix tests ( #60220 )
...
PR Close #60220
2025-03-06 14:33:48 -08:00
Matthieu Riegler
286e4da52b
docs(docs-infra): Throw error at build time for invalid links ( #59162 )
...
PR Close #59162
2025-03-04 20:07:23 +00:00
hawkgs
2b114e784d
docs(docs-infra): API doc content rendering fixes ( #60116 )
...
The PR introduces a few doc content rendering fixes:
- Fix highlighted section heading styles (regression from #59965 ).
- Convert JSDoc links within 'Usage Notes' sections to HTML and render them.
- Add IDs to doc content headings. This, by itself, makes these headings available in the page ToC.
PR Close #60116
2025-03-04 17:46:30 +00:00
Miles Malerba
2e03a8685b
docs(docs-infra): Improve support for @link within the jsdoc. ( #60201 )
...
PR Close #60201
2025-03-04 17:13:42 +00:00
Matthieu Riegler
ba94f6f84f
docs(docs-infra): hide github link for external repos. ( #60114 )
...
fixes #60113
PR Close #60114
2025-03-04 17:02:37 +00:00
hawkgs
ea5b7371e5
docs(docs-infra): fix card highlighting in the API reference details page ( #59965 )
...
Drop `pointer-events: none` and update the member card highlighting mechanism.
PR Close #59965
2025-02-18 14:56:48 +00:00
hawkgs
b6733eeea4
docs(docs-infra): drop tabs layout from the API reference details page ( #59068 )
...
Drop the tabs in favor of a single page separated by sections.
PR Close #59068
2025-02-13 14:58:33 +00:00
Matthieu Riegler
0d88463a66
docs(docs-infra): inline example in description ( #59908 )
...
fixes #59905
PR Close #59908
2025-02-12 09:21:49 -08:00
Matthieu Riegler
fd073004bb
docs(docs-infra): fix entry labels. ( #59384 )
...
fixes #59382
PR Close #59384
2025-01-08 15:22:43 +00:00
RafaelJCamara
fabd642826
docs: update README to reflect correct Angular repository branch in rendering regions ( #59421 )
...
PR Close #59421
2025-01-08 15:22:07 +00:00
Matthieu Riegler
139f61913c
docs: remove data attributes from api-item-label ( #59273 )
...
Perf measurments have revealed that `data-*` attributes are slower to set than classes.
PR Close #59273
2025-01-06 16:03:42 +00:00
Matthieu Riegler
cf27cbb1f8
docs(docs-infra): remove costly localeCompare ( #59106 )
...
This function wasn't necessary, the items where already sorted.
fixes #59069d
PR Close #59106
2024-12-16 15:18:39 -08:00
Matthieu Riegler
f15ccb94b9
docs(docs-infra): enable tslint ( #58961 )
...
PR Close #58961
2024-12-05 16:03:35 -08:00
hawkgs
77a0ee85c1
feat(docs-infra): use angular-ts and angular-html shiki highlighting ( #59004 )
...
Use `angular-ts` instead of `typescript` and `angular-html` instead of `html`.
PR Close #59004
2024-12-04 18:05:59 +01:00
hawkgs
0a399e7f9c
refactor(docs-infra): update comments ( #59004 )
...
Add missing file header comments and update others.
PR Close #59004
2024-12-04 18:05:59 +01:00
hawkgs
c13528b1b9
test(docs-infra): interpolation mechanism ( #59004 )
...
Test all use cases that are supported by the interpolation mechanism.
PR Close #59004
2024-12-04 18:05:58 +01:00
hawkgs
d40967c356
fix(docs-infra): minor bug fixes ( #59004 )
...
Minor bug fixes found and implemented during testing.
PR Close #59004
2024-12-04 18:05:58 +01:00
hawkgs
b97b92024d
test(docs-infra): add initial test ( #59004 )
...
Setup the test suite and add the initial test.
PR Close #59004
2024-12-04 18:05:58 +01:00
hawkgs
9ca8ddb265
fix(docs-infra): markdown code block highlighting for the different file types ( #59004 )
...
Set the code block language highlighting based on the file type.
PR Close #59004
2024-12-04 18:05:58 +01:00
hawkgs
f13f52f70f
feat(docs-infra): remove redundant JSDoc transform related to code examples ( #59004 )
...
The transform is no longer relevant nor it served any functional purpose.
PR Close #59004
2024-12-04 18:05:58 +01:00
hawkgs
e1009f09c0
fix(docs-infra): handle regions overlap and multiple-regions examples ( #59004 )
...
It seems that there are overlapping region markers and an example can be composed by multiple regions.
PR Close #59004
2024-12-04 18:05:58 +01:00
hawkgs
e0beb27581
fix(docs-infra): interpolation script nesting ( #59004 )
...
Add support for nested #docregion-s and modify the examples caching.
PR Close #59004
2024-12-04 18:05:58 +01:00
hawkgs
8b93e3c90d
feat(docs-infra): implement interpolation script ( #59004 )
...
The script substitutes the JSDoc example tags with the respective code sample.
PR Close #59004
2024-12-04 18:05:58 +01:00
hawkgs
a4ee2d90e6
feat(docs-infra): include code examples files in the API gen ( #59004 )
...
The code examples in `package/examples` are now passed to the API JSON generator.
PR Close #59004
2024-12-04 18:05:58 +01:00
Matthieu Riegler
d0ea622040
docs(docs-infra): read jsdoctags from function overloads ( #58994 )
...
Functions like `linkedSignal` have there `@developerPreview` tags on the overload signature. This commit adds the support for them.
This commit also removes the logic for multiple entries, as now overloads are a single entry.
fixes #58817
PR Close #58994
2024-12-02 16:17:02 +01:00
Alan Agius
c2a9b75045
fix(docs-infra): retain function keyword in API definitions ( #58561 )
...
**Before:**
```ts
animate(
timings: string | number,
styles?: AnimationStyleMetadata | AnimationKeyframesSequenceMetadata | null
): AnimationAnimateMetadata;
```
**Now:**
```ts
function animate(
timings: string | number,
styles?: AnimationStyleMetadata | AnimationKeyframesSequenceMetadata | null
): AnimationAnimateMetadata;
```
PR Close #58561
2024-11-08 17:16:04 +00:00
Alan Agius
d271c4422a
fix(compiler-cli): correct extraction of generics from type aliases ( #58548 )
...
**Before:**
```ts
type HttpEvent = | HttpSentEvent
| HttpHeaderResponse
| HttpResponse<T>
| HttpProgressEvent
| HttpUserEvent<T>
```
**After:**
```ts
type HttpEvent<T> = | HttpSentEvent
| HttpHeaderResponse
| HttpResponse<T>
| HttpProgressEvent
| HttpUserEvent<T>
```
PR Close #58548
2024-11-08 17:15:06 +00:00
Alan Agius
c95aca1f17
docs(docs-infra): update default generic values and add constraints for type parameters in functions ( #58548 )
...
Before
```typescript
createNodeRequestHandler(
handler: T
): T;
```
```typescript
class NgIf<T> {
@Input() set ngIf(value: T);
@Input() set ngIfThen(value: TemplateRef<NgIfContext<T>> | null);
@Input() set ngIfElse(value: TemplateRef<NgIfContext<T>> | null);
static ngTemplateGuard_ngIf: "binding";
static ngTemplateContextGuard<T>(dir: NgIf<T>, ctx: any): boolean;
}
```
Now
```typescript
createNodeRequestHandler<T extends NodeRequestHandlerFunction>(
handler: T
): T;
```
```typescript
class NgIf<T = unknown> {
@Input() set ngIf(value: T);
@Input() set ngIfThen(value: TemplateRef<NgIfContext<T>> | null);
@Input() set ngIfElse(value: TemplateRef<NgIfContext<T>> | null);
static ngTemplateGuard_ngIf: "binding";
static ngTemplateContextGuard<T>(dir: NgIf<T>, ctx: any): boolean;
}
```
PR Close #58548
2024-11-08 17:15:06 +00:00