alepha 0.22.0 → 0.24.0

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

@@ -1,4 +1,4 @@
-import { Alepha, AlephaError, Async, KIND, Middleware, Primitive, Static, TObject, TSchema } from "alepha";
+import { Alepha, AlephaError, Async, KIND, Middleware, Primitive, SchemaValidator, 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";
@@ -7,7 +7,6 @@ import { AnchorHTMLAttributes, CSSProperties, FC, ReactNode } from "react";
 import { ServerStaticProvider } from "alepha/server/static";
 import { FileSystemProvider } from "alepha/system";
 import { Route, RouterProvider } from "alepha/router";
-
 //#region ../../src/react/router/constants/PAGE_PRELOAD_KEY.d.ts
 /**
  * Symbol key for SSR module preloading path.
@@ -40,23 +39,97 @@ declare class Redirection extends AlephaError {
   constructor(redirect: string);
 }
 //#endregion
-//#region ../../src/react/router/providers/ReactPageProvider.d.ts
-declare const reactPageOptions: import("alepha").Atom<import("typebox").TObject<{
+//#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;
   /**
-   * Enable React StrictMode wrapper.
+   * Locales that carry a URL prefix — every known locale except the default.
    */
-  strictMode: import("typebox").TBoolean;
+  get prefixedLocales(): string[];
   /**
-   * 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,
-   * SSR is skipped and a plain 404 response is returned instead.
+   * Splits a leading locale segment off a pathname.
    *
-   * Set to empty string to disable this behavior.
+   * - `/fr/about` → `{ locale: "fr", pathname: "/about" }` when `fr` is a
+   *   prefixed locale.
+   * - `/about` → `{ locale: defaultLocale, pathname: "/about" }`.
    *
-   * @default "\\.[a-zA-Z0-9]{1,10}$"
+   * 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 `/`).
    */
-  staticFilePattern: import("typebox").TString;
-}>, "alepha.react.page.options">;
+  protected normalize(pathname: string): string;
+}
+//#endregion
+//#region ../../src/react/router/providers/ReactPageProvider.d.ts
+declare const reactPageOptions: import("alepha").Atom<import("zod").ZodObject<{
+  strictMode: import("zod").ZodDefault<import("zod").ZodBoolean>;
+  staticFilePattern: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, "alepha.react.page.options">;
 /**
  * Handle page routes for React applications. (Browser and Server)
  */
@@ -68,6 +141,8 @@ declare class ReactPageProvider {
     staticFilePattern: string;
   }>;
   protected readonly alepha: Alepha;
+  protected readonly rootComponentsProvider: RootComponentsProvider;
+  protected readonly localeProvider: RouterLocaleProvider;
   protected readonly pages: PageRoute[];
   protected nextIdCursor: number;
   protected readonly configure: import("alepha").HookPrimitive<"configure">;
@@ -269,8 +344,8 @@ declare abstract class ReactPageService {
  * const userProfile = $page({
  *   path: "/users/:id",
  *   schema: {
- *     params: t.object({ id: t.integer() }),
- *     query: t.object({ tab: t.optional(t.text()) })
+ *     params: z.object({ id: z.integer() }),
+ *     query: z.object({ tab: z.text().optional() })
  *   },
  *   loader: async ({ params }) => {
  *     const user = await userApi.getUser(params.id);
@@ -770,13 +845,219 @@ type CssAnimation = {
   timing?: string;
 };
 //#endregion
+//#region ../../src/react/router/services/ReactRouter.d.ts
+interface RouterPushOptions {
+  replace?: boolean;
+  params?: Record<string, string>;
+  query?: Record<string, string>;
+  meta?: Record<string, any>;
+  /**
+   * Recreate the whole page, ignoring the current state.
+   */
+  force?: boolean;
+}
+/**
+ * Friendly browser router API.
+ *
+ * Can be safely used server-side, but most methods will be no-op.
+ */
+declare class ReactRouter<T extends object> {
+  protected readonly alepha: Alepha;
+  protected readonly pageApi: ReactPageProvider;
+  get state(): ReactRouterState;
+  get pages(): import("alepha/react/router").PageRoute[];
+  get concretePages(): import("alepha/react/router").ConcretePageRoute[];
+  get browser(): ReactBrowserProvider | undefined;
+  isActive(href: string, options?: {
+    startWith?: boolean;
+  }): boolean;
+  node(name: keyof VirtualRouter<T> | string, config?: {
+    params?: Record<string, any>;
+    query?: Record<string, any>;
+  }): any;
+  path(name: keyof VirtualRouter<T> | string, config?: {
+    params?: Record<string, any>;
+    query?: Record<string, any>;
+  }): string;
+  /**
+   * Reload the current page.
+   * This is equivalent to calling `go()` with the current pathname and search.
+   */
+  reload(): Promise<void>;
+  getURL(): URL;
+  get location(): Location;
+  get current(): ReactRouterState;
+  get pathname(): string;
+  get query(): Record<string, string>;
+  back(): Promise<void>;
+  forward(): Promise<void>;
+  invalidate(props?: Record<string, any>): Promise<void>;
+  push(path: string, options?: RouterPushOptions): Promise<void>;
+  push(path: keyof VirtualRouter<T>, options?: RouterPushOptions): Promise<void>;
+  anchor(path: string, options?: RouterPushOptions): AnchorProps;
+  anchor(path: keyof VirtualRouter<T>, options?: RouterPushOptions): AnchorProps;
+  /**
+   * Prepend the base URL to the given path.
+   */
+  base(path: string): string;
+  /**
+   * Set query params.
+   *
+   * @param record
+   * @param options
+   */
+  setQueryParams(record: Record<string, any> | ((queryParams: Record<string, any>) => Record<string, any>), options?: {
+    /**
+     * If true, this will add a new entry to the history stack.
+     */
+    push?: boolean;
+  }): void;
+}
+type VirtualRouter<T> = { [K in keyof T as T[K] extends PagePrimitive ? K : never]: T[K]; };
+//#endregion
+//#region ../../src/react/router/providers/ReactBrowserRouterProvider.d.ts
+interface BrowserRoute extends Route {
+  page: PageRoute;
+}
+/**
+ * Implementation of AlephaRouter for React in browser environment.
+ */
+declare class ReactBrowserRouterProvider extends RouterProvider<BrowserRoute> {
+  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: import("alepha").HookPrimitive<"configure">;
+  transition(url: URL, previous?: PreviousLayerData[], meta?: {}, isStale?: () => boolean): Promise<string | undefined>;
+  root(state: ReactRouterState): ReactNode;
+}
+//#endregion
+//#region ../../src/react/router/providers/ReactBrowserProvider.d.ts
+/**
+ * React browser renderer configuration atom
+ */
+declare const reactBrowserOptions: import("alepha").Atom<import("zod").ZodObject<{
+  scrollRestoration: import("zod").ZodEnum<{
+    manual: "manual";
+    top: "top";
+  }>;
+  interceptAnchorClicks: import("zod").ZodDefault<import("zod").ZodBoolean>;
+}, import("zod/v4/core").$strip>, "alepha.react.browser.options">;
+type ReactBrowserRendererOptions = Static<typeof reactBrowserOptions.schema>;
+declare module "alepha" {
+  interface State {
+    [reactBrowserOptions.key]: ReactBrowserRendererOptions;
+  }
+}
+declare class ReactBrowserProvider {
+  protected readonly log: import("alepha/logger").Logger;
+  protected readonly client: LinkProvider;
+  protected readonly alepha: Alepha;
+  protected readonly router: ReactBrowserRouterProvider;
+  protected readonly dateTimeProvider: DateTimeProvider;
+  protected readonly browserHeadProvider: BrowserHeadProvider;
+  protected readonly validator: SchemaValidator;
+  protected readonly options: Readonly<{
+    scrollRestoration: "manual" | "top";
+    interceptAnchorClicks: boolean;
+  }>;
+  get rootId(): string;
+  protected getRootElement(): HTMLElement;
+  transitioning?: {
+    to: string;
+    from?: string;
+  };
+  /**
+   * Monotonic counter used to detect stale (superseded) transitions.
+   *
+   * Each call to `render()` captures `++this.transitionId` and any
+   * subsequent `render()` invalidates older in-flight transitions.
+   * This prevents a slow page from racing past a newer navigation
+   * (e.g. user clicks /pageA which has a 2s loader, then clicks /pageB
+   * — pageB must remain the committed page).
+   */
+  protected transitionId: number;
+  get state(): ReactRouterState;
+  /**
+   * Accessor for Document DOM API.
+   */
+  get document(): Document;
+  /**
+   * Accessor for History DOM API.
+   */
+  get history(): History;
+  /**
+   * Accessor for Location DOM API.
+   */
+  get location(): Location;
+  get base(): string;
+  get url(): string;
+  pushState(path: string, replace?: boolean): void;
+  invalidate(props?: Record<string, any>): Promise<void>;
+  push(url: string, options?: RouterPushOptions): Promise<void>;
+  protected render(options?: RouterRenderOptions): Promise<void>;
+  /**
+   * Get embedded layers from the server.
+   */
+  protected getHydrationState(): ReactHydrationState | undefined;
+  /**
+   * Apply the SSR hydration payload (the `#__ssr` script tag) to the atom
+   * store.
+   *
+   * Every key except `alepha.react.router.layers` is treated as an atom
+   * value. A registered atom's value is explicitly schema-validated: an
+   * invalid value is dropped (warn + keep the atom's default) instead of
+   * being trusted, so a tampered payload can't smuggle bad data into a
+   * validated atom. Atoms not registered yet fall through to
+   * `Alepha.set()`, which lets `StateManager.register()` decode them
+   * against the schema the moment they first get used.
+   *
+   * `alepha.react.router.layers` is deliberately skipped by this loop: it
+   * carries render instructions (`part`, `name`, `config`, `props`,
+   * `error`), not atom values. Those are NOT hardened here and are trusted
+   * as-is from the SSR payload — a tampered payload can still influence
+   * rendering through this key. Validating router layers is separate,
+   * future work; this method only guarantees atom values.
+   */
+  protected applyHydration(hydration: ReactHydrationState): void;
+  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).
+   *
+   * Bails out on modifier keys, non-primary mouse buttons, `target`, `download`,
+   * `data-no-router`, hash-only/external/non-http hrefs, and already-prevented
+   * events. Honors the runtime `interceptAnchorClicks` flag.
+   */
+  protected attachAnchorInterceptor(): () => void;
+  protected stripBase(path: string): string;
+}
+type ReactHydrationState = {
+  "alepha.react.router.layers"?: Array<PreviousLayerData>;
+} & {
+  [key: string]: any;
+};
+interface RouterRenderOptions {
+  url?: string;
+  previous?: PreviousLayerData[];
+  meta?: Record<string, any>;
+  /**
+   * Transition id used to detect supersession by a newer navigation.
+   * When omitted, render() allocates a fresh id internally.
+   */
+  transitionId?: number;
+}
+//#endregion
 //#region ../../src/react/router/components/ErrorViewer.d.ts
 interface ErrorViewerProps {
   error: Error;
   alepha: Alepha;
   onRetry?: () => void;
 }
-declare const ErrorViewer: (props: ErrorViewerProps) => import("react/jsx-runtime").JSX.Element;
+declare const ErrorViewer: (props: ErrorViewerProps) => import("react").JSX.Element;
 //#endregion
 //#region ../../src/react/router/components/Link.d.ts
 interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
@@ -788,123 +1069,6 @@ interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
  * It's a simple wrapper around an anchor (`<a>`) element using the `useRouter` hook.
  */
 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?: import("react").HTMLAttributeAnchorTarget | undefined;
-  type?: string | undefined;
-  referrerPolicy?: import("react").HTMLAttributeReferrerPolicy | undefined;
-  defaultChecked?: boolean | undefined;
-  defaultValue?: string | number | readonly string[] | undefined;
-  suppressContentEditableWarning?: boolean | undefined;
-  suppressHydrationWarning?: boolean | undefined;
-  accessKey?: string | undefined;
-  autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {});
-  autoFocus?: boolean | undefined;
-  className?: string | undefined;
-  contentEditable?: (boolean | "true" | "false") | "inherit" | "plaintext-only" | undefined;
-  contextMenu?: string | undefined;
-  dir?: string | undefined;
-  draggable?: (boolean | "true" | "false") | undefined;
-  enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined;
-  hidden?: boolean | undefined;
-  id?: string | undefined;
-  lang?: string | undefined;
-  nonce?: string | undefined;
-  slot?: string | undefined;
-  spellCheck?: (boolean | "true" | "false") | undefined;
-  style?: import("react").CSSProperties | undefined;
-  tabIndex?: number | undefined;
-  title?: string | undefined;
-  translate?: "yes" | "no" | undefined;
-  radioGroup?: string | undefined;
-  role?: import("react").AriaRole | undefined;
-  about?: string | undefined;
-  content?: string | undefined;
-  datatype?: string | undefined;
-  inlist?: any;
-  prefix?: string | undefined;
-  property?: string | undefined;
-  rel?: string | undefined;
-  resource?: string | undefined;
-  rev?: string | undefined;
-  typeof?: string | undefined;
-  vocab?: string | undefined;
-  autoCorrect?: string | undefined;
-  autoSave?: string | undefined;
-  color?: string | undefined;
-  itemProp?: string | undefined;
-  itemScope?: boolean | undefined;
-  itemType?: string | undefined;
-  itemID?: string | undefined;
-  itemRef?: string | undefined;
-  results?: number | undefined;
-  security?: string | undefined;
-  unselectable?: "on" | "off" | undefined;
-  popover?: "" | "auto" | "manual" | "hint" | undefined;
-  popoverTargetAction?: "toggle" | "show" | "hide" | undefined;
-  popoverTarget?: string | undefined;
-  inert?: boolean | undefined;
-  inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined;
-  is?: string | undefined;
-  exportparts?: string | undefined;
-  part?: string | undefined;
-  "aria-activedescendant"?: string | undefined;
-  "aria-atomic"?: (boolean | "true" | "false") | undefined;
-  "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined;
-  "aria-braillelabel"?: string | undefined;
-  "aria-brailleroledescription"?: string | undefined;
-  "aria-busy"?: (boolean | "true" | "false") | undefined;
-  "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined;
-  "aria-colcount"?: number | undefined;
-  "aria-colindex"?: number | undefined;
-  "aria-colindextext"?: string | undefined;
-  "aria-colspan"?: number | undefined;
-  "aria-controls"?: string | undefined;
-  "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined;
-  "aria-describedby"?: string | undefined;
-  "aria-description"?: string | undefined;
-  "aria-details"?: string | undefined;
-  "aria-disabled"?: (boolean | "true" | "false") | undefined;
-  "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined;
-  "aria-errormessage"?: string | undefined;
-  "aria-expanded"?: (boolean | "true" | "false") | undefined;
-  "aria-flowto"?: string | undefined;
-  "aria-grabbed"?: (boolean | "true" | "false") | undefined;
-  "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined;
-  "aria-hidden"?: (boolean | "true" | "false") | undefined;
-  "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined;
-  "aria-keyshortcuts"?: string | undefined;
-  "aria-label"?: string | undefined;
-  "aria-labelledby"?: string | undefined;
-  "aria-level"?: number | undefined;
-  "aria-live"?: "off" | "assertive" | "polite" | undefined;
-  "aria-modal"?: (boolean | "true" | "false") | undefined;
-  "aria-multiline"?: (boolean | "true" | "false") | undefined;
-  "aria-multiselectable"?: (boolean | "true" | "false") | undefined;
-  "aria-orientation"?: "horizontal" | "vertical" | undefined;
-  "aria-owns"?: string | undefined;
-  "aria-placeholder"?: string | undefined;
-  "aria-posinset"?: number | undefined;
-  "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined;
-  "aria-readonly"?: (boolean | "true" | "false") | undefined;
-  "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined;
-  "aria-required"?: (boolean | "true" | "false") | undefined;
-  "aria-roledescription"?: string | undefined;
-  "aria-rowcount"?: number | undefined;
-  "aria-rowindex"?: number | undefined;
-  "aria-rowindextext"?: string | undefined;
-  "aria-rowspan"?: number | undefined;
-  "aria-selected"?: (boolean | "true" | "false") | undefined;
-  "aria-setsize"?: number | undefined;
-  "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined;
-  "aria-valuemax"?: number | undefined;
-  "aria-valuemin"?: number | undefined;
-  "aria-valuenow"?: number | undefined;
-  "aria-valuetext"?: string | undefined;
   children?: import("react").ReactNode | undefined;
   dangerouslySetInnerHTML?: {
     __html: string | TrustedHTML;
@@ -1076,6 +1240,123 @@ declare const Link: (props: LinkProps) => import("react").DetailedReactHTMLEleme
   onTransitionRunCapture?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
   onTransitionStart?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
   onTransitionStartCapture?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+  "aria-activedescendant"?: string | undefined;
+  "aria-atomic"?: ("false" | "true" | boolean) | undefined;
+  "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined;
+  "aria-braillelabel"?: string | undefined;
+  "aria-brailleroledescription"?: string | undefined;
+  "aria-busy"?: ("false" | "true" | boolean) | undefined;
+  "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined;
+  "aria-colcount"?: number | undefined;
+  "aria-colindex"?: number | undefined;
+  "aria-colindextext"?: string | undefined;
+  "aria-colspan"?: number | undefined;
+  "aria-controls"?: string | undefined;
+  "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined;
+  "aria-describedby"?: string | undefined;
+  "aria-description"?: string | undefined;
+  "aria-details"?: string | undefined;
+  "aria-disabled"?: ("false" | "true" | boolean) | undefined;
+  "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined;
+  "aria-errormessage"?: string | undefined;
+  "aria-expanded"?: ("false" | "true" | boolean) | undefined;
+  "aria-flowto"?: string | undefined;
+  "aria-grabbed"?: ("false" | "true" | boolean) | undefined;
+  "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined;
+  "aria-hidden"?: ("false" | "true" | boolean) | undefined;
+  "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined;
+  "aria-keyshortcuts"?: string | undefined;
+  "aria-label"?: string | undefined;
+  "aria-labelledby"?: string | undefined;
+  "aria-level"?: number | undefined;
+  "aria-live"?: "off" | "assertive" | "polite" | undefined;
+  "aria-modal"?: ("false" | "true" | boolean) | undefined;
+  "aria-multiline"?: ("false" | "true" | boolean) | undefined;
+  "aria-multiselectable"?: ("false" | "true" | boolean) | undefined;
+  "aria-orientation"?: "horizontal" | "vertical" | undefined;
+  "aria-owns"?: string | undefined;
+  "aria-placeholder"?: string | undefined;
+  "aria-posinset"?: number | undefined;
+  "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined;
+  "aria-readonly"?: ("false" | "true" | boolean) | undefined;
+  "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined;
+  "aria-required"?: ("false" | "true" | boolean) | undefined;
+  "aria-roledescription"?: string | undefined;
+  "aria-rowcount"?: number | undefined;
+  "aria-rowindex"?: number | undefined;
+  "aria-rowindextext"?: string | undefined;
+  "aria-rowspan"?: number | undefined;
+  "aria-selected"?: ("false" | "true" | boolean) | undefined;
+  "aria-setsize"?: number | undefined;
+  "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined;
+  "aria-valuemax"?: number | undefined;
+  "aria-valuemin"?: number | undefined;
+  "aria-valuenow"?: number | undefined;
+  "aria-valuetext"?: string | undefined;
+  defaultChecked?: boolean | undefined;
+  defaultValue?: string | number | readonly string[] | undefined;
+  suppressContentEditableWarning?: boolean | undefined;
+  suppressHydrationWarning?: boolean | undefined;
+  accessKey?: string | undefined;
+  autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {});
+  autoFocus?: boolean | undefined;
+  className?: string | undefined;
+  contentEditable?: ("false" | "true" | boolean) | "inherit" | "plaintext-only" | undefined;
+  contextMenu?: string | undefined;
+  dir?: string | undefined;
+  draggable?: ("false" | "true" | boolean) | undefined;
+  enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined;
+  hidden?: boolean | undefined;
+  id?: string | undefined;
+  lang?: string | undefined;
+  nonce?: string | undefined;
+  slot?: string | undefined;
+  spellCheck?: ("false" | "true" | boolean) | undefined;
+  style?: import("react").CSSProperties | undefined;
+  tabIndex?: number | undefined;
+  title?: string | undefined;
+  translate?: "yes" | "no" | undefined;
+  radioGroup?: string | undefined;
+  role?: import("react").AriaRole | undefined;
+  about?: string | undefined;
+  content?: string | undefined;
+  datatype?: string | undefined;
+  inlist?: any;
+  prefix?: string | undefined;
+  property?: string | undefined;
+  rel?: string | undefined;
+  resource?: string | undefined;
+  rev?: string | undefined;
+  typeof?: string | undefined;
+  vocab?: string | undefined;
+  autoCorrect?: string | undefined;
+  autoSave?: string | undefined;
+  color?: string | undefined;
+  itemProp?: string | undefined;
+  itemScope?: boolean | undefined;
+  itemType?: string | undefined;
+  itemID?: string | undefined;
+  itemRef?: string | undefined;
+  results?: number | undefined;
+  security?: string | undefined;
+  unselectable?: "on" | "off" | undefined;
+  popover?: "" | "auto" | "manual" | "hint" | undefined;
+  popoverTargetAction?: "toggle" | "show" | "hide" | undefined;
+  popoverTarget?: string | undefined;
+  inert?: boolean | undefined;
+  inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined;
+  is?: string | undefined;
+  exportparts?: string | undefined;
+  part?: string | undefined;
+  download?: any;
+  hrefLang?: string | undefined;
+  media?: string | undefined;
+  ping?: string | undefined;
+  target?: import("react").HTMLAttributeAnchorTarget | undefined;
+  type?: string | undefined;
+  referrerPolicy?: import("react").HTMLAttributeReferrerPolicy | undefined;
+  href: string;
+  onClick: (ev?: any) => any;
 }, HTMLElement>;
 //#endregion
 //#region ../../src/react/router/components/NestedView.d.ts
@@ -1083,7 +1364,29 @@ interface NestedViewProps {
   children?: ReactNode;
   errorBoundary?: false | ((error: Error, reset: () => void) => ReactNode);
 }
-declare const _default: import("react").MemoExoticComponent<(props: NestedViewProps) => import("react/jsx-runtime").JSX.Element>;
+/**
+ * A component that renders the current view of the nested router layer.
+ *
+ * To be simple, it renders the `element` of the current child page of a parent page.
+ *
+ * @example
+ * ```tsx
+ * import { NestedView } from "alepha/react";
+ *
+ * class App {
+ *   parent = $page({
+ *     component: () => <NestedView />,
+ *   });
+ *
+ *   child = $page({
+ *     parent: this.root,
+ *     component: () => <div>Child Page</div>,
+ *   });
+ * }
+ * ```
+ */
+declare const NestedView: (props: NestedViewProps) => import("react").JSX.Element;
+declare const _default: import("react").MemoExoticComponent<typeof NestedView>;
 //#endregion
 //#region ../../src/react/router/components/NotFound.d.ts
 /**
@@ -1091,7 +1394,7 @@ declare const _default: import("react").MemoExoticComponent<(props: NestedViewPr
  */
 declare const NotFound: (props: {
   style?: CSSProperties;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => import("react").JSX.Element;
 //#endregion
 //#region ../../src/react/router/contexts/RouterLayerContext.d.ts
 interface RouterLayerContextValue {
@@ -1133,7 +1436,7 @@ interface UseActiveHook {
  *
  * @example
  * const [params, setParams] = useQueryParams(
- *   t.object({ tab: t.optional(t.string()) }),
+ *   z.object({ tab: z.string().optional() }),
  *   { format: "querystring" },
  * );
  * // params.tab reads from `?tab=…`; setParams({ tab: "security" }) writes it.
@@ -1180,235 +1483,22 @@ declare const useRouter: <T extends object = any>() => ReactRouter<T>;
 //#region ../../src/react/router/hooks/useRouterState.d.ts
 declare const useRouterState: () => ReactRouterState;
 //#endregion
-//#region ../../src/react/router/services/ReactRouter.d.ts
-interface RouterPushOptions {
-  replace?: boolean;
-  params?: Record<string, string>;
-  query?: Record<string, string>;
-  meta?: Record<string, any>;
-  /**
-   * Recreate the whole page, ignoring the current state.
-   */
-  force?: boolean;
-}
-/**
- * Friendly browser router API.
- *
- * Can be safely used server-side, but most methods will be no-op.
- */
-declare class ReactRouter<T extends object> {
-  protected readonly alepha: Alepha;
-  protected readonly pageApi: ReactPageProvider;
-  get state(): ReactRouterState;
-  get pages(): PageRoute[];
-  get concretePages(): ConcretePageRoute[];
-  get browser(): ReactBrowserProvider | undefined;
-  isActive(href: string, options?: {
-    startWith?: boolean;
-  }): boolean;
-  node(name: keyof VirtualRouter<T> | string, config?: {
-    params?: Record<string, any>;
-    query?: Record<string, any>;
-  }): any;
-  path(name: keyof VirtualRouter<T> | string, config?: {
-    params?: Record<string, any>;
-    query?: Record<string, any>;
-  }): string;
-  /**
-   * Reload the current page.
-   * This is equivalent to calling `go()` with the current pathname and search.
-   */
-  reload(): Promise<void>;
-  getURL(): URL;
-  get location(): Location;
-  get current(): ReactRouterState;
-  get pathname(): string;
-  get query(): Record<string, string>;
-  back(): Promise<void>;
-  forward(): Promise<void>;
-  invalidate(props?: Record<string, any>): Promise<void>;
-  push(path: string, options?: RouterPushOptions): Promise<void>;
-  push(path: keyof VirtualRouter<T>, options?: RouterPushOptions): Promise<void>;
-  anchor(path: string, options?: RouterPushOptions): AnchorProps;
-  anchor(path: keyof VirtualRouter<T>, options?: RouterPushOptions): AnchorProps;
-  /**
-   * Prepend the base URL to the given path.
-   */
-  base(path: string): string;
-  /**
-   * Set query params.
-   *
-   * @param record
-   * @param options
-   */
-  setQueryParams(record: Record<string, any> | ((queryParams: Record<string, any>) => Record<string, any>), options?: {
-    /**
-     * If true, this will add a new entry to the history stack.
-     */
-    push?: boolean;
-  }): void;
-}
-type VirtualRouter<T> = { [K in keyof T as T[K] extends PagePrimitive ? K : never]: T[K] };
-//#endregion
-//#region ../../src/react/router/providers/ReactBrowserRouterProvider.d.ts
-interface BrowserRoute extends Route {
-  page: PageRoute;
-}
-/**
- * Implementation of AlephaRouter for React in browser environment.
- */
-declare class ReactBrowserRouterProvider extends RouterProvider<BrowserRoute> {
-  protected readonly log: import("alepha/logger").Logger;
-  protected readonly alepha: Alepha;
-  protected readonly pageApi: ReactPageProvider;
-  protected readonly browserHeadProvider: BrowserHeadProvider;
-  add(entry: PageRouteEntry): void;
-  protected readonly configure: import("alepha").HookPrimitive<"configure">;
-  transition(url: URL, previous?: PreviousLayerData[], meta?: {}, isStale?: () => boolean): Promise<string | undefined>;
-  root(state: ReactRouterState): ReactNode;
-}
-//#endregion
-//#region ../../src/react/router/providers/ReactBrowserProvider.d.ts
-/**
- * React browser renderer configuration atom
- */
-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
-   * (notably for SSR/Markdown HTML rendered as raw markup).
-   *
-   * Skips: modifier keys, non-primary mouse buttons, `target` other than
-   * `_self`, `download`, `data-no-router`, non-http(s) schemes, hash-only
-   * hrefs, external origins, and clicks already `defaultPrevented`.
-   */
-  interceptAnchorClicks: import("typebox").TBoolean;
-}>, "alepha.react.browser.options">;
-type ReactBrowserRendererOptions = Static<typeof reactBrowserOptions.schema>;
-declare module "alepha" {
-  interface State {
-    [reactBrowserOptions.key]: ReactBrowserRendererOptions;
-  }
-}
-declare class ReactBrowserProvider {
-  protected readonly log: import("alepha/logger").Logger;
-  protected readonly client: LinkProvider;
-  protected readonly alepha: Alepha;
-  protected readonly router: ReactBrowserRouterProvider;
-  protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly browserHeadProvider: BrowserHeadProvider;
-  protected readonly options: Readonly<{
-    scrollRestoration: "top" | "manual";
-    interceptAnchorClicks: boolean;
-  }>;
-  get rootId(): string;
-  protected getRootElement(): HTMLElement;
-  transitioning?: {
-    to: string;
-    from?: string;
-  };
-  /**
-   * Monotonic counter used to detect stale (superseded) transitions.
-   *
-   * Each call to `render()` captures `++this.transitionId` and any
-   * subsequent `render()` invalidates older in-flight transitions.
-   * This prevents a slow page from racing past a newer navigation
-   * (e.g. user clicks /pageA which has a 2s loader, then clicks /pageB
-   * — pageB must remain the committed page).
-   */
-  protected transitionId: number;
-  get state(): ReactRouterState;
-  /**
-   * Accessor for Document DOM API.
-   */
-  get document(): Document;
-  /**
-   * Accessor for History DOM API.
-   */
-  get history(): History;
-  /**
-   * Accessor for Location DOM API.
-   */
-  get location(): Location;
-  get base(): string;
-  get url(): string;
-  pushState(path: string, replace?: boolean): void;
-  invalidate(props?: Record<string, any>): Promise<void>;
-  push(url: string, options?: RouterPushOptions): Promise<void>;
-  protected render(options?: RouterRenderOptions): Promise<void>;
-  /**
-   * Get embedded layers from the server.
-   */
-  protected getHydrationState(): ReactHydrationState | undefined;
-  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).
-   *
-   * Bails out on modifier keys, non-primary mouse buttons, `target`, `download`,
-   * `data-no-router`, hash-only/external/non-http hrefs, and already-prevented
-   * events. Honors the runtime `interceptAnchorClicks` flag.
-   */
-  protected attachAnchorInterceptor(): () => void;
-  protected stripBase(path: string): string;
-}
-type ReactHydrationState = {
-  "alepha.react.router.layers"?: Array<PreviousLayerData>;
-} & {
-  [key: string]: any;
-};
-interface RouterRenderOptions {
-  url?: string;
-  previous?: PreviousLayerData[];
-  meta?: Record<string, any>;
-  /**
-   * Transition id used to detect supersession by a newer navigation.
-   * When omitted, render() allocates a fresh id internally.
-   */
-  transitionId?: number;
-}
-//#endregion
 //#region ../../src/react/router/atoms/ssrManifestAtom.d.ts
 /**
  * Schema for the SSR manifest atom.
  */
-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: import("typebox").TOptional<import("typebox").TString>;
-  /**
-   * Preload manifest mapping short keys to source paths.
-   * Generated by viteAlephaSsrPreload plugin at build time.
-   */
-  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: 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: 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: import("typebox").TOptional<import("typebox").TString>;
-}>;
+declare const ssrManifestAtomSchema: import("zod").ZodObject<{
+  base: import("zod").ZodOptional<import("zod").ZodString>;
+  preload: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+  client: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+    file: import("zod").ZodString;
+    isEntry: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    imports: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    css: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+  }, import("zod/v4/core").$strip>>>;
+  devHead: import("zod").ZodOptional<import("zod").ZodString>;
+  favicon: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
 /**
  * Type for the SSR manifest schema.
  */
@@ -1766,6 +1856,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.
    */
@@ -1840,6 +1931,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>;
@@ -1857,9 +1960,9 @@ declare class ReactServerProvider {
    */
   protected streamToString(stream: ReadableStream<Uint8Array>): Promise<string>;
 }
-declare const envSchema: import("alepha").TObject<{
-  REACT_SSR_ENABLED: import("alepha").TOptional<import("alepha").TBoolean>;
-}>;
+declare const envSchema: import("zod").ZodObject<{
+  REACT_SSR_ENABLED: import("zod").ZodOptional<import("zod").ZodBoolean>;
+}, import("zod/v4/core").$strip>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
   interface State {
@@ -1874,13 +1977,13 @@ 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: 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">;
+declare const reactServerOptions: import("alepha").Atom<import("zod").ZodObject<{
+  publicDir: import("zod").ZodString;
+  staticServer: import("zod").ZodObject<{
+    disabled: import("zod").ZodBoolean;
+    path: import("zod").ZodString;
+  }, import("zod/v4/core").$strip>;
+}, import("zod/v4/core").$strip>, "alepha.react.server.options">;
 type ReactServerProviderOptions = Static<typeof reactServerOptions.schema>;
 declare module "alepha" {
   interface State {
@@ -1892,6 +1995,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 {
     /**
@@ -1966,5 +2074,5 @@ declare module "alepha" {
  */
 declare const AlephaReactRouter: import("alepha").Service<import("alepha").Module>;
 //#endregion
-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, RouterLayerContext, RouterLayerContextValue, 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