@orderly.network/i18n 3.0.0-beta.0 → 3.0.0-beta.2

package/dist/index.d.ts

@@ -1,54 +1,75 @@
-import { L as LocaleCode, R as Resources, a as LocaleContextState } from './constant-BeXwHrGj.js';
-export { b as Language, d as LocaleContext, f as LocaleEnum, e as LocaleMessages, P as PopupMode, c as PopupProps, g as defaultLanguages, h as defaultLng, i as defaultNS, l as en, k as i18nCookieKey, j as i18nLocalStorageKey, u as useLocaleContext } from './constant-BeXwHrGj.js';
+import { R as Resources, A as AsyncResources, L as LocaleCode, a as LanguageContextState } from './constant-DkvDyddr.js';
+export { b as Language, d as LanguageContext, f as LocaleEnum, e as LocaleMessages, P as PopupMode, c as PopupProps, g as defaultLanguages, h as defaultLng, i as defaultNS, l as en, k as i18nCookieKey, j as i18nLocalStorageKey, u as useLanguageContext } from './constant-DkvDyddr.js';
 import * as react_i18next from 'react-i18next';
-import { I18nextProviderProps, FallbackNs, UseTranslationOptions } from 'react-i18next';
+import { FallbackNs, UseTranslationOptions } from 'react-i18next';
 export * from 'react-i18next';
 import * as i18next from 'i18next';
 import { InitOptions, FlatNamespace, KeyPrefix } from 'i18next';
 export { createInstance, default as i18next } from 'i18next';
-import { ReactNode, PropsWithChildren, FC } from 'react';
+import { PropsWithChildren, FC } from 'react';
 import { $Tuple } from 'react-i18next/helpers';
 export { generatePath, getLocalePathFromPathname, parseI18nLang, removeLangPrefix } from './utils.js';
 
 declare function createI18nInstance(options?: InitOptions): i18next.i18n;
 declare const i18n: i18next.i18n;
 
+declare function registerResources(resources: Resources | AsyncResources | undefined, localeCode: LocaleCode): Promise<void>;
+
 type BackendOptions = {
     loadPath: (lang: LocaleCode, ns: string) => string | string[] | undefined;
 };
+declare class Backend {
+    options: BackendOptions;
+    cache: Set<string>;
+    constructor(options: BackendOptions);
+    fetchData(url: string): Promise<any>;
+    loadLanguage(lang: LocaleCode, ns: string): Promise<void>;
+}
 
-type I18nProviderProps = Partial<I18nextProviderProps>;
-declare const I18nProvider: React.FC<I18nProviderProps>;
-type LocaleProviderProps = {
-    children: ReactNode;
-    locale?: LocaleCode;
-    resource?: Record<string, string>;
-    resources?: Resources;
+/**
+ * Register the default language bundle before your React tree renders to reduce
+ * flicker of raw translation keys.
+ */
+declare const registerDefaultResource: (messages: Record<string, string>) => void;
+
+/**
+ * Shape of a locale JSON file loaded via dynamic import / Vite `import.meta.glob`.
+ */
+type LocaleJsonModule = {
+    default?: Record<string, string> | string | null;
+};
+declare function asMessageRecord(value: Record<string, string> | string | null | undefined): Record<string, string>;
+/**
+ * Loads a locale JSON module via a Vite `import.meta.glob` loader or a dynamic `import()` thunk,
+ * and normalizes `default` to a flat message record.
+ * Missing `loader`, rejected `loader()`, or missing/invalid `default` yields `{}` (see {@link asMessageRecord}).
+ */
+declare function importLocaleJsonModule(loader: (() => Promise<LocaleJsonModule>) | undefined): Promise<Record<string, string>>;
+
+type LanguageProviderProps = PropsWithChildren<{
+    backend?: BackendOptions;
     /**
      * supported languages, you can select supported languages from default languages
      */
     supportedLanguages?: LocaleCode[];
     /** optional conversion function to use to modify the detected language code */
     convertDetectedLanguage?: (lang: string) => LocaleCode;
-    backend?: BackendOptions;
-} & Partial<LocaleContextState>;
-declare const LocaleProvider: React.FC<LocaleProviderProps>;
+} & Partial<LanguageContextState>>;
+declare const LanguageProvider: FC<LanguageProviderProps>;
 
-declare function useTranslation<Ns extends FlatNamespace | $Tuple<FlatNamespace> | undefined, KPrefix extends KeyPrefix<FallbackNs<Ns>> = undefined>(ns?: Ns, options?: UseTranslationOptions<KPrefix>): react_i18next.UseTranslationResponse<FallbackNs<Ns>, KPrefix>;
-
-declare function useLocaleCode(): LocaleCode;
-
-/**
- * preload default locale resources to prevent flickering of raw translation keys
- */
-declare const preloadDefaultResource: (messages: Record<string, string>) => void;
+type LocaleProviderProps = LanguageProviderProps & {
+    /** Active locale; when set and bundles exist, syncs i18n language via `changeLanguage`. */
+    locale?: LocaleCode;
+    /** Flat key-value messages for `defaultNS`; used together with `locale` when `resources` is not provided. */
+    resource?: Record<string, string>;
+    /**
+     * Preload locale bundles: static `Resources` map, or an async loader (same contract as
+     * `ExternalLocaleProvider`). When set, takes precedence over `locale` + `resource`.
+     */
+    resources?: Resources | AsyncResources;
+};
+declare const LocaleProvider: FC<LocaleProviderProps>;
 
-/**
- * Async loader contract for pulling translation resources from an external system.
- * Implementations are expected to return the full message table for the given locale
- * and namespace so that the bundle can be replaced atomically.
- */
-type AsyncResources = (lang: LocaleCode, ns: string) => Promise<Record<string, string>>;
 type ExternalLocaleProviderProps = PropsWithChildren<{
     resources?: Resources | AsyncResources;
 }>;
@@ -62,8 +83,26 @@ type ExternalLocaleProviderProps = PropsWithChildren<{
  *   synchronously on mount.
  *
  * This component renders no UI; it only manages i18n side effects and simply
- * returns its children.
+ * returns its children. Same behavior as calling `useRegisterExternalResources(resources)`
+ * in your own component under `LocaleProvider`.
  */
 declare const ExternalLocaleProvider: FC<ExternalLocaleProviderProps>;
 
-export { type AsyncResources, ExternalLocaleProvider, type ExternalLocaleProviderProps, I18nProvider, type I18nProviderProps, LocaleCode, LocaleContextState, LocaleProvider, type LocaleProviderProps, Resources, createI18nInstance, i18n, preloadDefaultResource, useLocaleCode, useTranslation };
+declare function useTranslation<Ns extends FlatNamespace | $Tuple<FlatNamespace> | undefined, KPrefix extends KeyPrefix<FallbackNs<Ns>> = undefined>(ns?: Ns, options?: UseTranslationOptions<KPrefix>): react_i18next.UseTranslationResponse<FallbackNs<Ns>, KPrefix>;
+
+declare function useLocaleCode(): LocaleCode;
+
+/**
+ * Registers host-provided i18n resources into the shared i18n instance whenever
+ * the active locale or `resources` reference changes.
+ *
+ * - When `resources` is a function, it is invoked for the current locale to
+ *   load the bundle (e.g. from another bundle, backend, or runtime loader).
+ * - When `resources` is a static map, all provided locale bundles are registered.
+ *
+ * Prefer a stable `resources` reference (e.g. `useCallback` for loaders, module
+ * scope or `useMemo` for static maps) to avoid unnecessary re-registration.
+ */
+declare function useRegisterExternalResources(resources?: Resources | AsyncResources): void;
+
+export { AsyncResources, Backend, type BackendOptions, ExternalLocaleProvider, type ExternalLocaleProviderProps, LanguageContextState, LanguageProvider, type LanguageProviderProps, LocaleCode, type LocaleJsonModule, LocaleProvider, type LocaleProviderProps, Resources, asMessageRecord, createI18nInstance, i18n, importLocaleJsonModule, registerDefaultResource, registerResources, useLocaleCode, useRegisterExternalResources, useTranslation };

package/dist/index.js

@@ -99,6 +99,10 @@ var affiliate = {
   "affiliate.referralCode.label": "Enter referral code",
   "affiliate.referralCode.bound": "Referral code bound",
   "affiliate.referralCode.notExist": "This referral code does not exist.",
+  "affiliate.referralCode.bind.modal.title": "Were you referred by someone?",
+  "affiliate.referralCode.bind.modal.description": "If an affiliate shared their referral code with you, enter it below to bind your account and receive affiliate benefits.",
+  "affiliate.referralCode.bind.input.placeholder": "Enter referrer's code",
+  "affiliate.referralCode.bind.skip": "No, I was not referred by anyone",
   "affiliate.process.title": "How It Works",
   "affiliate.process.step1.title": "Trade $10,000+ or apply",
   "affiliate.process.step1.description": "Unlock a referral code automatically ($0 of $10,000 completed - main account only), or apply for a higher rate via the form.",
@@ -130,7 +134,7 @@ var affiliate = {
   "affiliate.base": "Affiliate",
   "affiliate.directBonus": "Direct bonus",
   "affiliate.commission.30d": "30d commission",
-  "affiliate.commission.column.activeUsers": "Referral active users",
+  "affiliate.commission.column.activeUsers": "New traders",
   "affiliate.myReferees": "My referees",
   "affiliate.referees": "Referees",
   "affiliate.referees.column.refereeAddress": "Referee address",
@@ -160,6 +164,7 @@ var affiliate = {
   "affiliate.direct": "Direct",
   "affiliate.directInclBonus": "Incl. {{amount}} bonus",
   "affiliate.indirect": "Indirect",
+  "affiliate.referredBy": "Referred by {{name}}",
   "affiliate.referrals": "Referrals",
   "affiliate.referralCode.edit.modal.title": "Configure your referral settings",
   "affiliate.referralCode.create": "Create referral code",
@@ -465,6 +470,7 @@ var markets = {
   "markets.favorites": "Favorites",
   "markets.recent": "Recent",
   "markets.newListings": "New listings",
+  "markets.community": "Community",
   "markets.allMarkets": "All markets",
   "markets.openInterest": "Open interest",
   "markets.openInterest.tooltip": "Total size of positions per side.",
@@ -514,7 +520,13 @@ var markets = {
   "markets.symbolInfoBar.24hVolume": "24h volume",
   "markets.symbolInfoBar.24hVolume.tooltip": "24 hour total trading volume on the Orderly Network.",
   "markets.symbolInfoBar.predFundingRate": "Est. funding rate",
-  "markets.symbolInfoBar.predFundingRate.tooltip": "Funding rates are payments between traders who are long and short. When positive, long positions pay short positions funding. When negative, short positions pay long positions."
+  "markets.symbolInfoBar.predFundingRate.tooltip": "Funding rates are payments between traders who are long and short. When positive, long positions pay short positions funding. When negative, short positions pay long positions.",
+  "markets.symbolInfoBar.riskNotice.content": "{{symbolWithBroker}} is a permissionless listing supported on Isolated Margin only, deployed and operated independently by {{brokerName}}. Please be aware of elevated risks, including low liquidity, high volatility, and increased liquidation risk."
+};
+
+// src/locale/module/navigation.ts
+var navigation = {
+  "tradingPoints.points": "Points"
 };
 
 // src/locale/module/notification.ts
@@ -559,6 +571,7 @@ var orderEntry = {
   "orderEntry.orderType.ioc.tooltip": "Executes immediately; any unfilled amount is canceled.",
   "orderEntry.orderType.fok": "FOK",
   "orderEntry.orderType.fok.tooltip": "Executes immediately in full, or is canceled entirely.",
+  "orderEntry.orderType.symbolPostOnly.tooltip": "This symbol is in POST_ONLY mode. Only limit orders are accepted until the order book is ready.",
   "orderEntry.orderType.scaledOrder": "Scaled",
   "orderEntry.orderType.trailingStop": "Trailing stop",
   "orderEntry.orderSize": "Order size",
@@ -631,10 +644,13 @@ var orderEntry = {
   "marginMode.current": "Current",
   "marginMode.marginModeSettings": "Margin mode settings",
   "marginMode.updatedSuccessfully": "Updated successfully",
+  "marginMode.noEditableSymbolsSelected": "No editable symbols selected",
+  "marginMode.failedToUpdateMarginMode": "Failed to update margin mode",
   "marginMode.perpetualFutures": "Perpetual futures",
   "marginMode.searchPlaceholder": "Search",
   "marginMode.selectAll": "Select all",
   "marginMode.setAs": "Set as",
+  "marginMode.disabledSymbolTooltip": "This symbol is independently operated by a third party. Isolated Margin is enforced to prevent risk from affecting your other positions.",
   "orderEntry.startPrice.error.required": "Start price is required",
   "orderEntry.startPrice.error.min": "Start price must be greater than {{value}}",
   "orderEntry.startPrice.error.max": "Start price must be less than {{value}}",
@@ -663,7 +679,12 @@ var orderEntry = {
   "orderEntry.reduceOnly.reminder": "Reduce-only reminder",
   "orderEntry.reduceOnly.reminder.content": "Your account is in reduce-only and cannot open new positions. Would you like to turn off reduce-only mode and proceed with the\xA0order?",
   "orderEntry.placeOrderNow": "Place order now",
-  "orderEntry.maxQty.reminder.content": "Order qty reduced to max available: {{maxQty}}"
+  "orderEntry.maxQty.reminder.content": "Order qty reduced to max available: {{maxQty}}",
+  "orderEntry.permissionlessNotice.title": "Community-Listed Market Notice",
+  "orderEntry.permissionlessNotice.content1": "This market was listed by a third-party deployer through the permissionless listing system.",
+  "orderEntry.permissionlessNotice.content2": "It is not created, reviewed, or endorsed by Orderly. Such markets may involve low liquidity, high volatility, incomplete information, or increased liquidation risk.",
+  "orderEntry.permissionlessNotice.content3": "Please review the deployer's documentation and trade at your own risk.",
+  "orderEntry.permissionlessNotice.checkbox": "I understand this is a community-listed market and accept the risks."
 };
 
 // src/locale/module/orders.ts
@@ -730,6 +751,8 @@ var portfolio = {
   "portfolio.overview.performance.cumulativePnl": "Cumulative PnL",
   "portfolio.overview.performance.dailyVolume": "Daily Volume",
   "portfolio.overview.performance.cumulativeVolume": "Cumulative Volume",
+  "portfolio.overview.todaysPnl": "Today's PnL",
+  "portfolio.overview.todaysVol": "Today's Vol",
   "portfolio.overview.distribution": "Distribution",
   "portfolio.overview.transferHistory": "Transfer history",
   "portfolio.overview.vaults": "Vaults",
@@ -1063,6 +1086,7 @@ var trading = {
   "trading.rwa.tooltip.openIn": "Regular trading hours will open in <0>{{timeFormat}}</0>",
   "trading.rwa.tooltip.checkDetailRules": "Check detail rules",
   "trading.rwa.countdown.title": "US markets are closing soon, volatility may be lower.",
+  "trading.symbolDelisting": "{{symbol}} has entered forced deleveraging mode (insufficient liquidity depth / insufficient IF balance). Your position on this symbol only allows closing operations.",
   "trading.rwa.outsideMarketHours.notify": "This market is currently outside regular trading hours. You can still place a trade, but please be aware of reduced liquidity and potential risks.",
   "trading.rwa.mWeb.outsideMarketHours.desc": "Regular trading hours are about to close - 24/7 trading continues; price may slow and liquidity may be lower.",
   "trading.rwa.mWeb.insideMarketHours.desc": "Regular trading hours are about to open - get ready."
@@ -1106,46 +1130,6 @@ var tradingLeaderboard = {
   "tradingLeaderboard.tradingVolume.tooltip": "Total trading volume generated during the campaign period. Updated every 30 seconds."
 };
 
-// src/locale/module/tradingPoints.ts
-var tradingPoints = {
-  "tradingPoints.points": "Points",
-  "tradingPoints.startsIn": "Starts in",
-  "tradingPoints.days": "Days",
-  "tradingPoints.hours": "Hours",
-  "tradingPoints.minutes": "Minutes",
-  "tradingPoints.seconds": "Seconds",
-  "tradingPoints.learnMore": "Learn more",
-  "tradingPoints.stagePoints": "Stage points",
-  "tradingPoints.stageRanking": "Stage ranking",
-  "tradingPoints.referralCode": "Referral code",
-  "tradingPoints.referralLink": "Referral link",
-  "tradingPoints.currentPoints": "Current points",
-  "tradingPoints.ranking": "Ranking",
-  "tradingPoints.myPoints": "My points",
-  "tradingPoints.thisWeek": "This week",
-  "tradingPoints.lastWeek": "Last week",
-  "tradingPoints.all": "All",
-  "tradingPoints.tradePoints": "Trade points",
-  "tradingPoints.tradePointsTooltip": "Trade Points are calculated based on your perps trading volume.Updated daily.",
-  "tradingPoints.tradeNow": "Trade now",
-  "tradingPoints.pnlPoints": "PNL points",
-  "tradingPoints.pnlPointsTooltip": "Both profit or loss of each trade will be recorded. Updated daily.",
-  "tradingPoints.referralPoints": "Referral points",
-  "tradingPoints.referralPointsTooltip": "First-level invitee's rebates: {{l1}}%, Second-level invitee's rebates: {{l2}}%, Update daily.",
-  "tradingPoints.copyLink": "Copy Link",
-  "tradingPoints.faq.title": "FAQ",
-  "tradingPoints.faq.whatArePoints.question": "What are Points?",
-  "tradingPoints.faq.whatArePoints.answer": "The Points program is designed to encourage genuine user engagement with products and to reward loyal users who actively contribute to the growth of the {{brokerName}} ecosystem. Rewards will be airdropped in the future based on users' point accumulation.",
-  "tradingPoints.faq.allocation.question": "What is the points allocation criteria?",
-  "tradingPoints.faq.allocation.answer": "Points = Trade points + PNL points + Referral points.\n\nThe page will update your points daily, calculating the points you are expected to receive based on your contribution.\n\nNote: Wash trading (e.g., self-trades) will not receive any points",
-  "tradingPoints.faq.distribution.question": "When will points be distributed?",
-  "tradingPoints.faq.distribution.answer": "Points are distributed at 08:00 UTC everyday.",
-  "tradingPoints.faq.pnl.question": "How are PNL points calculated?",
-  "tradingPoints.faq.pnl.answer": "Points are based on your net profit or loss each trading.",
-  "tradingPoints.faq.referral.question": "How does the referral work?",
-  "tradingPoints.faq.referral.answer": "Based on the total points of your invitees and their invitees. Points earned from first-level invitees are higher than those from second-level invitees. Updated daily."
-};
-
 // src/locale/module/tradingRewards.ts
 var tradingRewards = {
   "tradingRewards.rewards": "Rewards",
@@ -1199,6 +1183,7 @@ var tradingView = {
   "tradingView.displayControl.buySell": "Buy/Sell",
   "tradingView.displayControl.limitOrders": "Limit orders",
   "tradingView.displayControl.stopOrders": "Stop orders",
+  "tradingView.displayControl.liquidationPrice": "Liquidation Price",
   "tradingView.noScriptSrc": "Due to TradingView's policy, you will need to apply for your own license.",
   "tradingView.noScriptSrc.1": "1. Please apply for your TradingView Advanced Chart license <0>here</0>",
   "tradingView.noScriptSrc.2": "2. Follow the instructions on <0>orderly.network</0> to set up."
@@ -1221,10 +1206,20 @@ var transfer = {
   "transfer.deposit.requested": "Deposit requested",
   "transfer.deposit.completed": "Deposit completed",
   "transfer.deposit.failed": "Deposit failed",
+  "transfer.exclusiveDeposit.warning": "Only send {{token}} on {{network}} to this address. Sending other tokens, using other chains, or amounts below the minimum deposit will result in permanent loss of funds.",
+  "transfer.exclusiveDeposit.selectFirst": "Select your network and token first",
+  "transfer.exclusiveDeposit.selectNetwork": "Select network",
+  "transfer.exclusiveDeposit.selectToken": "Select token",
+  "transfer.exclusiveDeposit.minDeposit": "Min. deposit",
+  "transfer.exclusiveDeposit.estimatedTime": "Estimated time",
+  "transfer.exclusiveDeposit.estimatedTime.default": "~ 5 min",
+  "transfer.exclusiveDeposit.depositPending": "Deposit pending: {{amount}} {{symbol}}",
   "transfer.deposit.feeUnavailable": "Fee data is currently unavailable. Please try again later.",
   "transfer.deposit.notEnoughGas": "Not enough gas. Add some {{token}} to your wallet to continue.",
   "transfer.deposit.exceedCap": "Amount exceeds user deposit cap",
   "transfer.deposit.closeToMaxLimit": "Deposit amount too close to maximum limit. To ensure your transaction succeeds, please reduce the amount",
+  "transfer.deposit.tab.connectedWallet": "From connected wallet",
+  "transfer.deposit.tab.exchangeOrOtherWallet": "From exchange / other wallet",
   "transfer.deposit.estGasFee": "Est. gas fee",
   "transfer.deposit.estGasFee.tooltip": "Estimated gas fee includes: transaction execution cost on this chain, and destination chain operation fee for Orderly deposit. Please prepare extra to ensure sufficient coverage.",
   "transfer.deposit.destinationGasFee": "Destination gas fee",
@@ -1479,10 +1474,10 @@ var en = {
   ...affiliate,
   ...ui,
   ...tradingLeaderboard,
-  ...tradingPoints,
   ...widget,
   ...vaults,
-  ...notification
+  ...notification,
+  ...navigation
 };
 
 // src/i18n.ts
@@ -1510,8 +1505,30 @@ var i18n = createI18nInstance({
 });
 i18n.init();
 var i18n_default = i18n;
+var LanguageContext = react.createContext({
+  languages: [],
+  onLanguageBeforeChanged: () => Promise.resolve(),
+  onLanguageChanged: () => Promise.resolve()
+});
+var useLanguageContext = () => {
+  return react.useContext(LanguageContext);
+};
+
+// src/resourceBundles/registerResources.ts
+async function registerResources(resources2, localeCode) {
+  if (typeof resources2 === "function") {
+    const resource = await resources2(localeCode, defaultNS);
+    i18n_default.addResourceBundle(localeCode, defaultNS, resource, true, true);
+    return;
+  }
+  if (resources2) {
+    Object.entries(resources2).forEach(([locale, messages]) => {
+      i18n_default.addResourceBundle(locale, defaultNS, messages, true, true);
+    });
+  }
+}
 
-// src/backend.ts
+// src/resourceBundles/httpBackend.ts
 var Backend = class {
   constructor(options) {
     this.options = options;
@@ -1555,15 +1572,38 @@ var Backend = class {
     await Promise.all(promises);
   }
 };
-var LocaleContext = react.createContext({
-  languages: [],
-  onLanguageBeforeChanged: () => Promise.resolve(),
-  onLanguageChanged: () => Promise.resolve()
-});
-var useLocaleContext = () => {
-  return react.useContext(LocaleContext);
+
+// src/resourceBundles/registerDefaultResource.ts
+var registerDefaultResource = (messages) => {
+  i18n_default.addResourceBundle(defaultLng, defaultNS, messages, true, true);
 };
 
+// src/resourceBundles/importLocaleJsonModule.ts
+function asMessageRecord(value) {
+  if (!value) {
+    return {};
+  }
+  if (typeof value !== "string") {
+    return value;
+  }
+  try {
+    return JSON.parse(value);
+  } catch {
+    return {};
+  }
+}
+async function importLocaleJsonModule(loader) {
+  if (!loader) {
+    return asMessageRecord(void 0);
+  }
+  try {
+    const mod = await loader();
+    return asMessageRecord(mod.default);
+  } catch {
+    return {};
+  }
+}
+
 // src/utils.ts
 function parseI18nLang(lang, localeCodes, defaultLang) {
   localeCodes = localeCodes || Object.values(LocaleEnum);
@@ -1601,19 +1641,9 @@ function generatePath(params) {
   localePath = locale || parseI18nLang(i18n_default.language);
   return `/${localePath}${path}${searchUrl}`;
 }
-var I18nProvider = (props) => {
-  const { children, ...rest } = props;
-  return (
-    // @ts-ignore
-    /* @__PURE__ */ jsxRuntime.jsx(reactI18next.I18nextProvider, { ...rest, children })
-  );
-};
-var LocaleProvider = (props) => {
+var LanguageProvider = (props) => {
   const {
     children,
-    locale,
-    resource,
-    resources: resources2,
     backend,
     popup,
     supportedLanguages,
@@ -1623,22 +1653,6 @@ var LocaleProvider = (props) => {
   } = props;
   const [languages, setLanguages] = react.useState(defaultLanguages);
   const backendRef = react.useRef(new Backend(backend));
-  react.useEffect(() => {
-    if (resources2) {
-      Object.entries(resources2).forEach(([locale2, messages]) => {
-        i18n_default.addResourceBundle(locale2, defaultNS, messages, true, true);
-      });
-      return;
-    }
-    if (resource && locale) {
-      i18n_default.addResourceBundle(locale, defaultNS, resource, true, true);
-    }
-  }, [locale, resource, resources2]);
-  react.useEffect(() => {
-    if (locale && locale !== i18n_default.language) {
-      i18n_default.changeLanguage(locale);
-    }
-  }, [locale]);
   react.useEffect(() => {
     if (Array.isArray(props.languages)) {
       setLanguages(props.languages);
@@ -1649,7 +1663,7 @@ var LocaleProvider = (props) => {
         ).filter((item) => !!item)
       );
     }
-  }, [supportedLanguages, props.languages]);
+  }, [props.languages, supportedLanguages]);
   react.useEffect(() => {
     const initLanguage = async () => {
       const lang = typeof convertDetectedLanguage === "function" ? convertDetectedLanguage(i18n_default.language) : parseI18nLang(i18n_default.language);
@@ -1681,59 +1695,62 @@ var LocaleProvider = (props) => {
       onLanguageChanged: languageChangedHandle
     };
   }, [popup, languages, languageBeforeChangedHandle, languageChangedHandle]);
-  return /* @__PURE__ */ jsxRuntime.jsx(LocaleContext.Provider, { value: memoizedValue, children: /* @__PURE__ */ jsxRuntime.jsx(reactI18next.I18nextProvider, { i18n: i18n_default, defaultNS, children }) });
+  return /* @__PURE__ */ jsxRuntime.jsx(LanguageContext.Provider, { value: memoizedValue, children });
 };
-function useTranslation(ns, options) {
-  const context = react.useContext(reactI18next.I18nContext);
-  return reactI18next.useTranslation(ns, {
-    i18n: context?.i18n || i18n_default,
-    // @ts-ignore
-    // when the language resource is loaded, notify the translation component to re-render
-    bindI18nStore: "added",
-    ...options
-  });
-}
 function useLocaleCode() {
-  const [loacaleCode, setLoacaleCode] = react.useState(
+  const [localeCode, setLocaleCode] = react.useState(
     parseI18nLang(i18n_default.language)
   );
   react.useEffect(() => {
     const handleLanguageChange = (lng) => {
-      setLoacaleCode(lng);
+      setLocaleCode(lng);
     };
     i18n_default.on("languageChanged", handleLanguageChange);
     return () => {
       i18n_default.off("languageChanged", handleLanguageChange);
     };
   }, [i18n_default]);
-  return loacaleCode;
+  return localeCode;
 }
-
-// src/external/utils.ts
-var preloadDefaultResource = (messages) => {
-  i18n_default.addResourceBundle(defaultLng, defaultNS, messages, true, true);
-};
-var asyncAddResource = async (localeCode, resources2) => {
-  const resource = await resources2(localeCode, defaultNS);
-  i18n_default.addResourceBundle(localeCode, defaultNS, resource, true, true);
-};
-var ExternalLocaleProvider = (props) => {
-  const { resources: resources2 } = props;
-  const localeCode = useLocaleCode();
+var LocaleProvider = (props) => {
+  const { children, locale, resource, resources: resources2, ...languageProviderProps } = props;
+  const localeCodeFromI18n = useLocaleCode();
   react.useEffect(() => {
-    if (typeof resources2 === "function") {
-      asyncAddResource(localeCode, resources2);
-      return;
-    }
     if (resources2) {
-      Object.entries(resources2).forEach(([locale, messages]) => {
-        i18n_default.addResourceBundle(locale, defaultNS, messages, true, true);
-      });
+      registerResources(resources2, locale ?? localeCodeFromI18n);
       return;
     }
+    if (resource && locale) {
+      i18n_default.addResourceBundle(locale, defaultNS, resource, true, true);
+    }
+  }, [locale, localeCodeFromI18n, resource, resources2]);
+  react.useEffect(() => {
+    if (locale && locale !== i18n_default.language) {
+      i18n_default.changeLanguage(locale);
+    }
+  }, [locale]);
+  return /* @__PURE__ */ jsxRuntime.jsx(LanguageProvider, { ...languageProviderProps, children: /* @__PURE__ */ jsxRuntime.jsx(reactI18next.I18nextProvider, { i18n: i18n_default, defaultNS, children }) });
+};
+function useRegisterExternalResources(resources2) {
+  const localeCode = useLocaleCode();
+  react.useEffect(() => {
+    registerResources(resources2, localeCode);
   }, [localeCode, resources2]);
+}
+var ExternalLocaleProvider = (props) => {
+  useRegisterExternalResources(props.resources);
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: props.children });
 };
+function useTranslation(ns, options) {
+  const context = react.useContext(reactI18next.I18nContext);
+  return reactI18next.useTranslation(ns, {
+    i18n: context?.i18n || i18n_default,
+    // @ts-ignore
+    // when the language resource is loaded, notify the translation component to re-render
+    bindI18nStore: "added",
+    ...options
+  });
+}
 
 Object.defineProperty(exports, "createInstance", {
   enumerable: true,
@@ -1743,11 +1760,13 @@ Object.defineProperty(exports, "i18next", {
   enumerable: true,
   get: function () { return i18next__default.default; }
 });
+exports.Backend = Backend;
 exports.ExternalLocaleProvider = ExternalLocaleProvider;
-exports.I18nProvider = I18nProvider;
-exports.LocaleContext = LocaleContext;
+exports.LanguageContext = LanguageContext;
+exports.LanguageProvider = LanguageProvider;
 exports.LocaleEnum = LocaleEnum;
 exports.LocaleProvider = LocaleProvider;
+exports.asMessageRecord = asMessageRecord;
 exports.createI18nInstance = createI18nInstance;
 exports.defaultLanguages = defaultLanguages;
 exports.defaultLng = defaultLng;
@@ -1758,11 +1777,14 @@ exports.getLocalePathFromPathname = getLocalePathFromPathname;
 exports.i18n = i18n_default;
 exports.i18nCookieKey = i18nCookieKey;
 exports.i18nLocalStorageKey = i18nLocalStorageKey;
+exports.importLocaleJsonModule = importLocaleJsonModule;
 exports.parseI18nLang = parseI18nLang;
-exports.preloadDefaultResource = preloadDefaultResource;
+exports.registerDefaultResource = registerDefaultResource;
+exports.registerResources = registerResources;
 exports.removeLangPrefix = removeLangPrefix;
+exports.useLanguageContext = useLanguageContext;
 exports.useLocaleCode = useLocaleCode;
-exports.useLocaleContext = useLocaleContext;
+exports.useRegisterExternalResources = useRegisterExternalResources;
 exports.useTranslation = useTranslation;
 Object.keys(reactI18next).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {