import { type ReactElement } from "react";
import type { LocalizedString } from "./LocalizedString";
import type { ComponentKeyToRecord, WithOptionalKeys, TranslationFunction } from "./typeUtils";
import type { Dispatch, SetStateAction } from "react";
import type { StatefulObservable, StatefulReadonlyObservable } from "powerhooks/tools/StatefulObservable";
declare namespace JSX {
    interface Element extends ReactElement<any, any> {
    }
}
type UseTranslation<ComponentKey extends [string, string | {
    K: string;
}]> = {
    <ComponentName extends ComponentKey[0]>(wrappedComponentName: Record<ComponentName, unknown>): {
        t: TranslationFunction<ComponentName, ComponentKey>;
    };
    <ComponentName extends ComponentKey[0]>(componentName: ComponentName): {
        t: TranslationFunction<ComponentName, ComponentKey>;
    };
};
type I18nApi<ComponentKey extends [string, string | {
    K: string;
}], Language extends string> = {
    useLang: () => {
        lang: Language;
        setLang: Dispatch<SetStateAction<Language>>;
    };
    $lang: StatefulObservable<Language>;
    useTranslation: UseTranslation<ComponentKey>;
    useResolveLocalizedString(params?: {
        /** default: false */
        labelWhenMismatchingLanguage?: false;
    }): {
        resolveLocalizedString: (localizedString: LocalizedString<Language>) => string;
    };
    useResolveLocalizedString(params?: {
        /** default: false */
        labelWhenMismatchingLanguage: true | {
            ifStringAssumeLanguage: Language;
        };
    }): {
        resolveLocalizedString: (localizedString: LocalizedString<Language>) => JSX.Element;
        resolveLocalizedStringDetailed: (localizedString: LocalizedString<Language>) => {
            langAttrValue: Language | undefined;
            str: string;
        };
    };
    resolveLocalizedString(localizedString: LocalizedString<Language>, options?: {
        /** default: false */
        labelWhenMismatchingLanguage?: false;
    }): string;
    resolveLocalizedString(localizedString: LocalizedString<Language>, options?: {
        /** default: false */
        labelWhenMismatchingLanguage: true | {
            ifStringAssumeLanguage: Language;
        };
    }): JSX.Element;
    getTranslation: <ComponentName extends ComponentKey[0]>(componentName: ComponentName) => {
        t: TranslationFunction<ComponentName, ComponentKey>;
    };
    $readyLang: StatefulReadonlyObservable<Language | undefined>;
};
export type GenericTranslations<ComponentKey extends [string, string | {
    K: string;
}], Language extends string, FallbackLanguage extends Language, L extends Language> = L extends FallbackLanguage ? ComponentKeyToRecord<ComponentKey> : WithOptionalKeys<ComponentKeyToRecord<ComponentKey>>;
type ValueOrAsyncGetter<T> = T | (() => Promise<T>);
/** @see <https://docs.i18nifty.dev> */
export declare function createI18nApi<ComponentKey extends [string, string | {
    K: string;
}]>(): <Language extends string, FallbackLanguage extends Language>(params: {
    languages: readonly Language[];
    fallbackLanguage: FallbackLanguage;
}, translations: { [L in Language]: ValueOrAsyncGetter<GenericTranslations<ComponentKey, Language, FallbackLanguage, L>>; }) => I18nApi<ComponentKey, Language>;
export {};