import { Constrain, LooseAsyncReturnType, LooseReturnType, ValidateSerializable } from '@tanstack/router-core'; import { ComponentProps, ComponentType } from 'react'; export interface ServerComponentStream { createReplayStream: () => ReadableStream; } export declare const SERVER_COMPONENT_STREAM: unique symbol; export declare const SERVER_COMPONENT_CSS_HREFS: unique symbol; export declare const SERVER_COMPONENT_JS_PRELOADS: unique symbol; export declare const RSC_PROXY_PATH: unique symbol; export declare const RSC_PROXY_GET_TREE: unique symbol; export declare const RENDERABLE_RSC: unique symbol; export declare const RSC_SLOT_USAGES: unique symbol; export declare const RSC_SLOT_USAGES_STREAM: unique symbol; export type RscSlotUsageEvent = { slot: string; args?: Array; }; /** * Type guard to check if a value is a ServerComponent (Proxy with attached stream). * The value can be either an object (proxy target) or a function (stub for server functions). */ export declare function isServerComponent(value: unknown): value is AnyCompositeComponent; export type ValidateCompositeComponent = Constrain) => ValidateCompositeComponentReturnType>; export type ValidateCompositeComponentProps = unknown extends TComp ? TComp : ValidateCompositeComponentPropsObject>; export type ValidateCompositeComponentPropsObject = unknown extends TProps ? TProps : { [TKey in keyof TProps]: ValidateCompositeComponentProp; }; export type CompositeComponentProps = TComp extends (props: infer TProps) => any ? TProps : unknown; export type ValidateCompositeComponentProp = TProp extends (...args: Array) => any ? (...args: ValidateReactSerializable>) => React.ReactNode : TProp extends ComponentType ? ComponentType>> : TProp extends React.ReactNode ? TProp : React.ReactNode; export type ValidateReactSerializable = ValidateSerializable; export type ReactSerializable = number | string | bigint | boolean | null | undefined | React.ReactNode; export type ValidateCompositeComponentReturnType = unknown extends TComp ? React.ReactNode : ValidateCompositeComponentResult>; export type ValidateCompositeComponentResult = ValidateServerComponentResult; export type ValidateServerComponentResult = TNode extends Promise ? ValidateCompositeComponentPromiseResult : TNode extends React.ReactNode ? TNode : TNode extends (...args: Array) => any ? React.ReactNode : TNode extends object ? ValidateCompositeComponentObjectResult : React.ReactNode; export type ValidateCompositeComponentPromiseResult = TPromise extends Promise ? Promise> : never; export type ValidateCompositeComponentObjectResult = { [TKey in keyof TObject]: ValidateCompositeComponentResult; }; export type CompositeComponentResult = CompositeComponentBuilder>; export type CompositeComponentBuilder = TReturn extends React.ReactNode ? CompositeComponent : { [TKey in keyof TReturn]: CompositeComponentBuilder; }; export interface CompositeComponent { '~types': { props: CompositeComponentProps; return: TReturn; }; [SERVER_COMPONENT_STREAM]?: ServerComponentStream; /** * Root decoded tree getter. */ [RSC_PROXY_GET_TREE]?: () => unknown; /** * Nested selection path (eg ['content','Stats']). * Used by to render a sub-tree. */ [RSC_PROXY_PATH]?: Array; /** * CSS hrefs collected from the RSC stream. * Can be used for preloading in or emitting 103 Early Hints. */ [SERVER_COMPONENT_CSS_HREFS]?: ReadonlySet; /** * JS hrefs collected from the RSC stream. * Emitted as modulepreload links only if the decoded tree is rendered in SSR. */ [SERVER_COMPONENT_JS_PRELOADS]?: ReadonlySet; /** * Dev-only: async stream of slot usage preview events. * Used by devtools to show slot names and previewed call args without * buffering/draining the Flight stream. */ [RSC_SLOT_USAGES_STREAM]?: ReadableStream; } export type ValidateRenderableServerComponent = ValidateServerComponentResult; export type RenderableServerComponentBuilder = T extends React.ReactNode ? RenderableServerComponent : { [TKey in keyof T]: RenderableServerComponentBuilder; }; export type RenderableServerComponent = TNode & RenderableServerComponentAttributes; export interface RenderableServerComponentAttributes { '~types': { node: TNode; }; [SERVER_COMPONENT_STREAM]: ServerComponentStream; [RENDERABLE_RSC]: true; } declare module '@tanstack/router-core' { interface SerializableExtensions { CompositeComponent: AnyCompositeComponent; RenderableServerComponent: AnyRenderableServerComponent; } } export type AnyCompositeComponent = CompositeComponent; export type AnyRenderableServerComponent = RenderableServerComponentAttributes;