@stone-js/use-react 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { HTMLMetaDescriptor, HeadContext as HeadContext$1, FunctionalEventHandler, Route, Router, DecoratorPageRouteDefinition, NavigateOptions } from '@stone-js/router';
+import { HeadContext as HeadContext$1, HTMLMetaDescriptor, FunctionalEventHandler, Route, Router, DecoratorPageRouteDefinition, NavigateOptions } from '@stone-js/router';
 import * as react from 'react';
-import { ReactNode, ElementType, FunctionComponent } from 'react';
+import { ReactNode, ElementType, FunctionComponent, AnchorHTMLAttributes, HTMLAttributes } from 'react';
 import { Config } from '@stone-js/config';
 import { BrowserEvent, BrowserResponse, BrowserContext, BrowserAdapterResponseBuilder } from '@stone-js/browser-adapter';
-import { IncomingHttpEvent, OutgoingHttpResponse, RedirectResponse, IncomingHttpEventOptions, OutgoingHttpResponseOptions, RedirectResponseOptions } from '@stone-js/http-core';
-import { IncomingBrowserEvent, OutgoingBrowserResponse, RedirectBrowserResponse, IncomingBrowserEventOptions, OutgoingBrowserResponseOptions, RedirectBrowserResponseOptions } from '@stone-js/browser-core';
-import { IContainer, Promiseable, Laziable, FunctionalErrorHandler, IBlueprint, FunctionalAdapterErrorHandler, OutgoingResponseOptions, HookName as HookName$1, LifecycleHookType, ErrorHandlerOptions, AdapterErrorHandlerOptions, AdapterContext, IAdapterErrorHandler, AdapterErrorContext, AdapterEventBuilderType, IEventHandler, IErrorHandler, ILogger, IServiceProvider, StoneBlueprint, AppConfig, ClassType, InitializationError, ErrorOptions, BlueprintContext, NextMiddleware, MetaMiddleware } from '@stone-js/core';
+import { IncomingHttpEvent, OutgoingHttpResponse, RedirectResponse, IncomingHttpEventOptions, RedirectResponseOptions, OutgoingHttpResponseOptions } from '@stone-js/http-core';
+import { IncomingBrowserEvent, IncomingBrowserEventOptions, OutgoingBrowserResponse, RedirectBrowserResponse, RedirectBrowserResponseOptions, OutgoingBrowserResponseOptions } from '@stone-js/browser-core';
+import { AdapterErrorHandlerOptions, FunctionalAdapterErrorHandler, IBlueprint, IContainer, AdapterContext, ErrorHandlerOptions, FunctionalErrorHandler, Promiseable, HookName as HookName$1, Laziable, LifecycleHookType, OutgoingResponseOptions, IEventHandler, IErrorHandler, AdapterErrorContext, IServiceProvider, AppConfig, StoneBlueprint, IAdapterErrorHandler, AdapterEventBuilderType, InitializationError, ErrorOptions, ClassType, BlueprintContext, NextMiddleware, ILogger, MetaMiddleware } from '@stone-js/core';
 import { Root } from 'react-dom/client';
 
 /**
@@ -66,6 +66,14 @@ type ReactIncomingEvent = IncomingHttpEvent | IncomingBrowserEvent;
  * Incoming event options for React.
 */
 type ReactIncomingEventOptions = IncomingBrowserEventOptions | IncomingHttpEventOptions;
+/**
+ * Redirect response options for React.
+*/
+type ReactRedirectResponseOptions = RedirectResponseOptions | RedirectBrowserResponseOptions;
+/**
+ * Outgoing response options for React.
+*/
+type ReactResponseOptions = OutgoingHttpResponseOptions | ReactOutgoingResponseOptions | ReactRedirectResponseOptions | OutgoingBrowserResponseOptions;
 /**
  * Outgoing response for React.
 */
@@ -382,6 +390,12 @@ interface MetaAdapterErrorPage<RawEventType, RawResponseType, ExecutionContextTy
     module: AdapterErrorPageType<RawEventType, RawResponseType, ExecutionContextType> | Laziable<AdapterErrorPageType<RawEventType, RawResponseType, ExecutionContextType>>;
 }
 
+/**
+ * Stone context.
+ * Usefull to pass data to the components.
+ */
+declare const StoneContext: react.Context<StoneContextType>;
+
 /**
  * ReactRuntimeOptions
 */
@@ -466,49 +480,6 @@ declare const MetaReactRuntime: {
     singleton: boolean;
 };
 
-/**
- * UseReactBrowserErrorHandler options.
- */
-interface UseReactBrowserErrorHandlerOptions {
-    blueprint: IBlueprint;
-}
-/**
- * Class representing an UseReactBrowserErrorHandler.
- *
- * Adapter level error handler for React applications.
- */
-declare class UseReactBrowserErrorHandler implements IAdapterErrorHandler<unknown, unknown, unknown> {
-    private readonly logger;
-    private readonly blueprint;
-    /**
-     * Create an UseReactBrowserErrorHandler.
-     *
-     * @param options - UseReactBrowserErrorHandler options.
-     */
-    constructor({ blueprint }: UseReactBrowserErrorHandlerOptions);
-    /**
-     * Handle an error.
-     *
-     * @param error - The error to handle.
-     * @param context - The context of the adapter.
-     * @returns The raw response.
-     */
-    handle(error: any, context: AdapterErrorContext<unknown, unknown, unknown>): Promise<AdapterEventBuilderType<unknown>>;
-    /**
-     * Get the error body.
-     *
-     * @param error - The error to handle.
-     * @returns The error body.
-     */
-    private renderError;
-}
-
-/**
- * Stone context.
- * Usefull to pass data to the components.
- */
-declare const StoneContext: react.Context<StoneContextType>;
-
 /**
  * A useReact event handler for processing incoming events
  * For single event handler.
@@ -732,9 +703,9 @@ declare function getBrowserContent(app: ReactNode, component: ReactNode, layout:
  * @param container - The service container.
  * @param event - The incoming browser event.
  * @param head - The head context.
- * @returns A promise that resolves when the content is hydrated.
+ * @returns The server response content as a string.
  */
-declare function getServerContent(component: ReactNode, data: Partial<ResponseSnapshotType>, container: IContainer, event: IncomingBrowserEvent, head?: HeadContext): Promise<string>;
+declare function getServerContent(component: ReactNode, data: Partial<ResponseSnapshotType>, container: IContainer, event: IncomingBrowserEvent, head?: HeadContext): string;
 /**
  * Get the response snapshot.
  *
@@ -801,59 +772,6 @@ declare function prepareErrorPage(event: IncomingBrowserEvent, response: ReactOu
  */
 declare function prepareFallbackErrorPage(event: IncomingBrowserEvent, response: ReactOutgoingResponse, container: IContainer, snapshot: ResponseSnapshotType): Promise<void>;
 
-/**
- * Create an UseReact response.
- *
- * @param options - The options for creating the response.
- * @returns The React response.
- */
-declare const reactResponse: (options: OutgoingHttpResponseOptions | OutgoingBrowserResponseOptions | RedirectResponseOptions | RedirectBrowserResponseOptions) => Promise<ReactOutgoingResponse>;
-/**
- * Create an UseReact redirect response.
- *
- * @param options - The options for creating the response.
- * @returns The React redirect response.
- */
-declare const reactRedirectResponse: (options: RedirectResponseOptions | RedirectBrowserResponseOptions) => Promise<ReactOutgoingResponse>;
-
-/**
- * UseReactServerErrorHandler options.
- */
-interface UseReactServerErrorHandlerOptions {
-    logger: ILogger;
-    blueprint: IBlueprint;
-}
-/**
- * Class representing an UseReactServerErrorHandler.
- *
- * Adapter level error handler for React applications.
- */
-declare class UseReactServerErrorHandler implements IAdapterErrorHandler<unknown, unknown, unknown> {
-    private readonly logger;
-    private readonly blueprint;
-    /**
-     * Create an UseReactServerErrorHandler.
-     *
-     * @param options - UseReactServerErrorHandler options.
-     */
-    constructor({ blueprint }: UseReactServerErrorHandlerOptions);
-    /**
-     * Handle an error.
-     *
-     * @param error - The error to handle.
-     * @param context - The context of the adapter.
-     * @returns The raw response.
-     */
-    handle(error: any, context: AdapterErrorContext<unknown, unknown, unknown>): Promise<AdapterEventBuilderType<unknown>>;
-    /**
-     * Get the error body.
-     *
-     * @param error - The error to handle.
-     * @returns The error body.
-    */
-    private getErrorBody;
-}
-
 /**
  * Constants for the Stone SNAPSHOT
  */
@@ -923,6 +841,12 @@ interface UseReactConfig {
      * A map of layout components with their respective event handlers.
      */
     layout?: Record<string, MetaPageLayout>;
+    /**
+     * A list of platforms to ignore for React rendering.
+     * This can be used to disable React rendering on specific platforms.
+     * For example, you might want to ignore rendering on CLI platforms.
+     */
+    ignorePlatforms?: string[];
     /**
      * Handles incoming events for the root React component.
      */
@@ -960,26 +884,7 @@ interface UseReactBlueprint extends StoneBlueprint<ReactIncomingEvent, ReactOutg
  *
  * - Defines middleware, lifecycle hooks, and the default HTML template path.
  */
-declare const useReactBlueprint: UseReactBlueprint;
-
-/**
- * Utility function to define a factory-based adapter error page.
- *
- * @param module - The adapter error page module.
- * @param options - Optional adapter error page options.
- * @returns The UseReactBlueprint.
- */
-declare function defineAdapterErrorPage(module: FactoryAdapterErrorPage<unknown, unknown, unknown>, options?: AdapterErrorPageOptions): UseReactBlueprint;
-/**
- * Utility function to define a class-based adapter error page.
- *
- * @param module - The adapter error page module.
- * @param options - Adapter error page options.
- * @returns The UseReactBlueprint.
- */
-declare function defineAdapterErrorPage(module: AdapterErrorPageClass<unknown, unknown, unknown>, options: AdapterErrorPageOptions & {
-    isClass: boolean;
-}): UseReactBlueprint;
+declare const internalUseReactBlueprint: UseReactBlueprint;
 
 /**
  * Defines a Stone React app using a factory-based main handler.
@@ -1010,6 +915,82 @@ declare function defineStoneReactApp<U extends ReactIncomingEvent = ReactIncomin
  */
 declare function defineStoneReactApp<U extends ReactIncomingEvent = ReactIncomingEvent>(options?: Partial<UseReactAppConfig>, blueprints?: Array<StoneBlueprint<any, any> & Record<string, any>>): StoneBlueprint<U>;
 
+/**
+ * Utility function to define a factory-based adapter error page.
+ *
+ * @param module - The adapter error page module.
+ * @param options - Optional adapter error page options.
+ * @returns The UseReactBlueprint.
+ */
+declare function defineAdapterErrorPage(module: FactoryAdapterErrorPage<unknown, unknown, unknown>, options?: AdapterErrorPageOptions): UseReactBlueprint;
+/**
+ * Utility function to define a class-based adapter error page.
+ *
+ * @param module - The adapter error page module.
+ * @param options - Adapter error page options.
+ * @returns The UseReactBlueprint.
+ */
+declare function defineAdapterErrorPage(module: AdapterErrorPageClass<unknown, unknown, unknown>, options: AdapterErrorPageOptions & {
+    isClass: boolean;
+}): UseReactBlueprint;
+
+/**
+ * UseReactBrowserErrorHandler options.
+ */
+interface UseReactBrowserErrorHandlerOptions {
+    blueprint: IBlueprint;
+}
+/**
+ * Class representing an UseReactBrowserErrorHandler.
+ *
+ * Adapter level error handler for React applications.
+ */
+declare class UseReactBrowserErrorHandler implements IAdapterErrorHandler<unknown, unknown, unknown> {
+    private readonly logger;
+    private readonly blueprint;
+    /**
+     * Create an UseReactBrowserErrorHandler.
+     *
+     * @param options - UseReactBrowserErrorHandler options.
+     */
+    constructor({ blueprint }: UseReactBrowserErrorHandlerOptions);
+    /**
+     * Handle an error.
+     *
+     * @param error - The error to handle.
+     * @param context - The context of the adapter.
+     * @returns The raw response.
+     */
+    handle(error: any, context: AdapterErrorContext<unknown, unknown, unknown>): Promise<AdapterEventBuilderType<unknown>>;
+    /**
+     * Get the error body.
+     *
+     * @param error - The error to handle.
+     * @returns The error body.
+     */
+    private renderError;
+}
+
+/**
+ * Stone Error.
+ */
+declare const StoneError: FunctionComponent;
+
+/**
+ * Create an UseReact response.
+ *
+ * @param options - The options for creating the response.
+ * @returns The React response.
+ */
+declare const reactResponse: (options: ReactResponseOptions) => ReactOutgoingResponse;
+/**
+ * Create an UseReact redirect response.
+ *
+ * @param options - The options for creating the response.
+ * @returns The React redirect response.
+ */
+declare const reactRedirectResponse: (options: ReactRedirectResponseOptions) => ReactOutgoingResponse;
+
 /**
  * Stone Client options.
  */
@@ -1086,18 +1067,9 @@ declare function defineErrorPage(module: ErrorPageClass<ReactIncomingEvent>, opt
     isClass: true;
 }): UseReactBlueprint;
 
-/**
- * Stone Error.
- */
-declare const StoneError: FunctionComponent;
-
-interface BaseProps {
-    rel?: string;
-    href?: string;
-    target?: string;
+interface BaseProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
     noRel?: boolean;
     external?: boolean;
-    className?: string;
     children: ReactNode;
     defaultNav?: boolean;
     selectedClass?: string;
@@ -1111,30 +1083,10 @@ type StoneLinkOptions = (BaseProps & {
     to: string | NavigateOptions;
 });
 /**
- * Main StoneLink component delegating to internal or external versions.
+ * Internal link component using Stone.js router.
  */
 declare const StoneLink: FunctionComponent<StoneLinkOptions>;
 
-/**
- * Stone Outlet options.
- */
-interface StoneOutletOptions {
-    children: ReactNode;
-}
-/**
- * A dynamic rendering component that updates its content based on a global event.
- *
- * - Listens for `stone:inject:react-page:outlet` and updates its view when triggered.
- * - Uses `useState` to manage the currently displayed content.
- * - Automatically cleans up event listeners on unmount.
- *
- * This component enables dynamic content updates within a Stone.js application.
- *
- * @param options - The options to create the Stone Outlet.
- * @returns The Stone Outlet component.
- */
-declare const StoneOutlet: FunctionComponent<StoneOutletOptions>;
-
 /**
  * Stone Page options.
  */
@@ -1156,6 +1108,25 @@ interface StonePageOptions {
  */
 declare const StonePage: FunctionComponent<StonePageOptions>;
 
+/**
+ * Stone Outlet options.
+ */
+interface StoneOutletOptions extends HTMLAttributes<HTMLDivElement> {
+}
+/**
+ * A dynamic rendering component that updates its content based on a global event.
+ *
+ * - Listens for `stone:inject:react-page:outlet` and updates its view when triggered.
+ * - Uses `useState` to manage the currently displayed content.
+ * - Automatically cleans up event listeners on unmount.
+ *
+ * This component enables dynamic content updates within a Stone.js application.
+ *
+ * @param options - The options to create the Stone Outlet.
+ * @returns The Stone Outlet component.
+ */
+declare const StoneOutlet: FunctionComponent<StoneOutletOptions>;
+
 /**
  * Stone Server options.
  */
@@ -1171,6 +1142,13 @@ interface StoneServerOptions {
  */
 declare const StoneServer: FunctionComponent<StoneServerOptions>;
 
+/**
+ * Custom error for react operations.
+ */
+declare class UseReactError extends InitializationError {
+    constructor(message: string, options?: ErrorOptions);
+}
+
 /**
  * A class decorator for defining a class as a React Handler layout.
  *
@@ -1191,6 +1169,26 @@ declare const StoneServer: FunctionComponent<StoneServerOptions>;
  */
 declare const AdapterErrorPage: <T extends ClassType = ClassType>(options: AdapterErrorPageOptions) => ClassDecorator;
 
+/**
+ * A class decorator for defining a class as a React Handler layout.
+ *
+ * @param options - Configuration options for the layout definition.
+ * @returns A method decorator to be applied to a class method.
+ *
+ * @example
+ * ```typescript
+ * import { ErrorPage } from '@stone-js/use-react';
+ *
+ * @ErrorPage({ error: 'UserNotFoundError' })
+ * class UserErrorPage {
+ *   render({ error }) {
+ *     return <h1>User name: {error.message}</h1>;
+ *   }
+ * }
+ * ```
+ */
+declare const ErrorPage: <T extends ClassType = ClassType>(options: ErrorPageOptions) => ClassDecorator;
+
 /**
  * Hook decorator to mark a method as a lifecycle hook
  * And automatically add it to the global lifecycle hook registry.
@@ -1232,27 +1230,29 @@ declare const Hook: <T extends Function = Function>(name: HookName) => MethodDec
  * }
  * ```
  */
-declare const Page: <T extends ClassType = ClassType>(path: string, options?: PageOptions) => ClassDecorator;
+declare const Page: <T extends ClassType = ClassType>(path: string | string[], options?: PageOptions) => ClassDecorator;
 
 /**
- * A class decorator for defining a class as a React Handler layout.
+ * Decorator to set the status code of the response.
  *
- * @param options - Configuration options for the layout definition.
- * @returns A method decorator to be applied to a class method.
+ * @param statusCode - The status code of the response.
+ * @param headers - The headers for the response.
+ * @returns A method decorator.
  *
  * @example
  * ```typescript
- * import { ErrorPage } from '@stone-js/use-react';
+ * import { Page, PageStatus } from '@stone-js/use-react';
  *
- * @ErrorPage({ error: 'UserNotFoundError' })
- * class UserErrorPage {
- *   render({ error }) {
- *     return <h1>User name: {error.message}</h1>;
+ * @Page('/user-profile')
+ * class UserPage {
+ *   @PageStatus()
+ *   handle() {
+ *     return { name: 'John Doe' };
  *   }
  * }
  * ```
  */
-declare const ErrorPage: <T extends ClassType = ClassType>(options: ErrorPageOptions) => ClassDecorator;
+declare const PageStatus: <T extends Function = Function>(statusCode?: number, headers?: HeadersType) => MethodDecorator;
 
 /**
  * A class decorator for defining a class as a React Page layout.
@@ -1274,28 +1274,6 @@ declare const ErrorPage: <T extends ClassType = ClassType>(options: ErrorPageOpt
  */
 declare const PageLayout: <T extends ClassType = ClassType>(options: PageLayoutOptions) => ClassDecorator;
 
-/**
- * Decorator to set the status code of the response.
- *
- * @param statusCode - The status code of the response.
- * @param headers - The headers for the response.
- * @returns A method decorator.
- *
- * @example
- * ```typescript
- * import { Page, PageStatus } from '@stone-js/use-react';
- *
- * @Page('/user-profile')
- * class UserPage {
- *   @PageStatus()
- *   handle() {
- *     return { name: 'John Doe' };
- *   }
- * }
- * ```
- */
-declare const PageStatus: <T extends Function = Function>(statusCode?: number, headers?: HeadersType) => MethodDecorator;
-
 /**
  * Decorator to create a snapshot of the current data.
  *
@@ -1319,27 +1297,29 @@ declare const PageStatus: <T extends Function = Function>(statusCode?: number, h
 declare const Snapshot: <T extends Function = Function>(name?: string) => MethodDecorator;
 
 /**
- * UseReact decorator options.
+ * Constants are defined here to prevent Circular dependency between modules
+ * This pattern must be applied to all Stone libraries or third party libraries.
  */
-interface UseReactOptions extends Partial<UseReactConfig> {
-}
 /**
- * UseReact decorator.
- *
- * UseReact is a class decorator that allows you to use React components in your Stone application.
- * The decorator is used to define the React configuration for the class.
- *
- * @param options - UseReactOptions
- * @returns ClassDecorator
+ * A unique symbol key to mark classes as React Page component.
  */
-declare const UseReact: <T extends ClassType = ClassType>(options?: UseReactOptions) => ClassDecorator;
-
+declare const REACT_PAGE_KEY: unique symbol;
 /**
- * Custom error for react operations.
+ * A unique symbol key to mark classes as React Page layout component.
  */
-declare class UseReactError extends InitializationError {
-    constructor(message: string, options?: ErrorOptions);
-}
+declare const REACT_PAGE_LAYOUT_KEY: unique symbol;
+/**
+ * A unique symbol key to mark classes as React Error handler component.
+ */
+declare const REACT_ERROR_PAGE_KEY: unique symbol;
+/**
+ * A unique symbol key to mark classes as React Adapter Error handler component.
+ */
+declare const REACT_ADAPTER_ERROR_PAGE_KEY: unique symbol;
+/**
+ * A unique symbol key to mark classes as React Stone application entry point.
+ */
+declare const STONE_REACT_APP_KEY: unique symbol;
 
 /**
  * Blueprint middleware to dynamically set lifecycle hooks for react.
@@ -1354,22 +1334,6 @@ declare class UseReactError extends InitializationError {
  * ```
  */
 declare const SetUseReactHooksMiddleware: (context: BlueprintContext<IBlueprint, ClassType>, next: NextMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>) => Promiseable<IBlueprint>;
-/**
- * Blueprint middleware to set BrowserResponseMiddleware for the Browser adapter.
- *
- * The MetaBrowserResponseMiddleware is an adapter middleware and is useful
- * for handling outgoing responses and rendering them in the browser.
- *
- * @param context - The configuration context containing modules and blueprint.
- * @param next - The next pipeline function to continue processing.
- * @returns The updated blueprint or a promise resolving to it.
- *
- * @example
- * ```typescript
- * SetBrowserResponseMiddlewareMiddleware(context, next)
- * ```
- */
-declare const SetBrowserResponseMiddlewareMiddleware: (context: BlueprintContext<IBlueprint, ClassType>, next: NextMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>) => Promise<IBlueprint>;
 /**
  * Blueprint middleware to process and register kernel error page definitions from modules.
  *
@@ -1383,45 +1347,6 @@ declare const SetBrowserResponseMiddlewareMiddleware: (context: BlueprintContext
  * ```
  */
 declare const SetReactKernelErrorPageMiddleware: (context: BlueprintContext<IBlueprint, ClassType>, next: NextMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>) => Promiseable<IBlueprint>;
-/**
- * Blueprint middleware to process and register adapter error page definitions from modules.
- *
- * @param context - The configuration context containing modules and blueprint.
- * @param next - The next pipeline function to continue processing.
- * @returns The updated blueprint or a promise resolving to it.
- *
- * @example
- * ```typescript
- * SetReactAdapterErrorPageMiddleware(context, next)
- * ```
- */
-declare const SetReactAdapterErrorPageMiddleware: (context: BlueprintContext<IBlueprint, ClassType>, next: NextMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>) => Promiseable<IBlueprint>;
-/**
- * Blueprint middleware to set StaticFileMiddleware for SSR adapter.
- *
- * @param context - The configuration context containing modules and blueprint.
- * @param next - The next pipeline function to continue processing.
- * @returns The updated blueprint or a promise resolving to it.
- *
- * @example
- * ```typescript
- * SetSSRStaticFileMiddleware(context, next)
- * ```
- */
-declare const SetSSRStaticFileMiddleware: (context: BlueprintContext<IBlueprint, ClassType>, next: NextMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>) => Promise<IBlueprint>;
-/**
- * Blueprint middleware to set CompressionMiddleware for SSR adapter.
- *
- * @param context - The configuration context containing modules and blueprint.
- * @param next - The next pipeline function to continue processing.
- * @returns The updated blueprint or a promise resolving to it.
- *
- * @example
- * ```typescript
- * SetSSRCompressionMiddleware(context, next)
- * ```
- */
-declare const SetSSRCompressionMiddleware: (context: BlueprintContext<IBlueprint, ClassType>, next: NextMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>) => Promise<IBlueprint>;
 /**
  * Blueprint middleware to process and register route definitions from modules.
  *
@@ -1463,13 +1388,69 @@ declare const SetReactPageLayoutMiddleware: (context: BlueprintContext<IBlueprin
  * ```
  */
 declare function SetUseReactEventHandlerMiddleware(context: BlueprintContext<IBlueprint, ClassType>, next: NextMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>): Promise<IBlueprint>;
+
 /**
- * Configuration for react processing middleware.
+ * UseReactServerErrorHandler options.
+ */
+interface UseReactServerErrorHandlerOptions {
+    logger: ILogger;
+    blueprint: IBlueprint;
+}
+/**
+ * Class representing an UseReactServerErrorHandler.
  *
- * This array defines a list of middleware pipes, each with a `pipe` function and a `priority`.
- * These pipes are executed in the order of their priority values, with lower values running first.
+ * Adapter level error handler for React applications.
  */
-declare const metaUseReactBlueprintMiddleware: Array<MetaMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>>;
+declare class UseReactServerErrorHandler implements IAdapterErrorHandler<unknown, unknown, unknown> {
+    private readonly logger;
+    private readonly blueprint;
+    /**
+     * Create an UseReactServerErrorHandler.
+     *
+     * @param options - UseReactServerErrorHandler options.
+     */
+    constructor({ blueprint }: UseReactServerErrorHandlerOptions);
+    /**
+     * Handle an error.
+     *
+     * @param error - The error to handle.
+     * @param context - The context of the adapter.
+     * @returns The raw response.
+     */
+    handle(error: any, context: AdapterErrorContext<unknown, unknown, unknown>): Promise<AdapterEventBuilderType<unknown>>;
+    /**
+     * Get the error body.
+     *
+     * @param error - The error to handle.
+     * @returns The error body.
+    */
+    private getErrorBody;
+}
+
+/**
+ * Sets the error handler for the React adapter and registers error pages.
+ *
+ * @param errorHandler - The error handler to set for the React adapter.
+ * @param context - The blueprint context containing modules and blueprint.
+ * @returns The updated blueprint context with the error handler and error pages set.
+ */
+declare function setUseReactAdapterErrorHandler(errorHandler: typeof UseReactServerErrorHandler | typeof UseReactBrowserErrorHandler, context: BlueprintContext<IBlueprint, ClassType>): BlueprintContext<IBlueprint, ClassType>;
+
+/**
+ * UseReact decorator options.
+ */
+interface UseReactOptions extends Partial<UseReactConfig> {
+}
+/**
+ * UseReact decorator.
+ *
+ * UseReact is a class decorator that allows you to use React components in your Stone application.
+ * The decorator is used to define the React configuration for the class.
+ *
+ * @param options - UseReactOptions
+ * @returns ClassDecorator
+ */
+declare const UseReact: <T extends ClassType = ClassType>(options?: UseReactOptions) => ClassDecorator;
 
 /**
  * Adapter Middleware for handling outgoing responses and rendering them in the browser.
@@ -1538,29 +1519,48 @@ declare const MetaBrowserResponseMiddleware: {
 };
 
 /**
- * Constants are defined here to prevent Circular dependency between modules
- * This pattern must be applied to all Stone libraries or third party libraries.
- */
-/**
- * A unique symbol key to mark classes as React Page component.
- */
-declare const REACT_PAGE_KEY: unique symbol;
-/**
- * A unique symbol key to mark classes as React Page layout component.
+ * Default blueprint for a React-based Stone.js application.
+ *
+ * - Defines middleware, lifecycle hooks, and the default HTML template path.
  */
-declare const REACT_PAGE_LAYOUT_KEY: unique symbol;
+declare const useReactBlueprint: UseReactBlueprint;
+
 /**
- * A unique symbol key to mark classes as React Error handler component.
+ * Blueprint middleware to set BrowserResponseMiddleware for the Browser adapter.
+ *
+ * The MetaBrowserResponseMiddleware is an adapter middleware and is useful
+ * for handling outgoing responses and rendering them in the browser.
+ *
+ * @param context - The configuration context containing modules and blueprint.
+ * @param next - The next pipeline function to continue processing.
+ * @returns The updated blueprint or a promise resolving to it.
+ *
+ * @example
+ * ```typescript
+ * SetBrowserResponseMiddlewareMiddleware(context, next)
+ * ```
  */
-declare const REACT_ERROR_PAGE_KEY: unique symbol;
+declare const SetBrowserResponseMiddlewareMiddleware: (context: BlueprintContext<IBlueprint, ClassType>, next: NextMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>) => Promise<IBlueprint>;
 /**
- * A unique symbol key to mark classes as React Adapter Error handler component.
+ * Blueprint middleware to process and register adapter error page definitions from modules.
+ *
+ * @param context - The configuration context containing modules and blueprint.
+ * @param next - The next pipeline function to continue processing.
+ * @returns The updated blueprint or a promise resolving to it.
+ *
+ * @example
+ * ```typescript
+ * SetReactAdapterErrorPageMiddleware(context, next)
+ * ```
  */
-declare const REACT_ADAPTER_ERROR_PAGE_KEY: unique symbol;
+declare const SetReactAdapterErrorPageMiddleware: (context: BlueprintContext<IBlueprint, ClassType>, next: NextMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>) => Promiseable<IBlueprint>;
 /**
- * A unique symbol key to mark classes as React Stone application entry point.
+ * Configuration for react processing middleware.
+ *
+ * This array defines a list of middleware pipes, each with a `pipe` function and a `priority`.
+ * These pipes are executed in the order of their priority values, with lower values running first.
  */
-declare const STONE_REACT_APP_KEY: unique symbol;
+declare const metaBrowserUseReactBlueprintMiddleware: Array<MetaMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>>;
 
-export { AdapterErrorPage, BrowserResponseMiddleware, ErrorPage, Hook, MetaBrowserResponseMiddleware, MetaReactRuntime, MetaUseReactServiceProvider, Page, PageLayout, PageStatus, REACT_ADAPTER_ERROR_PAGE_KEY, REACT_ERROR_PAGE_KEY, REACT_PAGE_KEY, REACT_PAGE_LAYOUT_KEY, ReactRuntime, STONE_DOM_ATTR, STONE_PAGE_EVENT_OUTLET, STONE_REACT_APP_KEY, STONE_SNAPSHOT, SetBrowserResponseMiddlewareMiddleware, SetReactAdapterErrorPageMiddleware, SetReactKernelErrorPageMiddleware, SetReactPageLayoutMiddleware, SetReactRouteDefinitionsMiddleware, SetSSRCompressionMiddleware, SetSSRStaticFileMiddleware, SetUseReactEventHandlerMiddleware, SetUseReactHooksMiddleware, Snapshot, StoneClient, StoneContext, StoneError, StoneLink, StoneOutlet, StonePage, StoneServer, UseReact, UseReactBrowserErrorHandler, UseReactError, UseReactEventHandler, UseReactKernelErrorHandler, UseReactServerErrorHandler, UseReactServiceProvider, applyHeadContextToDom, applyHeadContextToHtmlString, applyMeta, buildAdapterErrorComponent, buildAppComponent, buildLayoutComponent, buildPageComponent, defineAdapterErrorPage, defineErrorPage, definePage, definePageLayout, defineStoneReactApp, executeHandler, executeHooks, getAppRootElement, getBrowserContent, getResponseSnapshot, getServerContent, htmlTemplate, hydrateReactApp, isClient, isSSR, isServer, metaUseReactBlueprintMiddleware, onPreparingResponse, prepareErrorPage, prepareFallbackErrorPage, preparePage, reactRedirectResponse, reactResponse, renderReactApp, renderStoneSnapshot, resolveComponent, resolveLazyComponent, snapshotResponse, useReactBlueprint };
-export type { AdapterErrorPageClass, AdapterErrorPageOptions, AdapterErrorPageRenderContext, AdapterErrorPageType, AdapterPageLayoutRenderContext, BrowserResponseContent, ErrorPageClass, ErrorPageHeadContext, ErrorPageOptions, ErrorPageRenderContext, ErrorPageType, FactoryAdapterErrorPage, FactoryErrorPage, FactoryPage, FactoryPageLayout, HeadContext, HeadersType, HookName, IAdapterErrorPage, IErrorPage, IPage, IPageLayout, IRoute, IRouter, ISnapshot, MetaAdapterErrorPage, MetaErrorPage, MetaPage, MetaPageLayout, OnPreparingResponseOptions, PageClass, PageHeadContext, PageLayoutClass, PageLayoutOptions, PageLayoutRenderContext, PageLayoutType, PageOptions, PageRenderContext, PageType, ReactBrowserAdapterContext, ReactIncomingEvent, ReactIncomingEventOptions, ReactLifecycleHookType, ReactOutgoingResponse, ReactOutgoingResponseOptions, ReactRuntimeOptions, ResponseSnapshotType, StoneContextType, StoneLinkOptions, StoneOutletOptions, UseReactAppConfig, UseReactBlueprint, UseReactBrowserErrorHandlerOptions, UseReactConfig, UseReactErrorResponseType, UseReactHookListener, UseReactHookListenerContext, UseReactHookName, UseReactHookType, UseReactOptions, UseReactServerErrorHandlerOptions, UseReactServiceProviderOptions };
+export { AdapterErrorPage, BrowserResponseMiddleware, ErrorPage, Hook, MetaBrowserResponseMiddleware, MetaReactRuntime, MetaUseReactServiceProvider, Page, PageLayout, PageStatus, REACT_ADAPTER_ERROR_PAGE_KEY, REACT_ERROR_PAGE_KEY, REACT_PAGE_KEY, REACT_PAGE_LAYOUT_KEY, ReactRuntime, STONE_DOM_ATTR, STONE_PAGE_EVENT_OUTLET, STONE_REACT_APP_KEY, STONE_SNAPSHOT, SetBrowserResponseMiddlewareMiddleware, SetReactAdapterErrorPageMiddleware, SetReactKernelErrorPageMiddleware, SetReactPageLayoutMiddleware, SetReactRouteDefinitionsMiddleware, SetUseReactEventHandlerMiddleware, SetUseReactHooksMiddleware, Snapshot, StoneClient, StoneContext, StoneError, StoneLink, StoneOutlet, StonePage, StoneServer, UseReact, UseReactBrowserErrorHandler, UseReactError, UseReactEventHandler, UseReactKernelErrorHandler, UseReactServiceProvider, applyHeadContextToDom, applyHeadContextToHtmlString, applyMeta, buildAdapterErrorComponent, buildAppComponent, buildLayoutComponent, buildPageComponent, defineAdapterErrorPage, defineErrorPage, definePage, definePageLayout, defineStoneReactApp, executeHandler, executeHooks, getAppRootElement, getBrowserContent, getResponseSnapshot, getServerContent, htmlTemplate, hydrateReactApp, internalUseReactBlueprint, isClient, isSSR, isServer, metaBrowserUseReactBlueprintMiddleware, onPreparingResponse, prepareErrorPage, prepareFallbackErrorPage, preparePage, reactRedirectResponse, reactResponse, renderReactApp, renderStoneSnapshot, resolveComponent, resolveLazyComponent, setUseReactAdapterErrorHandler, snapshotResponse, useReactBlueprint };
+export type { AdapterErrorPageClass, AdapterErrorPageOptions, AdapterErrorPageRenderContext, AdapterErrorPageType, AdapterPageLayoutRenderContext, BrowserResponseContent, ErrorPageClass, ErrorPageHeadContext, ErrorPageOptions, ErrorPageRenderContext, ErrorPageType, FactoryAdapterErrorPage, FactoryErrorPage, FactoryPage, FactoryPageLayout, HeadContext, HeadersType, HookName, IAdapterErrorPage, IErrorPage, IPage, IPageLayout, IRoute, IRouter, ISnapshot, MetaAdapterErrorPage, MetaErrorPage, MetaPage, MetaPageLayout, OnPreparingResponseOptions, PageClass, PageHeadContext, PageLayoutClass, PageLayoutOptions, PageLayoutRenderContext, PageLayoutType, PageOptions, PageRenderContext, PageType, ReactBrowserAdapterContext, ReactIncomingEvent, ReactIncomingEventOptions, ReactLifecycleHookType, ReactOutgoingResponse, ReactOutgoingResponseOptions, ReactRedirectResponseOptions, ReactResponseOptions, ReactRuntimeOptions, ResponseSnapshotType, StoneContextType, StoneLinkOptions, StoneOutletOptions, UseReactAppConfig, UseReactBlueprint, UseReactBrowserErrorHandlerOptions, UseReactConfig, UseReactErrorResponseType, UseReactHookListener, UseReactHookListenerContext, UseReactHookName, UseReactHookType, UseReactOptions, UseReactServiceProviderOptions };