Elgato_dark/angular
1
0
Fork 0
mirror of https://github.com/angular/angular synced 2026-05-24 09:28:37 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
33260 commits 106 branches 1260 tags 1 GiB
Commit graph

70 commits

Author SHA1 Message Date
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
Alan Agius
3ecf0f6701 docs: add hybrid rendering API guide (#58445) 
This commit introduces a new guide for hybrid rendering APIs, which are currently in developer preview. This documentation provides insights into the usage and features of the APIs, helping developers understand their capabilities and limitations during the preview phase.

PR Close #58445
 2024-11-07 21:28:54 +00:00
Alan Agius
c5ce302e0b docs(docs-infra): add support for @remarks (#58523) 
In TSDoc, we currently handle the `@usageNotes` annotation, but this is not a standard TSDoc tag. Instead, the `@remarks` annotation is the correct standard, which is used in the Angular CLI repo and on the SSR package.

This change ensures that `@remarks` is treated the same as `@usageNotes` during the transform process.

PR Close #58523
 2024-11-07 15:49:13 +00:00
Matthieu Riegler
c1aa9c6041 docs(docs-infra): fix CLI commands (#58294) 
With this commit the CLI doc will display the correct arguments for the subcommands

fixes #58279

PR Close #58294
 2024-10-22 07:42:21 -07:00
Matthieu Riegler
bb0edaded0 docs(docs-infra): Add NgModule exports for directives. (#58071) 
This information is extracted from the @NgModule Jsdoc tag.

fixes #57906

PR Close #58071
 2024-10-04 14:46:16 -07:00
Joey Perrott
9dbe6fc18b refactor: update license text to point to angular.dev (#57901) 
Update license text to point to angular.dev instead of angular.io

PR Close #57901
 2024-09-24 15:33:00 +02:00