@analogjs/router 3.0.0-alpha.2 → 3.0.0-alpha.21

package/types/server/actions/src/define-action.d.ts

@@ -0,0 +1,54 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { H3Event, H3EventContext } from 'nitro/h3';
+import type { $Fetch } from 'nitro/types';
+type NodeContext = NonNullable<H3Event['node']>;
+type OptionalSchema = StandardSchemaV1 | undefined;
+type InferSchema<TSchema extends OptionalSchema, TFallback> = TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TSchema> : TFallback;
+export interface DefineActionContext<TSchema extends OptionalSchema = undefined, TParamsSchema extends OptionalSchema = undefined> {
+    data: InferSchema<TSchema, Record<string, unknown>>;
+    params: InferSchema<TParamsSchema, H3EventContext['params']>;
+    req: NodeContext['req'];
+    res: NonNullable<NodeContext['res']>;
+    fetch: $Fetch;
+    event: H3Event;
+}
+export interface DefineActionOptions<TSchema extends OptionalSchema = undefined, TParamsSchema extends OptionalSchema = undefined> {
+    schema?: TSchema;
+    params?: TParamsSchema;
+    handler: (context: DefineActionContext<TSchema, TParamsSchema>) => Promise<Response> | Response;
+}
+/**
+ * Creates a server action handler with Standard Schema input validation.
+ *
+ * Parses the request body (JSON or FormData) and validates it against the
+ * provided schema before invoking the handler. On validation failure,
+ * returns `fail(422, issues)` with `StandardSchemaV1.Issue[]`.
+ * Repeated form fields are preserved as arrays instead of being collapsed
+ * to the last value.
+ *
+ * @example
+ * ```typescript
+ * import { defineAction, json } from '@analogjs/router/server/actions';
+ * import * as v from 'valibot';
+ *
+ * const Schema = v.object({
+ *   email: v.pipe(v.string(), v.email()),
+ * });
+ *
+ * export const action = defineAction({
+ *   schema: Schema,
+ *   handler: async ({ data }) => {
+ *     // data is typed as { email: string }
+ *     return json({ ok: true });
+ *   },
+ * });
+ * ```
+ */
+export declare function defineAction<TSchema extends OptionalSchema = undefined, TParamsSchema extends OptionalSchema = undefined>(options: DefineActionOptions<TSchema, TParamsSchema>): (ctx: {
+    params: H3EventContext["params"];
+    req: NodeContext["req"];
+    res: NonNullable<NodeContext["res"]>;
+    fetch: $Fetch;
+    event: H3Event;
+}) => Promise<Response>;
+export {};

package/types/server/actions/src/define-api-route.d.ts

@@ -0,0 +1,57 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { H3Event } from 'nitro/h3';
+export type DefineApiRouteResult = Response | unknown;
+type OptionalSchema = StandardSchemaV1 | undefined;
+type InferSchema<TSchema extends OptionalSchema, TFallback = unknown> = TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TSchema> : TFallback;
+type ResolveDataSchema<TInput extends OptionalSchema, TQuery extends OptionalSchema, TBody extends OptionalSchema> = TInput extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TInput> : TQuery extends StandardSchemaV1 ? TBody extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TQuery> | StandardSchemaV1.InferOutput<TBody> : StandardSchemaV1.InferOutput<TQuery> : TBody extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TBody> : unknown;
+export interface DefineApiRouteContext<TInput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined> {
+    data: ResolveDataSchema<TInput, TQuery, TBody>;
+    query: InferSchema<TQuery, undefined>;
+    body: InferSchema<TBody, undefined>;
+    params: InferSchema<TParams, H3Event['context']['params']>;
+    event: H3Event;
+}
+export interface DefineApiRouteOptions<TInput extends StandardSchemaV1 | undefined = undefined, TOutput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined, TResult extends DefineApiRouteResult = DefineApiRouteResult> {
+    input?: TInput;
+    query?: TQuery;
+    body?: TBody;
+    params?: TParams;
+    output?: TOutput;
+    handler: (context: DefineApiRouteContext<TInput, TQuery, TBody, TParams>) => Promise<TResult> | TResult;
+}
+/**
+ * Creates an h3-compatible event handler with Standard Schema validation.
+ *
+ * - `input` schema validates the request body (POST/PUT/PATCH) or query
+ *   params (GET). Returns 422 with `StandardSchemaV1.Issue[]` on failure.
+ * - `output` schema validates the response in development only (stripped
+ *   in production for zero overhead). Logs a warning on mismatch.
+ * - Plain return values are serialized with `json(...)`; raw `Response`
+ *   objects are returned unchanged.
+ *
+ * @example
+ * ```typescript
+ * import { defineApiRoute } from '@analogjs/router/server/actions';
+ * import * as v from 'valibot';
+ *
+ * const Input = v.object({
+ *   name: v.pipe(v.string(), v.minLength(1)),
+ *   email: v.pipe(v.string(), v.email()),
+ * });
+ * const Output = v.object({
+ *   id: v.string(),
+ *   name: v.string(),
+ * });
+ *
+ * export default defineApiRoute({
+ *   input: Input,
+ *   output: Output,
+ *   handler: async ({ data }) => {
+ *     const user = await db.users.create(data);
+ *     return user;
+ *   },
+ * });
+ * ```
+ */
+export declare function defineApiRoute<TInput extends StandardSchemaV1 | undefined = undefined, TOutput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined, TResult extends DefineApiRouteResult = DefineApiRouteResult>(options: DefineApiRouteOptions<TInput, TOutput, TQuery, TBody, TParams, TResult>): (event: H3Event) => Promise<Response>;
+export {};

package/types/server/actions/src/define-page-load.d.ts

@@ -0,0 +1,55 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { H3Event, H3EventContext } from 'nitro/h3';
+import type { $Fetch } from 'nitro/types';
+type NodeContext = NonNullable<H3Event['node']>;
+type OptionalSchema = StandardSchemaV1 | undefined;
+type InferSchema<TSchema extends OptionalSchema, TFallback> = TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TSchema> : TFallback;
+export interface PageLoadContext<TParamsSchema extends OptionalSchema = undefined, TQuerySchema extends OptionalSchema = undefined> {
+    params: InferSchema<TParamsSchema, H3EventContext['params']>;
+    query: InferSchema<TQuerySchema, Record<string, string | string[] | undefined>>;
+    req: NodeContext['req'];
+    res: NonNullable<NodeContext['res']>;
+    fetch: $Fetch;
+    event: H3Event;
+}
+export interface DefinePageLoadOptions<TParamsSchema extends OptionalSchema = undefined, TQuerySchema extends OptionalSchema = undefined, TResult = unknown> {
+    params?: TParamsSchema;
+    query?: TQuerySchema;
+    handler: (context: PageLoadContext<TParamsSchema, TQuerySchema>) => Promise<TResult> | TResult;
+}
+/**
+ * Creates a typed page server load function with optional
+ * Standard Schema validation for route params and query.
+ *
+ * Follows the same validation patterns as `defineAction` and
+ * `defineServerRoute`: validates before invoking the handler,
+ * returns `fail(422, issues)` on validation failure.
+ *
+ * @example
+ * ```typescript
+ * // src/app/pages/users/[id].server.ts
+ * import { definePageLoad } from '@analogjs/router/server/actions';
+ * import * as v from 'valibot';
+ *
+ * export const routeParamsSchema = v.object({
+ *   id: v.pipe(v.string(), v.regex(/^\d+$/)),
+ * });
+ *
+ * export const load = definePageLoad({
+ *   params: routeParamsSchema,
+ *   handler: async ({ params, fetch }) => {
+ *     // params.id is typed as string (validated)
+ *     const user = await fetch(`/api/users/${params.id}`);
+ *     return user;
+ *   },
+ * });
+ * ```
+ */
+export declare function definePageLoad<TParamsSchema extends OptionalSchema = undefined, TQuerySchema extends OptionalSchema = undefined, TResult = unknown>(options: DefinePageLoadOptions<TParamsSchema, TQuerySchema, TResult>): (ctx: {
+    params: H3EventContext['params'];
+    req: NodeContext['req'];
+    res: NonNullable<NodeContext['res']>;
+    fetch: $Fetch;
+    event: H3Event;
+}) => Promise<TResult | Response>;
+export {};

package/types/server/actions/src/define-server-route.d.ts

@@ -0,0 +1,68 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { H3Event } from 'nitro/h3';
+export type DefineServerRouteResult = Response | unknown;
+export interface ServerRouteHandler<TQuery = unknown, TBody = unknown, TResult = unknown> {
+    (event: H3Event): Promise<Response>;
+    readonly _types: {
+        readonly query: TQuery;
+        readonly body: TBody;
+        readonly result: TResult;
+    };
+}
+export type InferRouteQuery<T> = T extends ServerRouteHandler<infer Q, any, any> ? Q : never;
+export type InferRouteBody<T> = T extends ServerRouteHandler<any, infer B, any> ? B : never;
+export type InferRouteResult<T> = T extends ServerRouteHandler<any, any, infer R> ? Exclude<R, Response> : never;
+type OptionalSchema = StandardSchemaV1 | undefined;
+type InferSchema<TSchema extends OptionalSchema, TFallback = unknown> = TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TSchema> : TFallback;
+type ResolveDataSchema<TInput extends OptionalSchema, TQuery extends OptionalSchema, TBody extends OptionalSchema> = TInput extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TInput> : TQuery extends StandardSchemaV1 ? TBody extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TQuery> | StandardSchemaV1.InferOutput<TBody> : StandardSchemaV1.InferOutput<TQuery> : TBody extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TBody> : unknown;
+export interface DefineServerRouteContext<TInput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined> {
+    data: ResolveDataSchema<TInput, TQuery, TBody>;
+    query: InferSchema<TQuery, undefined>;
+    body: InferSchema<TBody, undefined>;
+    params: InferSchema<TParams, H3Event['context']['params']>;
+    event: H3Event;
+}
+export interface DefineServerRouteOptions<TInput extends StandardSchemaV1 | undefined = undefined, TOutput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined, TResult extends DefineServerRouteResult = DefineServerRouteResult> {
+    input?: TInput;
+    query?: TQuery;
+    body?: TBody;
+    params?: TParams;
+    output?: TOutput;
+    handler: (context: DefineServerRouteContext<TInput, TQuery, TBody, TParams>) => Promise<TResult> | TResult;
+}
+/**
+ * Creates an h3-compatible event handler with Standard Schema validation.
+ *
+ * - `input` schema validates the request body (POST/PUT/PATCH) or query
+ *   params (GET). Returns 422 with `StandardSchemaV1.Issue[]` on failure.
+ * - `output` schema validates the response in development only (stripped
+ *   in production for zero overhead). Logs a warning on mismatch.
+ * - Plain return values are serialized with `json(...)`; raw `Response`
+ *   objects are returned unchanged.
+ *
+ * @example
+ * ```typescript
+ * import { defineServerRoute } from '@analogjs/router/server/actions';
+ * import * as v from 'valibot';
+ *
+ * const Input = v.object({
+ *   name: v.pipe(v.string(), v.minLength(1)),
+ *   email: v.pipe(v.string(), v.email()),
+ * });
+ * const Output = v.object({
+ *   id: v.string(),
+ *   name: v.string(),
+ * });
+ *
+ * export default defineServerRoute({
+ *   input: Input,
+ *   output: Output,
+ *   handler: async ({ data }) => {
+ *     const user = await db.users.create(data);
+ *     return user;
+ *   },
+ * });
+ * ```
+ */
+export declare function defineServerRoute<TInput extends StandardSchemaV1 | undefined = undefined, TOutput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined, TResult extends DefineServerRouteResult = DefineServerRouteResult>(options: DefineServerRouteOptions<TInput, TOutput, TQuery, TBody, TParams, TResult>): ServerRouteHandler<InferSchema<TQuery, undefined>, InferSchema<TBody, undefined>, TResult>;
+export {};

package/types/server/actions/src/index.d.ts

@@ -0,0 +1,9 @@
+export type { PageServerAction } from './actions';
+export { json, redirect, fail } from './actions';
+export { defineAction } from './define-action';
+export type { DefineActionContext, DefineActionOptions } from './define-action';
+export { defineServerRoute } from './define-server-route';
+export type { DefineServerRouteContext, DefineServerRouteOptions, DefineServerRouteResult, ServerRouteHandler, InferRouteQuery, InferRouteBody, InferRouteResult, } from './define-server-route';
+export { definePageLoad } from './define-page-load';
+export type { PageLoadContext, DefinePageLoadOptions, } from './define-page-load';
+export { validateWithSchema } from './validate';

package/types/server/actions/src/parse-request-data.d.ts

@@ -0,0 +1,9 @@
+type RequestEntryValue = string | File;
+type ParsedRequestValue = RequestEntryValue | RequestEntryValue[];
+export declare function parseSearchParams(searchParams: URLSearchParams): Record<string, ParsedRequestValue>;
+export declare function parseFormData(formData: FormData): Record<string, ParsedRequestValue>;
+export declare function parseRequestData(event: {
+    method: string;
+    headers: Headers;
+}): Promise<unknown>;
+export {};

package/types/server/actions/src/validate.d.ts

@@ -0,0 +1,8 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+/**
+ * Validates unknown input against a Standard Schema.
+ *
+ * Handles both sync and async `validate` implementations — the Standard
+ * Schema spec allows either return shape.
+ */
+export declare function validateWithSchema<T extends StandardSchemaV1>(schema: T, data: unknown): Promise<StandardSchemaV1.Result<StandardSchemaV1.InferOutput<T>>>;

package/types/server/src/index.d.ts

@@ -0,0 +1,4 @@
+export { provideServerContext } from './provide-server-context';
+export { injectStaticProps, injectStaticOutputs } from './tokens';
+export { serverComponentRequest, renderServerComponent, } from './server-component-render';
+export { render } from './render';

package/types/server/src/provide-server-context.d.ts

@@ -0,0 +1,11 @@
+import { StaticProvider } from '@angular/core';
+import { ServerInternalFetch, ServerRequest, ServerResponse } from '@analogjs/router/tokens';
+export declare function provideServerContext({ req, res, fetch, }: {
+    req: ServerRequest;
+    res: ServerResponse;
+    fetch?: ServerInternalFetch;
+}): StaticProvider[];
+export declare function getBaseUrl(req: ServerRequest): string;
+export declare function getRequestProtocol(req: ServerRequest, opts?: {
+    xForwardedProto?: boolean;
+}): string;

package/types/server/src/render.d.ts

@@ -0,0 +1,12 @@
+import { ApplicationConfig, Provider, Type } from '@angular/core';
+import type { ServerContext } from '@analogjs/router/tokens';
+/**
+ * Returns a function that accepts the navigation URL,
+ * the root HTML, and server context.
+ *
+ * @param rootComponent
+ * @param config
+ * @param platformProviders
+ * @returns Promise<string | Reponse>
+ */
+export declare function render(rootComponent: Type<unknown>, config: ApplicationConfig, platformProviders?: Provider[]): (url: string, document: string, serverContext: ServerContext) => Promise<string | Response>;

package/types/server/src/server-component-render.d.ts

@@ -0,0 +1,4 @@
+import { ApplicationConfig } from '@angular/core';
+import { ServerContext } from '@analogjs/router/tokens';
+export declare function serverComponentRequest(serverContext: ServerContext): string | undefined;
+export declare function renderServerComponent(url: string, serverContext: ServerContext, config?: ApplicationConfig): Promise<Response>;

package/types/server/src/tokens.d.ts

@@ -0,0 +1,7 @@
+import { InjectionToken, Provider } from '@angular/core';
+export declare const STATIC_PROPS: InjectionToken<Record<string, any>>;
+export declare function provideStaticProps<T = Record<string, any>>(props: T): Provider;
+export declare function injectStaticProps(): Record<string, any>;
+export declare function injectStaticOutputs<T>(): {
+    set(data: T): void;
+};

package/types/src/index.d.ts

@@ -0,0 +1,27 @@
+export type { RouteExport } from './lib/models';
+export type { Files } from './lib/route-files';
+export { routes, createRoutes } from './lib/routes';
+export { defineRouteMeta, injectActivatedRoute, injectRouter, } from './lib/define-route';
+export type { RouteMeta } from './lib/models';
+export { provideFileRouter, withExtraRoutes } from './lib/provide-file-router';
+export type { MetaTag } from './lib/meta-tags';
+export type { PageServerLoad, LoadResult, LoadDataResult, } from './lib/route-types';
+export { injectLoad, injectLoadData } from './lib/inject-load';
+export { getLoadResolver } from './lib/get-load-resolver';
+export { requestContextInterceptor } from './lib/request-context';
+export { injectRouteEndpointURL } from './lib/inject-route-endpoint-url';
+export { FormAction } from './lib/form-action.directive';
+export type { FormActionState } from './lib/form-action.directive';
+export { injectDebugRoutes } from './lib/debug/routes';
+export { withDebugRoutes } from './lib/debug';
+export { ServerOnly } from './lib/server.component';
+export type { AnalogJsonLdDocument } from './lib/json-ld';
+export { issuesToFieldErrors, issuesToFormErrors, issuePathToFieldName, } from './lib/validation-errors';
+export type { ValidationFieldErrors } from './lib/validation-errors';
+export type { AnalogRouteTable, AnalogRoutePath, RoutePathOptions, RoutePathArgs, RoutePathOptionsBase, RouteParamsOutput, RouteQueryOutput, RouteLinkResult, } from './lib/route-path';
+export { routePath } from './lib/route-path';
+export { injectNavigate } from './lib/inject-navigate';
+export { withTypedRouter, withRouteContext, withLoaderCaching, EXPERIMENTAL_TYPED_ROUTER, EXPERIMENTAL_ROUTE_CONTEXT, EXPERIMENTAL_LOADER_CACHE, } from './lib/experimental';
+export type { TypedRouterOptions, LoaderCacheOptions, } from './lib/experimental';
+export { injectParams, injectQuery } from './lib/inject-typed-params';
+export { injectRouteContext } from './lib/inject-route-context';

package/types/src/lib/cache-key.d.ts

@@ -0,0 +1,3 @@
+import { HttpRequest } from '@angular/common/http';
+import { StateKey } from '@angular/core';
+export declare function makeCacheKey(request: HttpRequest<unknown>, mappedRequestUrl: string): StateKey<unknown>;

package/types/src/lib/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const ENDPOINT_EXTENSION = ".server.ts";
+export declare const APP_DIR = "src/app";

package/types/src/lib/cookie-interceptor.d.ts

@@ -0,0 +1,4 @@
+import { HttpHandlerFn, HttpRequest, HttpEvent } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { ServerRequest } from '@analogjs/router/tokens';
+export declare function cookieInterceptor(req: HttpRequest<unknown>, next: HttpHandlerFn, location?: object, serverRequest?: ServerRequest | null): Observable<HttpEvent<unknown>>;

package/types/src/lib/debug/debug.page.d.ts

@@ -0,0 +1,20 @@
+import { OnInit } from '@angular/core';
+import { DebugRoute } from './routes';
+import * as i0 from "@angular/core";
+type CollectedRoute = {
+    path: string;
+    filename: string;
+    file: string;
+    isLayout: boolean;
+    source: 'page' | 'content';
+};
+export default class DebugRoutesComponent implements OnInit {
+    collectedRoutes: CollectedRoute[];
+    private debugRoutes;
+    private extraSources;
+    ngOnInit(): void;
+    traverseRoutes(routes: DebugRoute[], parent?: string, source?: 'page' | 'content'): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DebugRoutesComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DebugRoutesComponent, "analogjs-debug-routes-page", never, {}, {}, never, never, true, never>;
+}
+export {};

package/types/src/lib/debug/index.d.ts

@@ -0,0 +1,10 @@
+import { EnvironmentProviders, Provider } from '@angular/core';
+/**
+ * Provides routes that provide additional
+ * pages for displaying and debugging
+ * routes.
+ */
+export declare function withDebugRoutes(): {
+    ɵkind: number;
+    ɵproviders: (Provider | EnvironmentProviders)[];
+};

package/types/src/lib/debug/routes.d.ts

@@ -0,0 +1,10 @@
+import { InjectionToken } from '@angular/core';
+import { Route } from '@angular/router';
+export declare const DEBUG_ROUTES: InjectionToken<(Route & DebugRoute)[]>;
+export type DebugRoute = {
+    path: string;
+    filename: string;
+    isLayout: boolean;
+    children?: DebugRoute[];
+};
+export declare function injectDebugRoutes(): (Route & DebugRoute)[];

package/types/src/lib/define-route.d.ts

@@ -0,0 +1,51 @@
+import { Route as NgRoute, Router } from '@angular/router';
+import { ActivatedRoute } from '@angular/router';
+import { AnalogJsonLdDocument } from './json-ld';
+import { MetaTag } from './meta-tags';
+type RouteOmitted = 'component' | 'loadComponent' | 'loadChildren' | 'path' | 'pathMatch';
+type RestrictedRoute = Omit<NgRoute, RouteOmitted> & {
+    meta?: MetaTag[];
+    jsonLd?: AnalogJsonLdDocument;
+};
+/**
+ * @deprecated Use `RouteMeta` type instead.
+ * For more info see: https://github.com/analogjs/analog/issues/223
+ *
+ * Defines additional route config metadata. This
+ * object is merged into the route config with
+ * the predefined file-based route.
+ *
+ * @usageNotes
+ *
+ * ```
+ * import { Component } from '@angular/core';
+ * import { defineRouteMeta } from '@analogjs/router';
+ *
+ *  export const routeMeta = defineRouteMeta({
+ *    title: 'Welcome'
+ *  });
+ *
+ * @Component({
+ *   template: `Home`,
+ *   standalone: true,
+ * })
+ * export default class HomeComponent {}
+ * ```
+ *
+ * @param route
+ * @returns
+ */
+export declare const defineRouteMeta: (route: RestrictedRoute) => RestrictedRoute;
+/**
+ * Returns the instance of Angular Router
+ *
+ * @returns The router
+ */
+export declare const injectRouter: () => Router;
+/**
+ * Returns the instance of the Activate Route for the component
+ *
+ * @returns The activated route
+ */
+export declare const injectActivatedRoute: () => ActivatedRoute;
+export {};

package/types/src/lib/endpoints.d.ts

@@ -0,0 +1,5 @@
+export declare const ANALOG_META_KEY: unique symbol;
+/**
+ * This variable reference is replaced with a glob of all route endpoints.
+ */
+export declare const ANALOG_PAGE_ENDPOINTS: Record<string, () => Promise<unknown>>;

package/types/src/lib/experimental.d.ts

@@ -0,0 +1,140 @@
+import { InjectionToken } from '@angular/core';
+import type { RouterFeatures } from '@angular/router';
+/**
+ * Configuration for experimental typed router features.
+ *
+ * Inspired by TanStack Router's type-safe navigation system where
+ * routes are registered globally and all navigation/hooks are typed
+ * against the route tree.
+ *
+ * @experimental
+ */
+export interface TypedRouterOptions {
+    /**
+     * When true, logs warnings in development when navigating to
+     * routes with params that don't match the generated route table.
+     *
+     * Similar to TanStack Router's strict mode where `useParams()`
+     * without a `from` constraint returns a union of all possible params.
+     *
+     * @default false
+     */
+    strictRouteParams?: boolean;
+}
+/**
+ * Configuration for experimental loader caching.
+ *
+ * Inspired by TanStack Router's built-in data caching where route
+ * loaders automatically cache results and support stale-while-revalidate.
+ *
+ * @experimental
+ */
+export interface LoaderCacheOptions {
+    /**
+     * Time in milliseconds before loader data is considered stale.
+     * While data is fresh, navigating back to the route uses cached
+     * data without re-invoking the server load function.
+     *
+     * Mirrors TanStack Router's `defaultStaleTime` option on `createRouter()`.
+     *
+     * @default 0 (always re-fetch)
+     */
+    defaultStaleTime?: number;
+    /**
+     * Time in milliseconds to retain unused loader data in cache
+     * after leaving a route. After this period the cached entry is
+     * garbage-collected.
+     *
+     * Mirrors TanStack Router's `defaultGcTime` (default 30 min).
+     *
+     * @default 300_000 (5 minutes)
+     */
+    defaultGcTime?: number;
+    /**
+     * Delay in milliseconds before showing a pending/loading indicator
+     * during route transitions. Prevents flash-of-loading-state for
+     * fast navigations.
+     *
+     * Mirrors TanStack Router's `defaultPendingMs`.
+     *
+     * @default 0 (show immediately)
+     */
+    defaultPendingMs?: number;
+}
+/** @experimental */
+export declare const EXPERIMENTAL_TYPED_ROUTER: InjectionToken<TypedRouterOptions>;
+/** @experimental */
+export declare const EXPERIMENTAL_ROUTE_CONTEXT: InjectionToken<Record<string, unknown>>;
+/** @experimental */
+export declare const EXPERIMENTAL_LOADER_CACHE: InjectionToken<LoaderCacheOptions>;
+/**
+ * Enables experimental typed router features.
+ *
+ * When active, `routePath()`, `injectNavigate()`, `injectParams()`,
+ * and `injectQuery()` will enforce route table constraints and
+ * optionally log warnings in strict mode.
+ *
+ * Inspired by TanStack Router's `Register` interface and strict type
+ * checking across the entire navigation surface.
+ *
+ * @example
+ * ```ts
+ * provideFileRouter(
+ *   withTypedRouter({ strictRouteParams: true }),
+ * )
+ * ```
+ *
+ * @experimental
+ */
+export declare function withTypedRouter(options?: TypedRouterOptions): RouterFeatures;
+/**
+ * Provides root-level route context available to all route loaders
+ * and components via `injectRouteContext()`.
+ *
+ * Inspired by TanStack Router's `createRootRouteWithContext<T>()` where
+ * a typed context object is required at router creation and automatically
+ * available in every route's `beforeLoad` and `loader`.
+ *
+ * In Angular terms, this creates a DI token that server-side load
+ * functions and components can inject to access shared services
+ * without importing them individually.
+ *
+ * @example
+ * ```ts
+ * // app.config.ts
+ * provideFileRouter(
+ *   withRouteContext({
+ *     auth: inject(AuthService),
+ *     db: inject(DatabaseService),
+ *   }),
+ * )
+ *
+ * // In a component
+ * const ctx = injectRouteContext<{ auth: AuthService; db: DatabaseService }>();
+ * ```
+ *
+ * @experimental
+ */
+export declare function withRouteContext<T extends Record<string, unknown>>(context: T): RouterFeatures;
+/**
+ * Configures experimental loader caching behavior for server-loaded
+ * route data.
+ *
+ * Inspired by TanStack Router's built-in cache where `createRouter()`
+ * accepts `defaultStaleTime` and `defaultGcTime` to control when
+ * loaders re-execute and when cached data is discarded.
+ *
+ * @example
+ * ```ts
+ * provideFileRouter(
+ *   withLoaderCaching({
+ *     defaultStaleTime: 30_000,  // 30s before re-fetch
+ *     defaultGcTime: 300_000,    // 5min cache retention
+ *     defaultPendingMs: 200,     // 200ms loading delay
+ *   }),
+ * )
+ * ```
+ *
+ * @experimental
+ */
+export declare function withLoaderCaching(options?: LoaderCacheOptions): RouterFeatures;

package/types/src/lib/form-action.directive.d.ts

@@ -0,0 +1,25 @@
+import { type InputSignal, type OutputEmitterRef, type WritableSignal } from '@angular/core';
+import * as i0 from "@angular/core";
+export type FormActionState = 'submitting' | 'error' | 'redirect' | 'success' | 'navigate';
+export declare class FormAction {
+    action: InputSignal<string>;
+    onSuccess: OutputEmitterRef<unknown>;
+    onError: OutputEmitterRef<unknown>;
+    state: OutputEmitterRef<FormActionState>;
+    private router;
+    private route;
+    protected currentState: WritableSignal<FormActionState | 'idle'>;
+    /** Cached during construction (injection context) so inject() works. */
+    private _endpointUrl;
+    submitted($event: SubmitEvent): void;
+    private _handleGet;
+    private _handlePost;
+    private _getExplicitAction;
+    private _getGetPath;
+    private _getPostPath;
+    private _emitState;
+    private _navigateTo;
+    private _isJSON;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormAction, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<FormAction, "form[action],form[method]", never, { "action": { "alias": "action"; "required": false; "isSignal": true; }; }, { "onSuccess": "onSuccess"; "onError": "onError"; "state": "state"; }, never, never, true, never>;
+}

package/types/src/lib/get-load-resolver.d.ts

@@ -0,0 +1,8 @@
+import { ActivatedRouteSnapshot } from '@angular/router';
+/**
+ * Get server load resolver data for the route
+ *
+ * @param route Provides the route to get server load resolver
+ * @returns Returns server load resolver data for the route
+ */
+export declare function getLoadResolver<T>(route: ActivatedRouteSnapshot): Promise<T>;

package/types/src/lib/inject-load.d.ts

@@ -0,0 +1,9 @@
+import { Injector } from '@angular/core';
+import { Observable } from 'rxjs';
+import { LoadDataResult, PageServerLoad } from './route-types';
+export declare function injectLoad<T extends (pageServerLoad: PageServerLoad) => Promise<unknown>>(options?: {
+    injector?: Injector;
+}): Observable<Awaited<ReturnType<T>>>;
+export declare function injectLoadData<T extends (pageServerLoad: PageServerLoad) => Promise<unknown>>(options?: {
+    injector?: Injector;
+}): Observable<LoadDataResult<T>>;