/**
 * `@nifrajs/web-react/i18n` - React bindings for `@nifrajs/i18n`. `<I18nProvider locale messages>` builds a
 * `Formatter` (memoized) and provides it; `useT()` reads it. Both `locale` + `messages` are
 * serializable, so a loader returns them, the page renders with the negotiated catalog on the server,
 * and the client rebuilds the same formatter from the same props (no mismatch). In an app that
 * registers its locale routing (`i18n` in `backend/framework.ts`), `locale` defaults to the page's and
 * `useLocale()` names it. No JSX (the package builds with plain `tsc`).
 */
import { type Formatter, type FormatterOptions, type MessageKey, type RegisteredMessages, type Translation } from "@nifrajs/i18n";
import { type ReactNode } from "react";
export interface I18nProviderProps extends FormatterOptions {
    /** The locale to format in. Default: the page's locale tag, in an app that registers its locale
     * routing. */
    readonly locale?: string;
    /** The catalog for `locale`, checked against the registered catalog type when one is declared. */
    readonly messages: Translation;
    readonly children?: ReactNode;
}
/** Provide a {@link Formatter} (built from `locale` + `messages`, with the optional `fallback`,
 * `onMissing`, `timeZone` and `numberingSystem` of `createFormatter`) to the subtree. Memoized
 * on those props, so switching locale rebuilds it and re-renders consumers; formatters are cached by
 * catalog identity, so an inline `fallback={[en]}` still yields the same instance. */
export declare function I18nProvider(props: I18nProviderProps): ReactNode;
/** Read the current {@link Formatter} (`{ locale, t, get, n, d }`). Throws if no `<I18nProvider>` is above. */
export declare function useT(): Formatter;
/**
 * The page's locale key (`ur`, the URL segment), in an app that registers its locale routing (`i18n`
 * in `backend/framework.ts`): from the request on the server, from the URL after each navigation.
 * Without one, the nearest `<I18nProvider>`'s locale; with neither, it throws.
 */
export declare function useLocale(): string;
/** Tag handlers for {@link rich}, by tag name: each receives its tag's content as one node. */
export type RichTags = Readonly<Record<string, (content: ReactNode) => ReactNode>>;
/**
 * The message at `key` with its tags rendered by `tags`, as React nodes - no HTML, no
 * `dangerouslySetInnerHTML`. `"Read the <link>terms</link>"` with
 * `{ link: (content) => <a href="/terms">{content}</a> }` renders the link around "terms"; a tag with
 * no handler renders its content as text, `<br/>` is a `<br>`, and interpolated values are always
 * text. See `@nifrajs/i18n/rich`.
 */
export declare function rich<M extends object = RegisteredMessages>(formatter: Formatter<M>, key: MessageKey<M>, tags?: RichTags, vars?: Readonly<Record<string, unknown>>): ReactNode;
//# sourceMappingURL=i18n.d.ts.map