alepha 0.21.2 → 0.23.0

package/dist/react/router/index.d.ts

@@ -1,17 +1,12 @@
-import * as _$alepha from "alepha";
 import { Alepha, AlephaError, Async, KIND, Middleware, Primitive, Static, TObject, TSchema } from "alepha";
 import { DateTimeProvider } from "alepha/datetime";
 import { BrowserHeadProvider, Head, ServerHeadProvider, SimpleHead } from "alepha/react/head";
 import { ServerHandler, ServerRequest, ServerRouterProvider } from "alepha/server";
 import { LinkProvider } from "alepha/server/links";
-import * as _$alepha_logger0 from "alepha/logger";
-import * as _$react from "react";
 import { AnchorHTMLAttributes, CSSProperties, FC, ReactNode } from "react";
-import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import { ServerStaticProvider } from "alepha/server/static";
 import { FileSystemProvider } from "alepha/system";
 import { Route, RouterProvider } from "alepha/router";
-import * as _$typebox from "typebox";
 
 //#region ../../src/react/router/constants/PAGE_PRELOAD_KEY.d.ts
 /**
@@ -45,12 +40,98 @@ declare class Redirection extends AlephaError {
   constructor(redirect: string);
 }
 //#endregion
+//#region ../../src/react/router/providers/RootComponentsProvider.d.ts
+/**
+ * Extension point letting any module contribute root-level React nodes that
+ * render on every page (siblings of the page view, inside AlephaContext).
+ *
+ * A module pushes into `rootComponents` from its `register` hook; the array
+ * is rendered by `ReactPageProvider.root()`. SSR-safe (same element feeds
+ * server render + client hydrate).
+ */
+declare class RootComponentsProvider {
+  rootComponents: ReactNode[];
+}
+//#endregion
+//#region ../../src/react/router/providers/RouterLocaleProvider.d.ts
+/**
+ * Generic locale path-prefix mechanism for the router.
+ *
+ * This provider knows nothing about i18n — it only deals with URL path
+ * segments. It is configured by the i18n module (`I18nProvider`) when
+ * `routing: "prefix"` is enabled, which keeps the dependency one-directional
+ * (`i18n → router`) and avoids a module cycle.
+ *
+ * The default locale is served WITHOUT a prefix (`/about` = default,
+ * `/fr/about` = French). The active locale is derived from the current
+ * request/navigation and stored under `alepha.react.router.locale`, so every
+ * URL the router builds (`pathname()`) automatically carries the right prefix.
+ */
+declare class RouterLocaleProvider {
+  protected readonly alepha: Alepha;
+  /**
+   * Whether locale path-prefixing is active. Off by default — opt-in via the
+   * i18n module.
+   */
+  enabled: boolean;
+  /**
+   * The default locale, served without a path prefix (e.g. `"en"` → `/about`).
+   */
+  defaultLocale: string;
+  /**
+   * All known locales, including the default one.
+   */
+  locales: string[];
+  /**
+   * Configure the provider. Called by the i18n module before the SSR routes
+   * are registered.
+   */
+  configure(options: {
+    enabled?: boolean;
+    defaultLocale?: string;
+    locales?: string[];
+  }): void;
+  /**
+   * Locales that carry a URL prefix — every known locale except the default.
+   */
+  get prefixedLocales(): string[];
+  /**
+   * Splits a leading locale segment off a pathname.
+   *
+   * - `/fr/about` → `{ locale: "fr", pathname: "/about" }` when `fr` is a
+   *   prefixed locale.
+   * - `/about` → `{ locale: defaultLocale, pathname: "/about" }`.
+   *
+   * When prefixing is disabled the pathname is returned untouched.
+   */
+  detect(pathname: string): {
+    locale: string;
+    pathname: string;
+  };
+  /**
+   * Prepends the locale prefix to a pathname when needed. The default locale
+   * (and any unknown/disabled case) returns the pathname unchanged.
+   */
+  withPrefix(pathname: string, locale?: string): string;
+  /**
+   * The active locale, derived from the current request/navigation. Falls back
+   * to the default locale when nothing has been detected.
+   */
+  get current(): string;
+  set current(locale: string);
+  /**
+   * Normalizes a stripped pathname so it always starts with a single slash and
+   * carries no trailing slash (except the root `/`).
+   */
+  protected normalize(pathname: string): string;
+}
+//#endregion
 //#region ../../src/react/router/providers/ReactPageProvider.d.ts
-declare const reactPageOptions: _$alepha.Atom<_$typebox.TObject<{
+declare const reactPageOptions: import("alepha").Atom<import("typebox").TObject<{
   /**
    * Enable React StrictMode wrapper.
    */
-  strictMode: _$typebox.TBoolean;
+  strictMode: import("typebox").TBoolean;
   /**
    * RegExp pattern (as string) to detect file-like URLs (e.g. /hello.txt, /wp-login.php).
    * When a request hits the catch-all wildcard route and matches this pattern,
@@ -60,22 +141,24 @@ declare const reactPageOptions: _$alepha.Atom<_$typebox.TObject<{
    *
    * @default "\\.[a-zA-Z0-9]{1,10}$"
    */
-  staticFilePattern: _$typebox.TString;
+  staticFilePattern: import("typebox").TString;
 }>, "alepha.react.page.options">;
 /**
  * Handle page routes for React applications. (Browser and Server)
  */
 declare class ReactPageProvider {
   protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly options: Readonly<{
     strictMode: boolean;
     staticFilePattern: string;
   }>;
   protected readonly alepha: Alepha;
+  protected readonly rootComponentsProvider: RootComponentsProvider;
+  protected readonly localeProvider: RouterLocaleProvider;
   protected readonly pages: PageRoute[];
   protected nextIdCursor: number;
-  protected readonly configure: _$alepha.HookPrimitive<"configure">;
+  protected readonly configure: import("alepha").HookPrimitive<"configure">;
   getPages(): PageRoute[];
   getConcretePages(): ConcretePageRoute[];
   page(name: string): PageRoute;
@@ -435,12 +518,38 @@ interface PagePrimitiveOptions<TConfig extends PageConfigSchema = PageConfigSche
    */
   parent?: PagePrimitive<PageConfigSchema, TPropsParent, any>;
   /**
-   * Function to determine if the page can be accessed.
+   * UI-affordance predicate for this page's navigation entry — **NOT security**.
+   * For real access control, gate the route with `use: [$secure({ permissions })]`
+   * (server-enforced); `can` is only consulted by navigation surfaces (sidebar,
+   * breadcrumbs, command palette), never by the router.
+   *
+   * Receives a `{ has }` context (a permission probe equivalent to
+   * `useAuth().has`) so it can express arbitrary access logic — including
+   * OR-of-permissions, which `nav.permission` (AND) cannot.
+   *
+   * - `true` (or omitted) → nav entry visible and enabled.
+   * - `"disabled"` → visible but disabled (greyed — e.g. insufficient role / paywalled).
+   * - `false` → hidden.
+   *
+   * For the common "needs these permissions" case, prefer the declarative
+   * {@link PageNav.permission} instead.
+   */
+  can?: (ctx: PageCanContext) => boolean | "disabled";
+  /**
+   * Navigation metadata — declares this page's presence in navigation
+   * surfaces: the sidebar, the breadcrumb trail, and a command palette
+   * (Spotlight). A page WITHOUT `nav` is route-only (reachable by URL but not
+   * listed).
+   *
+   * `$page` is pure React, so `label` / `icon` / `description` / `badge` accept
+   * `ReactNode` (pass `<Users />` directly).
    *
-   * If it returns false, the page will not be accessible and a 403 Forbidden error will be returned.
-   * This function can be used to implement permission-based access control.
+   * Visibility is UI-only (NOT security — gate the route with `use: [$secure(...)]`):
+   * an entry is hidden when `nav.hidden`, when `nav.permission` is set and not
+   * fully granted, or when `can()` returns `false`; it renders disabled when
+   * `can()` returns `"disabled"`.
    */
-  can?: () => boolean;
+  nav?: PageNav;
   /**
    * Catch any error from the `loader` function or during `rendering`.
    *
@@ -656,6 +765,58 @@ declare class PagePrimitive<TConfig extends PageConfigSchema = PageConfigSchema,
     response: Response;
   }>;
 }
+/**
+ * Context passed to {@link PagePrimitiveOptions.can} — a permission probe
+ * (equivalent to `useAuth().has`) supplied by the navigation builder.
+ */
+interface PageCanContext {
+  has: (permission: string) => boolean;
+}
+/**
+ * Navigation metadata for a page — see {@link PagePrimitiveOptions.nav}.
+ * Consumed by the sidebar, breadcrumbs and the command palette, all derived
+ * from the route tree (no separate nav list).
+ */
+interface PageNav {
+  /**
+   * Label for nav surfaces. Falls back to the page's `label`, then `head.title`.
+   */
+  label?: ReactNode;
+  /**
+   * Leading icon — a React element, e.g. `icon: <Users />`.
+   */
+  icon?: ReactNode;
+  /**
+   * Section the entry belongs to: sidebar group heading + command-palette section.
+   */
+  group?: string;
+  /**
+   * Sort order within the group (ascending).
+   */
+  order?: number;
+  /**
+   * Permission(s) required to SEE the entry — a single string or an array
+   * (ALL required, matching `$secure({ permissions })`). UI gate only; the
+   * real route gate is `use: [$secure(...)]`. For OR / custom logic use `can`.
+   */
+  permission?: string | string[];
+  /**
+   * Extra search terms for the command palette (synonyms / aliases beyond the label).
+   */
+  keywords?: string[];
+  /**
+   * Short description — command-palette subtitle / sidebar tooltip.
+   */
+  description?: ReactNode;
+  /**
+   * Trailing badge (unread count, "New", …) for the sidebar entry.
+   */
+  badge?: ReactNode;
+  /**
+   * Keep the route but exclude it from nav surfaces (e.g. a `/users/:id` detail page).
+   */
+  hidden?: boolean;
+}
 type ErrorHandler = (error: Error, state: ReactRouterState) => ReactNode | Redirection | undefined;
 interface PageConfigSchema {
   query?: TSchema;
@@ -703,7 +864,7 @@ interface ErrorViewerProps {
   alepha: Alepha;
   onRetry?: () => void;
 }
-declare const ErrorViewer: (props: ErrorViewerProps) => _$react_jsx_runtime0.JSX.Element;
+declare const ErrorViewer: (props: ErrorViewerProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region ../../src/react/router/components/Link.d.ts
 interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
@@ -714,16 +875,16 @@ interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
  *
  * It's a simple wrapper around an anchor (`<a>`) element using the `useRouter` hook.
  */
-declare const Link: (props: LinkProps) => _$react.DetailedReactHTMLElement<{
+declare const Link: (props: LinkProps) => import("react").DetailedReactHTMLElement<{
   href: string;
   onClick: (ev?: any) => any;
   download?: any;
   hrefLang?: string | undefined;
   media?: string | undefined;
   ping?: string | undefined;
-  target?: _$react.HTMLAttributeAnchorTarget | undefined;
+  target?: import("react").HTMLAttributeAnchorTarget | undefined;
   type?: string | undefined;
-  referrerPolicy?: _$react.HTMLAttributeReferrerPolicy | undefined;
+  referrerPolicy?: import("react").HTMLAttributeReferrerPolicy | undefined;
   defaultChecked?: boolean | undefined;
   defaultValue?: string | number | readonly string[] | undefined;
   suppressContentEditableWarning?: boolean | undefined;
@@ -743,12 +904,12 @@ declare const Link: (props: LinkProps) => _$react.DetailedReactHTMLElement<{
   nonce?: string | undefined;
   slot?: string | undefined;
   spellCheck?: (boolean | "true" | "false") | undefined;
-  style?: _$react.CSSProperties | undefined;
+  style?: import("react").CSSProperties | undefined;
   tabIndex?: number | undefined;
   title?: string | undefined;
   translate?: "yes" | "no" | undefined;
   radioGroup?: string | undefined;
-  role?: _$react.AriaRole | undefined;
+  role?: import("react").AriaRole | undefined;
   about?: string | undefined;
   content?: string | undefined;
   datatype?: string | undefined;
@@ -832,177 +993,177 @@ declare const Link: (props: LinkProps) => _$react.DetailedReactHTMLElement<{
   "aria-valuemin"?: number | undefined;
   "aria-valuenow"?: number | undefined;
   "aria-valuetext"?: string | undefined;
-  children?: _$react.ReactNode | undefined;
+  children?: import("react").ReactNode | undefined;
   dangerouslySetInnerHTML?: {
     __html: string | TrustedHTML;
   } | undefined;
-  onCopy?: _$react.ClipboardEventHandler<HTMLAnchorElement> | undefined;
-  onCopyCapture?: _$react.ClipboardEventHandler<HTMLAnchorElement> | undefined;
-  onCut?: _$react.ClipboardEventHandler<HTMLAnchorElement> | undefined;
-  onCutCapture?: _$react.ClipboardEventHandler<HTMLAnchorElement> | undefined;
-  onPaste?: _$react.ClipboardEventHandler<HTMLAnchorElement> | undefined;
-  onPasteCapture?: _$react.ClipboardEventHandler<HTMLAnchorElement> | undefined;
-  onCompositionEnd?: _$react.CompositionEventHandler<HTMLAnchorElement> | undefined;
-  onCompositionEndCapture?: _$react.CompositionEventHandler<HTMLAnchorElement> | undefined;
-  onCompositionStart?: _$react.CompositionEventHandler<HTMLAnchorElement> | undefined;
-  onCompositionStartCapture?: _$react.CompositionEventHandler<HTMLAnchorElement> | undefined;
-  onCompositionUpdate?: _$react.CompositionEventHandler<HTMLAnchorElement> | undefined;
-  onCompositionUpdateCapture?: _$react.CompositionEventHandler<HTMLAnchorElement> | undefined;
-  onFocus?: _$react.FocusEventHandler<HTMLAnchorElement> | undefined;
-  onFocusCapture?: _$react.FocusEventHandler<HTMLAnchorElement> | undefined;
-  onBlur?: _$react.FocusEventHandler<HTMLAnchorElement> | undefined;
-  onBlurCapture?: _$react.FocusEventHandler<HTMLAnchorElement> | undefined;
-  onChange?: _$react.ChangeEventHandler<HTMLAnchorElement, Element> | undefined;
-  onChangeCapture?: _$react.ChangeEventHandler<HTMLAnchorElement, Element> | undefined;
-  onBeforeInput?: _$react.InputEventHandler<HTMLAnchorElement> | undefined;
-  onBeforeInputCapture?: _$react.InputEventHandler<HTMLAnchorElement> | undefined;
-  onInput?: _$react.InputEventHandler<HTMLAnchorElement> | undefined;
-  onInputCapture?: _$react.InputEventHandler<HTMLAnchorElement> | undefined;
-  onReset?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onResetCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onSubmit?: _$react.SubmitEventHandler<HTMLAnchorElement> | undefined;
-  onSubmitCapture?: _$react.SubmitEventHandler<HTMLAnchorElement> | undefined;
-  onInvalid?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onInvalidCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onLoad?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onLoadCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onError?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onErrorCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onKeyDown?: _$react.KeyboardEventHandler<HTMLAnchorElement> | undefined;
-  onKeyDownCapture?: _$react.KeyboardEventHandler<HTMLAnchorElement> | undefined;
-  onKeyPress?: _$react.KeyboardEventHandler<HTMLAnchorElement> | undefined;
-  onKeyPressCapture?: _$react.KeyboardEventHandler<HTMLAnchorElement> | undefined;
-  onKeyUp?: _$react.KeyboardEventHandler<HTMLAnchorElement> | undefined;
-  onKeyUpCapture?: _$react.KeyboardEventHandler<HTMLAnchorElement> | undefined;
-  onAbort?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onAbortCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onCanPlay?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onCanPlayCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onCanPlayThrough?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onCanPlayThroughCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onDurationChange?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onDurationChangeCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onEmptied?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onEmptiedCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onEncrypted?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onEncryptedCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onEnded?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onEndedCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onLoadedData?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onLoadedDataCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onLoadedMetadata?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onLoadedMetadataCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onLoadStart?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onLoadStartCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onPause?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onPauseCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onPlay?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onPlayCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onPlaying?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onPlayingCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onProgress?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onProgressCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onRateChange?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onRateChangeCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onSeeked?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onSeekedCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onSeeking?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onSeekingCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onStalled?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onStalledCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onSuspend?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onSuspendCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onTimeUpdate?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onTimeUpdateCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onVolumeChange?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onVolumeChangeCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onWaiting?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onWaitingCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onAuxClick?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onAuxClickCapture?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onClickCapture?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onContextMenu?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onContextMenuCapture?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onDoubleClick?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onDoubleClickCapture?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onDrag?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragCapture?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragEnd?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragEndCapture?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragEnter?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragEnterCapture?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragExit?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragExitCapture?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragLeave?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragLeaveCapture?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragOver?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragOverCapture?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragStart?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDragStartCapture?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDrop?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onDropCapture?: _$react.DragEventHandler<HTMLAnchorElement> | undefined;
-  onMouseDown?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onMouseDownCapture?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onMouseEnter?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onMouseLeave?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onMouseMove?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onMouseMoveCapture?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onMouseOut?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onMouseOutCapture?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onMouseOver?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onMouseOverCapture?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onMouseUp?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onMouseUpCapture?: _$react.MouseEventHandler<HTMLAnchorElement> | undefined;
-  onSelect?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onSelectCapture?: _$react.ReactEventHandler<HTMLAnchorElement> | undefined;
-  onTouchCancel?: _$react.TouchEventHandler<HTMLAnchorElement> | undefined;
-  onTouchCancelCapture?: _$react.TouchEventHandler<HTMLAnchorElement> | undefined;
-  onTouchEnd?: _$react.TouchEventHandler<HTMLAnchorElement> | undefined;
-  onTouchEndCapture?: _$react.TouchEventHandler<HTMLAnchorElement> | undefined;
-  onTouchMove?: _$react.TouchEventHandler<HTMLAnchorElement> | undefined;
-  onTouchMoveCapture?: _$react.TouchEventHandler<HTMLAnchorElement> | undefined;
-  onTouchStart?: _$react.TouchEventHandler<HTMLAnchorElement> | undefined;
-  onTouchStartCapture?: _$react.TouchEventHandler<HTMLAnchorElement> | undefined;
-  onPointerDown?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerDownCapture?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerMove?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerMoveCapture?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerUp?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerUpCapture?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerCancel?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerCancelCapture?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerEnter?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerLeave?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerOver?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerOverCapture?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerOut?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onPointerOutCapture?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onGotPointerCapture?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onGotPointerCaptureCapture?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onLostPointerCapture?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onLostPointerCaptureCapture?: _$react.PointerEventHandler<HTMLAnchorElement> | undefined;
-  onScroll?: _$react.UIEventHandler<HTMLAnchorElement> | undefined;
-  onScrollCapture?: _$react.UIEventHandler<HTMLAnchorElement> | undefined;
-  onScrollEnd?: _$react.UIEventHandler<HTMLAnchorElement> | undefined;
-  onScrollEndCapture?: _$react.UIEventHandler<HTMLAnchorElement> | undefined;
-  onWheel?: _$react.WheelEventHandler<HTMLAnchorElement> | undefined;
-  onWheelCapture?: _$react.WheelEventHandler<HTMLAnchorElement> | undefined;
-  onAnimationStart?: _$react.AnimationEventHandler<HTMLAnchorElement> | undefined;
-  onAnimationStartCapture?: _$react.AnimationEventHandler<HTMLAnchorElement> | undefined;
-  onAnimationEnd?: _$react.AnimationEventHandler<HTMLAnchorElement> | undefined;
-  onAnimationEndCapture?: _$react.AnimationEventHandler<HTMLAnchorElement> | undefined;
-  onAnimationIteration?: _$react.AnimationEventHandler<HTMLAnchorElement> | undefined;
-  onAnimationIterationCapture?: _$react.AnimationEventHandler<HTMLAnchorElement> | undefined;
-  onToggle?: _$react.ToggleEventHandler<HTMLAnchorElement> | undefined;
-  onBeforeToggle?: _$react.ToggleEventHandler<HTMLAnchorElement> | undefined;
-  onTransitionCancel?: _$react.TransitionEventHandler<HTMLAnchorElement> | undefined;
-  onTransitionCancelCapture?: _$react.TransitionEventHandler<HTMLAnchorElement> | undefined;
-  onTransitionEnd?: _$react.TransitionEventHandler<HTMLAnchorElement> | undefined;
-  onTransitionEndCapture?: _$react.TransitionEventHandler<HTMLAnchorElement> | undefined;
-  onTransitionRun?: _$react.TransitionEventHandler<HTMLAnchorElement> | undefined;
-  onTransitionRunCapture?: _$react.TransitionEventHandler<HTMLAnchorElement> | undefined;
-  onTransitionStart?: _$react.TransitionEventHandler<HTMLAnchorElement> | undefined;
-  onTransitionStartCapture?: _$react.TransitionEventHandler<HTMLAnchorElement> | undefined;
+  onCopy?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+  onCopyCapture?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+  onCut?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+  onCutCapture?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+  onPaste?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+  onPasteCapture?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+  onCompositionEnd?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+  onCompositionEndCapture?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+  onCompositionStart?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+  onCompositionStartCapture?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+  onCompositionUpdate?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+  onCompositionUpdateCapture?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+  onFocus?: import("react").FocusEventHandler<HTMLAnchorElement> | undefined;
+  onFocusCapture?: import("react").FocusEventHandler<HTMLAnchorElement> | undefined;
+  onBlur?: import("react").FocusEventHandler<HTMLAnchorElement> | undefined;
+  onBlurCapture?: import("react").FocusEventHandler<HTMLAnchorElement> | undefined;
+  onChange?: import("react").ChangeEventHandler<HTMLAnchorElement, Element> | undefined;
+  onChangeCapture?: import("react").ChangeEventHandler<HTMLAnchorElement, Element> | undefined;
+  onBeforeInput?: import("react").InputEventHandler<HTMLAnchorElement> | undefined;
+  onBeforeInputCapture?: import("react").InputEventHandler<HTMLAnchorElement> | undefined;
+  onInput?: import("react").InputEventHandler<HTMLAnchorElement> | undefined;
+  onInputCapture?: import("react").InputEventHandler<HTMLAnchorElement> | undefined;
+  onReset?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onResetCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onSubmit?: import("react").SubmitEventHandler<HTMLAnchorElement> | undefined;
+  onSubmitCapture?: import("react").SubmitEventHandler<HTMLAnchorElement> | undefined;
+  onInvalid?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onInvalidCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onLoad?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onLoadCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onError?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onErrorCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onKeyDown?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+  onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+  onKeyPress?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+  onKeyPressCapture?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+  onKeyUp?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+  onKeyUpCapture?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+  onAbort?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onAbortCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onCanPlay?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onCanPlayCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onCanPlayThrough?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onCanPlayThroughCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onDurationChange?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onDurationChangeCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onEmptied?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onEmptiedCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onEncrypted?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onEncryptedCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onEnded?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onEndedCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onLoadedData?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onLoadedDataCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onLoadedMetadata?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onLoadedMetadataCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onLoadStart?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onLoadStartCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onPause?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onPauseCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onPlay?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onPlayCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onPlaying?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onPlayingCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onProgress?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onProgressCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onRateChange?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onRateChangeCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onSeeked?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onSeekedCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onSeeking?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onSeekingCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onStalled?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onStalledCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onSuspend?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onSuspendCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onTimeUpdate?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onTimeUpdateCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onVolumeChange?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onVolumeChangeCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onWaiting?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onWaitingCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onAuxClick?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onAuxClickCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onClickCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onContextMenu?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onContextMenuCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onDoubleClick?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onDoubleClickCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onDrag?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragEnd?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragEndCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragEnter?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragEnterCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragExit?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragExitCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragLeave?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragLeaveCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragOver?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragOverCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragStart?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDragStartCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDrop?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onDropCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+  onMouseDown?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onMouseDownCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onMouseEnter?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onMouseLeave?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onMouseMove?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onMouseMoveCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onMouseOut?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onMouseOutCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onMouseOver?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onMouseOverCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onMouseUp?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onMouseUpCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+  onSelect?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onSelectCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+  onTouchCancel?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+  onTouchCancelCapture?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+  onTouchEnd?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+  onTouchEndCapture?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+  onTouchMove?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+  onTouchMoveCapture?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+  onTouchStart?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+  onTouchStartCapture?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+  onPointerDown?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerDownCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerMove?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerMoveCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerUp?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerUpCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerCancel?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerCancelCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerEnter?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerLeave?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerOver?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerOverCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerOut?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onPointerOutCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onGotPointerCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onGotPointerCaptureCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onLostPointerCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onLostPointerCaptureCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+  onScroll?: import("react").UIEventHandler<HTMLAnchorElement> | undefined;
+  onScrollCapture?: import("react").UIEventHandler<HTMLAnchorElement> | undefined;
+  onScrollEnd?: import("react").UIEventHandler<HTMLAnchorElement> | undefined;
+  onScrollEndCapture?: import("react").UIEventHandler<HTMLAnchorElement> | undefined;
+  onWheel?: import("react").WheelEventHandler<HTMLAnchorElement> | undefined;
+  onWheelCapture?: import("react").WheelEventHandler<HTMLAnchorElement> | undefined;
+  onAnimationStart?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+  onAnimationStartCapture?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+  onAnimationEnd?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+  onAnimationEndCapture?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+  onAnimationIteration?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+  onAnimationIterationCapture?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+  onToggle?: import("react").ToggleEventHandler<HTMLAnchorElement> | undefined;
+  onBeforeToggle?: import("react").ToggleEventHandler<HTMLAnchorElement> | undefined;
+  onTransitionCancel?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+  onTransitionCancelCapture?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+  onTransitionEnd?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+  onTransitionEndCapture?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+  onTransitionRun?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+  onTransitionRunCapture?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+  onTransitionStart?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+  onTransitionStartCapture?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
 }, HTMLElement>;
 //#endregion
 //#region ../../src/react/router/components/NestedView.d.ts
@@ -1010,7 +1171,7 @@ interface NestedViewProps {
   children?: ReactNode;
   errorBoundary?: false | ((error: Error, reset: () => void) => ReactNode);
 }
-declare const _default: _$react.MemoExoticComponent<(props: NestedViewProps) => _$react_jsx_runtime0.JSX.Element>;
+declare const _default: import("react").MemoExoticComponent<(props: NestedViewProps) => import("react/jsx-runtime").JSX.Element>;
 //#endregion
 //#region ../../src/react/router/components/NotFound.d.ts
 /**
@@ -1018,7 +1179,7 @@ declare const _default: _$react.MemoExoticComponent<(props: NestedViewProps) =>
  */
 declare const NotFound: (props: {
   style?: CSSProperties;
-}) => _$react_jsx_runtime0.JSX.Element;
+}) => import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region ../../src/react/router/contexts/RouterLayerContext.d.ts
 interface RouterLayerContextValue {
@@ -1026,7 +1187,7 @@ interface RouterLayerContextValue {
   path: string;
   onError: ErrorHandler;
 }
-declare const RouterLayerContext: _$react.Context<RouterLayerContextValue | undefined>;
+declare const RouterLayerContext: import("react").Context<RouterLayerContextValue | undefined>;
 //#endregion
 //#region ../../src/react/router/hooks/useActive.d.ts
 interface UseActiveOptions {
@@ -1047,11 +1208,43 @@ interface UseActiveHook {
 //#region ../../src/react/router/hooks/useQueryParams.d.ts
 /**
  * Hook to manage query parameters in the URL using a defined schema.
+ *
+ * Two storage formats are supported via {@link UseQueryParamsHookOptions.format}:
+ * - `"base64"` (default) packs the whole object into a single opaque param
+ *   (named by `key`, default `q`) — e.g. `?q=eyJ0YWIiOiJzZWN1cml0eSJ9`.
+ * - `"querystring"` spreads each schema field across its own readable param —
+ *   e.g. `?tab=security`. In this mode `key` is ignored.
+ *
+ * By default the URL is updated with `replaceState` (no new history entry).
+ * Pass `push: true` to add a history entry instead, so the browser back
+ * button steps back through previous values.
+ *
+ * @example
+ * const [params, setParams] = useQueryParams(
+ *   t.object({ tab: t.optional(t.string()) }),
+ *   { format: "querystring" },
+ * );
+ * // params.tab reads from `?tab=…`; setParams({ tab: "security" }) writes it.
  */
 declare const useQueryParams: <T extends TObject>(schema: T, options?: UseQueryParamsHookOptions) => [Partial<Static<T>>, (data: Static<T>) => void];
 interface UseQueryParamsHookOptions {
+  /**
+   * How the params are stored in the URL.
+   * - `"base64"` (default): the whole object in one opaque param (`key`).
+   * - `"querystring"`: each schema field as its own readable param (`key`
+   *   is ignored).
+   */
   format?: "base64" | "querystring";
+  /**
+   * Param name used in `"base64"` format. Defaults to `"q"`. Ignored in
+   * `"querystring"` format, where the schema's field names are used.
+   */
   key?: string;
+  /**
+   * When `true`, updates push a new browser-history entry (`pushState`) so
+   * the back button returns to the previous value. Defaults to `false`,
+   * which replaces the current entry in place (`replaceState`).
+   */
   push?: boolean;
 }
 //#endregion
@@ -1153,12 +1346,13 @@ interface BrowserRoute extends Route {
  * Implementation of AlephaRouter for React in browser environment.
  */
 declare class ReactBrowserRouterProvider extends RouterProvider<BrowserRoute> {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly alepha: Alepha;
   protected readonly pageApi: ReactPageProvider;
   protected readonly browserHeadProvider: BrowserHeadProvider;
+  protected readonly localeProvider: RouterLocaleProvider;
   add(entry: PageRouteEntry): void;
-  protected readonly configure: _$alepha.HookPrimitive<"configure">;
+  protected readonly configure: import("alepha").HookPrimitive<"configure">;
   transition(url: URL, previous?: PreviousLayerData[], meta?: {}, isStale?: () => boolean): Promise<string | undefined>;
   root(state: ReactRouterState): ReactNode;
 }
@@ -1167,8 +1361,8 @@ declare class ReactBrowserRouterProvider extends RouterProvider<BrowserRoute> {
 /**
  * React browser renderer configuration atom
  */
-declare const reactBrowserOptions: _$alepha.Atom<_$typebox.TObject<{
-  scrollRestoration: _$typebox.TUnsafe<"top" | "manual">;
+declare const reactBrowserOptions: import("alepha").Atom<import("typebox").TObject<{
+  scrollRestoration: import("typebox").TUnsafe<"top" | "manual">;
   /**
    * Intercept clicks on plain `<a href="/...">` anchors and route them
    * through the SPA router, so authors don't need `<Link>` everywhere
@@ -1178,7 +1372,7 @@ declare const reactBrowserOptions: _$alepha.Atom<_$typebox.TObject<{
    * `_self`, `download`, `data-no-router`, non-http(s) schemes, hash-only
    * hrefs, external origins, and clicks already `defaultPrevented`.
    */
-  interceptAnchorClicks: _$typebox.TBoolean;
+  interceptAnchorClicks: import("typebox").TBoolean;
 }>, "alepha.react.browser.options">;
 type ReactBrowserRendererOptions = Static<typeof reactBrowserOptions.schema>;
 declare module "alepha" {
@@ -1187,7 +1381,7 @@ declare module "alepha" {
   }
 }
 declare class ReactBrowserProvider {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly client: LinkProvider;
   protected readonly alepha: Alepha;
   protected readonly router: ReactBrowserRouterProvider;
@@ -1236,8 +1430,8 @@ declare class ReactBrowserProvider {
    * Get embedded layers from the server.
    */
   protected getHydrationState(): ReactHydrationState | undefined;
-  protected readonly onTransitionEnd: _$alepha.HookPrimitive<"react:transition:end">;
-  readonly ready: _$alepha.HookPrimitive<"ready">;
+  protected readonly onTransitionEnd: import("alepha").HookPrimitive<"react:transition:end">;
+  readonly ready: import("alepha").HookPrimitive<"ready">;
   /**
    * Attach a delegated click listener that routes plain `<a href="/...">`
    * clicks through the SPA router. Returns a detach function (used in tests).
@@ -1269,40 +1463,40 @@ interface RouterRenderOptions {
 /**
  * Schema for the SSR manifest atom.
  */
-declare const ssrManifestAtomSchema: _$typebox.TObject<{
+declare const ssrManifestAtomSchema: import("typebox").TObject<{
   /**
    * Base path for assets (from Vite's base config).
    * Used to prefix asset URLs when serving from a subpath.
    * @example "/devtools" or "/"
    */
-  base: _$typebox.TOptional<_$typebox.TString>;
+  base: import("typebox").TOptional<import("typebox").TString>;
   /**
    * Preload manifest mapping short keys to source paths.
    * Generated by viteAlephaSsrPreload plugin at build time.
    */
-  preload: _$typebox.TOptional<_$typebox.TRecord<"^.*$", _$typebox.TString>>;
+  preload: import("typebox").TOptional<import("typebox").TRecord<"^.*$", import("typebox").TString>>;
   /**
    * Client manifest mapping source files to their output information.
    * Only includes fields actually used for preloading.
    */
-  client: _$typebox.TOptional<_$typebox.TRecord<"^.*$", _$typebox.TObject<{
-    file: _$typebox.TString;
-    isEntry: _$typebox.TOptional<_$typebox.TBoolean>;
-    imports: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-    css: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
+  client: import("typebox").TOptional<import("typebox").TRecord<"^.*$", import("typebox").TObject<{
+    file: import("typebox").TString;
+    isEntry: import("typebox").TOptional<import("typebox").TBoolean>;
+    imports: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+    css: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
   }>>>;
   /**
    * Dev mode head content.
    * Contains pre-transformed scripts injected by Vite and plugins (React, etc.).
    * Only set in dev mode via ViteDevServerProvider.
    */
-  devHead: _$typebox.TOptional<_$typebox.TString>;
+  devHead: import("typebox").TOptional<import("typebox").TString>;
   /**
    * Auto-detected favicon path and MIME type.
    * Format: "type:path" (e.g., "image/svg+xml:/favicon.svg").
    * Set at build/dev time by scanning the public directory.
    */
-  favicon: _$typebox.TOptional<_$typebox.TString>;
+  favicon: import("typebox").TOptional<import("typebox").TString>;
 }>;
 /**
  * Type for the SSR manifest schema.
@@ -1486,7 +1680,7 @@ declare class ReactPreloadProvider {
   /**
    * Add Link header to HTML responses for asset preloading.
    */
-  protected readonly onResponse: _$alepha.HookPrimitive<"server:onResponse">;
+  protected readonly onResponse: import("alepha").HookPrimitive<"server:onResponse">;
 }
 //#endregion
 //#region ../../src/react/router/providers/ReactServerTemplateProvider.d.ts
@@ -1497,7 +1691,7 @@ declare class ReactPreloadProvider {
  * Pre-encodes static parts as Uint8Array for zero-copy streaming.
  */
 declare class ReactServerTemplateProvider {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly alepha: Alepha;
   /**
    * Shared TextEncoder - reused across all requests.
@@ -1650,7 +1844,7 @@ declare class ReactServerProvider {
     readonly expires: "0";
   };
   protected readonly fs: FileSystemProvider;
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly alepha: Alepha;
   protected readonly env: {
     REACT_SSR_ENABLED?: boolean | undefined;
@@ -1661,6 +1855,7 @@ declare class ReactServerProvider {
   protected readonly serverStaticProvider: ServerStaticProvider;
   protected readonly serverRouterProvider: ServerRouterProvider;
   protected readonly ssrManifestProvider: SSRManifestProvider;
+  protected readonly localeProvider: RouterLocaleProvider;
   /**
    * Cached check for ServerLinksProvider - avoids has() lookup per request.
    */
@@ -1679,7 +1874,7 @@ declare class ReactServerProvider {
   /**
    * Configure the React server provider.
    */
-  readonly onConfigure: _$alepha.HookPrimitive<"configure">;
+  readonly onConfigure: import("alepha").HookPrimitive<"configure">;
   /**
    * Register all pages as server routes.
    */
@@ -1735,6 +1930,18 @@ declare class ReactServerProvider {
    * @param state - The router state
    * @returns Render result with redirect or React stream
    */
+  /**
+   * Inject SEO `hreflang` alternate links for the current route when
+   * locale-prefix routing is enabled. Each registered locale gets an absolute
+   * alternate URL (the default locale stays unprefixed), plus an `x-default`
+   * pointing at the unprefixed URL — this is what lets crawlers index every
+   * language. Also sets a best-effort `<html lang>` for the non-streaming /
+   * prerender path; the streamed path's `<html lang>` is finalized on the
+   * client (the early HTML head is flushed before the route is known).
+   *
+   * No-op unless `routing: "prefix"` is enabled on the i18n module.
+   */
+  protected injectLocaleHead(state: ReactRouterState): void;
   protected renderPage(route: PageRoute, state: ReactRouterState): Promise<{
     redirect?: string;
     reactStream?: ReadableStream<Uint8Array>;
@@ -1752,8 +1959,8 @@ declare class ReactServerProvider {
    */
   protected streamToString(stream: ReadableStream<Uint8Array>): Promise<string>;
 }
-declare const envSchema: _$alepha.TObject<{
-  REACT_SSR_ENABLED: _$alepha.TOptional<_$alepha.TBoolean>;
+declare const envSchema: import("alepha").TObject<{
+  REACT_SSR_ENABLED: import("alepha").TOptional<import("alepha").TBoolean>;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
@@ -1769,11 +1976,11 @@ declare module "alepha" {
  * Matches paths whose last segment contains a dot followed by 1-10 alphanumeric characters.
  */
 declare const DEFAULT_STATIC_FILE_PATTERN = "\\.[a-zA-Z0-9]{1,10}$";
-declare const reactServerOptions: _$alepha.Atom<_$alepha.TObject<{
-  publicDir: _$typebox.TString;
-  staticServer: _$alepha.TObject<{
-    disabled: _$alepha.TBoolean;
-    path: _$typebox.TString;
+declare const reactServerOptions: import("alepha").Atom<import("alepha").TObject<{
+  publicDir: import("typebox").TString;
+  staticServer: import("alepha").TObject<{
+    disabled: import("alepha").TBoolean;
+    path: import("typebox").TString;
   }>;
 }>, "alepha.react.server.options">;
 type ReactServerProviderOptions = Static<typeof reactServerOptions.schema>;
@@ -1787,6 +1994,11 @@ declare module "alepha" {
 declare module "alepha" {
   interface State {
     "alepha.react.router.state"?: ReactRouterState;
+    /**
+     * The active locale path-prefix (e.g. `"fr"`), when `routing: "prefix"` is
+     * enabled on the i18n module. Empty/absent for the default locale.
+     */
+    "alepha.react.router.locale"?: string;
   }
   interface Hooks {
     /**
@@ -1859,7 +2071,7 @@ declare module "alepha" {
  * @see {@link $page}
  * @module alepha.react.router
  */
-declare const AlephaReactRouter: _$alepha.Service<_$alepha.Module>;
+declare const AlephaReactRouter: import("alepha").Service<import("alepha").Module>;
 //#endregion
-export { $page, AlephaReactRouter, AnchorProps, ClientManifest, ConcretePageRoute, CreateLayersResult, DEFAULT_STATIC_FILE_PATTERN, EntryAssets, ErrorHandler, ErrorViewer, ErrorViewerProps, HydrationData, Layer, Link, type LinkProps, _default as NestedView, NestedViewProps, NotFound, PAGE_PRELOAD_KEY, PageAnimation, PageConfigSchema, PageLoader, PagePrimitive, PagePrimitiveOptions, PagePrimitiveRenderOptions, PagePrimitiveRenderResult, PageRequestConfig, PageRoute, PageRouteEntry, PreloadManifest, PreviousLayerData, ReactBrowserProvider, ReactBrowserRendererOptions, ReactHydrationState, ReactPageProvider, ReactPageService, ReactPreloadProvider, ReactRouter, ReactRouterState, ReactServerProvider, ReactServerProviderOptions, ReactServerTemplateProvider, Redirection, RouterLayerContext, RouterLayerContextValue, type RouterPushOptions, RouterRenderOptions, RouterStackItem, SSRManifestProvider, TPropsDefault, TPropsParentDefault, UseActiveHook, UseActiveOptions, UseQueryParamsHookOptions, VirtualRouter, isPageRoute, reactBrowserOptions, reactPageOptions, reactServerOptions, useActive, useQueryParams, useRouter, useRouterState };
+export { $page, AlephaReactRouter, AnchorProps, ClientManifest, ConcretePageRoute, CreateLayersResult, DEFAULT_STATIC_FILE_PATTERN, EntryAssets, ErrorHandler, ErrorViewer, type ErrorViewerProps, HydrationData, Layer, Link, type LinkProps, _default as NestedView, type NestedViewProps, NotFound, PAGE_PRELOAD_KEY, PageAnimation, PageCanContext, PageConfigSchema, PageLoader, PageNav, PagePrimitive, PagePrimitiveOptions, PagePrimitiveRenderOptions, PagePrimitiveRenderResult, PageRequestConfig, PageRoute, PageRouteEntry, PreloadManifest, PreviousLayerData, ReactBrowserProvider, ReactBrowserRendererOptions, ReactHydrationState, ReactPageProvider, ReactPageService, ReactPreloadProvider, ReactRouter, ReactRouterState, ReactServerProvider, ReactServerProviderOptions, ReactServerTemplateProvider, Redirection, RootComponentsProvider, RouterLayerContext, RouterLayerContextValue, RouterLocaleProvider, RouterPushOptions, RouterRenderOptions, RouterStackItem, SSRManifestProvider, TPropsDefault, TPropsParentDefault, UseActiveHook, UseActiveOptions, UseQueryParamsHookOptions, VirtualRouter, isPageRoute, reactBrowserOptions, reactPageOptions, reactServerOptions, useActive, useQueryParams, useRouter, useRouterState };
 //# sourceMappingURL=index.d.ts.map