feat(@angular/ssr): Add support for route matchers with fine-grained render mode control

[alan-agius4]

This commit adds support for custom route matchers in Angular SSR, allowing fine-grained control over the renderMode (Server, Client) for individual routes, including those defined with matchers.

Routes with custom matchers are not supported during prerendering and must explicitly define a renderMode of either server or client.

The following configuration demonstrates how to use glob patterns (including recursive **) to define server-side rendering (SSR) or client-side rendering (CSR) for specific parts of the 'product' route and its child routes.

// app.routes.ts
import { Routes } from '@angular/router';

export const routes: Routes = [
  {
    path: '',
    component: DummyComponent,
  },
  {
    path: 'product',
    component: DummyComponent,
    children: [
      {
        path: '',
        component: DummyComponent,
      },
      {
        path: 'list',
        component: DummyComponent,
      },
      {
        matcher: () => null, // Example custom matcher (always returns null)
        component: DummyComponent,
      },
    ],
  },
];

// app.routes.server.ts
import { RenderMode, ServerRoute } from '@angular/ssr';

export const serverRoutes: ServerRoute[] = [
  { path: '**', renderMode: RenderMode.Client },
  { path: 'product', renderMode: RenderMode.Prerender },
  { path: 'product/list', renderMode: RenderMode.Prerender },
  { path: 'product/**/overview/details', renderMode: RenderMode.Server },
];

Closes #29284

[dgp1130]

Seems reasonable to me, did we want to run this by Andrew Scott before merging or is this straightforward enough to be unobjectionable at this stage?

Also is there anything worth documenting on adev for custom route matchers and SSR?

[alan-agius4]

@dgp1130, I think this is simply enough. Re documentation, I will be working on that later next week

[angular-automatic-lock-bot]

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

_{This action has been performed automatically by a bot.}