@liberfi.io/i18n 0.1.0

package/dist/utils.d.ts

@@ -0,0 +1,63 @@
+import { L as LocaleCode } from './types-DY-Gbo__.js';
+
+/**
+ * transform browser language to i18n locale codes
+ * @param lang - browser language
+ * @param localeCodes - locale codes to check
+ * @param defaultLang - default locale code
+ * @example
+ * parseI18nLang('en-US') => 'en'
+ * parseI18nLang('zh-CN') => 'zh'
+ * parseI18nLang('zh-TW') => 'zh'
+ * parseI18nLang('ja') => 'ja'
+ * */
+declare function parseI18nLang(lang: string, localeCodes?: LocaleCode[], defaultLang?: LocaleCode): string;
+/**
+ * remove lang prefix from pathname
+ * @param pathname - pathname to remove lang prefix
+ * @param localeCodes - locale codes to check
+ * @example
+ * removeLangPrefix('/en/perp/PERP_ETH_USDC') => '/perp/PERP_ETH_USDC'
+ * removeLangPrefix('/en/markets') => '/markets'
+ * removeLangPrefix('/perp/PERP_ETH_USDC') => '/perp/PERP_ETH_USDC'
+ * removeLangPrefix('/markets') => '/markets'
+ */
+declare function removeLangPrefix(pathname: string, localeCodes?: string[]): string;
+/**
+ * get locale path from pathname
+ * @param pathname - pathname to get locale path
+ * @param localeCodes - locale codes to check
+ * @example
+ * getLocalePathFromPathname('/en/perp/PERP_ETH_USDC') => 'en'
+ * getLocalePathFromPathname('/perp/PERP_ETH_USDC') => null
+ * getLocalePathFromPathname('/en/markets') => 'en'
+ * getLocalePathFromPathname('/markets') => null
+ */
+declare function getLocalePathFromPathname(pathname: string, localeCodes?: string[]): string | null;
+/**
+ * Generate a localized path with proper locale prefix and search parameters
+ *
+ * This function ensures that the returned path includes the appropriate locale prefix.
+ * If the path already contains a valid locale prefix, it returns the path as-is.
+ * Otherwise, it prepends the specified locale or falls back to the current i18n language.
+ *
+ * @param params - Configuration object for path generation
+ * @param params.path - The base pathname (e.g., '/markets', '/perp/PERP_ETH_USDC')
+ * @param params.locale - Optional locale code to use as prefix. If not provided, uses i18n.language
+ * @param params.search - Optional search query string. If not provided, uses window.location.search
+ *
+ * @returns A complete URL path with locale prefix and search parameters
+ *
+ * @example
+ * generatePath({ path: '/markets' }) => '/en/markets?tab=spot'
+ * generatePath({ path: '/en/markets', search: '?tab=futures' }) => '/en/markets?tab=futures'
+ * generatePath({ path: '/perp/PERP_ETH_USDC', locale: 'zh' }) => '/zh/perp/PERP_ETH_USDC'
+ * generatePath({ path: '/en/perp/PERP_ETH_USDC' }) => '/en/perp/PERP_ETH_USDC'
+ */
+declare function generatePath(params: {
+    path: string;
+    locale?: string;
+    search?: string;
+}): string;
+
+export { generatePath, getLocalePathFromPathname, parseI18nLang, removeLangPrefix };

package/dist/utils.js

@@ -0,0 +1,2 @@
+'use strict';var reactI18next=require('react-i18next'),i18next=require('i18next'),h=require('i18next-browser-languagedetector');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var h__default=/*#__PURE__*/_interopDefault(h);var i=(e=>(e.en="en",e.zh="zh",e.ja="ja",e.es="es",e.ko="ko",e.vi="vi",e.de="de",e.fr="fr",e.ru="ru",e.id="id",e.tr="tr",e.it="it",e.pt="pt",e.uk="uk",e.pl="pl",e.nl="nl",e))(i||{});var s="en",l="translation",m="liberfi_i18nLng",p="liberfi_i18nLng";var d={"common.cancel":"Cancel","common.confirm":"Confirm","common.ok":"OK","common.yes":"Yes","common.no":"No","common.all":"All","common.buy":"Buy","common.sell":"Sell","common.long":"Long","common.short":"Short","common.edit":"Edit","common.save":"Save","common.add":"Add","common.delete":"Delete","common.tips":"Tips","common.max":"Max","common.download":"Download","common.copy":"Copy","common.copy.failed":"Copy failed","common.copy.copied":"Copied","common.share":"Share","common.export":"Export"};var g={"mediaTrack.title":"Media Track","mediaTrack.description":"Media Track"};var f={...d,...g};var y=i18next.createInstance();y.use(h__default.default).use(reactI18next.initReactI18next).init({fallbackLng:s,ns:[l],defaultNS:l,interpolation:{escapeValue:false},detection:{lookupLocalStorage:m,lookupCookie:p,caches:["cookie","localStorage"],order:["cookie","localStorage","htmlTag","navigator"]},resources:{[s]:{[l]:f}}});var u=y;function N(t,o,a){o=o||Object.values(i),a=a||"en";let c=/^([a-z]{2})/i,r=t?.match(c);if(!r)return a;let n=r[1];return o.includes(t)?t:o.includes(n)?n:a}function _(t,o){let a=x(t,o);return a?t.replace(new RegExp(`^/${a}(?=/)`),""):t}function x(t,o){let a=t.split("/")[1];return o=o||Object.values(i),o.includes(a)?a:null}function U(t){let{path:o,locale:a,search:c}=t,r=c||(typeof window<"u"?window.location.search:""),n=x(o);return n?`${o}${r}`:(n=a||N(u.language),`/${n}${o}${r}`)}exports.generatePath=U;exports.getLocalePathFromPathname=x;exports.parseI18nLang=N;exports.removeLangPrefix=_;//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/constant.ts","../src/locale/module/common.ts","../src/locale/module/mediaTrack.ts","../src/locale/en.ts","../src/i18n.ts","../src/utils.ts"],"names":["LocaleEnum","defaultLng","defaultNS","i18nLocalStorageKey","i18nCookieKey","common","mediaTrack","en","i18n","createInstance","LanguageDetector","initReactI18next","i18n_default","parseI18nLang","lang","localeCodes","defaultLang","regex","match","matchLang","removeLangPrefix","pathname","localePath","getLocalePathFromPathname","locale","generatePath","params","path","search","searchUrl"],"mappings":"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","file":"utils.js","sourcesContent":["// import the original type declarations\nimport \"i18next\";\n// import all namespaces (for the default language, only)\nimport { en } from \"./locale/en\";\n\nexport enum LocaleEnum {\n  /** English */\n  en = \"en\",\n  /** Chinese */\n  zh = \"zh\",\n  /** Japanese */\n  ja = \"ja\",\n  /** Spanish */\n  es = \"es\",\n  /** Korean */\n  ko = \"ko\",\n  /** Vietnamese */\n  vi = \"vi\",\n  /** German */\n  de = \"de\",\n  /** French */\n  fr = \"fr\",\n  /** Russian */\n  ru = \"ru\",\n  /** Indonesian */\n  id = \"id\",\n  /** Turkish */\n  tr = \"tr\",\n  /** Italian */\n  it = \"it\",\n  /** Portuguese */\n  pt = \"pt\",\n  /** Ukrainian */\n  uk = \"uk\",\n  /** Polish */\n  pl = \"pl\",\n  /** Dutch */\n  nl = \"nl\",\n}\n\nexport type LocaleCode = keyof typeof LocaleEnum | (string & {});\n\nexport type Language = {\n  localCode: LocaleCode;\n  displayName: string;\n};\n\nexport type ExtendLocaleMessages = Record<`extend.${string}`, string>;\n\nexport type LocaleMessages = typeof en & ExtendLocaleMessages;\n\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport type Resources<T extends {} = {}> = {\n  [key in LocaleCode]?: Partial<LocaleMessages & T>;\n};\n\n// https://www.i18next.com/overview/typescript#create-a-declaration-file\n// Enhance the input parameter intelliSense for the t function.\ndeclare module \"i18next\" {\n  // Extend CustomTypeOptions\n  interface CustomTypeOptions {\n    // custom namespace type, if you changed it\n    defaultNS: \"translation\";\n    // custom resources type\n    resources: {\n      translation: LocaleMessages;\n    };\n  }\n}\n","import { Language, LocaleEnum } from \"./types\";\n\nexport const defaultLanguages: Language[] = [\n  { localCode: LocaleEnum.en, displayName: \"English\" }, // English\n  { localCode: LocaleEnum.zh, displayName: \"中文\" }, // Chinese\n  { localCode: LocaleEnum.ja, displayName: \"日本語\" }, // Japanese\n  { localCode: LocaleEnum.es, displayName: \"Español\" }, // Spanish\n  { localCode: LocaleEnum.ko, displayName: \"한국어\" }, // Korean\n  { localCode: LocaleEnum.vi, displayName: \"Tiếng Việt\" }, // Vietnamese\n  { localCode: LocaleEnum.de, displayName: \"Deutsch\" }, // German\n  { localCode: LocaleEnum.fr, displayName: \"Français\" }, // French\n  { localCode: LocaleEnum.ru, displayName: \"Русский\" }, // Russian\n  { localCode: LocaleEnum.id, displayName: \"Bahasa Indonesia\" }, // Indonesian\n  { localCode: LocaleEnum.tr, displayName: \"Türkçe\" }, // Turkish\n  { localCode: LocaleEnum.it, displayName: \"Italiano\" }, // Italian\n  { localCode: LocaleEnum.pt, displayName: \"Português\" }, // Portuguese\n  { localCode: LocaleEnum.uk, displayName: \"Українська\" }, // Ukrainian\n  { localCode: LocaleEnum.pl, displayName: \"Polski\" }, // Polish\n  { localCode: LocaleEnum.nl, displayName: \"Nederlands\" }, // Dutch\n];\n\nexport const defaultLng = LocaleEnum.en;\n\nexport const defaultNS = \"translation\";\n\nexport const i18nLocalStorageKey = \"liberfi_i18nLng\";\n\nexport const i18nCookieKey = \"liberfi_i18nLng\";\n","export const common = {\n  \"common.cancel\": \"Cancel\",\n  \"common.confirm\": \"Confirm\",\n  \"common.ok\": \"OK\",\n  \"common.yes\": \"Yes\",\n  \"common.no\": \"No\",\n  \"common.all\": \"All\",\n  \"common.buy\": \"Buy\",\n  \"common.sell\": \"Sell\",\n  \"common.long\": \"Long\",\n  \"common.short\": \"Short\",\n  \"common.edit\": \"Edit\",\n  \"common.save\": \"Save\",\n  \"common.add\": \"Add\",\n  \"common.delete\": \"Delete\",\n  \"common.tips\": \"Tips\",\n  \"common.max\": \"Max\",\n  \"common.download\": \"Download\",\n  \"common.copy\": \"Copy\",\n  \"common.copy.failed\": \"Copy failed\",\n  \"common.copy.copied\": \"Copied\",\n  \"common.share\": \"Share\",\n  \"common.export\": \"Export\",\n};\n","export const mediaTrack = {\n  \"mediaTrack.title\": \"Media Track\",\n  \"mediaTrack.description\": \"Media Track\",\n};\n","import { common } from \"./module/common\";\nimport { mediaTrack } from \"./module/mediaTrack\";\n\nexport const en = {\n  ...common,\n  ...mediaTrack,\n};\n","import { initReactI18next } from \"react-i18next\";\nimport { i18n as I18nInstance, createInstance } from \"i18next\";\nimport LanguageDetector from \"i18next-browser-languagedetector\";\nimport {\n  defaultLng,\n  defaultNS,\n  i18nCookieKey,\n  i18nLocalStorageKey,\n} from \"./constant\";\nimport { en } from \"./locale/en\";\n\nconst i18n: I18nInstance = createInstance();\n\ni18n\n  .use(LanguageDetector)\n  .use(initReactI18next) // bind react-i18next to the instance\n  .init({\n    fallbackLng: defaultLng,\n    ns: [defaultNS],\n    defaultNS,\n    interpolation: {\n      escapeValue: false, // not needed for react!!\n    },\n    detection: {\n      lookupLocalStorage: i18nLocalStorageKey,\n      lookupCookie: i18nCookieKey,\n      caches: [\"cookie\", \"localStorage\"],\n      order: [\"cookie\", \"localStorage\", \"htmlTag\", \"navigator\"],\n    },\n    resources: {\n      [defaultLng]: { [defaultNS]: en },\n    },\n  });\n\nexport default i18n;\n","import i18n from \"./i18n\";\nimport { type LocaleCode, LocaleEnum } from \"./types\";\n\n/**\n * transform browser language to i18n locale codes\n * @param lang - browser language\n * @param localeCodes - locale codes to check\n * @param defaultLang - default locale code\n * @example\n * parseI18nLang('en-US') => 'en'\n * parseI18nLang('zh-CN') => 'zh'\n * parseI18nLang('zh-TW') => 'zh'\n * parseI18nLang('ja') => 'ja'\n * */\nexport function parseI18nLang(\n  lang: string,\n  localeCodes?: LocaleCode[],\n  defaultLang?: LocaleCode,\n) {\n  localeCodes = localeCodes || Object.values(LocaleEnum);\n  defaultLang = defaultLang || LocaleEnum.en;\n\n  const regex = /^([a-z]{2})/i;\n  const match = lang?.match(regex);\n\n  if (!match) {\n    return defaultLang;\n  }\n\n  const matchLang = match[1];\n\n  if (localeCodes.includes(lang)) {\n    return lang;\n  }\n\n  if (localeCodes.includes(matchLang)) {\n    return matchLang;\n  }\n\n  return defaultLang;\n}\n\n/**\n * remove lang prefix from pathname\n * @param pathname - pathname to remove lang prefix\n * @param localeCodes - locale codes to check\n * @example\n * removeLangPrefix('/en/perp/PERP_ETH_USDC') => '/perp/PERP_ETH_USDC'\n * removeLangPrefix('/en/markets') => '/markets'\n * removeLangPrefix('/perp/PERP_ETH_USDC') => '/perp/PERP_ETH_USDC'\n * removeLangPrefix('/markets') => '/markets'\n */\nexport function removeLangPrefix(pathname: string, localeCodes?: string[]) {\n  const localePath = getLocalePathFromPathname(pathname, localeCodes);\n\n  return localePath\n    ? pathname.replace(new RegExp(`^/${localePath}(?=/)`), \"\")\n    : pathname;\n}\n\n/**\n * get locale path from pathname\n * @param pathname - pathname to get locale path\n * @param localeCodes - locale codes to check\n * @example\n * getLocalePathFromPathname('/en/perp/PERP_ETH_USDC') => 'en'\n * getLocalePathFromPathname('/perp/PERP_ETH_USDC') => null\n * getLocalePathFromPathname('/en/markets') => 'en'\n * getLocalePathFromPathname('/markets') => null\n */\nexport function getLocalePathFromPathname(\n  pathname: string,\n  localeCodes?: string[],\n) {\n  const locale = pathname.split(\"/\")[1];\n  localeCodes = localeCodes || Object.values(LocaleEnum);\n  return localeCodes.includes(locale as LocaleEnum) ? locale : null;\n}\n\n/**\n * Generate a localized path with proper locale prefix and search parameters\n *\n * This function ensures that the returned path includes the appropriate locale prefix.\n * If the path already contains a valid locale prefix, it returns the path as-is.\n * Otherwise, it prepends the specified locale or falls back to the current i18n language.\n *\n * @param params - Configuration object for path generation\n * @param params.path - The base pathname (e.g., '/markets', '/perp/PERP_ETH_USDC')\n * @param params.locale - Optional locale code to use as prefix. If not provided, uses i18n.language\n * @param params.search - Optional search query string. If not provided, uses window.location.search\n *\n * @returns A complete URL path with locale prefix and search parameters\n *\n * @example\n * generatePath({ path: '/markets' }) => '/en/markets?tab=spot'\n * generatePath({ path: '/en/markets', search: '?tab=futures' }) => '/en/markets?tab=futures'\n * generatePath({ path: '/perp/PERP_ETH_USDC', locale: 'zh' }) => '/zh/perp/PERP_ETH_USDC'\n * generatePath({ path: '/en/perp/PERP_ETH_USDC' }) => '/en/perp/PERP_ETH_USDC'\n */\nexport function generatePath(params: {\n  path: string;\n  locale?: string;\n  search?: string;\n}) {\n  const { path, locale, search } = params;\n  const searchUrl =\n    search || (typeof window !== \"undefined\" ? window.location.search : \"\");\n\n  let localePath = getLocalePathFromPathname(path);\n\n  // If path already contains a valid locale prefix, return it unchanged\n  if (localePath) {\n    return `${path}${searchUrl}`;\n  }\n\n  // Use provided locale or fall back to current i18n language\n  localePath = locale || parseI18nLang(i18n.language);\n\n  // Prepend locale prefix to path\n  return `/${localePath}${path}${searchUrl}`;\n}\n"]}

package/dist/utils.mjs

@@ -0,0 +1,2 @@
+import {initReactI18next}from'react-i18next';import {createInstance}from'i18next';import h from'i18next-browser-languagedetector';var i=(e=>(e.en="en",e.zh="zh",e.ja="ja",e.es="es",e.ko="ko",e.vi="vi",e.de="de",e.fr="fr",e.ru="ru",e.id="id",e.tr="tr",e.it="it",e.pt="pt",e.uk="uk",e.pl="pl",e.nl="nl",e))(i||{});var s="en",l="translation",m="liberfi_i18nLng",p="liberfi_i18nLng";var d={"common.cancel":"Cancel","common.confirm":"Confirm","common.ok":"OK","common.yes":"Yes","common.no":"No","common.all":"All","common.buy":"Buy","common.sell":"Sell","common.long":"Long","common.short":"Short","common.edit":"Edit","common.save":"Save","common.add":"Add","common.delete":"Delete","common.tips":"Tips","common.max":"Max","common.download":"Download","common.copy":"Copy","common.copy.failed":"Copy failed","common.copy.copied":"Copied","common.share":"Share","common.export":"Export"};var g={"mediaTrack.title":"Media Track","mediaTrack.description":"Media Track"};var f={...d,...g};var y=createInstance();y.use(h).use(initReactI18next).init({fallbackLng:s,ns:[l],defaultNS:l,interpolation:{escapeValue:false},detection:{lookupLocalStorage:m,lookupCookie:p,caches:["cookie","localStorage"],order:["cookie","localStorage","htmlTag","navigator"]},resources:{[s]:{[l]:f}}});var u=y;function N(t,o,a){o=o||Object.values(i),a=a||"en";let c=/^([a-z]{2})/i,r=t?.match(c);if(!r)return a;let n=r[1];return o.includes(t)?t:o.includes(n)?n:a}function _(t,o){let a=x(t,o);return a?t.replace(new RegExp(`^/${a}(?=/)`),""):t}function x(t,o){let a=t.split("/")[1];return o=o||Object.values(i),o.includes(a)?a:null}function U(t){let{path:o,locale:a,search:c}=t,r=c||(typeof window<"u"?window.location.search:""),n=x(o);return n?`${o}${r}`:(n=a||N(u.language),`/${n}${o}${r}`)}export{U as generatePath,x as getLocalePathFromPathname,N as parseI18nLang,_ as removeLangPrefix};//# sourceMappingURL=utils.mjs.map
+//# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/constant.ts","../src/locale/module/common.ts","../src/locale/module/mediaTrack.ts","../src/locale/en.ts","../src/i18n.ts","../src/utils.ts"],"names":["LocaleEnum","defaultLng","defaultNS","i18nLocalStorageKey","i18nCookieKey","common","mediaTrack","en","i18n","createInstance","LanguageDetector","initReactI18next","i18n_default","parseI18nLang","lang","localeCodes","defaultLang","regex","match","matchLang","removeLangPrefix","pathname","localePath","getLocalePathFromPathname","locale","generatePath","params","path","search","searchUrl"],"mappings":"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","file":"utils.mjs","sourcesContent":["// import the original type declarations\nimport \"i18next\";\n// import all namespaces (for the default language, only)\nimport { en } from \"./locale/en\";\n\nexport enum LocaleEnum {\n  /** English */\n  en = \"en\",\n  /** Chinese */\n  zh = \"zh\",\n  /** Japanese */\n  ja = \"ja\",\n  /** Spanish */\n  es = \"es\",\n  /** Korean */\n  ko = \"ko\",\n  /** Vietnamese */\n  vi = \"vi\",\n  /** German */\n  de = \"de\",\n  /** French */\n  fr = \"fr\",\n  /** Russian */\n  ru = \"ru\",\n  /** Indonesian */\n  id = \"id\",\n  /** Turkish */\n  tr = \"tr\",\n  /** Italian */\n  it = \"it\",\n  /** Portuguese */\n  pt = \"pt\",\n  /** Ukrainian */\n  uk = \"uk\",\n  /** Polish */\n  pl = \"pl\",\n  /** Dutch */\n  nl = \"nl\",\n}\n\nexport type LocaleCode = keyof typeof LocaleEnum | (string & {});\n\nexport type Language = {\n  localCode: LocaleCode;\n  displayName: string;\n};\n\nexport type ExtendLocaleMessages = Record<`extend.${string}`, string>;\n\nexport type LocaleMessages = typeof en & ExtendLocaleMessages;\n\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport type Resources<T extends {} = {}> = {\n  [key in LocaleCode]?: Partial<LocaleMessages & T>;\n};\n\n// https://www.i18next.com/overview/typescript#create-a-declaration-file\n// Enhance the input parameter intelliSense for the t function.\ndeclare module \"i18next\" {\n  // Extend CustomTypeOptions\n  interface CustomTypeOptions {\n    // custom namespace type, if you changed it\n    defaultNS: \"translation\";\n    // custom resources type\n    resources: {\n      translation: LocaleMessages;\n    };\n  }\n}\n","import { Language, LocaleEnum } from \"./types\";\n\nexport const defaultLanguages: Language[] = [\n  { localCode: LocaleEnum.en, displayName: \"English\" }, // English\n  { localCode: LocaleEnum.zh, displayName: \"中文\" }, // Chinese\n  { localCode: LocaleEnum.ja, displayName: \"日本語\" }, // Japanese\n  { localCode: LocaleEnum.es, displayName: \"Español\" }, // Spanish\n  { localCode: LocaleEnum.ko, displayName: \"한국어\" }, // Korean\n  { localCode: LocaleEnum.vi, displayName: \"Tiếng Việt\" }, // Vietnamese\n  { localCode: LocaleEnum.de, displayName: \"Deutsch\" }, // German\n  { localCode: LocaleEnum.fr, displayName: \"Français\" }, // French\n  { localCode: LocaleEnum.ru, displayName: \"Русский\" }, // Russian\n  { localCode: LocaleEnum.id, displayName: \"Bahasa Indonesia\" }, // Indonesian\n  { localCode: LocaleEnum.tr, displayName: \"Türkçe\" }, // Turkish\n  { localCode: LocaleEnum.it, displayName: \"Italiano\" }, // Italian\n  { localCode: LocaleEnum.pt, displayName: \"Português\" }, // Portuguese\n  { localCode: LocaleEnum.uk, displayName: \"Українська\" }, // Ukrainian\n  { localCode: LocaleEnum.pl, displayName: \"Polski\" }, // Polish\n  { localCode: LocaleEnum.nl, displayName: \"Nederlands\" }, // Dutch\n];\n\nexport const defaultLng = LocaleEnum.en;\n\nexport const defaultNS = \"translation\";\n\nexport const i18nLocalStorageKey = \"liberfi_i18nLng\";\n\nexport const i18nCookieKey = \"liberfi_i18nLng\";\n","export const common = {\n  \"common.cancel\": \"Cancel\",\n  \"common.confirm\": \"Confirm\",\n  \"common.ok\": \"OK\",\n  \"common.yes\": \"Yes\",\n  \"common.no\": \"No\",\n  \"common.all\": \"All\",\n  \"common.buy\": \"Buy\",\n  \"common.sell\": \"Sell\",\n  \"common.long\": \"Long\",\n  \"common.short\": \"Short\",\n  \"common.edit\": \"Edit\",\n  \"common.save\": \"Save\",\n  \"common.add\": \"Add\",\n  \"common.delete\": \"Delete\",\n  \"common.tips\": \"Tips\",\n  \"common.max\": \"Max\",\n  \"common.download\": \"Download\",\n  \"common.copy\": \"Copy\",\n  \"common.copy.failed\": \"Copy failed\",\n  \"common.copy.copied\": \"Copied\",\n  \"common.share\": \"Share\",\n  \"common.export\": \"Export\",\n};\n","export const mediaTrack = {\n  \"mediaTrack.title\": \"Media Track\",\n  \"mediaTrack.description\": \"Media Track\",\n};\n","import { common } from \"./module/common\";\nimport { mediaTrack } from \"./module/mediaTrack\";\n\nexport const en = {\n  ...common,\n  ...mediaTrack,\n};\n","import { initReactI18next } from \"react-i18next\";\nimport { i18n as I18nInstance, createInstance } from \"i18next\";\nimport LanguageDetector from \"i18next-browser-languagedetector\";\nimport {\n  defaultLng,\n  defaultNS,\n  i18nCookieKey,\n  i18nLocalStorageKey,\n} from \"./constant\";\nimport { en } from \"./locale/en\";\n\nconst i18n: I18nInstance = createInstance();\n\ni18n\n  .use(LanguageDetector)\n  .use(initReactI18next) // bind react-i18next to the instance\n  .init({\n    fallbackLng: defaultLng,\n    ns: [defaultNS],\n    defaultNS,\n    interpolation: {\n      escapeValue: false, // not needed for react!!\n    },\n    detection: {\n      lookupLocalStorage: i18nLocalStorageKey,\n      lookupCookie: i18nCookieKey,\n      caches: [\"cookie\", \"localStorage\"],\n      order: [\"cookie\", \"localStorage\", \"htmlTag\", \"navigator\"],\n    },\n    resources: {\n      [defaultLng]: { [defaultNS]: en },\n    },\n  });\n\nexport default i18n;\n","import i18n from \"./i18n\";\nimport { type LocaleCode, LocaleEnum } from \"./types\";\n\n/**\n * transform browser language to i18n locale codes\n * @param lang - browser language\n * @param localeCodes - locale codes to check\n * @param defaultLang - default locale code\n * @example\n * parseI18nLang('en-US') => 'en'\n * parseI18nLang('zh-CN') => 'zh'\n * parseI18nLang('zh-TW') => 'zh'\n * parseI18nLang('ja') => 'ja'\n * */\nexport function parseI18nLang(\n  lang: string,\n  localeCodes?: LocaleCode[],\n  defaultLang?: LocaleCode,\n) {\n  localeCodes = localeCodes || Object.values(LocaleEnum);\n  defaultLang = defaultLang || LocaleEnum.en;\n\n  const regex = /^([a-z]{2})/i;\n  const match = lang?.match(regex);\n\n  if (!match) {\n    return defaultLang;\n  }\n\n  const matchLang = match[1];\n\n  if (localeCodes.includes(lang)) {\n    return lang;\n  }\n\n  if (localeCodes.includes(matchLang)) {\n    return matchLang;\n  }\n\n  return defaultLang;\n}\n\n/**\n * remove lang prefix from pathname\n * @param pathname - pathname to remove lang prefix\n * @param localeCodes - locale codes to check\n * @example\n * removeLangPrefix('/en/perp/PERP_ETH_USDC') => '/perp/PERP_ETH_USDC'\n * removeLangPrefix('/en/markets') => '/markets'\n * removeLangPrefix('/perp/PERP_ETH_USDC') => '/perp/PERP_ETH_USDC'\n * removeLangPrefix('/markets') => '/markets'\n */\nexport function removeLangPrefix(pathname: string, localeCodes?: string[]) {\n  const localePath = getLocalePathFromPathname(pathname, localeCodes);\n\n  return localePath\n    ? pathname.replace(new RegExp(`^/${localePath}(?=/)`), \"\")\n    : pathname;\n}\n\n/**\n * get locale path from pathname\n * @param pathname - pathname to get locale path\n * @param localeCodes - locale codes to check\n * @example\n * getLocalePathFromPathname('/en/perp/PERP_ETH_USDC') => 'en'\n * getLocalePathFromPathname('/perp/PERP_ETH_USDC') => null\n * getLocalePathFromPathname('/en/markets') => 'en'\n * getLocalePathFromPathname('/markets') => null\n */\nexport function getLocalePathFromPathname(\n  pathname: string,\n  localeCodes?: string[],\n) {\n  const locale = pathname.split(\"/\")[1];\n  localeCodes = localeCodes || Object.values(LocaleEnum);\n  return localeCodes.includes(locale as LocaleEnum) ? locale : null;\n}\n\n/**\n * Generate a localized path with proper locale prefix and search parameters\n *\n * This function ensures that the returned path includes the appropriate locale prefix.\n * If the path already contains a valid locale prefix, it returns the path as-is.\n * Otherwise, it prepends the specified locale or falls back to the current i18n language.\n *\n * @param params - Configuration object for path generation\n * @param params.path - The base pathname (e.g., '/markets', '/perp/PERP_ETH_USDC')\n * @param params.locale - Optional locale code to use as prefix. If not provided, uses i18n.language\n * @param params.search - Optional search query string. If not provided, uses window.location.search\n *\n * @returns A complete URL path with locale prefix and search parameters\n *\n * @example\n * generatePath({ path: '/markets' }) => '/en/markets?tab=spot'\n * generatePath({ path: '/en/markets', search: '?tab=futures' }) => '/en/markets?tab=futures'\n * generatePath({ path: '/perp/PERP_ETH_USDC', locale: 'zh' }) => '/zh/perp/PERP_ETH_USDC'\n * generatePath({ path: '/en/perp/PERP_ETH_USDC' }) => '/en/perp/PERP_ETH_USDC'\n */\nexport function generatePath(params: {\n  path: string;\n  locale?: string;\n  search?: string;\n}) {\n  const { path, locale, search } = params;\n  const searchUrl =\n    search || (typeof window !== \"undefined\" ? window.location.search : \"\");\n\n  let localePath = getLocalePathFromPathname(path);\n\n  // If path already contains a valid locale prefix, return it unchanged\n  if (localePath) {\n    return `${path}${searchUrl}`;\n  }\n\n  // Use provided locale or fall back to current i18n language\n  localePath = locale || parseI18nLang(i18n.language);\n\n  // Prepend locale prefix to path\n  return `/${localePath}${path}${searchUrl}`;\n}\n"]}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@liberfi.io/i18n",
+  "version": "0.1.0",
+  "description": "Internationalization for Liberfi React SDK",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    },
+    "./locales/*": "./dist/locales/*",
+    "./constant": {
+      "types": "./dist/constant.d.ts",
+      "require": "./dist/constant.js",
+      "import": "./dist/constant.mjs"
+    },
+    "./utils": {
+      "types": "./dist/utils.d.ts",
+      "require": "./dist/utils.js",
+      "import": "./dist/utils.mjs"
+    }
+  },
+  "bin": {
+    "i18n": "bin/cli.js"
+  },
+  "keywords": [],
+  "files": [
+    "dist",
+    "script"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "i18next": "^25.5.2",
+    "i18next-browser-languagedetector": "^8.2.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
+    "react-i18next": "^15.7.3"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.22.9",
+    "@babel/preset-env": "^7.22.9",
+    "@babel/preset-react": "^7.27.1",
+    "@babel/preset-typescript": "^7.22.5",
+    "@types/react": "^19.1.13",
+    "@types/react-dom": "^19.1.9",
+    "@types/fs-extra": "^11.0.4",
+    "@types/jest": "^29.5.3",
+    "fs-extra": "^11.3.2",
+    "babel-jest": "^29.6.1",
+    "jest": "^29.6.1",
+    "jest-environment-jsdom": "^29.7.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "yargs": "^18.0.0",
+    "tsconfig": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "scripts": {
+    "test": "jest",
+    "build": "tsup && pnpm locales",
+    "locales": "pnpm _generateEnJson && pnpm mergeJson && pnpm json2csv",
+    "cli": "node ./bin/cli.js",
+    "csv2json": "pnpm cli csv2json ./dist/locale.csv ./dist/locales",
+    "json2csv": "pnpm cli json2csv ./dist/locales ./dist/locale.csv",
+    "generateCsv": "pnpm cli generateCsv ./dist/locale.csv",
+    "diffcsv": "pnpm cli diffcsv ./dist/locale1.csv ./dist/locale2.csv",
+    "fillJson": "pnpm cli fillJson ./src/locale/zh.json ./dist/locale/zh.json",
+    "separateJson": "pnpm cli separateJson ./locales ./dist/locales extend",
+    "mergeJson": "pnpm cli mergeJson ./locales ./dist/locales",
+    "mergeExtendJson": "pnpm cli mergeJson ./locales ./locales",
+    "_generateEnJson": "node ./script/generateEnJson.js",
+    "generateEnJson": "pnpm tsup && node ./script/generateEnJson.js",
+    "copyLocales": "node ./script/copyLocales.js",
+    "generateMissingKeys": "pnpm tsup && pnpm _generateEnJson && node ./script/generateMissingKeys.js"
+  }
+}

package/script/copyLocales.js

@@ -0,0 +1,11 @@
+const fs = require("fs-extra");
+const path = require("path");
+
+async function copyLocales() {
+  await fs.copy(
+    path.resolve(__dirname, "../locales"),
+    path.resolve(__dirname, "../dist/locales"),
+  );
+}
+
+copyLocales();

package/script/csv2json.js

@@ -0,0 +1,28 @@
+const fs = require("fs-extra");
+const path = require("path");
+const { csv2multiJson } = require("./json-csv-converter");
+const { checkFileExists } = require("./utils");
+
+/** Convert locale CSV to multiple locale JSON files */
+async function csv2json(inputPath, outputDir) {
+  const csv = fs.readFileSync(inputPath, { encoding: "utf8" });
+
+  const json = csv2multiJson(csv);
+
+  const files = [];
+
+  for (const key of Object.keys(json)) {
+    const filePath = path.resolve(outputDir, `${key}.json`);
+    await checkFileExists(filePath);
+    await fs.outputFile(filePath, JSON.stringify(json[key], undefined, 4), {
+      encoding: "utf8",
+    });
+    files.push(filePath);
+  }
+
+  console.log("csv2json success =>", files);
+}
+
+module.exports = {
+  csv2json,
+};

package/script/diffCsv.js

@@ -0,0 +1,175 @@
+const fs = require("fs-extra");
+const path = require("path");
+const { csv2multiJson } = require("./json-csv-converter");
+const packageJson = require("../package.json");
+
+/**
+ * https://www.jsdelivr.com/package/npm/@liberfi.io/i18n?tab=files&path=dist
+ * Compare two locale CSV files
+ */
+async function diffCsv(oldFile, newFile) {
+  const oldCsv = await fs.readFile(oldFile, { encoding: "utf8" });
+  const newCsv = await fs.readFile(newFile, { encoding: "utf8" });
+
+  const oldJson = csv2multiJson(oldCsv);
+  const newJson = csv2multiJson(newCsv);
+  const diffResult = compareJsonFiles(oldJson, newJson);
+  console.log("CSV diff result:", JSON.stringify(diffResult, null, 2));
+
+  const filepath = path.resolve("LOCALE_CHANGELOG.md");
+
+  // generate .md file
+  let markdownContent = generateMarkdown(diffResult);
+
+  if (!(await fs.exists(filepath))) {
+    const title = `# Locale Changelog`;
+    markdownContent = `${title}\n\n${markdownContent}`;
+
+    await fs.writeFile(filepath, markdownContent, {
+      encoding: "utf8",
+    });
+    console.log("LOCALE_CHANGELOG.md created");
+  } else {
+    // Read existing content
+    const existingContent = await fs.readFile(filepath, { encoding: "utf8" });
+
+    // Find the position after "# Locale Changelog"
+    const titleIndex = existingContent.indexOf("# Locale Changelog");
+    if (titleIndex === -1) {
+      console.error("Could not find '# Locale Changelog' title in the file");
+      return;
+    }
+
+    const titleEndIndex = titleIndex + "# Locale Changelog".length;
+
+    // Split content and insert new content after the title
+    const beforeTitle = existingContent.slice(0, titleEndIndex);
+    const afterTitle = existingContent.slice(titleEndIndex);
+
+    // Combine all parts
+    const newContent = `${beforeTitle}\n\n${markdownContent}${afterTitle}`;
+
+    // Write back to file
+    await fs.writeFile(filepath, newContent, {
+      encoding: "utf8",
+    });
+    console.log("LOCALE_CHANGELOG.md updated");
+  }
+}
+
+// Compare function
+function compareJsonFiles(oldJson, newJson) {
+  const result = {
+    added: {},
+    removed: {},
+    updated: {},
+  };
+
+  Object.keys(newJson).forEach((lang) => {
+    result.added[lang] = {};
+    result.removed[lang] = {};
+    result.updated[lang] = {};
+
+    const oldKeys = oldJson[lang] || {};
+    const newKeys = newJson[lang];
+
+    // Find added keys
+    Object.keys(newKeys).forEach((key) => {
+      if (!(key in oldKeys)) {
+        result.added[lang][key] = newKeys[key];
+      }
+    });
+
+    // Find removed keys
+    Object.keys(oldKeys).forEach((key) => {
+      if (!(key in newKeys)) {
+        result.removed[lang][key] = oldKeys[key];
+      }
+    });
+
+    // Find updated keys (same key, different value)
+    Object.keys(newKeys).forEach((key) => {
+      if (key in oldKeys && oldKeys[key] !== newKeys[key]) {
+        result.updated[lang][key] = {
+          old: oldKeys[key],
+          new: newKeys[key],
+        };
+      }
+    });
+  });
+
+  return result;
+}
+
+// generate Markdown conent
+function generateMarkdown(diff) {
+  let mdContent = `## ${packageJson.version}\n\n`;
+
+  const addedKeysEmpty = Object.keys(diff.added).every((lang) => {
+    return Object.keys(diff.added[lang]).length === 0;
+  });
+  const removedKeysEmpty = Object.keys(diff.removed).every((lang) => {
+    return Object.keys(diff.removed[lang]).length === 0;
+  });
+  const updatedKeysEmpty = Object.keys(diff.updated).every((lang) => {
+    return Object.keys(diff.updated[lang]).length === 0;
+  });
+
+  if (addedKeysEmpty && removedKeysEmpty && updatedKeysEmpty) {
+    return `${mdContent}### No locale changes`;
+  }
+
+  // handle added content
+  if (!addedKeysEmpty) {
+    mdContent += `### Added Keys\n`;
+    Object.keys(diff.added).forEach((lang) => {
+      if (Object.keys(diff.added[lang]).length === 0) {
+        mdContent += `\n#### Language: **${lang}**\n> No added keys.\n`;
+      } else {
+        mdContent += `\n#### Language: **${lang}**\n`;
+        mdContent += `| Key | Value |\n| --- | --- |\n`;
+        Object.entries(diff.added[lang]).forEach(([key, value]) => {
+          mdContent += `| ${key} | ${value} |\n`;
+        });
+      }
+    });
+  }
+
+  // handle removed content
+  if (!removedKeysEmpty) {
+    mdContent += `\n### Removed Keys\n`;
+    Object.keys(diff.removed).forEach((lang) => {
+      if (Object.keys(diff.removed[lang]).length === 0) {
+        mdContent += `\n#### Language: **${lang}**\n> No removed keys.\n`;
+      } else {
+        mdContent += `\n#### Language: **${lang}**\n`;
+        mdContent += `| Key | Value |\n| --- | --- |\n`;
+        Object.entries(diff.removed[lang]).forEach(([key, value]) => {
+          mdContent += `| ${key} | ${value} |\n`;
+        });
+      }
+    });
+  }
+
+  // handle updated content
+  if (!updatedKeysEmpty) {
+    mdContent += `\n### Updated Keys\n`;
+    Object.keys(diff.updated).forEach((lang) => {
+      if (Object.keys(diff.updated[lang]).length === 0) {
+        mdContent += `\n#### Language: **${lang}**\n> No updates found.\n`;
+      } else {
+        mdContent += `\n#### Language: **${lang}**\n`;
+        mdContent += `| Key | Old Value | New Value |\n| --- | --- | --- |\n`;
+        Object.entries(diff.updated[lang]).forEach(([key, values]) => {
+          mdContent += `| ${key} | ${values.old} | ${values.new} |\n`;
+        });
+      }
+    });
+  }
+
+  return mdContent;
+}
+
+module.exports = {
+  diffCsv,
+};

package/script/fillJson.js

@@ -0,0 +1,33 @@
+const fs = require("fs-extra");
+const path = require("path");
+const { checkFileExists } = require("./utils");
+const { en } = require("../dist");
+
+/** Fill values from the input locale JSON file and generate a new locale JSON file */
+async function fillJson(inputPath, outputPath) {
+  const inputJson = await fs.readJSON(inputPath, { encoding: "utf8" });
+
+  const newJson = {};
+  const missingValues = {};
+  Object.keys(en).forEach((key) => {
+    const value = inputJson[key] || "";
+    if (!value) {
+      missingValues[key] = en[key];
+    }
+    newJson[key] = value;
+  });
+  console.log("missingValues", missingValues);
+
+  const jsonPath = path.resolve(outputPath);
+  await checkFileExists(jsonPath);
+
+  await fs.outputFile(jsonPath, JSON.stringify(newJson, null, 4), {
+    encoding: "utf8",
+  });
+
+  console.log("fillJson success =>", jsonPath);
+}
+
+module.exports = {
+  fillJson,
+};

package/script/generateCsv.js

@@ -0,0 +1,36 @@
+const fs = require("fs-extra");
+const path = require("path");
+const { checkFileExists } = require("./utils");
+const { multiJson2Csv } = require("./json-csv-converter");
+const { defaultLanguages } = require("../dist");
+
+/** Generate a locale CSV file */
+async function generateCsv(outputPath) {
+  const headers = [""];
+  const jsonList = [];
+
+  for (const item of defaultLanguages) {
+    headers.push(item.localCode);
+    const json = await fs.readJSON(
+      path.resolve(__dirname, `../locales/${item.localCode}.json`),
+      {
+        encoding: "utf8",
+      },
+    );
+    jsonList.push(json);
+  }
+
+  const csv = multiJson2Csv(jsonList, headers);
+
+  const csvPath = path.resolve(outputPath);
+
+  await checkFileExists(outputPath);
+
+  await fs.outputFile(outputPath, csv, { encoding: "utf8" });
+
+  console.log("generateCsv success =>", csvPath);
+}
+
+module.exports = {
+  generateCsv,
+};

package/script/generateEnJson.js

@@ -0,0 +1,11 @@
+const fs = require("fs-extra");
+const path = require("path");
+const { en } = require("../dist");
+
+async function generateEnJson() {
+  const outPath = path.resolve(__dirname, "../locales/en.json");
+  const jsonData = JSON.stringify(en, null, 2);
+  await fs.outputFile(outPath, jsonData, { encoding: "utf8" });
+}
+
+generateEnJson();

package/script/generateMissingKeys.js

@@ -0,0 +1,48 @@
+const fs = require("fs-extra");
+const path = require("path");
+const { getMissingKeys } = require("./json-csv-converter");
+const { checkFileExists, findJsonFiles } = require("./utils");
+const { LocaleEnum } = require("../dist");
+
+async function generateMissingKeys() {
+  const inputDir = path.resolve(__dirname, "../locales");
+  const jsonFiles = await findJsonFiles(inputDir);
+
+  // Sort input files by locale
+  jsonFiles.sort((a, b) => (b.startsWith(LocaleEnum.en) ? 1 : -1));
+
+  const jsonList = [];
+  const headers = [""];
+
+  for (const file of jsonFiles) {
+    const jsonPath = path.resolve(inputDir, file);
+
+    const json = await fs.readJSON(jsonPath, {
+      encoding: "utf8",
+    });
+
+    jsonList.push(json);
+
+    const fileName = path.basename(file, path.extname(file));
+    headers.push(fileName);
+  }
+
+  const errors = getMissingKeys(jsonList, headers);
+
+  const missingJson = {};
+  for (const locale of Object.values(errors)) {
+    for (const [key, value] of Object.entries(locale)) {
+      missingJson[key] = value;
+    }
+  }
+
+  const outputPath = path.resolve(inputDir, "extend/en.json");
+
+  await checkFileExists(outputPath);
+
+  await fs.outputFile(outputPath, JSON.stringify(missingJson, null, 2), {
+    encoding: "utf8",
+  });
+}
+
+generateMissingKeys();