@@ -10,6 +10,8 @@ import { EnvironmentProviders, InjectionToken, makeEnvironmentProviders } from '
10
10
11
11
/**
12
12
* Different rendering modes for server routes.
13
+ * @see {@link provideServerRoutesConfig }
14
+ * @see {@link ServerRoute }
13
15
* @developerPreview
14
16
*/
15
17
export enum RenderMode {
@@ -29,7 +31,7 @@ export enum RenderMode {
29
31
/**
30
32
* Defines the fallback strategies for Static Site Generation (SSG) routes when a pre-rendered path is not available.
31
33
* This is particularly relevant for routes with parameterized URLs where some paths might not be pre-rendered at build time.
32
- *
34
+ * @see { @link ServerRoutePrerenderWithParams }
33
35
* @developerPreview
34
36
*/
35
37
export enum PrerenderFallback {
@@ -68,6 +70,7 @@ export interface ServerRouteCommon {
68
70
69
71
/**
70
72
* A server route that uses AppShell rendering mode.
73
+ * @see {@link RenderMode }
71
74
*/
72
75
export interface ServerRouteAppShell extends Omit < ServerRouteCommon , 'headers' | 'status' > {
73
76
/** Specifies that the route uses AppShell rendering mode. */
@@ -76,6 +79,7 @@ export interface ServerRouteAppShell extends Omit<ServerRouteCommon, 'headers' |
76
79
77
80
/**
78
81
* A server route that uses Client-Side Rendering (CSR) mode.
82
+ * @see {@link RenderMode }
79
83
*/
80
84
export interface ServerRouteClient extends ServerRouteCommon {
81
85
/** Specifies that the route uses Client-Side Rendering (CSR) mode. */
@@ -84,6 +88,7 @@ export interface ServerRouteClient extends ServerRouteCommon {
84
88
85
89
/**
86
90
* A server route that uses Static Site Generation (SSG) mode.
91
+ * @see {@link RenderMode }
87
92
*/
88
93
export interface ServerRoutePrerender extends Omit < ServerRouteCommon , 'status' > {
89
94
/** Specifies that the route uses Static Site Generation (SSG) mode. */
@@ -95,6 +100,9 @@ export interface ServerRoutePrerender extends Omit<ServerRouteCommon, 'status'>
95
100
96
101
/**
97
102
* A server route configuration that uses Static Site Generation (SSG) mode, including support for routes with parameters.
103
+ * @see {@link RenderMode }
104
+ * @see {@link ServerRoutePrerender }
105
+ * @see {@link PrerenderFallback }
98
106
*/
99
107
export interface ServerRoutePrerenderWithParams extends Omit < ServerRoutePrerender , 'fallback' > {
100
108
/**
@@ -138,6 +146,7 @@ export interface ServerRoutePrerenderWithParams extends Omit<ServerRoutePrerende
138
146
139
147
/**
140
148
* A server route that uses Server-Side Rendering (SSR) mode.
149
+ * @see {@link RenderMode }
141
150
*/
142
151
export interface ServerRouteServer extends ServerRouteCommon {
143
152
/** Specifies that the route uses Server-Side Rendering (SSR) mode. */
@@ -146,6 +155,7 @@ export interface ServerRouteServer extends ServerRouteCommon {
146
155
147
156
/**
148
157
* Server route configuration.
158
+ * @see {@link provideServerRoutesConfig }
149
159
* @developerPreview
150
160
*/
151
161
export type ServerRoute =
@@ -166,6 +176,7 @@ export const SERVER_ROUTES_CONFIG = new InjectionToken<ServerRoute[]>('SERVER_RO
166
176
*
167
177
* @param routes - An array of server routes to be provided.
168
178
* @returns An `EnvironmentProviders` object that contains the server routes configuration.
179
+ * @see {@link ServerRoute }
169
180
* @developerPreview
170
181
*/
171
182
export function provideServerRoutesConfig ( routes : ServerRoute [ ] ) : EnvironmentProviders {
0 commit comments