Commit Graph

2698 Commits

Author SHA1 Message Date
Kam 8f625e77bd refactor(docs-infra): extract magic 27 in navigation-list tooltip threshold
The matTooltip on navigation list items was disabled when the label was
shorter than the literal `27`, repeated across four bindings in the
template. Lift the value to a protected readonly field so the threshold
has a name and lives in one place.

(cherry picked from commit 34d577f697)
2026-05-28 16:08:17 +02:00
Bhuvansh855 7b4b0672a8 docs: fix grammar issues in resource guide
(cherry picked from commit 0e6cb4151c)
2026-05-28 13:48:07 +02:00
Angular Robot d88b796518 build: update cross-repo angular dependencies
See associated pull request for more information.
2026-05-27 16:41:13 -07:00
Yenya030 618c850282 fix(http): exclude withCredentials requests from transfer cache
Update the transfer cache check to safely exclude all requests sent with the `withCredentials` flag.

By default, the HTTP transfer cache avoids caching user-specific responses to prevent sensitive data exposure or incorrect caching. While requests with explicit headers like `Cookie` or `Authorization` are excluded by default, requests can also be sent with credentials via the `withCredentials` flag without having those headers explicitly declared on the request object.

To keep user-specific responses from being cached, exclude `withCredentials` requests unconditionally, even when the `includeRequestsWithAuthHeaders` option is set to true.

(cherry picked from commit 34090cb12e)
2026-05-27 14:13:23 -07:00
Yenya030 86390f2be4 fix(http): skip TransferCache for cookie-bearing requests by default
Treat requests with a Cookie header like other auth-bearing requests and skip TransferCache caching them by default.

This preserves the explicit opt-in path via includeRequestsWithAuthHeaders, adds regression coverage for cookie-bearing requests, and updates the SSR guide to document the behavior.

(cherry picked from commit ab459798d9)
2026-05-27 14:13:23 -07:00
Ricardo Chavarria 5144f5f404 docs(docs-infra): add Spanish community translation
Add https://docs.angular.lat/ (Español) to the community translations section.

(cherry picked from commit 48b4625fb3)
2026-05-27 11:17:00 -07:00
tjshiu a0fbf84856 docs: modernize combobox and select guides and examples
Upgrades the guides and interactive examples to use modern signal-based APIs,
restoring the nested search dialogs and introducing datepicker grids.

(cherry picked from commit 30a8a2c4bd)
2026-05-27 11:11:39 -07:00
Kam 8bb70f860f docs: fix preposition in libraries naming callout
The naming callout said the ng- prefix is "used from the Angular framework". Change to "used by", matching standard usage and the surrounding prose.

(cherry picked from commit 8c3e46fb53)
2026-05-27 11:09:47 -07:00
Harmeet Singh 8462b666e4 docs: clarify signals effect import source
(cherry picked from commit 741fcc4abf)
2026-05-27 11:08:55 -07:00
Bhuvansh855 554be43643 fix(docs-infra): improve inline code layout
Remove inline-block layout behavior from inline code elements
to improve wrapping and spacing in multiline documentation
paragraphs.

(cherry picked from commit fdf0bf9a62)
2026-05-27 10:52:20 -07:00
aparziale 516db8512b docs: update CDK Overlay URL
Update CDK Overlay URL for strategy select.md and multiselect.md

Fixed #68914

(cherry picked from commit fcecf7016e)
2026-05-27 10:48:44 -07:00
Cheng-Hsuan Tsai c7be8990d5 docs: modernize Aria guides
(cherry picked from commit cf2e6ec16d)
2026-05-27 10:45:54 -07:00
Alan Agius a97d5ec22d build: update minimum supported Node.js versions
Update the minimum supported Node.js versions for v22 and v24. Specifically, the minimum supported version for Node.js v22 is bumped to v22.22.3, and for v24 it is bumped to v24.15.0. This ensures compatibility with newer runtime versions and coordinates ranges across monorepo packages.

(cherry picked from commit 861d37e669)
2026-05-27 10:39:21 -07:00
Matthieu Riegler 6ab4b5c030 docs: align main and 22.0.x for aria examples 2026-05-27 10:35:20 -07:00
Kam 9966a809e1 docs: link to ng new reference from installation guide
The installation guide walks a developer through `ng new <project-name>` but provides no link to the `ng new` CLI reference, leaving every option the command supports undiscoverable from the install flow. Link `ng new` in the prose to the reference page so options are one click away.

(cherry picked from commit 04f31cce3e)
2026-05-20 14:09:39 -07:00
Douglas Parker 2dfe80fb6e docs: add WebMCP docs
Adds initial documentation of experimental WebMCP APIs.

(cherry picked from commit c7e08ebe59)
2026-05-20 14:06:20 -07:00
tjshiu 1f2b06cb5c docs: simplify multiselect examples by removing scroll resets
(cherry picked from commit 069b0153aa)
2026-05-20 14:04:17 -07:00
tjshiu 7c85697976 docs: simplify multiselect overlay bindings and transitions
Remove the delayed overlayOpen signals and synchronization effects across all 9 multiselect example variations. Bind cdkConnectedOverlayOpen directly to popupExpanded() and remove conditional closing classes to simplify code.

(cherry picked from commit 36500a70e3)
2026-05-20 14:04:17 -07:00
tjshiu 41d47f72b1 docs: modernize multiselect guide and standalone examples
Update the multiselect guide and all 27 interactive examples to utilize
the modern standalone, Signal-based Angular ARIA APIs.

* Modernize all examples (Standard, Material, Retro)
  to use standalone directives, animations, and focus suppression.
* Update the multiselect guide API tables and templates:
  - Document ngComboboxPopup, cdkConnectedOverlay, and disabled input.
  - Document ngListbox selectionMode, focusMode, tabIndex, and value signal.
  - Document activeDescendant active focus tracking with ngComboboxWidget.

(cherry picked from commit 8fa7311c6e)
2026-05-20 14:04:17 -07:00
tjshiu d6def8abad docs: modernize select guide and examples
(cherry picked from commit 62f8449453)
2026-05-20 13:56:52 -07:00
Kam 2109f49dc4 docs: fix grammar slips on pipes guide
Fixes subject-verb agreement in the overview opener and date/currency example, a singular pronoun for a plural antecedent under change detection, and an "a object" -> "an object" a/an slip.

(cherry picked from commit 41a772ec0b)
2026-05-20 13:51:56 -07:00
arturovt 83bfaf0e9e docs: document barrel file caveat for @defer lazy chunks
Users often enable @defer expecting a separate lazy chunk but don't get
one, with no obvious error to explain why. The root cause is almost
always a barrel file import — the bundler treats the whole barrel as a
single module and can't split out individual exports.

Add a section to the defer guide that starts from the symptom (no lazy
chunk), shows the barrel import pattern that causes it, and gives the
direct-import fix.

Closes #52554

(cherry picked from commit d985957f09)
2026-05-20 13:47:48 -07:00
arturovt a91315c9d7 docs: document content projection limitations
Add a Limitations section to the content projection guide covering two
common footguns that aren't obvious from the feature description alone.

First, projected content lives in the declaring component's view, not
the receiving component's. This means OnPush on the receiving component
doesn't prevent projected content from being checked on every parent
cycle, and projected content can't see the receiving component's
viewProviders.

Second, some library components (menus, tabs, lists) use ContentChildren
to wire up keyboard navigation and ARIA behavior and assume they own
their children directly. Projecting external content into them tends to
break that behavior silently.

Closes #49679

(cherry picked from commit de9e3d136e)
2026-05-20 13:31:51 -07:00
Angular Robot 51571e3652 docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-20 11:08:24 -07:00
Kam 83026cf158 fix(docs-infra): make absolute angular.dev hrefs relative in CLI option descriptions
CLI option descriptions are sourced from `@angular/cli` schema JSON
files, several of which contain absolute `https://angular.dev/...` URLs
in their `description` text. Those URLs render with the external-link
icon and push preview users out to production when viewed on
`next.angular.dev` or other dev previews. The path bypasses the existing
`link.mts` ban on absolute angular.dev links because option descriptions
go through `marked.parse` directly, without `AdevDocsRenderer`. Rewrite
the rendered hrefs whose values begin with `https://angular.dev/` (or
the `http:` variant) to root-relative paths so the resulting anchors
route through Angular's Router and resolve against the active
deployment. Subdomains such as `next.angular.dev/...` are intentionally
not rewritten because they refer to genuinely different deployments.

Closes #68795

(cherry picked from commit 745ee71c25)
2026-05-20 10:28:33 -07:00
Alan Agius 378b365af4 docs: update supported Angular versions table to reflect v19 end-of-life status
(cherry picked from commit b70515cada)
2026-05-20 10:10:02 -07:00
arturovt b0237cd472 docs: clarify viewProviders visibility with projected content
The providers vs. viewProviders section explained what happens but not
why — specifically, why projected content can still access a parent
component's viewProviders. Added an explanation that DI follows where
content was declared, not where it's rendered, so projecting a component
into a child's ng-content cuts off the child's viewProviders but leaves
the declaring component's viewProviders reachable.

Closes #49202

(cherry picked from commit 03161dc114)
2026-05-20 10:09:09 -07:00
aparziale 0e1ec0c3e3 docs: update HTTP testing setup guidance
Update testing documentation clarify HttpClient testing providers

Fixed #68792

(cherry picked from commit 8ebc900067)
2026-05-19 13:41:19 -07:00
g.turri 97ab8481e6 docs: Fix accepted Provider type in doc snippet
out of the box my IDE tells me there an error on

    const testProviders: Provider[] = [provideHttpClient(), provideHttpClientTesting()];

because `provideHttpClient()` returns an `EnvironmentProviders` so
I can't put it in a variable of type `Provider[]`

(cherry picked from commit 4e55ceafc9)
2026-05-19 13:19:39 -07:00
Angular Robot 0358469e81 docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-19 13:10:43 -07:00
june-by aed08ab7a9 docs(compiler): add typeCheckHostBindings option to angular compiler options
(cherry picked from commit c49661b57b)
2026-05-19 13:09:31 -07:00
SkyZeroZx 2e5623c92e docs: Adds lazy service loading for best practice performance
(cherry picked from commit d251c0bf87)
2026-05-19 13:08:57 -07:00
Matthieu Riegler efa2267394 docs(docs-infra): Show function args
With this change non-overloaded functions also show the params + return type in a dedicated block.

(cherry picked from commit 872853fbcb)
2026-05-18 13:22:34 -07:00
Kam caa953a30c docs: open external anchors in adev markdown in a new tab
Several raw HTML `<a>` anchors in adev markdown link to external
sites without `target="_blank"`, so they open in the same tab
instead of a new one like the rest of the site's external links.
Add `target="_blank"` to match.

(cherry picked from commit b7255f9d13)
2026-05-18 13:18:26 -07:00
Angular Robot c2160cd9ce docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-15 13:35:27 -07:00
cexbrayat 08d50171a7 docs: use when in signal forms rule examples
Update the Signal Forms guides to match df54e6a7b2, which introduced the consistent {when: ...} form for these rules.

(cherry picked from commit 9a7dedced6)
2026-05-15 12:16:55 -07:00
Jens Kuehlers 4dd983977f docs: move Angular 19 to unsupported versions
(cherry picked from commit 358d2e63fb)
2026-05-15 10:41:43 -07:00
Angular Robot 35234a98c8 build: update cross-repo angular dependencies to v22.0.0-rc.0
See associated pull request for more information.
2026-05-15 10:41:15 -07:00
Alan Agius 639a785376 docs: add version 22 to the browser support reference table
(cherry picked from commit dbf38537f2)
2026-05-13 15:33:59 -07:00
Ben Hong e9ff7cc33b docs: add clarification around plain object models
Co-authored-by: Matthieu Riegler <kyro38@gmail.com>
(cherry picked from commit 3584eeb491)
2026-05-13 11:24:40 -07:00
Angular Robot 7017557d4d build: update cross-repo angular dependencies
See associated pull request for more information.
2026-05-12 15:53:07 -07:00
Angular Robot 1080c764ea docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-12 15:51:17 -07:00
Angular Robot 3ca31a6bb0 docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-12 11:41:02 -07:00
Matthieu Riegler 2c0e45b9d5 build: update cross-repo angular dependencies (22.0.x)
This PR also replaces the implementation of the select component on ADEV due to the aria breaking changes
2026-05-12 10:58:03 -07:00
Angular Robot 8391cf0df7 docs: update cross-repo adev docs
Updated Angular adev cross repo docs files.
2026-05-11 12:45:51 -07:00
Matthieu Riegler 3593ceb407 docs: update guides to use @Service
In the cases where it was preferable to use `@Service` in place of `@Injectable`

(cherry picked from commit 52a848790f)
2026-05-11 12:38:27 -07:00
Ben Hong ff21eb9b39 docs: add new signal forms field metadata guide
Co-authored-by: Matthieu Riegler <kyro38@gmail.com>
(cherry picked from commit ef134ac367)
2026-05-11 12:05:33 -07:00
Kam 0601dc579a docs: add inject() example to "Forwarding injected dependencies"
Lead the section with the recommended `inject()` pattern (child
inherits the property, no `super` forwarding), and keep the existing
constructor DI example after as the alternative. Also fixes a typo
where the verb "class" should read "pass".

(cherry picked from commit 4ec076e13c)
2026-05-11 12:02:51 -07:00
Kam 2e9085c82a docs: recommend output() over EventEmitter in reactive forms guide
The "Save form data" step pointed at `EventEmitter` while the rest of
the guide uses modern APIs (e.g. `inject(FormBuilder)`). Swap to
`output()` and align the TODO in the profile-editor example.

(cherry picked from commit 0629e7e505)
2026-05-11 12:02:09 -07:00
SkyZeroZx 5a6e946708 docs: remove experimental warnings from resource/signal forms documentation
(cherry picked from commit 538d0a8e93)
2026-05-11 11:46:12 -07:00