@stone-js/use-react 0.2.0 → 0.3.1

package/dist/index.d.ts

@@ -1,13 +1,40 @@
-import { FunctionalEventHandler, HeadContext as HeadContext$1, Route, Router, DecoratorPageRouteDefinition, HTMLMetaDescriptor, 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, RedirectResponseOptions, OutgoingHttpResponseOptions } from '@stone-js/http-core';
-import { IncomingBrowserEvent, OutgoingBrowserResponse, RedirectBrowserResponse, IncomingBrowserEventOptions, RedirectBrowserResponseOptions, OutgoingBrowserResponseOptions } from '@stone-js/browser-core';
-import { IContainer, Promiseable, Laziable, FunctionalErrorHandler, IBlueprint, FunctionalAdapterErrorHandler, OutgoingResponseOptions, HookName as HookName$1, LifecycleHookType, ErrorHandlerOptions, AdapterErrorHandlerOptions, AdapterContext, IEventHandler, IErrorHandler, AdapterErrorContext, IServiceProvider, StoneBlueprint, AppConfig, IAdapterErrorHandler, AdapterEventBuilderType, ClassType, BlueprintContext, NextMiddleware, InitializationError, ErrorOptions, ILogger, MetaMiddleware } from '@stone-js/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, ClassType, BlueprintContext, NextMiddleware, InitializationError, ErrorOptions, ILogger, MetaMiddleware } from '@stone-js/core';
 import { Root } from 'react-dom/client';
 
+/**
+  * Stone DOM Attribute.
+  */
+declare const STONE_DOM_ATTR = "data-stone-head";
+/**
+ * Apply meta tags to the document document.head.
+ *
+ * @param document - The document object.
+ * @param meta - The meta tag descriptor.
+ */
+declare const applyMeta: (document: Document, meta: HTMLMetaDescriptor) => void;
+/**
+ * Apply the head context to the document document.head.
+ *
+ * @param document - The document object.
+ * @param context - The head context containing meta, link, script, and style descriptors.
+ */
+declare const applyHeadContextToDom: (document: Document, context: HeadContext$1) => void;
+/**
+ * Escape HTML special characters in a string.
+ *
+ * @param context - The head context containing meta, link, script, and style descriptors.
+ * @param html - The HTML string to escape.
+ * @returns The escaped string.
+ */
+declare const applyHeadContextToHtmlString: (context: HeadContext$1, html: string) => string;
+
 /**
  * The type representing the Head Context for React.
  * It extends the BaseHeadContext to include additional properties specific to React.
@@ -363,6 +390,89 @@ 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>;
+
+/**
+ * A useReact event handler for processing incoming events
+ * For single event handler.
+ *
+ * Multiple event handlers will be processed by the router.
+ *
+ * @template IncomingEventType - The type representing the incoming event.
+ * @template OutgoingResponseType - The type representing the outgoing response.
+ */
+declare class UseReactEventHandler<IncomingEventType extends ReactIncomingEvent = ReactIncomingEvent> implements IEventHandler<IncomingEventType, MetaPage<IncomingEventType>> {
+    private readonly blueprint;
+    /**
+     * Constructs a `UseReactEventHandler` instance.
+     *
+     * @param options - The UseReactEventHandler options including blueprint.
+     */
+    constructor({ blueprint }: {
+        blueprint: IBlueprint;
+    });
+    /**
+     * Handle an incoming event.
+     *
+     * @returns The outgoing response.
+     */
+    handle(): MetaPage<IncomingEventType>;
+    /**
+     * Get the component event handler.
+     *
+     * @returns The component event handler.
+     * @throws {UseReactError} If the component event handler is missing.
+     */
+    private getComponentEventHandler;
+}
+
+/**
+ * UseReactError response type.
+ */
+type UseReactErrorResponseType = Record<'content' | 'statusCode', Partial<MetaErrorPage<ReactIncomingEvent>> | number>;
+/**
+ * Class representing an UseReactUseReactKernelErrorHandler.
+ *
+ * Kernel level error handler for React applications.
+ */
+declare class UseReactKernelErrorHandler implements IErrorHandler<ReactIncomingEvent, UseReactErrorResponseType> {
+    private readonly blueprint;
+    /**
+     * Create an UseReactUseReactKernelErrorHandler.
+     *
+     * @param options - UseReactUseReactKernelErrorHandler options.
+     */
+    constructor({ blueprint }: {
+        blueprint: IBlueprint;
+    });
+    /**
+     * Handle an error.
+     *
+     * @param error - The error to handle.
+     * @returns The outgoing http response.
+     */
+    handle(error: any): UseReactErrorResponseType;
+}
+
+/**
+ * Options for onPreparingResponse hook.
+ */
+interface OnPreparingResponseOptions {
+    container: IContainer;
+    event: IncomingBrowserEvent;
+    response: ReactOutgoingResponse;
+}
+/**
+ * Hook that runs just before preparing the response.
+ *
+ * @param context - The context of the hook.
+*/
+declare function onPreparingResponse({ event, response, container }: OnPreparingResponseOptions): Promise<void>;
+
 /**
  * ReactRuntimeOptions
 */
@@ -448,114 +558,41 @@ declare const MetaReactRuntime: {
 };
 
 /**
-  * Stone DOM Attribute.
-  */
-declare const STONE_DOM_ATTR = "data-stone-head";
-/**
- * Apply meta tags to the document document.head.
- *
- * @param document - The document object.
- * @param meta - The meta tag descriptor.
- */
-declare const applyMeta: (document: Document, meta: HTMLMetaDescriptor) => void;
-/**
- * Apply the head context to the document document.head.
+ * Prepare the page to render.
  *
- * @param document - The document object.
- * @param context - The head context containing meta, link, script, and style descriptors.
- */
-declare const applyHeadContextToDom: (document: Document, context: HeadContext$1) => void;
-/**
- * Escape HTML special characters in a string.
+ * Here we prepare the page to render by resolving
+ * the handler, handler the event, and rendering the component.
  *
- * @param context - The head context containing meta, link, script, and style descriptors.
- * @param html - The HTML string to escape.
- * @returns The escaped string.
+ * @param event - The incoming HTTP event.
+ * @param response - The outgoing HTTP response.
+ * @param container - The service container.
+ * @param snapshot - The response snapshot.
  */
-declare const applyHeadContextToHtmlString: (context: HeadContext$1, html: string) => string;
-
+declare function preparePage(event: IncomingBrowserEvent, response: ReactOutgoingResponse, container: IContainer, snapshot: ResponseSnapshotType): Promise<void>;
 /**
- * A useReact event handler for processing incoming events
- * For single event handler.
+ * Prepare the error page to render.
  *
- * Multiple event handlers will be processed by the router.
+ * Error pages are prepared sepatately because their handler
+ * is different from the normal page handler.
+ * Their handler takes an error as the first argument and the event as the second.
  *
- * @template IncomingEventType - The type representing the incoming event.
- * @template OutgoingResponseType - The type representing the outgoing response.
- */
-declare class UseReactEventHandler<IncomingEventType extends ReactIncomingEvent = ReactIncomingEvent> implements IEventHandler<IncomingEventType, MetaPage<IncomingEventType>> {
-    private readonly blueprint;
-    /**
-     * Constructs a `UseReactEventHandler` instance.
-     *
-     * @param options - The UseReactEventHandler options including blueprint.
-     */
-    constructor({ blueprint }: {
-        blueprint: IBlueprint;
-    });
-    /**
-     * Handle an incoming event.
-     *
-     * @returns The outgoing response.
-     */
-    handle(): MetaPage<IncomingEventType>;
-    /**
-     * Get the component event handler.
-     *
-     * @returns The component event handler.
-     * @throws {UseReactError} If the component event handler is missing.
-     */
-    private getComponentEventHandler;
-}
-
-/**
- * Stone context.
- * Usefull to pass data to the components.
- */
-declare const StoneContext: react.Context<StoneContextType>;
-
-/**
- * UseReactError response type.
+ * @param event - The incoming HTTP event.
+ * @param response - The outgoing HTTP response.
+ * @param container - The service container.
+ * @param snapshot - The response snapshot.
  */
-type UseReactErrorResponseType = Record<'content' | 'statusCode', Partial<MetaErrorPage<ReactIncomingEvent>> | number>;
+declare function prepareErrorPage(event: IncomingBrowserEvent, response: ReactOutgoingResponse, container: IContainer, snapshot: ResponseSnapshotType): Promise<void>;
 /**
- * Class representing an UseReactUseReactKernelErrorHandler.
+ * Prepare the fallback error page to render.
  *
- * Kernel level error handler for React applications.
- */
-declare class UseReactKernelErrorHandler implements IErrorHandler<ReactIncomingEvent, UseReactErrorResponseType> {
-    private readonly blueprint;
-    /**
-     * Create an UseReactUseReactKernelErrorHandler.
-     *
-     * @param options - UseReactUseReactKernelErrorHandler options.
-     */
-    constructor({ blueprint }: {
-        blueprint: IBlueprint;
-    });
-    /**
-     * Handle an error.
-     *
-     * @param error - The error to handle.
-     * @returns The outgoing http response.
-     */
-    handle(error: any): UseReactErrorResponseType;
-}
-
-/**
- * Options for onPreparingResponse hook.
- */
-interface OnPreparingResponseOptions {
-    container: IContainer;
-    event: IncomingBrowserEvent;
-    response: ReactOutgoingResponse;
-}
-/**
- * Hook that runs just before preparing the response.
+ * We prepare a fallback error page if no event nor error handler is provided.
  *
- * @param context - The context of the hook.
-*/
-declare function onPreparingResponse({ event, response, container }: OnPreparingResponseOptions): Promise<void>;
+ * @param event - The incoming event.
+ * @param response - The outgoing response.
+ * @param container - The service container.
+ * @param snapshot - The response snapshot.
+ */
+declare function prepareFallbackErrorPage(event: IncomingBrowserEvent, response: ReactOutgoingResponse, container: IContainer, snapshot: ResponseSnapshotType): Promise<void>;
 
 /**
  * Build the React application for the current route.
@@ -777,48 +814,11 @@ declare const MetaUseReactServiceProvider: {
 };
 
 /**
- * Prepare the page to render.
- *
- * Here we prepare the page to render by resolving
- * the handler, handler the event, and rendering the component.
- *
- * @param event - The incoming HTTP event.
- * @param response - The outgoing HTTP response.
- * @param container - The service container.
- * @param snapshot - The response snapshot.
+ * Constants for the Stone SNAPSHOT
  */
-declare function preparePage(event: IncomingBrowserEvent, response: ReactOutgoingResponse, container: IContainer, snapshot: ResponseSnapshotType): Promise<void>;
+declare const STONE_SNAPSHOT = "__STONE_SNAPSHOT__";
 /**
- * Prepare the error page to render.
- *
- * Error pages are prepared sepatately because their handler
- * is different from the normal page handler.
- * Their handler takes an error as the first argument and the event as the second.
- *
- * @param event - The incoming HTTP event.
- * @param response - The outgoing HTTP response.
- * @param container - The service container.
- * @param snapshot - The response snapshot.
- */
-declare function prepareErrorPage(event: IncomingBrowserEvent, response: ReactOutgoingResponse, container: IContainer, snapshot: ResponseSnapshotType): Promise<void>;
-/**
- * Prepare the fallback error page to render.
- *
- * We prepare a fallback error page if no event nor error handler is provided.
- *
- * @param event - The incoming event.
- * @param response - The outgoing response.
- * @param container - The service container.
- * @param snapshot - The response snapshot.
- */
-declare function prepareFallbackErrorPage(event: IncomingBrowserEvent, response: ReactOutgoingResponse, container: IContainer, snapshot: ResponseSnapshotType): Promise<void>;
-
-/**
- * Constants for the Stone SNAPSHOT
- */
-declare const STONE_SNAPSHOT = "__STONE_SNAPSHOT__";
-/**
- * Constants for the Stone Page Event Outlet
+ * Constants for the Stone Page Event Outlet
  */
 declare const STONE_PAGE_EVENT_OUTLET = "stone:inject:react-page:outlet";
 
@@ -905,6 +905,35 @@ declare function defineAdapterErrorPage(module: AdapterErrorPageClass<unknown, u
     isClass: boolean;
 }): UseReactBlueprint;
 
+/**
+ * Defines a Stone React app using a factory-based main handler.
+ *
+ * @param module - A factory function for the main page.
+ * @param options - Optional application-level configuration.
+ * @param blueprints - Additional blueprints to merge.
+ * @returns A fully merged Stone blueprint.
+ */
+declare function defineStoneReactApp<U extends ReactIncomingEvent = ReactIncomingEvent>(module: FactoryPage<U>, options?: Partial<UseReactAppConfig>, blueprints?: Array<StoneBlueprint<any, any> & Record<string, any>>): StoneBlueprint<U>;
+/**
+ * Defines a Stone React app using a class-based main handler.
+ *
+ * @param module - A class constructor for the main page.
+ * @param options - Optional application-level configuration.
+ * @param blueprints - Additional blueprints to merge.
+ * @returns A fully merged Stone blueprint.
+ */
+declare function defineStoneReactApp<U extends ReactIncomingEvent = ReactIncomingEvent>(module: PageClass<U>, options: Partial<UseReactAppConfig> & {
+    isClass: boolean;
+}, blueprints?: Array<StoneBlueprint<any, any> & Record<string, any>>): StoneBlueprint<U>;
+/**
+ * Defines a Stone React app without a main handler (router-only).
+ *
+ * @param options - Application-level configuration.
+ * @param blueprints - Additional blueprints to merge.
+ * @returns A fully merged Stone blueprint.
+ */
+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 page.
  *
@@ -966,35 +995,6 @@ declare function defineErrorPage(module: ErrorPageClass<ReactIncomingEvent>, opt
     isClass: true;
 }): UseReactBlueprint;
 
-/**
- * Defines a Stone React app using a factory-based main handler.
- *
- * @param module - A factory function for the main page.
- * @param options - Optional application-level configuration.
- * @param blueprints - Additional blueprints to merge.
- * @returns A fully merged Stone blueprint.
- */
-declare function defineStoneReactApp<U extends ReactIncomingEvent = ReactIncomingEvent>(module: FactoryPage<U>, options?: Partial<UseReactAppConfig>, blueprints?: Array<StoneBlueprint<any, any> & Record<string, any>>): StoneBlueprint<U>;
-/**
- * Defines a Stone React app using a class-based main handler.
- *
- * @param module - A class constructor for the main page.
- * @param options - Optional application-level configuration.
- * @param blueprints - Additional blueprints to merge.
- * @returns A fully merged Stone blueprint.
- */
-declare function defineStoneReactApp<U extends ReactIncomingEvent = ReactIncomingEvent>(module: PageClass<U>, options: Partial<UseReactAppConfig> & {
-    isClass: boolean;
-}, blueprints?: Array<StoneBlueprint<any, any> & Record<string, any>>): StoneBlueprint<U>;
-/**
- * Defines a Stone React app without a main handler (router-only).
- *
- * @param options - Application-level configuration.
- * @param blueprints - Additional blueprints to merge.
- * @returns A fully merged Stone blueprint.
- */
-declare function defineStoneReactApp<U extends ReactIncomingEvent = ReactIncomingEvent>(options?: Partial<UseReactAppConfig>, blueprints?: Array<StoneBlueprint<any, any> & Record<string, any>>): StoneBlueprint<U>;
-
 /**
  * UseReactBrowserErrorHandler options.
  */
@@ -1047,33 +1047,9 @@ declare const reactResponse: (options: ReactResponseOptions) => ReactOutgoingRes
  */
 declare const reactRedirectResponse: (options: ReactRedirectResponseOptions) => ReactOutgoingResponse;
 
-/**
- * Stone Error.
- */
-declare const StoneError: FunctionComponent;
-
-/**
- * Stone Client options.
- */
-interface StoneClientOptions {
-    children: ReactNode;
-}
-/**
- * Stone Client.
- * This component is used to wrap content
- * that should only be rendered on the client.
- *
- * @param options - The options to create the Stone Client.
- */
-declare const StoneClient: FunctionComponent<StoneClientOptions>;
-
-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;
@@ -1087,10 +1063,15 @@ 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 Error.
+ */
+declare const StoneError: FunctionComponent;
+
 /**
  * Stone Page options.
  */
@@ -1115,8 +1096,7 @@ declare const StonePage: FunctionComponent<StonePageOptions>;
 /**
  * Stone Outlet options.
  */
-interface StoneOutletOptions {
-    children: ReactNode;
+interface StoneOutletOptions extends HTMLAttributes<HTMLDivElement> {
 }
 /**
  * A dynamic rendering component that updates its content based on a global event.
@@ -1147,6 +1127,21 @@ interface StoneServerOptions {
  */
 declare const StoneServer: FunctionComponent<StoneServerOptions>;
 
+/**
+ * Stone Client options.
+ */
+interface StoneClientOptions {
+    children: ReactNode;
+}
+/**
+ * Stone Client.
+ * This component is used to wrap content
+ * that should only be rendered on the client.
+ *
+ * @param options - The options to create the Stone Client.
+ */
+declare const StoneClient: FunctionComponent<StoneClientOptions>;
+
 /**
  * A class decorator for defining a class as a React Handler layout.
  *
@@ -1187,24 +1182,6 @@ declare const AdapterErrorPage: <T extends ClassType = ClassType>(options: Adapt
  */
 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.
- *
- * @example
- * ```typescript
- * class MyClass {
- *    // ...
- *    @Hook('onPreparingPage')
- *    onPreparingPage () {}
- * }
- * ```
- *
- * @param name - The name of the lifecycle hook.
- * @returns A class decorator function that sets the metadata using the provided options.
- */
-declare const Hook: <T extends Function = Function>(name: HookName) => MethodDecorator;
-
 /**
  * A class decorator for defining a class as a React Page route action.
  * Uses the `Match` decorator internally to register the route with the HTTP `GET` method.
@@ -1228,27 +1205,25 @@ 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 Page layout.
- *
- * @param options - Configuration options for the layout definition.
- * @returns A method decorator to be applied to a class method.
+ * Hook decorator to mark a method as a lifecycle hook
+ * And automatically add it to the global lifecycle hook registry.
  *
  * @example
  * ```typescript
- * import { PageLayout } from '@stone-js/use-react';
- *
- * @PageLayout({ name: 'UserPageLayout' })
- * class UserPageLayout {
- *   render({ data }) {
- *     return <h1>User name: {data.name}</h1>;
- *   }
+ * class MyClass {
+ *    // ...
+ *    @Hook('onPreparingPage')
+ *    onPreparingPage () {}
  * }
  * ```
+ *
+ * @param name - The name of the lifecycle hook.
+ * @returns A class decorator function that sets the metadata using the provided options.
  */
-declare const PageLayout: <T extends ClassType = ClassType>(options: PageLayoutOptions) => ClassDecorator;
+declare const Hook: <T extends Function = Function>(name: HookName) => MethodDecorator;
 
 /**
  * Decorator to set the status code of the response.
@@ -1272,6 +1247,26 @@ declare const PageLayout: <T extends ClassType = ClassType>(options: PageLayoutO
  */
 declare const PageStatus: <T extends Function = Function>(statusCode?: number, headers?: HeadersType) => MethodDecorator;
 
+/**
+ * A class decorator for defining a class as a React Page layout.
+ *
+ * @param options - Configuration options for the layout definition.
+ * @returns A method decorator to be applied to a class method.
+ *
+ * @example
+ * ```typescript
+ * import { PageLayout } from '@stone-js/use-react';
+ *
+ * @PageLayout({ name: 'UserPageLayout' })
+ * class UserPageLayout {
+ *   render({ data }) {
+ *     return <h1>User name: {data.name}</h1>;
+ *   }
+ * }
+ * ```
+ */
+declare const PageLayout: <T extends ClassType = ClassType>(options: PageLayoutOptions) => ClassDecorator;
+
 /**
  * Decorator to create a snapshot of the current data.
  *
@@ -1294,6 +1289,31 @@ declare const PageStatus: <T extends Function = Function>(statusCode?: number, h
  */
 declare const Snapshot: <T extends Function = Function>(name?: string) => MethodDecorator;
 
+/**
+ * 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.
+ */
+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.
  *
@@ -1362,31 +1382,6 @@ declare const SetReactPageLayoutMiddleware: (context: BlueprintContext<IBlueprin
  */
 declare function SetUseReactEventHandlerMiddleware(context: BlueprintContext<IBlueprint, ClassType>, next: NextMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>): Promise<IBlueprint>;
 
-/**
- * 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.
- */
-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;
-
 /**
  * Custom error for react operations.
  */
@@ -1441,6 +1436,22 @@ declare class UseReactServerErrorHandler implements IAdapterErrorHandler<unknown
  */
 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;
+
 /**
  * Blueprint middleware to set BrowserResponseMiddleware for the Browser adapter.
  *
@@ -1478,6 +1489,13 @@ declare const SetReactAdapterErrorPageMiddleware: (context: BlueprintContext<IBl
  */
 declare const metaBrowserUseReactBlueprintMiddleware: Array<MetaMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>>;
 
+/**
+ * Default blueprint for a React-based Stone.js application.
+ *
+ * - Defines middleware, lifecycle hooks, and the default HTML template path.
+ */
+declare const useReactBlueprint: UseReactBlueprint;
+
 /**
  * Adapter Middleware for handling outgoing responses and rendering them in the browser.
  */
@@ -1544,28 +1562,5 @@ declare const MetaBrowserResponseMiddleware: {
     isClass: boolean;
 };
 
-/**
- * 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;
-
-/**
- * Default blueprint for a React-based Stone.js application.
- *
- * - Defines middleware, lifecycle hooks, and the default HTML template path.
- */
-declare const useReactBlueprint: UseReactBlueprint;
-
 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 };