react-i18next/dist/commonjs/utils.js

Internationalization for react done right. Using the i18next i18n ecosystem.

"use strict";

Object.defineProperty(exports, "__esModule", {
  value: true
});
exports.warnOnce = exports.warn = exports.loadNamespaces = exports.loadLanguages = exports.isString = exports.isObject = exports.inDevelopment = exports.hasLoadedNamespace = exports.getFormatPlugin = exports.getDisplayName = exports.escapeStringValues = void 0;
const warn = (i18n, code, msg, rest) => {
  const args = [msg, {
    code,
    ...(rest || {})
  }];
  if (i18n?.services?.logger?.forward) {
    return i18n.services.logger.forward(args, 'warn', 'react-i18next::', true);
  }
  if (isString(args[0])) args[0] = `react-i18next:: ${args[0]}`;
  if (i18n?.services?.logger?.warn) {
    i18n.services.logger.warn(...args);
  } else if (console?.warn) {
    console.warn(...args);
  }
};
exports.warn = warn;
const warnedFor = new WeakMap();
const warnedWithoutInstance = new Set();
const warnOnce = (i18n, code, msg, rest) => {
  if (isString(msg)) {
    let warned = warnedWithoutInstance;
    const owner = i18n?.services?.logger || i18n;
    if (isObject(owner)) {
      warned = warnedFor.get(owner);
      if (!warned) warnedFor.set(owner, warned = new Set());
    }
    if (warned.has(msg)) return;
    warned.add(msg);
  }
  warn(i18n, code, msg, rest);
};
exports.warnOnce = warnOnce;
const inDevelopment = () => {
  try {
    return process.env.NODE_ENV !== 'production';
  } catch (e) {
    return false;
  }
};
exports.inDevelopment = inDevelopment;
const loadedClb = (i18n, cb) => () => {
  if (i18n.isInitialized) {
    cb();
  } else {
    i18n.once('initialized', () => cb());
  }
};
const loadNamespaces = (i18n, ns, cb) => {
  i18n.loadNamespaces(ns, loadedClb(i18n, cb));
};
exports.loadNamespaces = loadNamespaces;
const loadLanguages = (i18n, lng, ns, cb) => {
  if (isString(ns)) ns = [ns];
  if (i18n.options.preload && i18n.options.preload.indexOf(lng) > -1) return loadNamespaces(i18n, ns, cb);
  ns.forEach(n => {
    if (i18n.options.ns.indexOf(n) < 0) i18n.options.ns.push(n);
  });
  i18n.loadLanguages(lng, loadedClb(i18n, cb));
};
exports.loadLanguages = loadLanguages;
const hasLoadedNamespace = (ns, i18n, options = {}) => {
  if (!i18n.languages || !i18n.languages.length) {
    warnOnce(i18n, 'NO_LANGUAGES', 'i18n.languages were undefined or empty', {
      languages: i18n.languages
    });
    return true;
  }
  return i18n.hasLoadedNamespace(ns, {
    lng: options.lng,
    precheck: (i18nInstance, loadNotPending) => {
      if (options.bindI18n && options.bindI18n.indexOf('languageChanging') > -1 && i18nInstance.services.backendConnector.backend && i18nInstance.isLanguageChangingTo && !loadNotPending(i18nInstance.isLanguageChangingTo, ns)) return false;
    }
  });
};
exports.hasLoadedNamespace = hasLoadedNamespace;
const getDisplayName = Component => Component.displayName || Component.name || (isString(Component) && Component.length > 0 ? Component : 'Unknown');
exports.getDisplayName = getDisplayName;
const isString = obj => typeof obj === 'string';
exports.isString = isString;
const isObject = obj => typeof obj === 'object' && obj !== null;
exports.isObject = isObject;
const getFormatPlugin = i18n => {
  const plugin = i18n?.services?.i18nFormat;
  return typeof plugin?.parse === 'function' ? plugin : undefined;
};
exports.getFormatPlugin = getFormatPlugin;
const htmlEscapes = {
  '&': '&amp;',
  '<': '&lt;',
  '>': '&gt;',
  '"': '&quot;',
  "'": '&#39;'
};
const escapeStringValues = values => {
  if (!values) return values;
  const escaped = {};
  Object.keys(values).forEach(k => {
    const v = values[k];
    escaped[k] = isString(v) ? v.replace(/[&<>"']/g, c => htmlEscapes[c]) : v;
  });
  return escaped;
};
exports.escapeStringValues = escapeStringValues;