@sheet-i18n/react 1.6.1 → 1.6.2-canary.0

package/README.md

@@ -528,11 +528,7 @@ export default function App() {
 }
 ```
 
-## 🌐 Advanced Interpolation Strategies
-
-sheet-i18n provides advanced interpolation strategies for different rendering environments. These strategies ensure optimal performance and user experience across various deployment scenarios.
-
-### 🖥️ Client-Side Rendering (CSR) Interpolation
+## 🖥️ Persistent Locale Settings
 
 For client-side applications, sheet-i18n offers `StorageBasedIntlProvider` with `LocaleStorageManager` to handle **persistent locale settings** and interpolation seamlessly.
 
@@ -764,6 +760,56 @@ const { t } = useTranslation('userSheet');
 const translatedText = t.rule('ageRule', { age: 25 }); // 'You are an adult. Your age is 25'
 ```
 
+## 🌐 Monorepo Support
+
+### **Render Prop Support (Monorepo-Friendly)**
+
+Both `StorageBasedIntlProvider` and `IntlProvider` accept either regular children
+or a render function. When a function is provided, the current locale is injected
+as the first argument. This is useful in monorepos where:
+
+```text
+┌───────────────┐          ┌───────────────────────┐
+│ workspace app │ ───────> │ app i18n context      │
+└───────────────┘          │ (Store A)             │
+                           └───────────────────────┘
+
+┌───────────────┐          ┌───────────────────────┐
+│ packages/ui   │ ───────> │ ui i18n context       │
+└───────────────┘          │ (Store B)             │
+                           └───────────────────────┘
+
+             locale bridge (A -> B)
+
+The contexts stay separate (for example, different packages can point to
+different sheets), while the current locale can still be bridged.
+```
+
+```tsx
+// packages/ui: export its own IntlProvider
+export { IntlProvider as PackageUIIntlProvider } from './src/i18n/i18nContext';
+
+// workspace: bridge the locale to the package provider
+import { PackageUIIntlProvider } from '@packages/ui';
+import {
+  localeStorageManager,
+  StorageBasedIntlProvider,
+} from '@/i18n/i18nContext';
+
+export default function LocaleProvider({ children }: PropsWithChildren) {
+  return (
+    <StorageBasedIntlProvider storageManager={localeStorageManager}>
+      // currentLocale: automatically injected
+      {(currentLocale) => (
+        <PackageUIIntlProvider currentLocale={currentLocale}>
+          {children}
+        </PackageUIIntlProvider>
+      )}
+    </StorageBasedIntlProvider>
+  );
+}
+```
+
 ## License 📜
 
 This project is licensed under the ISC License. See the LICENSE file for details.

package/dist/index.d.mts

@@ -1,2 +1,112 @@
-export * from '@sheet-i18n/react-core';
-export * from '@sheet-i18n/react-client';
+import { I18nStore } from '@sheet-i18n/core';
+export * from '@sheet-i18n/core';
+import { ObserverManager } from '@sheet-i18n/shared-utils';
+import { MessageDescriptor, IntlShape } from 'react-intl';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface IStorageService<V extends string> {
+    getItem(key: string): V;
+    setItem(key: string, value: V): boolean;
+    removeItem(key: string): boolean;
+    clear(): boolean;
+}
+/**
+ * locale storage manager
+ * implements ILocaleStorageManager (injected StorageService)
+ */
+interface ILocaleStorageManager<TSupportedLocales extends readonly string[]> {
+    getLocale(): TSupportedLocales[number];
+    setLocale(locale: TSupportedLocales[number]): void;
+}
+declare class LocaleStorageManager<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TTypeSafe extends boolean = false> implements ILocaleStorageManager<TSupportedLocales> {
+    private readonly storageService;
+    private readonly i18nStore;
+    private readonly localeStorageKey;
+    observerManager: ObserverManager<TSupportedLocales[number]>;
+    constructor(storageService: IStorageService<TSupportedLocales[number]>, i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>, localeStorageKey?: string);
+    private initializeCurrentLocale;
+    getLocale: () => TSupportedLocales[number];
+    setLocale: (locale: TSupportedLocales[number]) => void;
+}
+
+type UseIntlParams<D = MessageDescriptor> = Parameters<IntlShape['$t']> extends [D, ...infer R] ? [...R, Omit<D, 'id'>] : never;
+type ExtendedUseIntlParams<D = MessageDescriptor> = UseIntlParams<D> extends [infer A, infer B, ...infer Rest] ? A extends Record<string, infer V> ? [Record<string, V | React.ReactNode>, B, ...Rest] : [A, B, ...Rest] : UseIntlParams<D>;
+type $TParams = Partial<ExtendedUseIntlParams>;
+/**
+ * Resolves to keys of a specific sheet title in a localized set,
+ * or falls back to `string` if not type-safe or keys resolve to `never`.
+ */
+type SafeMessageId<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TTypeSafe extends boolean> = TTypeSafe extends true ? keyof NonNullable<TLocaleSet[TSupportedLocales[number]]>[TSheetTitle] extends never ? string : keyof NonNullable<TLocaleSet[TSupportedLocales[number]]>[TSheetTitle] : string;
+/**
+ * Resolves to valid sheet titles from the locale set
+ * or defaults to string if type safety is off or keys are not available.
+ */
+type SupportedLocales = readonly string[];
+type LocaleSet = Partial<Record<SupportedLocales[number], Record<string, any>>>;
+type TypeSafe = boolean;
+type SafeSheetTitle<TSupportedLocales extends SupportedLocales, TLocaleSet extends LocaleSet, TTypeSafe extends TypeSafe> = TTypeSafe extends true ? keyof TLocaleSet[TSupportedLocales[number]] extends never ? string : keyof TLocaleSet[TSupportedLocales[number]] : string;
+/**
+ * Plugin types
+ */
+type RuleKey = string;
+type RuleFn<TSupportedLocales extends SupportedLocales, TLocaleSet extends LocaleSet, TI18nStore extends I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>, TTypeSafe extends TypeSafe, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues = any> = (values: TValues, currentLocaleSet: ReturnType<TI18nStore['getCurrentLocaleSet']>) => TMessageId;
+type Plugins<TRules extends Rules = Rules> = {
+    rules?: TRules;
+};
+type Rules<TSupportedLocales extends SupportedLocales = SupportedLocales, TLocaleSet extends LocaleSet = LocaleSet, TTypeSafe extends TypeSafe = TypeSafe, TI18nStore extends I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe> = I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe> = SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe> = SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>> = Record<RuleKey, RuleFn<TSupportedLocales, TLocaleSet, TI18nStore, TTypeSafe, TSheetTitle, TMessageId>>;
+
+type GetTranslationReturn<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TTypeSafe extends boolean, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>> = {
+    t: <TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues extends $TParams[0], TOpts extends $TParams[1], TDescriptor extends $TParams[2]>(id: TMessageId, values?: TValues, opts?: TOpts, _descriptor?: TDescriptor) => TTypeSafe extends true ? TMessageId : any;
+} & {
+    t: {
+        dynamic: <TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues extends $TParams[0], TOpts extends $TParams[1], TDescriptor extends $TParams[2]>(id: string, values?: TValues, opts?: TOpts, _descriptor?: TDescriptor) => TTypeSafe extends true ? string : any;
+        promise: <TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues extends $TParams[0], TOpts extends $TParams[1], TDescriptor extends $TParams[2]>(id: TMessageId, values?: TValues, opts?: TOpts, _descriptor?: TDescriptor) => TTypeSafe extends true ? Promise<TMessageId> : any;
+    };
+};
+
+type UseTranslationReturn<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Partial<Record<TSupportedLocales[number], Record<string, any>>>>, TTypeSafe extends boolean, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TRules extends Rules> = {
+    t: <TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues extends $TParams[0], TOpts extends $TParams[1], TDescriptor extends $TParams[2]>(id: TMessageId, values?: TValues, opts?: TOpts, _descriptor?: TDescriptor) => TTypeSafe extends true ? TMessageId : any;
+} & {
+    t: {
+        dynamic: <TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues extends $TParams[0], TOpts extends $TParams[1], TDescriptor extends $TParams[2]>(id: string, values?: TValues, opts?: TOpts, _descriptor?: TDescriptor) => TTypeSafe extends true ? string : any;
+        rule: <TRuleKey extends keyof TRules, TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>>(ruleKey: TRuleKey, values?: Parameters<TRules[TRuleKey]>[0]) => TTypeSafe extends true ? TMessageId : any;
+    };
+};
+
+type IntlProviderProps<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TTypeSafe extends boolean = false> = {
+    i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>;
+    currentLocale?: TSupportedLocales[number];
+    children: Omit<React.ReactNode, 'bigint'> | ((currentLocale?: TSupportedLocales[number]) => React.ReactNode);
+};
+
+declare function useLocaleStorage<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TTypeSafe extends boolean = false>(localeStorageManager: LocaleStorageManager<TSupportedLocales, TLocaleSet, TTypeSafe>): {
+    locale: TSupportedLocales[number] | undefined;
+};
+
+interface StorageBasedIntlProviderProps<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TTypeSafe extends boolean = false> {
+    i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>;
+    storageManager: LocaleStorageManager<TSupportedLocales, TLocaleSet, TTypeSafe>;
+    fallbackUI?: React.ReactNode;
+    children: Omit<React.ReactNode, 'bigint'> | ((currentLocale?: TSupportedLocales[number]) => React.ReactNode);
+}
+
+declare function createI18nContext<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TRules extends Rules, TTypeSafe extends boolean = false>(i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>, plugins?: Plugins<TRules>): {
+    IntlProvider: ({ currentLocale, children, }: Omit<IntlProviderProps<TSupportedLocales, TLocaleSet>, "currentLocale" | "i18nStore"> & {
+        currentLocale?: string;
+        children?: React.ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    StorageBasedIntlProvider: ({ storageManager, children, }: Omit<StorageBasedIntlProviderProps<TSupportedLocales, TLocaleSet, TTypeSafe>, "i18nStore">) => react_jsx_runtime.JSX.Element;
+    useTranslation: <TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>>(sheetTitle: TSheetTitle) => UseTranslationReturn<TSupportedLocales, TLocaleSet, TTypeSafe, TSheetTitle, TRules>;
+    getTranslation: <TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>>(sheetTitle: TSheetTitle) => GetTranslationReturn<TSupportedLocales, TLocaleSet, TTypeSafe, TSheetTitle>;
+    getLocaleStorageManager: (storageService?: IStorageService<string>) => LocaleStorageManager<TSupportedLocales, TLocaleSet, TTypeSafe>;
+    useLocaleStorage: typeof useLocaleStorage;
+};
+
+declare class RuleService<TSupportedLocales extends SupportedLocales, TLocaleSet extends LocaleSet, TTypeSafe extends TypeSafe, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>> {
+    private readonly i18nStore;
+    constructor(i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>);
+    createRule: <TValues extends $TParams[0]>(ruleFn: RuleFn<TSupportedLocales, TLocaleSet, I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>, TTypeSafe, TSheetTitle, TMessageId, TValues>) => (values: TValues) => TMessageId;
+}
+declare const ruleFactory: <TSupportedLocales extends SupportedLocales, TLocaleSet extends LocaleSet, TTypeSafe extends TypeSafe>(i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>) => RuleService<TSupportedLocales, TLocaleSet, TTypeSafe, SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, SafeMessageId<TSupportedLocales, TLocaleSet, SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TTypeSafe>>;
+
+export { type GetTranslationReturn as GetTranslation, LocaleStorageManager, type Plugins, type Rules, type IStorageService as Storage, type StorageBasedIntlProviderProps, type UseTranslationReturn as UseTranslation, createI18nContext, ruleFactory };

package/dist/index.d.ts

@@ -1,2 +1,112 @@
-export * from '@sheet-i18n/react-core';
-export * from '@sheet-i18n/react-client';
+import { I18nStore } from '@sheet-i18n/core';
+export * from '@sheet-i18n/core';
+import { ObserverManager } from '@sheet-i18n/shared-utils';
+import { MessageDescriptor, IntlShape } from 'react-intl';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface IStorageService<V extends string> {
+    getItem(key: string): V;
+    setItem(key: string, value: V): boolean;
+    removeItem(key: string): boolean;
+    clear(): boolean;
+}
+/**
+ * locale storage manager
+ * implements ILocaleStorageManager (injected StorageService)
+ */
+interface ILocaleStorageManager<TSupportedLocales extends readonly string[]> {
+    getLocale(): TSupportedLocales[number];
+    setLocale(locale: TSupportedLocales[number]): void;
+}
+declare class LocaleStorageManager<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TTypeSafe extends boolean = false> implements ILocaleStorageManager<TSupportedLocales> {
+    private readonly storageService;
+    private readonly i18nStore;
+    private readonly localeStorageKey;
+    observerManager: ObserverManager<TSupportedLocales[number]>;
+    constructor(storageService: IStorageService<TSupportedLocales[number]>, i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>, localeStorageKey?: string);
+    private initializeCurrentLocale;
+    getLocale: () => TSupportedLocales[number];
+    setLocale: (locale: TSupportedLocales[number]) => void;
+}
+
+type UseIntlParams<D = MessageDescriptor> = Parameters<IntlShape['$t']> extends [D, ...infer R] ? [...R, Omit<D, 'id'>] : never;
+type ExtendedUseIntlParams<D = MessageDescriptor> = UseIntlParams<D> extends [infer A, infer B, ...infer Rest] ? A extends Record<string, infer V> ? [Record<string, V | React.ReactNode>, B, ...Rest] : [A, B, ...Rest] : UseIntlParams<D>;
+type $TParams = Partial<ExtendedUseIntlParams>;
+/**
+ * Resolves to keys of a specific sheet title in a localized set,
+ * or falls back to `string` if not type-safe or keys resolve to `never`.
+ */
+type SafeMessageId<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TTypeSafe extends boolean> = TTypeSafe extends true ? keyof NonNullable<TLocaleSet[TSupportedLocales[number]]>[TSheetTitle] extends never ? string : keyof NonNullable<TLocaleSet[TSupportedLocales[number]]>[TSheetTitle] : string;
+/**
+ * Resolves to valid sheet titles from the locale set
+ * or defaults to string if type safety is off or keys are not available.
+ */
+type SupportedLocales = readonly string[];
+type LocaleSet = Partial<Record<SupportedLocales[number], Record<string, any>>>;
+type TypeSafe = boolean;
+type SafeSheetTitle<TSupportedLocales extends SupportedLocales, TLocaleSet extends LocaleSet, TTypeSafe extends TypeSafe> = TTypeSafe extends true ? keyof TLocaleSet[TSupportedLocales[number]] extends never ? string : keyof TLocaleSet[TSupportedLocales[number]] : string;
+/**
+ * Plugin types
+ */
+type RuleKey = string;
+type RuleFn<TSupportedLocales extends SupportedLocales, TLocaleSet extends LocaleSet, TI18nStore extends I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>, TTypeSafe extends TypeSafe, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues = any> = (values: TValues, currentLocaleSet: ReturnType<TI18nStore['getCurrentLocaleSet']>) => TMessageId;
+type Plugins<TRules extends Rules = Rules> = {
+    rules?: TRules;
+};
+type Rules<TSupportedLocales extends SupportedLocales = SupportedLocales, TLocaleSet extends LocaleSet = LocaleSet, TTypeSafe extends TypeSafe = TypeSafe, TI18nStore extends I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe> = I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe> = SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe> = SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>> = Record<RuleKey, RuleFn<TSupportedLocales, TLocaleSet, TI18nStore, TTypeSafe, TSheetTitle, TMessageId>>;
+
+type GetTranslationReturn<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TTypeSafe extends boolean, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>> = {
+    t: <TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues extends $TParams[0], TOpts extends $TParams[1], TDescriptor extends $TParams[2]>(id: TMessageId, values?: TValues, opts?: TOpts, _descriptor?: TDescriptor) => TTypeSafe extends true ? TMessageId : any;
+} & {
+    t: {
+        dynamic: <TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues extends $TParams[0], TOpts extends $TParams[1], TDescriptor extends $TParams[2]>(id: string, values?: TValues, opts?: TOpts, _descriptor?: TDescriptor) => TTypeSafe extends true ? string : any;
+        promise: <TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues extends $TParams[0], TOpts extends $TParams[1], TDescriptor extends $TParams[2]>(id: TMessageId, values?: TValues, opts?: TOpts, _descriptor?: TDescriptor) => TTypeSafe extends true ? Promise<TMessageId> : any;
+    };
+};
+
+type UseTranslationReturn<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Partial<Record<TSupportedLocales[number], Record<string, any>>>>, TTypeSafe extends boolean, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TRules extends Rules> = {
+    t: <TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues extends $TParams[0], TOpts extends $TParams[1], TDescriptor extends $TParams[2]>(id: TMessageId, values?: TValues, opts?: TOpts, _descriptor?: TDescriptor) => TTypeSafe extends true ? TMessageId : any;
+} & {
+    t: {
+        dynamic: <TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>, TValues extends $TParams[0], TOpts extends $TParams[1], TDescriptor extends $TParams[2]>(id: string, values?: TValues, opts?: TOpts, _descriptor?: TDescriptor) => TTypeSafe extends true ? string : any;
+        rule: <TRuleKey extends keyof TRules, TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>>(ruleKey: TRuleKey, values?: Parameters<TRules[TRuleKey]>[0]) => TTypeSafe extends true ? TMessageId : any;
+    };
+};
+
+type IntlProviderProps<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TTypeSafe extends boolean = false> = {
+    i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>;
+    currentLocale?: TSupportedLocales[number];
+    children: Omit<React.ReactNode, 'bigint'> | ((currentLocale?: TSupportedLocales[number]) => React.ReactNode);
+};
+
+declare function useLocaleStorage<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TTypeSafe extends boolean = false>(localeStorageManager: LocaleStorageManager<TSupportedLocales, TLocaleSet, TTypeSafe>): {
+    locale: TSupportedLocales[number] | undefined;
+};
+
+interface StorageBasedIntlProviderProps<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TTypeSafe extends boolean = false> {
+    i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>;
+    storageManager: LocaleStorageManager<TSupportedLocales, TLocaleSet, TTypeSafe>;
+    fallbackUI?: React.ReactNode;
+    children: Omit<React.ReactNode, 'bigint'> | ((currentLocale?: TSupportedLocales[number]) => React.ReactNode);
+}
+
+declare function createI18nContext<TSupportedLocales extends readonly string[], TLocaleSet extends Partial<Record<TSupportedLocales[number], Record<string, any>>>, TRules extends Rules, TTypeSafe extends boolean = false>(i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>, plugins?: Plugins<TRules>): {
+    IntlProvider: ({ currentLocale, children, }: Omit<IntlProviderProps<TSupportedLocales, TLocaleSet>, "currentLocale" | "i18nStore"> & {
+        currentLocale?: string;
+        children?: React.ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    StorageBasedIntlProvider: ({ storageManager, children, }: Omit<StorageBasedIntlProviderProps<TSupportedLocales, TLocaleSet, TTypeSafe>, "i18nStore">) => react_jsx_runtime.JSX.Element;
+    useTranslation: <TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>>(sheetTitle: TSheetTitle) => UseTranslationReturn<TSupportedLocales, TLocaleSet, TTypeSafe, TSheetTitle, TRules>;
+    getTranslation: <TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>>(sheetTitle: TSheetTitle) => GetTranslationReturn<TSupportedLocales, TLocaleSet, TTypeSafe, TSheetTitle>;
+    getLocaleStorageManager: (storageService?: IStorageService<string>) => LocaleStorageManager<TSupportedLocales, TLocaleSet, TTypeSafe>;
+    useLocaleStorage: typeof useLocaleStorage;
+};
+
+declare class RuleService<TSupportedLocales extends SupportedLocales, TLocaleSet extends LocaleSet, TTypeSafe extends TypeSafe, TSheetTitle extends SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TMessageId extends SafeMessageId<TSupportedLocales, TLocaleSet, TSheetTitle, TTypeSafe>> {
+    private readonly i18nStore;
+    constructor(i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>);
+    createRule: <TValues extends $TParams[0]>(ruleFn: RuleFn<TSupportedLocales, TLocaleSet, I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>, TTypeSafe, TSheetTitle, TMessageId, TValues>) => (values: TValues) => TMessageId;
+}
+declare const ruleFactory: <TSupportedLocales extends SupportedLocales, TLocaleSet extends LocaleSet, TTypeSafe extends TypeSafe>(i18nStore: I18nStore<TSupportedLocales, TLocaleSet, TTypeSafe>) => RuleService<TSupportedLocales, TLocaleSet, TTypeSafe, SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, SafeMessageId<TSupportedLocales, TLocaleSet, SafeSheetTitle<TSupportedLocales, TLocaleSet, TTypeSafe>, TTypeSafe>>;
+
+export { type GetTranslationReturn as GetTranslation, LocaleStorageManager, type Plugins, type Rules, type IStorageService as Storage, type StorageBasedIntlProviderProps, type UseTranslationReturn as UseTranslation, createI18nContext, ruleFactory };