New Case Study:See how Anthropic automated 95% of dependency reviews with Socket.Learn More →
@tolgee/core
Advanced tools
@tolgee/core - npm Package Compare versions
Comparing version 4.9.3-rc.e39950d.0 to 4.9.4-rc.6a51a7a.0
@@ -50,18 +50,9 @@ 'use strict'; | ||
| } | ||
| function sanitizeUrl(url) { | ||
| return url ? url.replace(/\/+$/, '') : url; | ||
| } | ||
| function incrementInMap(map, value) { | ||
| const currNum = map.get(value) || 0; | ||
| map.set(value, currNum + 1); | ||
| } | ||
| function decrementInMap(map, value) { | ||
| let currNum = map.get(value) || 1; | ||
| currNum -= 1; | ||
| if (currNum <= 0) { | ||
| map.delete(value); | ||
| } | ||
| else { | ||
| map.set(value, currNum); | ||
| } | ||
| } | ||
| const EventEmitterSelective = (getFallbackNamespaces) => { | ||
| const DEFAULT_NS = 0; | ||
| const FALLBACK_NS = 1; | ||
| const EventEmitterSelective = (getFallbackNs, getDefaultNs) => { | ||
| const listeners = new Set(); | ||
@@ -83,4 +74,4 @@ const partialListeners = new Set(); | ||
| }, | ||
| keys: new Map(), | ||
| namespaces: new Map(), | ||
| keys: new Set(), | ||
| namespaces: new Set(), | ||
| }; | ||
@@ -93,27 +84,19 @@ partialListeners.add(handlerWrapper); | ||
| subscribeNs: (ns) => { | ||
| getFallbackArray(ns).forEach((val) => incrementInMap(handlerWrapper.namespaces, val)); | ||
| return result; | ||
| }, | ||
| unsubscribeNs: (ns) => { | ||
| getFallbackArray(ns).forEach((val) => decrementInMap(handlerWrapper.namespaces, val)); | ||
| return result; | ||
| }, | ||
| subscribeKey: (descriptor) => { | ||
| const { key, ns } = descriptor; | ||
| incrementInMap(handlerWrapper.keys, key); | ||
| getFallbackArray(ns).forEach((val) => incrementInMap(handlerWrapper.namespaces, val)); | ||
| getFallbackArray(ns).forEach((val) => handlerWrapper.namespaces.add(val)); | ||
| if (ns === undefined) { | ||
| // subscribing to all namespaces | ||
| incrementInMap(handlerWrapper.namespaces, undefined); | ||
| // subscribing to default ns | ||
| handlerWrapper.namespaces.add(DEFAULT_NS); | ||
| } | ||
| return result; | ||
| }, | ||
| unsubscribeKey: (descriptor) => { | ||
| subscribeKey: (descriptor) => { | ||
| const { key, ns } = descriptor; | ||
| decrementInMap(handlerWrapper.keys, key); | ||
| getFallbackArray(ns).forEach((val) => decrementInMap(handlerWrapper.namespaces, val)); | ||
| handlerWrapper.keys.add(key); | ||
| getFallbackArray(ns).forEach((val) => handlerWrapper.namespaces.add(val)); | ||
| if (ns === undefined) { | ||
| // subscribing to all namespaces | ||
| decrementInMap(handlerWrapper.namespaces, undefined); | ||
| // subscribing to default ns | ||
| handlerWrapper.namespaces.add(DEFAULT_NS); | ||
| } | ||
| // always subscribe to fallback namespaces | ||
| handlerWrapper.namespaces.add(FALLBACK_NS); | ||
| return result; | ||
@@ -125,6 +108,12 @@ }, | ||
| const namespacesWithFallbacks = (namespaces) => { | ||
| if (namespaces.has(undefined)) { | ||
| if (namespaces.has(FALLBACK_NS) || namespaces.has(DEFAULT_NS)) { | ||
| const result = new Set(namespaces.keys()); | ||
| result.delete(undefined); | ||
| getFallbackNamespaces().forEach((ns) => result.add(ns)); | ||
| if (namespaces.has(FALLBACK_NS)) { | ||
| result.delete(FALLBACK_NS); | ||
| getFallbackNs().forEach((ns) => result.add(ns)); | ||
| } | ||
| if (namespaces.has(DEFAULT_NS)) { | ||
| result.delete(DEFAULT_NS); | ||
| result.add(getDefaultNs()); | ||
| } | ||
| return result; | ||
@@ -154,10 +143,10 @@ } | ||
| }); | ||
| const namespaces = new Set(); | ||
| let namespaces = new Set(); | ||
| let keys = new Set(); | ||
| queue.forEach((descriptor) => { | ||
| if ((descriptor === null || descriptor === void 0 ? void 0 : descriptor.ns) === undefined) { | ||
| // when no ns specified, it affets all fallback namespaces | ||
| namespaces.add(undefined); | ||
| // when no ns specified, it affects all namespaces | ||
| namespaces = undefined; | ||
| } | ||
| else { | ||
| else if (namespaces !== undefined) { | ||
| descriptor.ns.forEach((ns) => namespaces.add(ns)); | ||
@@ -173,3 +162,5 @@ } | ||
| }); | ||
| const namespacesArray = Array.from(namespacesWithFallbacks(namespaces).keys()); | ||
| const namespacesArray = namespaces | ||
| ? Array.from(namespaces.keys()) | ||
| : undefined; | ||
| (keys || [undefined]).forEach((key) => { | ||
@@ -186,5 +177,3 @@ callHandlers(key, namespacesArray); | ||
| else { | ||
| Promise.resolve().then(() => { | ||
| solveQueue(); | ||
| }); | ||
| setTimeout(solveQueue, 0); | ||
| } | ||
@@ -195,3 +184,3 @@ }; | ||
| const Events = (getFallbackNamespaces) => { | ||
| const Events = (getFallbackNs, getDefaultNs) => { | ||
| const onPendingLanguageChange = EventEmitter(); | ||
@@ -203,3 +192,3 @@ const onLanguageChange = EventEmitter(); | ||
| const onInitialLoaded = EventEmitter(); | ||
| const onKeyUpdate = EventEmitterSelective(getFallbackNamespaces); | ||
| const onKeyUpdate = EventEmitterSelective(getFallbackNs, getDefaultNs); | ||
| const onCacheChange = EventEmitter(); | ||
@@ -264,3 +253,5 @@ const onRunningChange = EventEmitter(); | ||
| const decodeCacheKey = (key) => { | ||
| const [firstPart, secondPart] = key.split(':'); | ||
| const [firstPart, ...rest] = key.split(':'); | ||
| // if namespaces contains ":" it won't get lost | ||
| const secondPart = rest.join(':'); | ||
| return { language: firstPart, namespace: secondPart || '' }; | ||
@@ -333,7 +324,7 @@ }; | ||
| if (value !== undefined && value !== null) { | ||
| return namespace; | ||
| return [namespace]; | ||
| } | ||
| } | ||
| } | ||
| return Array.from(new Set(namespaces)); | ||
| return unique(namespaces); | ||
| } | ||
@@ -392,6 +383,2 @@ function getTranslationFallback(namespaces, languages, key) { | ||
| } | ||
| if (!dataPromise) { | ||
| // return empty data, so we know it has already been attempted to fetch | ||
| dataPromise = Promise.resolve({}); | ||
| } | ||
| return dataPromise; | ||
@@ -428,3 +415,3 @@ } | ||
| } | ||
| const dataPromise = fetchData(keyObject, isDev); | ||
| const dataPromise = fetchData(keyObject, isDev) || Promise.resolve(undefined); | ||
| asyncRequests.set(cacheKey, dataPromise); | ||
@@ -451,2 +438,6 @@ return { | ||
| } | ||
| else if (!getRecord(value.keyObject)) { | ||
| // if no data exist, put empty object | ||
| addRecord(value.keyObject, {}); | ||
| } | ||
| } | ||
@@ -494,3 +485,5 @@ }); | ||
| const PluginService = (getLanguage, getInitialOptions, getObserverOptions, getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation) => { | ||
| const PluginService = (getLanguage, getInitialOptions, getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation) => { | ||
| let prepared = false; | ||
| let onPrepareQueue = []; | ||
| const plugins = { | ||
@@ -512,32 +505,15 @@ ui: undefined, | ||
| var _a; | ||
| const withNs = keysAndDefaults.map(({ key, ns, defaultValue }) => ({ | ||
| key, | ||
| defaultValue, | ||
| ns: getFallbackArray(getTranslationNs({ key, ns, defaultValue })), | ||
| translation: getTranslation({ | ||
| const withNs = keysAndDefaults.map(({ key, ns, defaultValue }) => { | ||
| return { | ||
| key, | ||
| ns, | ||
| }), | ||
| })); | ||
| defaultValue, | ||
| ns: getTranslationNs({ key, ns }), | ||
| translation: getTranslation({ | ||
| key, | ||
| ns, | ||
| }), | ||
| }; | ||
| }); | ||
| (_a = instances.ui) === null || _a === void 0 ? void 0 : _a.handleElementClick(event, withNs); | ||
| }; | ||
| const run = (isDev) => { | ||
| var _a, _b; | ||
| if (!instances.ui && plugins.ui) { | ||
| instances.ui = new plugins.ui({ | ||
| apiKey: getInitialOptions().apiKey, | ||
| apiUrl: getInitialOptions().apiUrl, | ||
| highlight, | ||
| changeTranslation, | ||
| }); | ||
| } | ||
| if (!instances.observer) { | ||
| instances.observer = (_a = plugins.observer) === null || _a === void 0 ? void 0 : _a.call(plugins, { | ||
| translate, | ||
| onClick, | ||
| options: getObserverOptions(), | ||
| }); | ||
| } | ||
| (_b = instances.observer) === null || _b === void 0 ? void 0 : _b.run({ mouseHighlight: isDev }); | ||
| }; | ||
| const stop = () => { | ||
@@ -553,3 +529,6 @@ var _a; | ||
| const translate = (props) => { | ||
| const translation = getTranslation(props); | ||
| const translation = getTranslation({ | ||
| key: props.key, | ||
| ns: props.ns, | ||
| }); | ||
| return formatTranslation(Object.assign(Object.assign({}, props), { translation, formatEnabled: true })); | ||
@@ -580,5 +559,2 @@ }; | ||
| }; | ||
| const getLanguageStorage = () => { | ||
| return instances.languageStorage; | ||
| }; | ||
| const setStoredLanguage = (language) => { | ||
@@ -623,2 +599,23 @@ var _a; | ||
| }; | ||
| const run = (isDev) => { | ||
| var _a, _b; | ||
| if (!instances.ui && plugins.ui) { | ||
| const { apiKey, apiUrl, projectId } = getInitialOptions(); | ||
| instances.ui = new plugins.ui({ | ||
| apiKey: apiKey, | ||
| apiUrl: apiUrl, | ||
| projectId, | ||
| highlight, | ||
| changeTranslation, | ||
| }); | ||
| } | ||
| if (!instances.observer) { | ||
| instances.observer = (_a = plugins.observer) === null || _a === void 0 ? void 0 : _a.call(plugins, { | ||
| translate, | ||
| onClick, | ||
| options: getInitialOptions().observerOptions, | ||
| }); | ||
| } | ||
| (_b = instances.observer) === null || _b === void 0 ? void 0 : _b.run({ mouseHighlight: isDev }); | ||
| }; | ||
| const getDevBackend = () => { | ||
@@ -629,5 +626,7 @@ return instances.devBackend; | ||
| var _a; | ||
| const { apiKey, apiUrl, projectId } = getInitialOptions(); | ||
| return (_a = instances.devBackend) === null || _a === void 0 ? void 0 : _a.getRecord({ | ||
| apiKey: getInitialOptions().apiKey, | ||
| apiUrl: getInitialOptions().apiUrl, | ||
| apiKey, | ||
| apiUrl, | ||
| projectId, | ||
| language, | ||
@@ -653,4 +652,37 @@ namespace, | ||
| }; | ||
| const formatTranslation = ({ key, translation, defaultValue, noWrap, params, orEmpty, ns, formatEnabled, }) => { | ||
| const unwrap = (text) => { | ||
| var _a; | ||
| if (instances.observer) { | ||
| return (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.unwrap(text); | ||
| } | ||
| return { text, keys: [] }; | ||
| }; | ||
| const retranslate = () => { | ||
| var _a; | ||
| (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.retranslate(); | ||
| }; | ||
| const onPrepare = (callback) => { | ||
| onPrepareQueue.push(callback); | ||
| }; | ||
| function addPlugin(tolgeeInstance, plugin) { | ||
| const pluginTools = Object.freeze({ | ||
| setFinalFormatter, | ||
| addFormatter, | ||
| setObserver, | ||
| hasObserver, | ||
| setUi, | ||
| hasUi, | ||
| setDevBackend, | ||
| addBackend, | ||
| setLanguageDetector, | ||
| setLanguageStorage, | ||
| onPrepare, | ||
| }); | ||
| plugin(tolgeeInstance, pluginTools); | ||
| if (prepared) { | ||
| prepare(); | ||
| } | ||
| } | ||
| function formatTranslation({ key, translation, defaultValue, noWrap, params, orEmpty, ns, formatEnabled, }) { | ||
| var _a; | ||
| const formattableTranslation = translation || defaultValue; | ||
@@ -689,3 +721,6 @@ let result = formattableTranslation || (orEmpty ? '' : key); | ||
| return result; | ||
| }; | ||
| } | ||
| function hasDevBackend() { | ||
| return Boolean(getDevBackend()); | ||
| } | ||
| const wrap = (params) => { | ||
@@ -698,30 +733,18 @@ var _a; | ||
| }; | ||
| const unwrap = (text) => { | ||
| var _a; | ||
| if (instances.observer) { | ||
| return (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.unwrap(text); | ||
| function prepare() { | ||
| prepared = true; | ||
| while (onPrepareQueue.length) { | ||
| const queue = onPrepareQueue; | ||
| onPrepareQueue = []; | ||
| queue.forEach((callback) => callback()); | ||
| } | ||
| return { text, keys: [] }; | ||
| }; | ||
| const retranslate = () => { | ||
| var _a; | ||
| (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.retranslate(); | ||
| }; | ||
| } | ||
| return Object.freeze({ | ||
| setFinalFormatter, | ||
| addFormatter, | ||
| prepare, | ||
| addPlugin, | ||
| formatTranslation, | ||
| setObserver, | ||
| hasObserver, | ||
| setUi, | ||
| hasUi, | ||
| addBackend, | ||
| setDevBackend, | ||
| getDevBackend, | ||
| getBackendRecord, | ||
| getBackendDevRecord, | ||
| setLanguageDetector, | ||
| getLanguageDetector, | ||
| setLanguageStorage, | ||
| getLanguageStorage, | ||
| getInitialLanguage, | ||
@@ -733,4 +756,5 @@ setStoredLanguage, | ||
| highlight, | ||
| unwrap, | ||
| wrap, | ||
| unwrap, | ||
| hasDevBackend, | ||
| }); | ||
@@ -757,3 +781,3 @@ }; | ||
| const defaultValues$1 = { | ||
| const defaultObserverOptions = { | ||
| tagAttributes: { | ||
@@ -773,14 +797,19 @@ textarea: ['placeholder'], | ||
| }; | ||
| const initObserverOptions = (options) => { | ||
| return Object.assign(Object.assign({}, defaultValues$1), options); | ||
| }; | ||
| const defaultValues = { | ||
| defaultNs: '', | ||
| observerOptions: defaultObserverOptions, | ||
| observerType: 'invisible', | ||
| }; | ||
| const combineOptions = (...states) => { | ||
| let result = {}; | ||
| states.forEach((state) => { | ||
| result = Object.assign(Object.assign(Object.assign({}, result), state), { observerOptions: Object.assign(Object.assign({}, result.observerOptions), state === null || state === void 0 ? void 0 : state.observerOptions) }); | ||
| }); | ||
| return result; | ||
| }; | ||
| const initState = (options, previousState) => { | ||
| const initialOptions = Object.assign(Object.assign(Object.assign({}, defaultValues), previousState === null || previousState === void 0 ? void 0 : previousState.initialOptions), options); | ||
| const initialOptions = combineOptions(defaultValues, previousState === null || previousState === void 0 ? void 0 : previousState.initialOptions, options); | ||
| // remove extra '/' from url end | ||
| const apiUrl = initialOptions.apiUrl; | ||
| initialOptions.apiUrl = apiUrl ? apiUrl.replace(/\/+$/, '') : apiUrl; | ||
| initialOptions.apiUrl = sanitizeUrl(initialOptions.apiUrl); | ||
| return { | ||
@@ -798,3 +827,2 @@ initialOptions, | ||
| let state = initState(); | ||
| let observerOptions = initObserverOptions(); | ||
| let devCredentials = undefined; | ||
@@ -867,2 +895,3 @@ function init(options) { | ||
| ...(state.initialOptions.ns || [state.initialOptions.defaultNs]), | ||
| ...getFallbackArray(state.initialOptions.fallbackNs), | ||
| ...state.activeNamespaces.keys(), | ||
@@ -881,8 +910,8 @@ ]); | ||
| } | ||
| function getFallbackNamespaces() { | ||
| const defaultNs = state.initialOptions.defaultNs; | ||
| const fallbackNs = state.initialOptions.fallbackNs; | ||
| const fallbackNamespaces = typeof defaultNs === 'string' ? [defaultNs] : []; | ||
| return unique([...fallbackNamespaces, ...getFallbackArray(fallbackNs)]); | ||
| function getFallbackNs() { | ||
| return getFallbackArray(state.initialOptions.fallbackNs); | ||
| } | ||
| function getDefaultNs(ns) { | ||
| return ns === undefined ? state.initialOptions.defaultNs : ns; | ||
| } | ||
| function getAvailableLanguages() { | ||
@@ -906,10 +935,9 @@ if (state.initialOptions.availableLanguages) { | ||
| function overrideCredentials(credentials) { | ||
| devCredentials = credentials; | ||
| if (credentials) { | ||
| devCredentials = Object.assign(Object.assign({}, credentials), { apiUrl: sanitizeUrl(credentials.apiUrl) }); | ||
| } | ||
| else { | ||
| devCredentials = undefined; | ||
| } | ||
| } | ||
| function setObserverOptions(options) { | ||
| observerOptions = initObserverOptions(options); | ||
| } | ||
| function getObserverOptions() { | ||
| return observerOptions; | ||
| } | ||
| return Object.freeze({ | ||
@@ -930,8 +958,7 @@ init, | ||
| getFallbackLangs, | ||
| getFallbackNamespaces, | ||
| getFallbackNs, | ||
| getDefaultNs, | ||
| getAvailableLanguages, | ||
| withDefaultNs, | ||
| overrideCredentials, | ||
| setObserverOptions, | ||
| getObserverOptions, | ||
| }); | ||
@@ -973,5 +1000,4 @@ }; | ||
| orEmpty: orEmpty, | ||
| params: Object.assign(Object.assign({}, rest), params), | ||
| }; | ||
| return options; | ||
| return Object.assign(Object.assign({}, options), { params: Object.assign({}, rest) }); | ||
| } | ||
@@ -1001,7 +1027,7 @@ const getTranslateParams = (keyOrProps, ...params) => { | ||
| const Controller = ({ options }) => { | ||
| const events = Events(getFallbackNamespaces); | ||
| const events = Events(getFallbackNs, getDefaultNs); | ||
| const fetchingObserver = ValueObserver(false, () => cache.isFetching(), events.onFetchingChange.emit); | ||
| const loadingObserver = ValueObserver(false, () => isLoading(), events.onLoadingChange.emit); | ||
| const state = State(events.onLanguageChange, events.onPendingLanguageChange, events.onRunningChange); | ||
| const pluginService = PluginService(state.getLanguage, state.getInitialOptions, state.getObserverOptions, state.getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation); | ||
| const pluginService = PluginService(state.getLanguage, state.getInitialOptions, state.getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation); | ||
| const cache = Cache(events.onCacheChange, pluginService.getBackendRecord, pluginService.getBackendDevRecord, state.withDefaultNs, state.isInitialLoading, fetchingObserver, loadingObserver); | ||
@@ -1016,2 +1042,21 @@ if (options) { | ||
| }); | ||
| function getFallbackNs() { | ||
| return state.getFallbackNs(); | ||
| } | ||
| function getDefaultNs(ns) { | ||
| return state.getDefaultNs(ns); | ||
| } | ||
| // gets all namespaces where translation could be located | ||
| // takes (ns|default, fallback ns) | ||
| function getDefaultAndFallbackNs(ns) { | ||
| return [...getFallbackArray(getDefaultNs(ns)), ...getFallbackNs()]; | ||
| } | ||
| // gets all namespaces which need to be loaded | ||
| // takes (ns|default, initial ns, fallback ns, active ns) | ||
| function getRequiredNamespaces(ns) { | ||
| return [ | ||
| ...getFallbackArray(ns || getDefaultNs()), | ||
| ...state.getRequiredNamespaces(), | ||
| ]; | ||
| } | ||
| function changeTranslation(descriptor, key, value) { | ||
@@ -1027,5 +1072,2 @@ const keyObject = state.withDefaultNs(descriptor); | ||
| } | ||
| function getFallbackNamespaces() { | ||
| return state.getFallbackNamespaces(); | ||
| } | ||
| function init(options) { | ||
@@ -1039,5 +1081,3 @@ state.init(options); | ||
| function isDev() { | ||
| return Boolean(state.getInitialOptions().apiKey && | ||
| state.getInitialOptions().apiUrl && | ||
| pluginService.getDevBackend()); | ||
| return Boolean(state.getInitialOptions().apiKey && state.getInitialOptions().apiUrl); | ||
| } | ||
@@ -1054,3 +1094,3 @@ async function addActiveNs(ns, forget) { | ||
| const languages = state.getFallbackLangs(lang); | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getRequiredNamespaces(); | ||
| const namespaces = getRequiredNamespaces(ns); | ||
| const result = []; | ||
@@ -1072,3 +1112,3 @@ languages.forEach((language) => { | ||
| const languages = state.getFallbackLangs(language); | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getRequiredNamespaces(); | ||
| const namespaces = getRequiredNamespaces(ns); | ||
| const result = []; | ||
@@ -1106,9 +1146,9 @@ languages.forEach((language) => { | ||
| } | ||
| function getTranslationNs({ key, ns, }) { | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getFallbackNamespaces(); | ||
| function getTranslationNs({ key, ns }) { | ||
| const languages = state.getFallbackLangs(); | ||
| const namespaces = getDefaultAndFallbackNs(ns); | ||
| return cache.getTranslationNs(namespaces, languages, key); | ||
| } | ||
| function getTranslation({ key, ns, }) { | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getFallbackNamespaces(); | ||
| function getTranslation({ key, ns }) { | ||
| const namespaces = getDefaultAndFallbackNs(ns); | ||
| const languages = state.getFallbackLangs(); | ||
@@ -1205,3 +1245,2 @@ return cache.getTranslationFallback(namespaces, languages, key); | ||
| addActiveNs, | ||
| loadRequiredRecords, | ||
| loadRecords, | ||
@@ -1217,19 +1256,7 @@ loadRecord, | ||
| const Tolgee = (options) => { | ||
| const TolgeeInstanceCreator = (options) => { | ||
| const controller = Controller({ | ||
| options, | ||
| }); | ||
| const pluginTools = Object.freeze({ | ||
| setFinalFormatter: controller.setFinalFormatter, | ||
| addFormatter: controller.addFormatter, | ||
| setObserver: controller.setObserver, | ||
| hasObserver: controller.hasObserver, | ||
| setUi: controller.setUi, | ||
| hasUi: controller.hasUi, | ||
| setDevBackend: controller.setDevBackend, | ||
| addBackend: controller.addBackend, | ||
| setLanguageDetector: controller.setLanguageDetector, | ||
| setLanguageStorage: controller.setLanguageStorage, | ||
| overrideCredentials: controller.overrideCredentials, | ||
| }); | ||
| // restarts tolgee while applying callback | ||
| const withRestart = (callback) => { | ||
@@ -1242,61 +1269,337 @@ const wasRunning = controller.isRunning(); | ||
| const tolgee = Object.freeze({ | ||
| // event listeners | ||
| /** | ||
| * Listen to tolgee events. | ||
| */ | ||
| on: controller.on, | ||
| /** | ||
| * Listen for specific keys/namespaces changes. | ||
| */ | ||
| onKeyUpdate: controller.onKeyUpdate.listenSome, | ||
| // state | ||
| /** | ||
| * @return current language if set. | ||
| */ | ||
| getLanguage: controller.getLanguage, | ||
| /** | ||
| * `pendingLanguage` represents language which is currently being loaded. | ||
| * @return current `pendingLanguage` if set. | ||
| */ | ||
| getPendingLanguage: controller.getPendingLanguage, | ||
| /** | ||
| * Change current language. | ||
| * - if not running sets `pendingLanguage`, `language` to the new value | ||
| * - if running sets `pendingLanguage` to the value, fetches necessary data and then changes `language` | ||
| * | ||
| * @return Promise which is resolved when `language` is changed. | ||
| */ | ||
| changeLanguage: controller.changeLanguage, | ||
| /** | ||
| * Temporarily change translation in cache. | ||
| * @return object with revert method. | ||
| */ | ||
| changeTranslation: controller.changeTranslation, | ||
| /** | ||
| * Adds namespace(s) list of active namespaces. And if tolgee is running, loads required data. | ||
| */ | ||
| addActiveNs: controller.addActiveNs, | ||
| /** | ||
| * Remove namespace(s) from active namespaces. | ||
| * | ||
| * Tolgee internally counts how many times was each active namespace added, | ||
| * so this method will remove namespace only if the counter goes down to 0. | ||
| */ | ||
| removeActiveNs: controller.removeActiveNs, | ||
| /** | ||
| * Manually load multiple records from `Backend` (or `DevBackend` when in dev mode) | ||
| * | ||
| * It loads data together and adds them to cache in one operation, to prevent partly loaded state. | ||
| */ | ||
| loadRecords: controller.loadRecords, | ||
| /** | ||
| * Manually load record from `Backend` (or `DevBackend` when in dev mode) | ||
| */ | ||
| loadRecord: controller.loadRecord, | ||
| /** | ||
| * | ||
| */ | ||
| addStaticData: controller.addStaticData, | ||
| /** | ||
| * Get record from cache. | ||
| */ | ||
| getRecord: controller.getRecord, | ||
| /** | ||
| * Get all records from cache. | ||
| */ | ||
| getAllRecords: controller.getAllRecords, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if there are data that need to be fetched. | ||
| */ | ||
| isLoaded: controller.isLoaded, | ||
| /** | ||
| * @return `true` if tolgee is loading initial data (triggered by `run`). | ||
| */ | ||
| isInitialLoading: controller.isInitialLoading, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if tolgee is loading some translations for the first time. | ||
| */ | ||
| isLoading: controller.isLoading, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if tolgee is fetching some translations. | ||
| */ | ||
| isFetching: controller.isFetching, | ||
| /** | ||
| * @return `true` if tolgee is running. | ||
| */ | ||
| isRunning: controller.isRunning, | ||
| /** | ||
| * Changes internal state to running: true and loads initial files. | ||
| * Runs runnable plugins mainly Observer if present. | ||
| */ | ||
| run: controller.run, | ||
| /** | ||
| * Changes internal state to running: false and stops runnable plugins. | ||
| */ | ||
| stop: controller.stop, | ||
| /** | ||
| * Returns translated and formatted key. | ||
| * If Observer is present and tolgee is running, wraps result to be identifiable in the DOM. | ||
| */ | ||
| t: controller.t, | ||
| /** | ||
| * Highlight keys that match selection. | ||
| */ | ||
| highlight: controller.highlight, | ||
| /** | ||
| * @return current Tolgee options. | ||
| */ | ||
| getInitialOptions: controller.getInitialOptions, | ||
| /** | ||
| * Tolgee is in dev mode if `DevTools` plugin is used and `apiKey` + `apiUrl` are specified. | ||
| * @return `true` if tolgee is in dev mode. | ||
| */ | ||
| isDev: controller.isDev, | ||
| /** | ||
| * Wraps translation if there is `Observer` plugin | ||
| */ | ||
| wrap: controller.wrap, | ||
| /** | ||
| * Unwrap translation | ||
| */ | ||
| unwrap: controller.unwrap, | ||
| // plugins | ||
| setObserverOptions: (options) => { | ||
| controller.setObserverOptions(options); | ||
| return tolgee; | ||
| /** | ||
| * Override creadentials passed on initialization | ||
| */ | ||
| overrideCredentials(credentials) { | ||
| withRestart(() => controller.overrideCredentials(credentials)); | ||
| }, | ||
| use: (plugin) => { | ||
| /** | ||
| * Add tolgee plugin. | ||
| */ | ||
| addPlugin(plugin) { | ||
| if (plugin) { | ||
| withRestart(() => plugin(tolgee, pluginTools)); | ||
| withRestart(() => controller.addPlugin(tolgee, plugin)); | ||
| } | ||
| return tolgee; | ||
| }, | ||
| init: (options) => { | ||
| withRestart(() => controller.init(options)); | ||
| /** | ||
| * Updates options after instance creation. Extends existing options, | ||
| * so it only changes the fields, that are listed. | ||
| * | ||
| * When called in running state, tolgee stops and runs again. | ||
| */ | ||
| updateOptions(options) { | ||
| if (options) { | ||
| withRestart(() => controller.init(options)); | ||
| } | ||
| }, | ||
| }); | ||
| return tolgee; | ||
| }; | ||
| /** | ||
| * Tolgee chainable constructor. | ||
| * | ||
| * Usage: | ||
| * ``` | ||
| * const tolgee = Tolgee().use(...).init(...) | ||
| * ``` | ||
| */ | ||
| const Tolgee = () => { | ||
| const state = { | ||
| plugins: [], | ||
| options: {}, | ||
| }; | ||
| const tolgeeChain = Object.freeze({ | ||
| use(plugin) { | ||
| state.plugins.push(plugin); | ||
| return tolgeeChain; | ||
| }, | ||
| updateDefaults(options) { | ||
| state.options = combineOptions(state.options, options); | ||
| return tolgeeChain; | ||
| }, | ||
| init(options) { | ||
| const tolgee = TolgeeInstanceCreator(combineOptions(state.options, options)); | ||
| state.plugins.forEach(tolgee.addPlugin); | ||
| return tolgee; | ||
| }, | ||
| }); | ||
| return tolgeeChain; | ||
| }; | ||
| const ERROR_PARAM_EMPTY = 0, ERROR_UNEXPECTED_CHAR = 1, ERROR_UNEXPECTED_END = 2; | ||
| class FormatError extends Error { | ||
| constructor(code, index, text) { | ||
| let error; | ||
| if (code === ERROR_PARAM_EMPTY) { | ||
| error = 'Empty parameter'; | ||
| } | ||
| else if (code === ERROR_UNEXPECTED_CHAR) { | ||
| error = 'Unexpected character'; | ||
| } | ||
| else { | ||
| error = 'Unexpected end'; | ||
| } | ||
| super(`Tolgee parser: ${error} at ${index} in "${text}"`); | ||
| this.code = code; | ||
| this.index = index; | ||
| } | ||
| } | ||
| function isWhitespace(ch) { | ||
| return /\s/.test(ch); | ||
| } | ||
| const STATE_TEXT = 0, STATE_ESCAPE_MAYBE = 1, STATE_ESCAPE = 2, STATE_PARAM = 3, STATE_PARAM_AFTER = 4; | ||
| const END_STATES = new Set([ | ||
| STATE_ESCAPE, | ||
| STATE_ESCAPE_MAYBE, | ||
| STATE_TEXT, | ||
| ]); | ||
| const CHAR_ESCAPE = "'"; | ||
| const ESCAPABLE = new Set(['{', '}', CHAR_ESCAPE]); | ||
| const isAllowedInParam = (char) => { | ||
| return /[0-9a-zA-Z_]/.test(char); | ||
| }; | ||
| function formatParser(translation) { | ||
| let state = STATE_TEXT; | ||
| let text = ''; | ||
| let param = ''; | ||
| let ch = ''; | ||
| const texts = []; | ||
| const params = []; | ||
| let i = 0; | ||
| function parsingError(code) { | ||
| throw new FormatError(code, i, translation); | ||
| } | ||
| const addText = () => { | ||
| texts.push(text); | ||
| text = ''; | ||
| }; | ||
| const addParamChar = () => { | ||
| if (!isAllowedInParam(ch)) { | ||
| parsingError(ERROR_UNEXPECTED_CHAR); | ||
| } | ||
| param += ch; | ||
| }; | ||
| const addParam = () => { | ||
| if (param === '') { | ||
| parsingError(ERROR_PARAM_EMPTY); | ||
| } | ||
| params.push(param); | ||
| param = ''; | ||
| }; | ||
| for (i = 0; i < translation.length; i++) { | ||
| ch = translation[i]; | ||
| switch (state) { | ||
| case STATE_TEXT: | ||
| if (ch === CHAR_ESCAPE) { | ||
| text += ch; | ||
| state = STATE_ESCAPE_MAYBE; | ||
| } | ||
| else if (ch === '{') { | ||
| addText(); | ||
| state = STATE_PARAM; | ||
| } | ||
| else { | ||
| text += ch; | ||
| state = STATE_TEXT; | ||
| } | ||
| break; | ||
| case STATE_ESCAPE_MAYBE: | ||
| if (ESCAPABLE.has(ch)) { | ||
| text = text.slice(0, -1) + ch; | ||
| state = STATE_ESCAPE; | ||
| } | ||
| else { | ||
| text += ch; | ||
| state = STATE_TEXT; | ||
| } | ||
| break; | ||
| case STATE_ESCAPE: | ||
| if (ch === CHAR_ESCAPE) { | ||
| state = STATE_TEXT; | ||
| } | ||
| else { | ||
| text += ch; | ||
| state = STATE_ESCAPE; | ||
| } | ||
| break; | ||
| case STATE_PARAM: | ||
| if (ch === '}') { | ||
| addParam(); | ||
| state = STATE_TEXT; | ||
| } | ||
| else if (!isWhitespace(ch)) { | ||
| addParamChar(); | ||
| state = STATE_PARAM; | ||
| } | ||
| else if (param !== '') { | ||
| addParam(); | ||
| state = STATE_PARAM_AFTER; | ||
| } | ||
| break; | ||
| case STATE_PARAM_AFTER: | ||
| if (ch == '}') { | ||
| state = STATE_TEXT; | ||
| } | ||
| else if (isWhitespace(ch)) { | ||
| state = STATE_PARAM_AFTER; | ||
| } | ||
| else { | ||
| parsingError(ERROR_UNEXPECTED_CHAR); | ||
| } | ||
| } | ||
| } | ||
| if (!END_STATES.has(state)) { | ||
| parsingError(ERROR_UNEXPECTED_END); | ||
| } | ||
| addText(); | ||
| return [texts, params]; | ||
| } | ||
| function formatter(translation, params) { | ||
| const [texts, pars] = formatParser(translation); | ||
| const result = [texts[0]]; | ||
| for (let i = 1; i < texts.length; i++) { | ||
| const parameter = params === null || params === void 0 ? void 0 : params[pars[i - 1]]; | ||
| if (parameter === undefined) { | ||
| throw new Error(`Missing parameter "${pars[i - 1]}" in "${translation}"`); | ||
| } | ||
| result.push(String(parameter)); | ||
| result.push(texts[i]); | ||
| } | ||
| return result.join(''); | ||
| } | ||
| function FormatSimpleCreator() { | ||
| return { | ||
| format: ({ translation, params }) => formatter(translation, params), | ||
| }; | ||
| } | ||
| const FormatSimple = () => (tolgee, tools) => { | ||
| tools.setFinalFormatter(FormatSimpleCreator()); | ||
| return tolgee; | ||
| }; | ||
| const RESTRICTED_ASCENDANT_ATTRIBUTE = 'data-tolgee-restricted'; | ||
| const TOLGEE_ATTRIBUTE_NAME = '_tolgee'; | ||
| const TOLGEE_HIGHLIGHTER_CLASS = '_tolgee-highlighter'; | ||
| const TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE = 'data-tolgee-key-only'; | ||
| // needs to be same as in @tolgee/ui package | ||
| const DEVTOOLS_ID = '__tolgee_dev_tools'; | ||
| exports.DEVTOOLS_ID = DEVTOOLS_ID; | ||
| exports.RESTRICTED_ASCENDANT_ATTRIBUTE = RESTRICTED_ASCENDANT_ATTRIBUTE; | ||
| exports.TOLGEE_ATTRIBUTE_NAME = TOLGEE_ATTRIBUTE_NAME; | ||
| exports.TOLGEE_HIGHLIGHTER_CLASS = TOLGEE_HIGHLIGHTER_CLASS; | ||
| exports.TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE = TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE; | ||
| exports.FormatSimple = FormatSimple; | ||
| exports.Tolgee = Tolgee; | ||
@@ -1303,0 +1606,0 @@ exports.getFallback = getFallback; |
@@ -1,2 +0,2 @@ | ||
| "use strict";Object.defineProperty(exports,"__esModule",{value:!0});const e=()=>{let e=[];return Object.freeze({listen:n=>{const t=e=>{n(e)};return e.push(t),{unsubscribe:()=>{e=e.filter((e=>t!==e))}}},emit:n=>{e.forEach((e=>e({value:n})))}})};function n(e){return"string"==typeof e?[e]:Array.isArray(e)?e:void 0}function t(e){return n(e)||[]}function a(e,n){return"object"!=typeof(a=n)||Array.isArray(a)||null===a?t(n):t(null==n?void 0:n[e]);var a}function i(e){return Array.from(new Set(e))}function o(e,n){const t=e.get(n)||0;e.set(n,t+1)}function r(e,n){let t=e.get(n)||1;t-=1,t<=0?e.delete(n):e.set(n,t)}const s=e=>{const n=new Set,a=new Set,i=n=>{if(n.has(void 0)){const t=new Set(n.keys());return t.delete(void 0),e().forEach((e=>t.add(e))),t}return n};let s=[];const g=()=>{if(0===s.length)return;n.forEach((e=>{e({value:void 0})}));const e=new Set;let t=new Set;s.forEach((n=>{void 0===(null==n?void 0:n.ns)?e.add(void 0):n.ns.forEach((n=>e.add(n))),void 0===(null==n?void 0:n.key)?t=void 0:void 0!==t&&t.add(n.key)}));const o=Array.from(i(e).keys());(t||[void 0]).forEach((e=>{((e,n)=>{a.forEach((t=>{const a=i(t.namespaces),o=void 0===n||-1!==(null==n?void 0:n.findIndex((e=>a.has(e)))),r=void 0===e||t.keys.has(e)||0===t.keys.size;o&&r&&t.fn({value:void 0})}))})(e,o)})),s=[]};return Object.freeze({listenSome:e=>{const n={fn:n=>{e(n)},keys:new Map,namespaces:new Map};a.add(n);const i={unsubscribe:()=>{a.delete(n)},subscribeNs:e=>(t(e).forEach((e=>o(n.namespaces,e))),i),unsubscribeNs:e=>(t(e).forEach((e=>r(n.namespaces,e))),i),subscribeKey:e=>{const{key:a,ns:r}=e;return o(n.keys,a),t(r).forEach((e=>o(n.namespaces,e))),void 0===r&&o(n.namespaces,void 0),i},unsubscribeKey:e=>{const{key:a,ns:o}=e;return r(n.keys,a),t(o).forEach((e=>r(n.namespaces,e))),void 0===o&&r(n.namespaces,void 0),i}};return i},listen:e=>{n.add(e);return{unsubscribe:()=>{n.delete(e)}}},emit:(e,n)=>{s.push(e),n?Promise.resolve().then((()=>{g()})):g()}})},g=e=>{const n=new Map;return Object.entries(e).forEach((([e,t])=>{null!=t&&("object"!=typeof t?n.set(e,t):g(t).forEach(((t,a)=>{n.set(e+"."+a,t)})))})),n},c=e=>{const[n,t]=e.split(":");return{language:n,namespace:t||""}},u=({language:e,namespace:n})=>n?`${e}:${n}`:e,l=(e,n,a,i,o,r,s)=>{const l=new Map,d=new Map;let f={},p=0;function v(n,t,a){const i=u(n);d.set(i,{data:g(t),version:a}),e.emit(n)}function b(e,n){v(e,n,p)}function h(e,n=!1){const t=d.get(u(e));return t&&n?t.version===p:Boolean(t)}function m(e){var n;return null===(n=d.get(u(i(e))))||void 0===n?void 0:n.data}function y(e){let t;if(!t){const n=f[u(e)];"function"==typeof n&&(t=n())}return t||(t=n(e)),t||(t=Promise.resolve({})),t}return Object.freeze({addStaticData:function(e){e&&(f=Object.assign(Object.assign({},f),e),Object.entries(e).forEach((([e,n])=>{if("function"!=typeof n){const t=c(e),a=d.get(e);a&&0!==a.version||v(t,n,0)}})))},invalidate:function(){l.clear(),p+=1},addRecord:b,exists:h,getRecord:m,getTranslation:function(e,n){var t;return null===(t=d.get(u(e)))||void 0===t?void 0:t.data.get(n)},getTranslationNs:function(e,n,t){var a;for(const i of e)for(const e of n){const n=null===(a=d.get(u({language:e,namespace:i})))||void 0===a?void 0:a.data.get(t);if(null!=n)return i}return Array.from(new Set(e))},getTranslationFallback:function(e,n,t){var a;for(const i of e)for(const e of n){const n=null===(a=d.get(u({language:e,namespace:i})))||void 0===a?void 0:a.data.get(t);if(null!=n)return n}},changeTranslation:function(n,t,a){var i;const o=null===(i=d.get(u(n)))||void 0===i?void 0:i.data;null==o||o.set(t,a),e.emit(Object.assign(Object.assign({},n),{key:t}))},isFetching:function(e){if(o())return!0;if(void 0===e)return l.size>0;const n=t(e);return Boolean(Array.from(l.keys()).find((e=>n.includes(c(e).namespace))))},isLoading:function(e,n){const a=t(n);return Boolean(o()||Array.from(l.keys()).find((n=>{const t=c(n);return(!a.length||a.includes(t.namespace))&&!h({namespace:t.namespace,language:e})})))},loadRecords:async function(e,n){const t=e.map((e=>{const t=i(e),o=u(t),r=l.get(o);if(r)return{new:!1,promise:r,keyObject:t,cacheKey:o};const s=function(e,n){var t;let i;return n&&(i=null===(t=a(e))||void 0===t?void 0:t.catch((()=>(console.warn("Tolgee: Failed to fetch data from dev backend"),y(e))))),i||(i=y(e)),i}(t,n);return l.set(o,s),{new:!0,promise:s,keyObject:t,cacheKey:o}}));r.notify(),s.notify();const o=await Promise.all(t.map((e=>e.promise)));return t.forEach(((e,n)=>{const t=l.get(e.cacheKey)!==e.promise;if(e.new&&!t){l.delete(e.cacheKey);const t=o[n];t&&b(e.keyObject,t)}})),r.notify(),s.notify(),t.map((e=>m(e.keyObject)))},getAllRecords:function(){return Array.from(d.entries()).map((([e,n])=>Object.assign(Object.assign({},c(e)),{data:n.data})))}})};function d(e){return Boolean(e&&"function"==typeof e.then)}const f=(e,n)=>d(e)?Promise.resolve(e).then(n):n(e),p=e=>`Tolgee: You need to specify '${e}' option`,v=(e,n,a,i,o,r,s)=>{const g={ui:void 0,observer:void 0},c={formatters:[],finalFormatter:void 0,observer:void 0,devBackend:void 0,backends:[],ui:void 0,languageDetector:void 0,languageStorage:void 0},u=async(e,{keysAndDefaults:n})=>{var a;const i=n.map((({key:e,ns:n,defaultValue:a})=>({key:e,defaultValue:a,ns:t(o({key:e,ns:n,defaultValue:a})),translation:r({key:e,ns:n})})));null===(a=c.ui)||void 0===a||a.handleElementClick(e,i)},l=(e,n)=>{var t,a;return(null===(a=null===(t=c.observer)||void 0===t?void 0:t.highlight)||void 0===a?void 0:a.call(t,e,n))||{unhighlight(){}}},p=e=>{const n=r(e);return v(Object.assign(Object.assign({},e),{translation:n,formatEnabled:!0}))},v=({key:n,translation:t,defaultValue:a,noWrap:i,params:o,orEmpty:r,ns:s,formatEnabled:g})=>{var u;const l=t||a;let d=l||(r?"":n);c.observer&&!i&&(d=c.observer.wrap({key:n,translation:d,defaultValue:a,params:o,ns:s}));const f=e(),p=g||!(null===(u=c.observer)||void 0===u?void 0:u.outputNotFormattable);if(l&&f&&p)for(const e of c.formatters)d=e.format({translation:d,language:f,params:o});return c.finalFormatter&&l&&f&&p&&(d=c.finalFormatter.format({translation:d,language:f,params:o})),d};return Object.freeze({setFinalFormatter:e=>{c.finalFormatter=e},addFormatter:e=>{e&&c.formatters.push(e)},formatTranslation:v,setObserver:e=>{g.observer=e},hasObserver:()=>Boolean(g.observer),setUi:e=>{g.ui=(null==e?void 0:e.UI)||e},hasUi:()=>Boolean(g.ui),addBackend:e=>{e&&c.backends.push(e)},setDevBackend:e=>{c.devBackend=e},getDevBackend:()=>c.devBackend,getBackendRecord:({language:e,namespace:n})=>{for(const t of c.backends){const a=t.getRecord({language:e,namespace:n});if(d(a))return null==a?void 0:a.catch((e=>(console.error(e),{})));if(void 0!==a)return a}},getBackendDevRecord:({language:e,namespace:t})=>{var a;return null===(a=c.devBackend)||void 0===a?void 0:a.getRecord({apiKey:n().apiKey,apiUrl:n().apiUrl,language:e,namespace:t})},setLanguageDetector:e=>{c.languageDetector=e},getLanguageDetector:()=>c.languageDetector,setLanguageStorage:e=>{c.languageStorage=e},getLanguageStorage:()=>c.languageStorage,getInitialLanguage:()=>{var e;const n=i(),t=null===(e=c.languageStorage)||void 0===e?void 0:e.getLanguage();return f(t,(e=>n&&!n.includes(e)||!e?(()=>{if(!c.languageDetector)return;const e=i();return c.languageDetector.getLanguage({availableLanguages:e})})():e))},setStoredLanguage:e=>{var n;null===(n=c.languageStorage)||void 0===n||n.setLanguage(e)},run:e=>{var t,i;!c.ui&&g.ui&&(c.ui=new g.ui({apiKey:n().apiKey,apiUrl:n().apiUrl,highlight:l,changeTranslation:s})),c.observer||(c.observer=null===(t=g.observer)||void 0===t?void 0:t.call(g,{translate:p,onClick:u,options:a()})),null===(i=c.observer)||void 0===i||i.run({mouseHighlight:e})},stop:()=>{var e;c.ui=void 0,null===(e=c.observer)||void 0===e||e.stop()},retranslate:()=>{var e;null===(e=c.observer)||void 0===e||e.retranslate()},highlight:l,wrap:e=>{var n;return c.observer?null===(n=c.observer)||void 0===n?void 0:n.wrap(e):e.translation},unwrap:e=>{var n;return c.observer?null===(n=c.observer)||void 0===n?void 0:n.unwrap(e):{text:e,keys:[]}}})},b=(e,n,t)=>{let a=e;return Object.freeze({init:function(e){a=e},notify:function(){const e=n();a!==e&&t(e),a=e}})},h={tagAttributes:{textarea:["placeholder"],input:["value","placeholder"],img:["alt"],"*":["aria-label","title"]},restrictedElements:["script","style"],highlightKeys:["Alt"],highlightColor:"rgb(255, 0, 0)",highlightWidth:5,inputPrefix:"%-%tolgee:",inputSuffix:"%-%",passToParent:["option","optgroup"]},m=e=>Object.assign(Object.assign({},h),e),y={defaultNs:""},O=(e,n)=>{const t=Object.assign(Object.assign(Object.assign({},y),null==n?void 0:n.initialOptions),e),a=t.apiUrl;return t.apiUrl=a?a.replace(/\/+$/,""):a,{initialOptions:t,activeNamespaces:(null==n?void 0:n.activeNamespaces)||new Map,language:null==n?void 0:n.language,pendingLanguage:null==n?void 0:n.language,isInitialLoading:!1,isRunning:!1}};function L(e){var{ns:n,noWrap:t,orEmpty:a,params:i}=e,o=function(e,n){var t={};for(var a in e)Object.prototype.hasOwnProperty.call(e,a)&&n.indexOf(a)<0&&(t[a]=e[a]);if(null!=e&&"function"==typeof Object.getOwnPropertySymbols){var i=0;for(a=Object.getOwnPropertySymbols(e);i<a.length;i++)n.indexOf(a[i])<0&&Object.prototype.propertyIsEnumerable.call(e,a[i])&&(t[a[i]]=e[a[i]])}return t}(e,["ns","noWrap","orEmpty","params"]);return{ns:n,noWrap:t,orEmpty:a,params:Object.assign(Object.assign({},o),i)}}const k=(e,...n)=>{let t,a={};return"object"==typeof e?a=e:(a.key=e,"string"==typeof n[0]?(a.defaultValue=n[0],t=n[1]):"object"==typeof n[0]&&(t=n[0])),t&&(a=Object.assign(Object.assign({},L(t)),a)),a},j=({options:n})=>{const o=(n=>{const t=e(),a=e(),i=e(),o=e(),r=e(),g=e(),c=s(n),u=e(),l=e();return g.listen((()=>c.emit())),a.listen((()=>c.emit())),u.listen((({value:e})=>{c.emit({ns:[e.namespace],key:e.key},!0)})),Object.freeze({onPendingLanguageChange:t,onLanguageChange:a,onKeyChange:i,onKeyUpdate:c,onLoadingChange:o,onFetchingChange:r,onInitialLoaded:g,onRunningChange:l,onCacheChange:u,on:(e,n)=>{switch(e){case"pendingLanguage":return t.listen(n);case"language":return a.listen(n);case"loading":return o.listen(n);case"fetching":return r.listen(n);case"initialLoad":return g.listen(n);case"running":return l.listen(n);case"cache":return u.listen(n);case"keyUpdate":return c.listen(n)}}})})((function(){return u.getFallbackNamespaces()})),r=b(!1,(()=>y.isFetching()),o.onFetchingChange.emit),g=b(!1,(()=>R()),o.onLoadingChange.emit),u=((e,n,o)=>{let r,s=O(),g=m();function u(){return s.language||s.initialOptions.language}function l(){return Object.assign(Object.assign({},s.initialOptions),r)}return Object.freeze({init:function(e){s=O(e,s)},isRunning:function(){return s.isRunning},setRunning:function(e){s.isRunning!==e&&(s.isRunning=e,o.emit(e))},isInitialLoading:function(){return s.isInitialLoading},setInitialLoading:function(e){s.isInitialLoading=e},getLanguage:u,setLanguage:function(n){s.language!==n&&(s.language=n,e.emit(n))},getPendingLanguage:function(){return s.pendingLanguage||u()},setPendingLanguage:function(e){s.pendingLanguage!==e&&(s.pendingLanguage=e,n.emit(e))},getInitialOptions:l,addActiveNs:function(e){t(e).forEach((e=>{const n=s.activeNamespaces.get(e);void 0!==n?s.activeNamespaces.set(e,n+1):s.activeNamespaces.set(e,1)}))},removeActiveNs:function(e){t(e).forEach((e=>{const n=s.activeNamespaces.get(e);void 0!==n&&n>1?s.activeNamespaces.set(e,n-1):s.activeNamespaces.delete(e)}))},getRequiredNamespaces:function(){return i([...s.initialOptions.ns||[s.initialOptions.defaultNs],...s.activeNamespaces.keys()])},getFallbackLangs:function(e){const n=e||u();return n?i([n,...a(n,s.initialOptions.fallbackLanguage)]):[]},getFallbackNamespaces:function(){const e=s.initialOptions.defaultNs;return i([..."string"==typeof e?[e]:[],...t(s.initialOptions.fallbackNs)])},getAvailableLanguages:function(){if(s.initialOptions.availableLanguages)return s.initialOptions.availableLanguages;if(s.initialOptions.staticData){const e=Object.keys(s.initialOptions.staticData).map((e=>c(e).language));return Array.from(new Set(e))}},withDefaultNs:function(e){return{namespace:void 0===e.namespace?l().defaultNs:e.namespace,language:e.language}},overrideCredentials:function(e){r=e},setObserverOptions:function(e){g=m(e)},getObserverOptions:function(){return g}})})(o.onLanguageChange,o.onPendingLanguageChange,o.onRunningChange),h=v(u.getLanguage,u.getInitialOptions,u.getObserverOptions,u.getAvailableLanguages,(function({key:e,ns:n}){const a=void 0!==n?t(n):u.getFallbackNamespaces(),i=u.getFallbackLangs();return y.getTranslationNs(a,i,e)}),N,L),y=l(o.onCacheChange,h.getBackendRecord,h.getBackendDevRecord,u.withDefaultNs,u.isInitialLoading,r,g);function L(e,n,t){const a=u.withDefaultNs(e),i=y.getTranslation(a,n);return y.changeTranslation(a,n,t),{revert:()=>{y.changeTranslation(a,n,i)}}}function j(e){u.init(e),y.addStaticData(u.getInitialOptions().staticData)}function R(e){return y.isLoading(u.getLanguage(),e)}function E(){return Boolean(u.getInitialOptions().apiKey&&u.getInitialOptions().apiUrl&&h.getDevBackend())}function w(e,n){const a=function(e,n){const a=u.getFallbackLangs(e),i=void 0!==n?t(n):u.getRequiredNamespaces(),o=[];return a.forEach((e=>{i.forEach((n=>{y.exists({language:e,namespace:n},!0)||o.push({language:e,namespace:n})}))})),o}(e,n);if(a.length)return f(T(a),(()=>{}))}function N({key:e,ns:n}){const a=void 0!==n?t(n):u.getFallbackNamespaces(),i=u.getFallbackLangs();return y.getTranslationFallback(a,i,e)}function A(){const e=f(function(){if(u.getLanguage())return;if(!u.getInitialOptions().defaultLanguage)throw new Error(p("defaultLanguage"));const e=h.getInitialLanguage();return f(e,(e=>{const n=e||u.getInitialOptions().defaultLanguage;n&&u.setLanguage(n)}))}(),(()=>w()));if(d(e))return u.setInitialLoading(!0),r.notify(),g.notify(),Promise.resolve(e).then((()=>{u.setInitialLoading(!1),r.notify(),g.notify(),o.onInitialLoaded.emit()}));o.onInitialLoaded.emit()}function T(e){return y.loadRecords(e,E())}n&&j(n),o.onKeyUpdate.listen((()=>{u.isRunning()&&h.retranslate()}));return Object.freeze(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({},o),u),h),y),{init:j,changeLanguage:async function(e){u.getPendingLanguage()===e&&u.getLanguage()===e||(u.setPendingLanguage(e),u.isRunning()&&await w(e),e===u.getPendingLanguage()&&(u.setLanguage(e),h.setStoredLanguage(e)))},getTranslation:N,changeTranslation:L,addActiveNs:async function(e,n){n||u.addActiveNs(e),u.isRunning()&&await w(void 0,e)},loadRequiredRecords:w,loadRecords:T,loadRecord:async function(e){return(await T([e]))[0]},isLoading:R,isLoaded:function(e){const n=u.getLanguage();if(!n)return!1;const a=u.getFallbackLangs(n),i=void 0!==e?t(e):u.getRequiredNamespaces(),o=[];return a.forEach((e=>{i.forEach((n=>{y.exists({language:e,namespace:n})||o.push({language:e,namespace:n})}))})),0===o.length},t:(...e)=>{const n=k(...e),t=N(n);return h.formatTranslation(Object.assign(Object.assign({},n),{translation:t}))},isDev:E,run:function(){let e;return(()=>{const e=h.getLanguageDetector();if(e&&!u.getAvailableLanguages())throw new Error(p("availableLanguages"));if(!u.getLanguage()&&!u.getInitialOptions().defaultLanguage)throw e?new Error(p("defaultLanguage")):new Error(p("language"))})(),u.isRunning()||(E()&&y.invalidate(),u.setRunning(!0),h.run(E()),e=A()),Promise.resolve(e)},stop:function(){u.isRunning()&&(h.stop(),u.setRunning(!1))}}))};exports.DEVTOOLS_ID="__tolgee_dev_tools",exports.RESTRICTED_ASCENDANT_ATTRIBUTE="data-tolgee-restricted",exports.TOLGEE_ATTRIBUTE_NAME="_tolgee",exports.TOLGEE_HIGHLIGHTER_CLASS="_tolgee-highlighter",exports.TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE="data-tolgee-key-only",exports.Tolgee=e=>{const n=j({options:e}),t=Object.freeze({setFinalFormatter:n.setFinalFormatter,addFormatter:n.addFormatter,setObserver:n.setObserver,hasObserver:n.hasObserver,setUi:n.setUi,hasUi:n.hasUi,setDevBackend:n.setDevBackend,addBackend:n.addBackend,setLanguageDetector:n.setLanguageDetector,setLanguageStorage:n.setLanguageStorage,overrideCredentials:n.overrideCredentials}),a=e=>{const t=n.isRunning();t&&n.stop(),e(),t&&n.run()},i=Object.freeze({on:n.on,onKeyUpdate:n.onKeyUpdate.listenSome,getLanguage:n.getLanguage,getPendingLanguage:n.getPendingLanguage,changeLanguage:n.changeLanguage,changeTranslation:n.changeTranslation,addActiveNs:n.addActiveNs,removeActiveNs:n.removeActiveNs,loadRecords:n.loadRecords,loadRecord:n.loadRecord,addStaticData:n.addStaticData,getRecord:n.getRecord,getAllRecords:n.getAllRecords,isLoaded:n.isLoaded,isInitialLoading:n.isInitialLoading,isLoading:n.isLoading,isFetching:n.isFetching,isRunning:n.isRunning,run:n.run,stop:n.stop,t:n.t,highlight:n.highlight,getInitialOptions:n.getInitialOptions,isDev:n.isDev,wrap:n.wrap,unwrap:n.unwrap,setObserverOptions:e=>(n.setObserverOptions(e),i),use:e=>(e&&a((()=>e(i,t))),i),init:e=>(a((()=>n.init(e))),i)});return i},exports.getFallback=n,exports.getFallbackArray=t,exports.getTranslateParams=k; | ||
| "use strict";Object.defineProperty(exports,"__esModule",{value:!0});const e=()=>{let e=[];return Object.freeze({listen:n=>{const t=e=>{n(e)};return e.push(t),{unsubscribe:()=>{e=e.filter((e=>t!==e))}}},emit:n=>{e.forEach((e=>e({value:n})))}})};function n(e){return"string"==typeof e?[e]:Array.isArray(e)?e:void 0}function t(e){return n(e)||[]}function a(e,n){return"object"!=typeof(a=n)||Array.isArray(a)||null===a?t(n):t(null==n?void 0:n[e]);var a}function i(e){return Array.from(new Set(e))}function o(e){return e?e.replace(/\/+$/,""):e}const r=(e,n)=>{const a=new Set,i=new Set,o=(t,a)=>{i.forEach((i=>{const o=(t=>{if(t.has(1)||t.has(0)){const a=new Set(t.keys());return t.has(1)&&(a.delete(1),e().forEach((e=>a.add(e)))),t.has(0)&&(a.delete(0),a.add(n())),a}return t})(i.namespaces),r=void 0===a||-1!==(null==a?void 0:a.findIndex((e=>o.has(e)))),s=void 0===t||i.keys.has(t)||0===i.keys.size;r&&s&&i.fn({value:void 0})}))};let r=[];const s=()=>{if(0===r.length)return;a.forEach((e=>{e({value:void 0})}));let e=new Set,n=new Set;r.forEach((t=>{void 0===(null==t?void 0:t.ns)?e=void 0:void 0!==e&&t.ns.forEach((n=>e.add(n))),void 0===(null==t?void 0:t.key)?n=void 0:void 0!==n&&n.add(t.key)}));const t=e?Array.from(e.keys()):void 0;(n||[void 0]).forEach((e=>{o(e,t)})),r=[]};return Object.freeze({listenSome:e=>{const n={fn:n=>{e(n)},keys:new Set,namespaces:new Set};i.add(n);const a={unsubscribe:()=>{i.delete(n)},subscribeNs:e=>(t(e).forEach((e=>n.namespaces.add(e))),void 0===e&&n.namespaces.add(0),a),subscribeKey:e=>{const{key:i,ns:o}=e;return n.keys.add(i),t(o).forEach((e=>n.namespaces.add(e))),void 0===o&&n.namespaces.add(0),n.namespaces.add(1),a}};return a},listen:e=>{a.add(e);return{unsubscribe:()=>{a.delete(e)}}},emit:(e,n)=>{r.push(e),n?setTimeout(s,0):s()}})},s=e=>{const n=new Map;return Object.entries(e).forEach((([e,t])=>{null!=t&&("object"!=typeof t?n.set(e,t):s(t).forEach(((t,a)=>{n.set(e+"."+a,t)})))})),n},c=e=>{const[n,...t]=e.split(":");return{language:n,namespace:t.join(":")||""}},g=({language:e,namespace:n})=>n?`${e}:${n}`:e,u=(e,n,a,o,r,u,l)=>{const d=new Map,f=new Map;let p={},v=0;function h(n,t,a){const i=g(n);f.set(i,{data:s(t),version:a}),e.emit(n)}function b(e,n){h(e,n,v)}function m(e,n=!1){const t=f.get(g(e));return t&&n?t.version===v:Boolean(t)}function y(e){var n;return null===(n=f.get(g(o(e))))||void 0===n?void 0:n.data}function O(e){let t;if(!t){const n=p[g(e)];"function"==typeof n&&(t=n())}return t||(t=n(e)),t}return Object.freeze({addStaticData:function(e){e&&(p=Object.assign(Object.assign({},p),e),Object.entries(e).forEach((([e,n])=>{if("function"!=typeof n){const t=c(e),a=f.get(e);a&&0!==a.version||h(t,n,0)}})))},invalidate:function(){d.clear(),v+=1},addRecord:b,exists:m,getRecord:y,getTranslation:function(e,n){var t;return null===(t=f.get(g(e)))||void 0===t?void 0:t.data.get(n)},getTranslationNs:function(e,n,t){var a;for(const i of e)for(const e of n){const n=null===(a=f.get(g({language:e,namespace:i})))||void 0===a?void 0:a.data.get(t);if(null!=n)return[i]}return i(e)},getTranslationFallback:function(e,n,t){var a;for(const i of e)for(const e of n){const n=null===(a=f.get(g({language:e,namespace:i})))||void 0===a?void 0:a.data.get(t);if(null!=n)return n}},changeTranslation:function(n,t,a){var i;const o=null===(i=f.get(g(n)))||void 0===i?void 0:i.data;null==o||o.set(t,a),e.emit(Object.assign(Object.assign({},n),{key:t}))},isFetching:function(e){if(r())return!0;if(void 0===e)return d.size>0;const n=t(e);return Boolean(Array.from(d.keys()).find((e=>n.includes(c(e).namespace))))},isLoading:function(e,n){const a=t(n);return Boolean(r()||Array.from(d.keys()).find((n=>{const t=c(n);return(!a.length||a.includes(t.namespace))&&!m({namespace:t.namespace,language:e})})))},loadRecords:async function(e,n){const t=e.map((e=>{const t=o(e),i=g(t),r=d.get(i);if(r)return{new:!1,promise:r,keyObject:t,cacheKey:i};const s=function(e,n){var t;let i;return n&&(i=null===(t=a(e))||void 0===t?void 0:t.catch((()=>(console.warn("Tolgee: Failed to fetch data from dev backend"),O(e))))),i||(i=O(e)),i}(t,n)||Promise.resolve(void 0);return d.set(i,s),{new:!0,promise:s,keyObject:t,cacheKey:i}}));u.notify(),l.notify();const i=await Promise.all(t.map((e=>e.promise)));return t.forEach(((e,n)=>{const t=d.get(e.cacheKey)!==e.promise;if(e.new&&!t){d.delete(e.cacheKey);const t=i[n];t?b(e.keyObject,t):y(e.keyObject)||b(e.keyObject,{})}})),u.notify(),l.notify(),t.map((e=>y(e.keyObject)))},getAllRecords:function(){return Array.from(f.entries()).map((([e,n])=>Object.assign(Object.assign({},c(e)),{data:n.data})))}})};function l(e){return Boolean(e&&"function"==typeof e.then)}const d=(e,n)=>l(e)?Promise.resolve(e).then(n):n(e),f=e=>`Tolgee: You need to specify '${e}' option`,p=(e,n,t,a,i,o)=>{let r=!1,s=[];const c={ui:void 0,observer:void 0},g={formatters:[],finalFormatter:void 0,observer:void 0,devBackend:void 0,backends:[],ui:void 0,languageDetector:void 0,languageStorage:void 0},u=async(e,{keysAndDefaults:n})=>{var t;const o=n.map((({key:e,ns:n,defaultValue:t})=>({key:e,defaultValue:t,ns:a({key:e,ns:n}),translation:i({key:e,ns:n})})));null===(t=g.ui)||void 0===t||t.handleElementClick(e,o)},f=(e,n)=>{var t,a;return(null===(a=null===(t=g.observer)||void 0===t?void 0:t.highlight)||void 0===a?void 0:a.call(t,e,n))||{unhighlight(){}}},p=e=>{const n=i({key:e.key,ns:e.ns});return N(Object.assign(Object.assign({},e),{translation:n,formatEnabled:!0}))},v=e=>{c.observer=e},h=()=>Boolean(c.observer),b=e=>{e&&g.formatters.push(e)},m=e=>{g.finalFormatter=e},y=e=>{c.ui=(null==e?void 0:e.UI)||e},O=()=>Boolean(c.ui),L=e=>{g.languageStorage=e},k=e=>{g.languageDetector=e},j=e=>{e&&g.backends.push(e)},w=e=>{g.devBackend=e},R=()=>g.devBackend,E=e=>{s.push(e)};function N({key:n,translation:t,defaultValue:a,noWrap:i,params:o,orEmpty:r,ns:s,formatEnabled:c}){var u;const l=t||a;let d=l||(r?"":n);g.observer&&!i&&(d=g.observer.wrap({key:n,translation:d,defaultValue:a,params:o,ns:s}));const f=e(),p=c||!(null===(u=g.observer)||void 0===u?void 0:u.outputNotFormattable);if(l&&f&&p)for(const e of g.formatters)d=e.format({translation:d,language:f,params:o});return g.finalFormatter&&l&&f&&p&&(d=g.finalFormatter.format({translation:d,language:f,params:o})),d}function I(){for(r=!0;s.length;){const e=s;s=[],e.forEach((e=>e()))}}return Object.freeze({prepare:I,addPlugin:function(e,n){n(e,Object.freeze({setFinalFormatter:m,addFormatter:b,setObserver:v,hasObserver:h,setUi:y,hasUi:O,setDevBackend:w,addBackend:j,setLanguageDetector:k,setLanguageStorage:L,onPrepare:E})),r&&I()},formatTranslation:N,getDevBackend:R,getBackendRecord:({language:e,namespace:n})=>{for(const t of g.backends){const a=t.getRecord({language:e,namespace:n});if(l(a))return null==a?void 0:a.catch((e=>(console.error(e),{})));if(void 0!==a)return a}},getBackendDevRecord:({language:e,namespace:t})=>{var a;const{apiKey:i,apiUrl:o,projectId:r}=n();return null===(a=g.devBackend)||void 0===a?void 0:a.getRecord({apiKey:i,apiUrl:o,projectId:r,language:e,namespace:t})},getLanguageDetector:()=>g.languageDetector,getInitialLanguage:()=>{var e;const n=t(),a=null===(e=g.languageStorage)||void 0===e?void 0:e.getLanguage();return d(a,(e=>n&&!n.includes(e)||!e?(()=>{if(!g.languageDetector)return;const e=t();return g.languageDetector.getLanguage({availableLanguages:e})})():e))},setStoredLanguage:e=>{var n;null===(n=g.languageStorage)||void 0===n||n.setLanguage(e)},run:e=>{var t,a;if(!g.ui&&c.ui){const{apiKey:e,apiUrl:t,projectId:a}=n();g.ui=new c.ui({apiKey:e,apiUrl:t,projectId:a,highlight:f,changeTranslation:o})}g.observer||(g.observer=null===(t=c.observer)||void 0===t?void 0:t.call(c,{translate:p,onClick:u,options:n().observerOptions})),null===(a=g.observer)||void 0===a||a.run({mouseHighlight:e})},stop:()=>{var e;g.ui=void 0,null===(e=g.observer)||void 0===e||e.stop()},retranslate:()=>{var e;null===(e=g.observer)||void 0===e||e.retranslate()},highlight:f,unwrap:e=>{var n;return g.observer?null===(n=g.observer)||void 0===n?void 0:n.unwrap(e):{text:e,keys:[]}},wrap:e=>{var n;return g.observer?null===(n=g.observer)||void 0===n?void 0:n.wrap(e):e.translation},hasDevBackend:function(){return Boolean(R())}})},v=(e,n,t)=>{let a=e;return Object.freeze({init:function(e){a=e},notify:function(){const e=n();a!==e&&t(e),a=e}})},h={defaultNs:"",observerOptions:{tagAttributes:{textarea:["placeholder"],input:["value","placeholder"],img:["alt"],"*":["aria-label","title"]},restrictedElements:["script","style"],highlightKeys:["Alt"],highlightColor:"rgb(255, 0, 0)",highlightWidth:5,inputPrefix:"%-%tolgee:",inputSuffix:"%-%",passToParent:["option","optgroup"]},observerType:"invisible"},b=(...e)=>{let n={};return e.forEach((e=>{n=Object.assign(Object.assign(Object.assign({},n),e),{observerOptions:Object.assign(Object.assign({},n.observerOptions),null==e?void 0:e.observerOptions)})})),n},m=(e,n)=>{const t=b(h,null==n?void 0:n.initialOptions,e);return t.apiUrl=o(t.apiUrl),{initialOptions:t,activeNamespaces:(null==n?void 0:n.activeNamespaces)||new Map,language:null==n?void 0:n.language,pendingLanguage:null==n?void 0:n.language,isInitialLoading:!1,isRunning:!1}};function y(e){var{ns:n,noWrap:t,orEmpty:a,params:i}=e,o=function(e,n){var t={};for(var a in e)Object.prototype.hasOwnProperty.call(e,a)&&n.indexOf(a)<0&&(t[a]=e[a]);if(null!=e&&"function"==typeof Object.getOwnPropertySymbols){var i=0;for(a=Object.getOwnPropertySymbols(e);i<a.length;i++)n.indexOf(a[i])<0&&Object.prototype.propertyIsEnumerable.call(e,a[i])&&(t[a[i]]=e[a[i]])}return t}(e,["ns","noWrap","orEmpty","params"]);const r={ns:n,noWrap:t,orEmpty:a};return Object.assign(Object.assign({},r),{params:Object.assign({},o)})}const O=(e,...n)=>{let t,a={};return"object"==typeof e?a=e:(a.key=e,"string"==typeof n[0]?(a.defaultValue=n[0],t=n[1]):"object"==typeof n[0]&&(t=n[0])),t&&(a=Object.assign(Object.assign({},y(t)),a)),a},L=({options:n})=>{const s=((n,t)=>{const a=e(),i=e(),o=e(),s=e(),c=e(),g=e(),u=r(n,t),l=e(),d=e();return g.listen((()=>u.emit())),i.listen((()=>u.emit())),l.listen((({value:e})=>{u.emit({ns:[e.namespace],key:e.key},!0)})),Object.freeze({onPendingLanguageChange:a,onLanguageChange:i,onKeyChange:o,onKeyUpdate:u,onLoadingChange:s,onFetchingChange:c,onInitialLoaded:g,onRunningChange:d,onCacheChange:l,on:(e,n)=>{switch(e){case"pendingLanguage":return a.listen(n);case"language":return i.listen(n);case"loading":return s.listen(n);case"fetching":return c.listen(n);case"initialLoad":return g.listen(n);case"running":return d.listen(n);case"cache":return l.listen(n);case"keyUpdate":return u.listen(n)}}})})(k,j),g=v(!1,(()=>L.isFetching()),s.onFetchingChange.emit),h=v(!1,(()=>I()),s.onLoadingChange.emit),b=((e,n,r)=>{let s,g=m();function u(){return g.language||g.initialOptions.language}function l(){return Object.assign(Object.assign({},g.initialOptions),s)}return Object.freeze({init:function(e){g=m(e,g)},isRunning:function(){return g.isRunning},setRunning:function(e){g.isRunning!==e&&(g.isRunning=e,r.emit(e))},isInitialLoading:function(){return g.isInitialLoading},setInitialLoading:function(e){g.isInitialLoading=e},getLanguage:u,setLanguage:function(n){g.language!==n&&(g.language=n,e.emit(n))},getPendingLanguage:function(){return g.pendingLanguage||u()},setPendingLanguage:function(e){g.pendingLanguage!==e&&(g.pendingLanguage=e,n.emit(e))},getInitialOptions:l,addActiveNs:function(e){t(e).forEach((e=>{const n=g.activeNamespaces.get(e);void 0!==n?g.activeNamespaces.set(e,n+1):g.activeNamespaces.set(e,1)}))},removeActiveNs:function(e){t(e).forEach((e=>{const n=g.activeNamespaces.get(e);void 0!==n&&n>1?g.activeNamespaces.set(e,n-1):g.activeNamespaces.delete(e)}))},getRequiredNamespaces:function(){return i([...g.initialOptions.ns||[g.initialOptions.defaultNs],...t(g.initialOptions.fallbackNs),...g.activeNamespaces.keys()])},getFallbackLangs:function(e){const n=e||u();return n?i([n,...a(n,g.initialOptions.fallbackLanguage)]):[]},getFallbackNs:function(){return t(g.initialOptions.fallbackNs)},getDefaultNs:function(e){return void 0===e?g.initialOptions.defaultNs:e},getAvailableLanguages:function(){if(g.initialOptions.availableLanguages)return g.initialOptions.availableLanguages;if(g.initialOptions.staticData){const e=Object.keys(g.initialOptions.staticData).map((e=>c(e).language));return Array.from(new Set(e))}},withDefaultNs:function(e){return{namespace:void 0===e.namespace?l().defaultNs:e.namespace,language:e.language}},overrideCredentials:function(e){s=e?Object.assign(Object.assign({},e),{apiUrl:o(e.apiUrl)}):void 0}})})(s.onLanguageChange,s.onPendingLanguageChange,s.onRunningChange),y=p(b.getLanguage,b.getInitialOptions,b.getAvailableLanguages,(function({key:e,ns:n}){const t=b.getFallbackLangs(),a=w(n);return L.getTranslationNs(a,t,e)}),F,E),L=u(s.onCacheChange,y.getBackendRecord,y.getBackendDevRecord,b.withDefaultNs,b.isInitialLoading,g,h);function k(){return b.getFallbackNs()}function j(e){return b.getDefaultNs(e)}function w(e){return[...t(j(e)),...k()]}function R(e){return[...t(e||j()),...b.getRequiredNamespaces()]}function E(e,n,t){const a=b.withDefaultNs(e),i=L.getTranslation(a,n);return L.changeTranslation(a,n,t),{revert:()=>{L.changeTranslation(a,n,i)}}}function N(e){b.init(e),L.addStaticData(b.getInitialOptions().staticData)}function I(e){return L.isLoading(b.getLanguage(),e)}function D(){return Boolean(b.getInitialOptions().apiKey&&b.getInitialOptions().apiUrl)}function A(e,n){const t=function(e,n){const t=b.getFallbackLangs(e),a=R(n),i=[];return t.forEach((e=>{a.forEach((n=>{L.exists({language:e,namespace:n},!0)||i.push({language:e,namespace:n})}))})),i}(e,n);if(t.length)return d(P(t),(()=>{}))}function F({key:e,ns:n}){const t=w(n),a=b.getFallbackLangs();return L.getTranslationFallback(t,a,e)}function S(){const e=d(function(){if(b.getLanguage())return;if(!b.getInitialOptions().defaultLanguage)throw new Error(f("defaultLanguage"));const e=y.getInitialLanguage();return d(e,(e=>{const n=e||b.getInitialOptions().defaultLanguage;n&&b.setLanguage(n)}))}(),(()=>A()));if(l(e))return b.setInitialLoading(!0),g.notify(),h.notify(),Promise.resolve(e).then((()=>{b.setInitialLoading(!1),g.notify(),h.notify(),s.onInitialLoaded.emit()}));s.onInitialLoaded.emit()}function P(e){return L.loadRecords(e,D())}n&&N(n),s.onKeyUpdate.listen((()=>{b.isRunning()&&y.retranslate()}));return Object.freeze(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({},s),b),y),L),{init:N,changeLanguage:async function(e){b.getPendingLanguage()===e&&b.getLanguage()===e||(b.setPendingLanguage(e),b.isRunning()&&await A(e),e===b.getPendingLanguage()&&(b.setLanguage(e),y.setStoredLanguage(e)))},getTranslation:F,changeTranslation:E,addActiveNs:async function(e,n){n||b.addActiveNs(e),b.isRunning()&&await A(void 0,e)},loadRecords:P,loadRecord:async function(e){return(await P([e]))[0]},isLoading:I,isLoaded:function(e){const n=b.getLanguage();if(!n)return!1;const t=b.getFallbackLangs(n),a=R(e),i=[];return t.forEach((e=>{a.forEach((n=>{L.exists({language:e,namespace:n})||i.push({language:e,namespace:n})}))})),0===i.length},t:(...e)=>{const n=O(...e),t=F(n);return y.formatTranslation(Object.assign(Object.assign({},n),{translation:t}))},isDev:D,run:function(){let e;return(()=>{const e=y.getLanguageDetector();if(e&&!b.getAvailableLanguages())throw new Error(f("availableLanguages"));if(!b.getLanguage()&&!b.getInitialOptions().defaultLanguage)throw e?new Error(f("defaultLanguage")):new Error(f("language"))})(),b.isRunning()||(D()&&L.invalidate(),b.setRunning(!0),y.run(D()),e=S()),Promise.resolve(e)},stop:function(){b.isRunning()&&(y.stop(),b.setRunning(!1))}}))};class k extends Error{constructor(e,n,t){let a;a=0===e?"Empty parameter":1===e?"Unexpected character":"Unexpected end",super(`Tolgee parser: ${a} at ${n} in "${t}"`),this.code=e,this.index=n}}function j(e){return/\s/.test(e)}const w=new Set([2,1,0]),R=new Set(["{","}","'"]);function E(e,n){const[t,a]=function(e){let n=0,t="",a="",i="";const o=[],r=[];let s=0;function c(n){throw new k(n,s,e)}const g=()=>{o.push(t),t=""},u=()=>{""===a&&c(0),r.push(a),a=""};for(s=0;s<e.length;s++)switch(i=e[s],n){case 0:"'"===i?(t+=i,n=1):"{"===i?(g(),n=3):(t+=i,n=0);break;case 1:R.has(i)?(t=t.slice(0,-1)+i,n=2):(t+=i,n=0);break;case 2:"'"===i?n=0:(t+=i,n=2);break;case 3:"}"===i?(u(),n=0):j(i)?""!==a&&(u(),n=4):(/[0-9a-zA-Z_]/.test(i)||c(1),a+=i,n=3);break;case 4:"}"==i?n=0:j(i)?n=4:c(1)}return w.has(n)||c(2),g(),[o,r]}(e),i=[t[0]];for(let o=1;o<t.length;o++){const r=null==n?void 0:n[a[o-1]];if(void 0===r)throw new Error(`Missing parameter "${a[o-1]}" in "${e}"`);i.push(String(r)),i.push(t[o])}return i.join("")}exports.FormatSimple=()=>(e,n)=>(n.setFinalFormatter({format:({translation:e,params:n})=>E(e,n)}),e),exports.Tolgee=()=>{const e={plugins:[],options:{}},n=Object.freeze({use:t=>(e.plugins.push(t),n),updateDefaults:t=>(e.options=b(e.options,t),n),init(n){const t=(e=>{const n=L({options:e}),t=e=>{const t=n.isRunning();t&&n.stop(),e(),t&&n.run()},a=Object.freeze({on:n.on,onKeyUpdate:n.onKeyUpdate.listenSome,getLanguage:n.getLanguage,getPendingLanguage:n.getPendingLanguage,changeLanguage:n.changeLanguage,changeTranslation:n.changeTranslation,addActiveNs:n.addActiveNs,removeActiveNs:n.removeActiveNs,loadRecords:n.loadRecords,loadRecord:n.loadRecord,addStaticData:n.addStaticData,getRecord:n.getRecord,getAllRecords:n.getAllRecords,isLoaded:n.isLoaded,isInitialLoading:n.isInitialLoading,isLoading:n.isLoading,isFetching:n.isFetching,isRunning:n.isRunning,run:n.run,stop:n.stop,t:n.t,highlight:n.highlight,getInitialOptions:n.getInitialOptions,isDev:n.isDev,wrap:n.wrap,unwrap:n.unwrap,overrideCredentials(e){t((()=>n.overrideCredentials(e)))},addPlugin(e){e&&t((()=>n.addPlugin(a,e)))},updateOptions(e){e&&t((()=>n.init(e)))}});return a})(b(e.options,n));return e.plugins.forEach(t.addPlugin),t}});return n},exports.getFallback=n,exports.getFallbackArray=t,exports.getTranslateParams=O; | ||
| //# sourceMappingURL=tolgee.cjs.min.js.map |
@@ -46,18 +46,9 @@ const EventEmitter = () => { | ||
| } | ||
| function sanitizeUrl(url) { | ||
| return url ? url.replace(/\/+$/, '') : url; | ||
| } | ||
| function incrementInMap(map, value) { | ||
| const currNum = map.get(value) || 0; | ||
| map.set(value, currNum + 1); | ||
| } | ||
| function decrementInMap(map, value) { | ||
| let currNum = map.get(value) || 1; | ||
| currNum -= 1; | ||
| if (currNum <= 0) { | ||
| map.delete(value); | ||
| } | ||
| else { | ||
| map.set(value, currNum); | ||
| } | ||
| } | ||
| const EventEmitterSelective = (getFallbackNamespaces) => { | ||
| const DEFAULT_NS = 0; | ||
| const FALLBACK_NS = 1; | ||
| const EventEmitterSelective = (getFallbackNs, getDefaultNs) => { | ||
| const listeners = new Set(); | ||
@@ -79,4 +70,4 @@ const partialListeners = new Set(); | ||
| }, | ||
| keys: new Map(), | ||
| namespaces: new Map(), | ||
| keys: new Set(), | ||
| namespaces: new Set(), | ||
| }; | ||
@@ -89,27 +80,19 @@ partialListeners.add(handlerWrapper); | ||
| subscribeNs: (ns) => { | ||
| getFallbackArray(ns).forEach((val) => incrementInMap(handlerWrapper.namespaces, val)); | ||
| return result; | ||
| }, | ||
| unsubscribeNs: (ns) => { | ||
| getFallbackArray(ns).forEach((val) => decrementInMap(handlerWrapper.namespaces, val)); | ||
| return result; | ||
| }, | ||
| subscribeKey: (descriptor) => { | ||
| const { key, ns } = descriptor; | ||
| incrementInMap(handlerWrapper.keys, key); | ||
| getFallbackArray(ns).forEach((val) => incrementInMap(handlerWrapper.namespaces, val)); | ||
| getFallbackArray(ns).forEach((val) => handlerWrapper.namespaces.add(val)); | ||
| if (ns === undefined) { | ||
| // subscribing to all namespaces | ||
| incrementInMap(handlerWrapper.namespaces, undefined); | ||
| // subscribing to default ns | ||
| handlerWrapper.namespaces.add(DEFAULT_NS); | ||
| } | ||
| return result; | ||
| }, | ||
| unsubscribeKey: (descriptor) => { | ||
| subscribeKey: (descriptor) => { | ||
| const { key, ns } = descriptor; | ||
| decrementInMap(handlerWrapper.keys, key); | ||
| getFallbackArray(ns).forEach((val) => decrementInMap(handlerWrapper.namespaces, val)); | ||
| handlerWrapper.keys.add(key); | ||
| getFallbackArray(ns).forEach((val) => handlerWrapper.namespaces.add(val)); | ||
| if (ns === undefined) { | ||
| // subscribing to all namespaces | ||
| decrementInMap(handlerWrapper.namespaces, undefined); | ||
| // subscribing to default ns | ||
| handlerWrapper.namespaces.add(DEFAULT_NS); | ||
| } | ||
| // always subscribe to fallback namespaces | ||
| handlerWrapper.namespaces.add(FALLBACK_NS); | ||
| return result; | ||
@@ -121,6 +104,12 @@ }, | ||
| const namespacesWithFallbacks = (namespaces) => { | ||
| if (namespaces.has(undefined)) { | ||
| if (namespaces.has(FALLBACK_NS) || namespaces.has(DEFAULT_NS)) { | ||
| const result = new Set(namespaces.keys()); | ||
| result.delete(undefined); | ||
| getFallbackNamespaces().forEach((ns) => result.add(ns)); | ||
| if (namespaces.has(FALLBACK_NS)) { | ||
| result.delete(FALLBACK_NS); | ||
| getFallbackNs().forEach((ns) => result.add(ns)); | ||
| } | ||
| if (namespaces.has(DEFAULT_NS)) { | ||
| result.delete(DEFAULT_NS); | ||
| result.add(getDefaultNs()); | ||
| } | ||
| return result; | ||
@@ -150,10 +139,10 @@ } | ||
| }); | ||
| const namespaces = new Set(); | ||
| let namespaces = new Set(); | ||
| let keys = new Set(); | ||
| queue.forEach((descriptor) => { | ||
| if ((descriptor === null || descriptor === void 0 ? void 0 : descriptor.ns) === undefined) { | ||
| // when no ns specified, it affets all fallback namespaces | ||
| namespaces.add(undefined); | ||
| // when no ns specified, it affects all namespaces | ||
| namespaces = undefined; | ||
| } | ||
| else { | ||
| else if (namespaces !== undefined) { | ||
| descriptor.ns.forEach((ns) => namespaces.add(ns)); | ||
@@ -169,3 +158,5 @@ } | ||
| }); | ||
| const namespacesArray = Array.from(namespacesWithFallbacks(namespaces).keys()); | ||
| const namespacesArray = namespaces | ||
| ? Array.from(namespaces.keys()) | ||
| : undefined; | ||
| (keys || [undefined]).forEach((key) => { | ||
@@ -182,5 +173,3 @@ callHandlers(key, namespacesArray); | ||
| else { | ||
| Promise.resolve().then(() => { | ||
| solveQueue(); | ||
| }); | ||
| setTimeout(solveQueue, 0); | ||
| } | ||
@@ -191,3 +180,3 @@ }; | ||
| const Events = (getFallbackNamespaces) => { | ||
| const Events = (getFallbackNs, getDefaultNs) => { | ||
| const onPendingLanguageChange = EventEmitter(); | ||
@@ -199,3 +188,3 @@ const onLanguageChange = EventEmitter(); | ||
| const onInitialLoaded = EventEmitter(); | ||
| const onKeyUpdate = EventEmitterSelective(getFallbackNamespaces); | ||
| const onKeyUpdate = EventEmitterSelective(getFallbackNs, getDefaultNs); | ||
| const onCacheChange = EventEmitter(); | ||
@@ -260,3 +249,5 @@ const onRunningChange = EventEmitter(); | ||
| const decodeCacheKey = (key) => { | ||
| const [firstPart, secondPart] = key.split(':'); | ||
| const [firstPart, ...rest] = key.split(':'); | ||
| // if namespaces contains ":" it won't get lost | ||
| const secondPart = rest.join(':'); | ||
| return { language: firstPart, namespace: secondPart || '' }; | ||
@@ -329,7 +320,7 @@ }; | ||
| if (value !== undefined && value !== null) { | ||
| return namespace; | ||
| return [namespace]; | ||
| } | ||
| } | ||
| } | ||
| return Array.from(new Set(namespaces)); | ||
| return unique(namespaces); | ||
| } | ||
@@ -388,6 +379,2 @@ function getTranslationFallback(namespaces, languages, key) { | ||
| } | ||
| if (!dataPromise) { | ||
| // return empty data, so we know it has already been attempted to fetch | ||
| dataPromise = Promise.resolve({}); | ||
| } | ||
| return dataPromise; | ||
@@ -424,3 +411,3 @@ } | ||
| } | ||
| const dataPromise = fetchData(keyObject, isDev); | ||
| const dataPromise = fetchData(keyObject, isDev) || Promise.resolve(undefined); | ||
| asyncRequests.set(cacheKey, dataPromise); | ||
@@ -447,2 +434,6 @@ return { | ||
| } | ||
| else if (!getRecord(value.keyObject)) { | ||
| // if no data exist, put empty object | ||
| addRecord(value.keyObject, {}); | ||
| } | ||
| } | ||
@@ -490,3 +481,5 @@ }); | ||
| const PluginService = (getLanguage, getInitialOptions, getObserverOptions, getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation) => { | ||
| const PluginService = (getLanguage, getInitialOptions, getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation) => { | ||
| let prepared = false; | ||
| let onPrepareQueue = []; | ||
| const plugins = { | ||
@@ -508,32 +501,15 @@ ui: undefined, | ||
| var _a; | ||
| const withNs = keysAndDefaults.map(({ key, ns, defaultValue }) => ({ | ||
| key, | ||
| defaultValue, | ||
| ns: getFallbackArray(getTranslationNs({ key, ns, defaultValue })), | ||
| translation: getTranslation({ | ||
| const withNs = keysAndDefaults.map(({ key, ns, defaultValue }) => { | ||
| return { | ||
| key, | ||
| ns, | ||
| }), | ||
| })); | ||
| defaultValue, | ||
| ns: getTranslationNs({ key, ns }), | ||
| translation: getTranslation({ | ||
| key, | ||
| ns, | ||
| }), | ||
| }; | ||
| }); | ||
| (_a = instances.ui) === null || _a === void 0 ? void 0 : _a.handleElementClick(event, withNs); | ||
| }; | ||
| const run = (isDev) => { | ||
| var _a, _b; | ||
| if (!instances.ui && plugins.ui) { | ||
| instances.ui = new plugins.ui({ | ||
| apiKey: getInitialOptions().apiKey, | ||
| apiUrl: getInitialOptions().apiUrl, | ||
| highlight, | ||
| changeTranslation, | ||
| }); | ||
| } | ||
| if (!instances.observer) { | ||
| instances.observer = (_a = plugins.observer) === null || _a === void 0 ? void 0 : _a.call(plugins, { | ||
| translate, | ||
| onClick, | ||
| options: getObserverOptions(), | ||
| }); | ||
| } | ||
| (_b = instances.observer) === null || _b === void 0 ? void 0 : _b.run({ mouseHighlight: isDev }); | ||
| }; | ||
| const stop = () => { | ||
@@ -549,3 +525,6 @@ var _a; | ||
| const translate = (props) => { | ||
| const translation = getTranslation(props); | ||
| const translation = getTranslation({ | ||
| key: props.key, | ||
| ns: props.ns, | ||
| }); | ||
| return formatTranslation(Object.assign(Object.assign({}, props), { translation, formatEnabled: true })); | ||
@@ -576,5 +555,2 @@ }; | ||
| }; | ||
| const getLanguageStorage = () => { | ||
| return instances.languageStorage; | ||
| }; | ||
| const setStoredLanguage = (language) => { | ||
@@ -619,2 +595,23 @@ var _a; | ||
| }; | ||
| const run = (isDev) => { | ||
| var _a, _b; | ||
| if (!instances.ui && plugins.ui) { | ||
| const { apiKey, apiUrl, projectId } = getInitialOptions(); | ||
| instances.ui = new plugins.ui({ | ||
| apiKey: apiKey, | ||
| apiUrl: apiUrl, | ||
| projectId, | ||
| highlight, | ||
| changeTranslation, | ||
| }); | ||
| } | ||
| if (!instances.observer) { | ||
| instances.observer = (_a = plugins.observer) === null || _a === void 0 ? void 0 : _a.call(plugins, { | ||
| translate, | ||
| onClick, | ||
| options: getInitialOptions().observerOptions, | ||
| }); | ||
| } | ||
| (_b = instances.observer) === null || _b === void 0 ? void 0 : _b.run({ mouseHighlight: isDev }); | ||
| }; | ||
| const getDevBackend = () => { | ||
@@ -625,5 +622,7 @@ return instances.devBackend; | ||
| var _a; | ||
| const { apiKey, apiUrl, projectId } = getInitialOptions(); | ||
| return (_a = instances.devBackend) === null || _a === void 0 ? void 0 : _a.getRecord({ | ||
| apiKey: getInitialOptions().apiKey, | ||
| apiUrl: getInitialOptions().apiUrl, | ||
| apiKey, | ||
| apiUrl, | ||
| projectId, | ||
| language, | ||
@@ -649,4 +648,37 @@ namespace, | ||
| }; | ||
| const formatTranslation = ({ key, translation, defaultValue, noWrap, params, orEmpty, ns, formatEnabled, }) => { | ||
| const unwrap = (text) => { | ||
| var _a; | ||
| if (instances.observer) { | ||
| return (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.unwrap(text); | ||
| } | ||
| return { text, keys: [] }; | ||
| }; | ||
| const retranslate = () => { | ||
| var _a; | ||
| (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.retranslate(); | ||
| }; | ||
| const onPrepare = (callback) => { | ||
| onPrepareQueue.push(callback); | ||
| }; | ||
| function addPlugin(tolgeeInstance, plugin) { | ||
| const pluginTools = Object.freeze({ | ||
| setFinalFormatter, | ||
| addFormatter, | ||
| setObserver, | ||
| hasObserver, | ||
| setUi, | ||
| hasUi, | ||
| setDevBackend, | ||
| addBackend, | ||
| setLanguageDetector, | ||
| setLanguageStorage, | ||
| onPrepare, | ||
| }); | ||
| plugin(tolgeeInstance, pluginTools); | ||
| if (prepared) { | ||
| prepare(); | ||
| } | ||
| } | ||
| function formatTranslation({ key, translation, defaultValue, noWrap, params, orEmpty, ns, formatEnabled, }) { | ||
| var _a; | ||
| const formattableTranslation = translation || defaultValue; | ||
@@ -685,3 +717,6 @@ let result = formattableTranslation || (orEmpty ? '' : key); | ||
| return result; | ||
| }; | ||
| } | ||
| function hasDevBackend() { | ||
| return Boolean(getDevBackend()); | ||
| } | ||
| const wrap = (params) => { | ||
@@ -694,30 +729,18 @@ var _a; | ||
| }; | ||
| const unwrap = (text) => { | ||
| var _a; | ||
| if (instances.observer) { | ||
| return (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.unwrap(text); | ||
| function prepare() { | ||
| prepared = true; | ||
| while (onPrepareQueue.length) { | ||
| const queue = onPrepareQueue; | ||
| onPrepareQueue = []; | ||
| queue.forEach((callback) => callback()); | ||
| } | ||
| return { text, keys: [] }; | ||
| }; | ||
| const retranslate = () => { | ||
| var _a; | ||
| (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.retranslate(); | ||
| }; | ||
| } | ||
| return Object.freeze({ | ||
| setFinalFormatter, | ||
| addFormatter, | ||
| prepare, | ||
| addPlugin, | ||
| formatTranslation, | ||
| setObserver, | ||
| hasObserver, | ||
| setUi, | ||
| hasUi, | ||
| addBackend, | ||
| setDevBackend, | ||
| getDevBackend, | ||
| getBackendRecord, | ||
| getBackendDevRecord, | ||
| setLanguageDetector, | ||
| getLanguageDetector, | ||
| setLanguageStorage, | ||
| getLanguageStorage, | ||
| getInitialLanguage, | ||
@@ -729,4 +752,5 @@ setStoredLanguage, | ||
| highlight, | ||
| unwrap, | ||
| wrap, | ||
| unwrap, | ||
| hasDevBackend, | ||
| }); | ||
@@ -753,3 +777,3 @@ }; | ||
| const defaultValues$1 = { | ||
| const defaultObserverOptions = { | ||
| tagAttributes: { | ||
@@ -769,14 +793,19 @@ textarea: ['placeholder'], | ||
| }; | ||
| const initObserverOptions = (options) => { | ||
| return Object.assign(Object.assign({}, defaultValues$1), options); | ||
| }; | ||
| const defaultValues = { | ||
| defaultNs: '', | ||
| observerOptions: defaultObserverOptions, | ||
| observerType: 'invisible', | ||
| }; | ||
| const combineOptions = (...states) => { | ||
| let result = {}; | ||
| states.forEach((state) => { | ||
| result = Object.assign(Object.assign(Object.assign({}, result), state), { observerOptions: Object.assign(Object.assign({}, result.observerOptions), state === null || state === void 0 ? void 0 : state.observerOptions) }); | ||
| }); | ||
| return result; | ||
| }; | ||
| const initState = (options, previousState) => { | ||
| const initialOptions = Object.assign(Object.assign(Object.assign({}, defaultValues), previousState === null || previousState === void 0 ? void 0 : previousState.initialOptions), options); | ||
| const initialOptions = combineOptions(defaultValues, previousState === null || previousState === void 0 ? void 0 : previousState.initialOptions, options); | ||
| // remove extra '/' from url end | ||
| const apiUrl = initialOptions.apiUrl; | ||
| initialOptions.apiUrl = apiUrl ? apiUrl.replace(/\/+$/, '') : apiUrl; | ||
| initialOptions.apiUrl = sanitizeUrl(initialOptions.apiUrl); | ||
| return { | ||
@@ -794,3 +823,2 @@ initialOptions, | ||
| let state = initState(); | ||
| let observerOptions = initObserverOptions(); | ||
| let devCredentials = undefined; | ||
@@ -863,2 +891,3 @@ function init(options) { | ||
| ...(state.initialOptions.ns || [state.initialOptions.defaultNs]), | ||
| ...getFallbackArray(state.initialOptions.fallbackNs), | ||
| ...state.activeNamespaces.keys(), | ||
@@ -877,8 +906,8 @@ ]); | ||
| } | ||
| function getFallbackNamespaces() { | ||
| const defaultNs = state.initialOptions.defaultNs; | ||
| const fallbackNs = state.initialOptions.fallbackNs; | ||
| const fallbackNamespaces = typeof defaultNs === 'string' ? [defaultNs] : []; | ||
| return unique([...fallbackNamespaces, ...getFallbackArray(fallbackNs)]); | ||
| function getFallbackNs() { | ||
| return getFallbackArray(state.initialOptions.fallbackNs); | ||
| } | ||
| function getDefaultNs(ns) { | ||
| return ns === undefined ? state.initialOptions.defaultNs : ns; | ||
| } | ||
| function getAvailableLanguages() { | ||
@@ -902,10 +931,9 @@ if (state.initialOptions.availableLanguages) { | ||
| function overrideCredentials(credentials) { | ||
| devCredentials = credentials; | ||
| if (credentials) { | ||
| devCredentials = Object.assign(Object.assign({}, credentials), { apiUrl: sanitizeUrl(credentials.apiUrl) }); | ||
| } | ||
| else { | ||
| devCredentials = undefined; | ||
| } | ||
| } | ||
| function setObserverOptions(options) { | ||
| observerOptions = initObserverOptions(options); | ||
| } | ||
| function getObserverOptions() { | ||
| return observerOptions; | ||
| } | ||
| return Object.freeze({ | ||
@@ -926,8 +954,7 @@ init, | ||
| getFallbackLangs, | ||
| getFallbackNamespaces, | ||
| getFallbackNs, | ||
| getDefaultNs, | ||
| getAvailableLanguages, | ||
| withDefaultNs, | ||
| overrideCredentials, | ||
| setObserverOptions, | ||
| getObserverOptions, | ||
| }); | ||
@@ -969,5 +996,4 @@ }; | ||
| orEmpty: orEmpty, | ||
| params: Object.assign(Object.assign({}, rest), params), | ||
| }; | ||
| return options; | ||
| return Object.assign(Object.assign({}, options), { params: Object.assign({}, rest) }); | ||
| } | ||
@@ -997,7 +1023,7 @@ const getTranslateParams = (keyOrProps, ...params) => { | ||
| const Controller = ({ options }) => { | ||
| const events = Events(getFallbackNamespaces); | ||
| const events = Events(getFallbackNs, getDefaultNs); | ||
| const fetchingObserver = ValueObserver(false, () => cache.isFetching(), events.onFetchingChange.emit); | ||
| const loadingObserver = ValueObserver(false, () => isLoading(), events.onLoadingChange.emit); | ||
| const state = State(events.onLanguageChange, events.onPendingLanguageChange, events.onRunningChange); | ||
| const pluginService = PluginService(state.getLanguage, state.getInitialOptions, state.getObserverOptions, state.getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation); | ||
| const pluginService = PluginService(state.getLanguage, state.getInitialOptions, state.getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation); | ||
| const cache = Cache(events.onCacheChange, pluginService.getBackendRecord, pluginService.getBackendDevRecord, state.withDefaultNs, state.isInitialLoading, fetchingObserver, loadingObserver); | ||
@@ -1012,2 +1038,21 @@ if (options) { | ||
| }); | ||
| function getFallbackNs() { | ||
| return state.getFallbackNs(); | ||
| } | ||
| function getDefaultNs(ns) { | ||
| return state.getDefaultNs(ns); | ||
| } | ||
| // gets all namespaces where translation could be located | ||
| // takes (ns|default, fallback ns) | ||
| function getDefaultAndFallbackNs(ns) { | ||
| return [...getFallbackArray(getDefaultNs(ns)), ...getFallbackNs()]; | ||
| } | ||
| // gets all namespaces which need to be loaded | ||
| // takes (ns|default, initial ns, fallback ns, active ns) | ||
| function getRequiredNamespaces(ns) { | ||
| return [ | ||
| ...getFallbackArray(ns || getDefaultNs()), | ||
| ...state.getRequiredNamespaces(), | ||
| ]; | ||
| } | ||
| function changeTranslation(descriptor, key, value) { | ||
@@ -1023,5 +1068,2 @@ const keyObject = state.withDefaultNs(descriptor); | ||
| } | ||
| function getFallbackNamespaces() { | ||
| return state.getFallbackNamespaces(); | ||
| } | ||
| function init(options) { | ||
@@ -1035,5 +1077,3 @@ state.init(options); | ||
| function isDev() { | ||
| return Boolean(state.getInitialOptions().apiKey && | ||
| state.getInitialOptions().apiUrl && | ||
| pluginService.getDevBackend()); | ||
| return Boolean(state.getInitialOptions().apiKey && state.getInitialOptions().apiUrl); | ||
| } | ||
@@ -1050,3 +1090,3 @@ async function addActiveNs(ns, forget) { | ||
| const languages = state.getFallbackLangs(lang); | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getRequiredNamespaces(); | ||
| const namespaces = getRequiredNamespaces(ns); | ||
| const result = []; | ||
@@ -1068,3 +1108,3 @@ languages.forEach((language) => { | ||
| const languages = state.getFallbackLangs(language); | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getRequiredNamespaces(); | ||
| const namespaces = getRequiredNamespaces(ns); | ||
| const result = []; | ||
@@ -1102,9 +1142,9 @@ languages.forEach((language) => { | ||
| } | ||
| function getTranslationNs({ key, ns, }) { | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getFallbackNamespaces(); | ||
| function getTranslationNs({ key, ns }) { | ||
| const languages = state.getFallbackLangs(); | ||
| const namespaces = getDefaultAndFallbackNs(ns); | ||
| return cache.getTranslationNs(namespaces, languages, key); | ||
| } | ||
| function getTranslation({ key, ns, }) { | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getFallbackNamespaces(); | ||
| function getTranslation({ key, ns }) { | ||
| const namespaces = getDefaultAndFallbackNs(ns); | ||
| const languages = state.getFallbackLangs(); | ||
@@ -1201,3 +1241,2 @@ return cache.getTranslationFallback(namespaces, languages, key); | ||
| addActiveNs, | ||
| loadRequiredRecords, | ||
| loadRecords, | ||
@@ -1213,19 +1252,7 @@ loadRecord, | ||
| const Tolgee = (options) => { | ||
| const TolgeeInstanceCreator = (options) => { | ||
| const controller = Controller({ | ||
| options, | ||
| }); | ||
| const pluginTools = Object.freeze({ | ||
| setFinalFormatter: controller.setFinalFormatter, | ||
| addFormatter: controller.addFormatter, | ||
| setObserver: controller.setObserver, | ||
| hasObserver: controller.hasObserver, | ||
| setUi: controller.setUi, | ||
| hasUi: controller.hasUi, | ||
| setDevBackend: controller.setDevBackend, | ||
| addBackend: controller.addBackend, | ||
| setLanguageDetector: controller.setLanguageDetector, | ||
| setLanguageStorage: controller.setLanguageStorage, | ||
| overrideCredentials: controller.overrideCredentials, | ||
| }); | ||
| // restarts tolgee while applying callback | ||
| const withRestart = (callback) => { | ||
@@ -1238,57 +1265,337 @@ const wasRunning = controller.isRunning(); | ||
| const tolgee = Object.freeze({ | ||
| // event listeners | ||
| /** | ||
| * Listen to tolgee events. | ||
| */ | ||
| on: controller.on, | ||
| /** | ||
| * Listen for specific keys/namespaces changes. | ||
| */ | ||
| onKeyUpdate: controller.onKeyUpdate.listenSome, | ||
| // state | ||
| /** | ||
| * @return current language if set. | ||
| */ | ||
| getLanguage: controller.getLanguage, | ||
| /** | ||
| * `pendingLanguage` represents language which is currently being loaded. | ||
| * @return current `pendingLanguage` if set. | ||
| */ | ||
| getPendingLanguage: controller.getPendingLanguage, | ||
| /** | ||
| * Change current language. | ||
| * - if not running sets `pendingLanguage`, `language` to the new value | ||
| * - if running sets `pendingLanguage` to the value, fetches necessary data and then changes `language` | ||
| * | ||
| * @return Promise which is resolved when `language` is changed. | ||
| */ | ||
| changeLanguage: controller.changeLanguage, | ||
| /** | ||
| * Temporarily change translation in cache. | ||
| * @return object with revert method. | ||
| */ | ||
| changeTranslation: controller.changeTranslation, | ||
| /** | ||
| * Adds namespace(s) list of active namespaces. And if tolgee is running, loads required data. | ||
| */ | ||
| addActiveNs: controller.addActiveNs, | ||
| /** | ||
| * Remove namespace(s) from active namespaces. | ||
| * | ||
| * Tolgee internally counts how many times was each active namespace added, | ||
| * so this method will remove namespace only if the counter goes down to 0. | ||
| */ | ||
| removeActiveNs: controller.removeActiveNs, | ||
| /** | ||
| * Manually load multiple records from `Backend` (or `DevBackend` when in dev mode) | ||
| * | ||
| * It loads data together and adds them to cache in one operation, to prevent partly loaded state. | ||
| */ | ||
| loadRecords: controller.loadRecords, | ||
| /** | ||
| * Manually load record from `Backend` (or `DevBackend` when in dev mode) | ||
| */ | ||
| loadRecord: controller.loadRecord, | ||
| /** | ||
| * | ||
| */ | ||
| addStaticData: controller.addStaticData, | ||
| /** | ||
| * Get record from cache. | ||
| */ | ||
| getRecord: controller.getRecord, | ||
| /** | ||
| * Get all records from cache. | ||
| */ | ||
| getAllRecords: controller.getAllRecords, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if there are data that need to be fetched. | ||
| */ | ||
| isLoaded: controller.isLoaded, | ||
| /** | ||
| * @return `true` if tolgee is loading initial data (triggered by `run`). | ||
| */ | ||
| isInitialLoading: controller.isInitialLoading, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if tolgee is loading some translations for the first time. | ||
| */ | ||
| isLoading: controller.isLoading, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if tolgee is fetching some translations. | ||
| */ | ||
| isFetching: controller.isFetching, | ||
| /** | ||
| * @return `true` if tolgee is running. | ||
| */ | ||
| isRunning: controller.isRunning, | ||
| /** | ||
| * Changes internal state to running: true and loads initial files. | ||
| * Runs runnable plugins mainly Observer if present. | ||
| */ | ||
| run: controller.run, | ||
| /** | ||
| * Changes internal state to running: false and stops runnable plugins. | ||
| */ | ||
| stop: controller.stop, | ||
| /** | ||
| * Returns translated and formatted key. | ||
| * If Observer is present and tolgee is running, wraps result to be identifiable in the DOM. | ||
| */ | ||
| t: controller.t, | ||
| /** | ||
| * Highlight keys that match selection. | ||
| */ | ||
| highlight: controller.highlight, | ||
| /** | ||
| * @return current Tolgee options. | ||
| */ | ||
| getInitialOptions: controller.getInitialOptions, | ||
| /** | ||
| * Tolgee is in dev mode if `DevTools` plugin is used and `apiKey` + `apiUrl` are specified. | ||
| * @return `true` if tolgee is in dev mode. | ||
| */ | ||
| isDev: controller.isDev, | ||
| /** | ||
| * Wraps translation if there is `Observer` plugin | ||
| */ | ||
| wrap: controller.wrap, | ||
| /** | ||
| * Unwrap translation | ||
| */ | ||
| unwrap: controller.unwrap, | ||
| // plugins | ||
| setObserverOptions: (options) => { | ||
| controller.setObserverOptions(options); | ||
| return tolgee; | ||
| /** | ||
| * Override creadentials passed on initialization | ||
| */ | ||
| overrideCredentials(credentials) { | ||
| withRestart(() => controller.overrideCredentials(credentials)); | ||
| }, | ||
| use: (plugin) => { | ||
| /** | ||
| * Add tolgee plugin. | ||
| */ | ||
| addPlugin(plugin) { | ||
| if (plugin) { | ||
| withRestart(() => plugin(tolgee, pluginTools)); | ||
| withRestart(() => controller.addPlugin(tolgee, plugin)); | ||
| } | ||
| return tolgee; | ||
| }, | ||
| init: (options) => { | ||
| withRestart(() => controller.init(options)); | ||
| /** | ||
| * Updates options after instance creation. Extends existing options, | ||
| * so it only changes the fields, that are listed. | ||
| * | ||
| * When called in running state, tolgee stops and runs again. | ||
| */ | ||
| updateOptions(options) { | ||
| if (options) { | ||
| withRestart(() => controller.init(options)); | ||
| } | ||
| }, | ||
| }); | ||
| return tolgee; | ||
| }; | ||
| /** | ||
| * Tolgee chainable constructor. | ||
| * | ||
| * Usage: | ||
| * ``` | ||
| * const tolgee = Tolgee().use(...).init(...) | ||
| * ``` | ||
| */ | ||
| const Tolgee = () => { | ||
| const state = { | ||
| plugins: [], | ||
| options: {}, | ||
| }; | ||
| const tolgeeChain = Object.freeze({ | ||
| use(plugin) { | ||
| state.plugins.push(plugin); | ||
| return tolgeeChain; | ||
| }, | ||
| updateDefaults(options) { | ||
| state.options = combineOptions(state.options, options); | ||
| return tolgeeChain; | ||
| }, | ||
| init(options) { | ||
| const tolgee = TolgeeInstanceCreator(combineOptions(state.options, options)); | ||
| state.plugins.forEach(tolgee.addPlugin); | ||
| return tolgee; | ||
| }, | ||
| }); | ||
| return tolgeeChain; | ||
| }; | ||
| const ERROR_PARAM_EMPTY = 0, ERROR_UNEXPECTED_CHAR = 1, ERROR_UNEXPECTED_END = 2; | ||
| class FormatError extends Error { | ||
| constructor(code, index, text) { | ||
| let error; | ||
| if (code === ERROR_PARAM_EMPTY) { | ||
| error = 'Empty parameter'; | ||
| } | ||
| else if (code === ERROR_UNEXPECTED_CHAR) { | ||
| error = 'Unexpected character'; | ||
| } | ||
| else { | ||
| error = 'Unexpected end'; | ||
| } | ||
| super(`Tolgee parser: ${error} at ${index} in "${text}"`); | ||
| this.code = code; | ||
| this.index = index; | ||
| } | ||
| } | ||
| function isWhitespace(ch) { | ||
| return /\s/.test(ch); | ||
| } | ||
| const STATE_TEXT = 0, STATE_ESCAPE_MAYBE = 1, STATE_ESCAPE = 2, STATE_PARAM = 3, STATE_PARAM_AFTER = 4; | ||
| const END_STATES = new Set([ | ||
| STATE_ESCAPE, | ||
| STATE_ESCAPE_MAYBE, | ||
| STATE_TEXT, | ||
| ]); | ||
| const CHAR_ESCAPE = "'"; | ||
| const ESCAPABLE = new Set(['{', '}', CHAR_ESCAPE]); | ||
| const isAllowedInParam = (char) => { | ||
| return /[0-9a-zA-Z_]/.test(char); | ||
| }; | ||
| function formatParser(translation) { | ||
| let state = STATE_TEXT; | ||
| let text = ''; | ||
| let param = ''; | ||
| let ch = ''; | ||
| const texts = []; | ||
| const params = []; | ||
| let i = 0; | ||
| function parsingError(code) { | ||
| throw new FormatError(code, i, translation); | ||
| } | ||
| const addText = () => { | ||
| texts.push(text); | ||
| text = ''; | ||
| }; | ||
| const addParamChar = () => { | ||
| if (!isAllowedInParam(ch)) { | ||
| parsingError(ERROR_UNEXPECTED_CHAR); | ||
| } | ||
| param += ch; | ||
| }; | ||
| const addParam = () => { | ||
| if (param === '') { | ||
| parsingError(ERROR_PARAM_EMPTY); | ||
| } | ||
| params.push(param); | ||
| param = ''; | ||
| }; | ||
| for (i = 0; i < translation.length; i++) { | ||
| ch = translation[i]; | ||
| switch (state) { | ||
| case STATE_TEXT: | ||
| if (ch === CHAR_ESCAPE) { | ||
| text += ch; | ||
| state = STATE_ESCAPE_MAYBE; | ||
| } | ||
| else if (ch === '{') { | ||
| addText(); | ||
| state = STATE_PARAM; | ||
| } | ||
| else { | ||
| text += ch; | ||
| state = STATE_TEXT; | ||
| } | ||
| break; | ||
| case STATE_ESCAPE_MAYBE: | ||
| if (ESCAPABLE.has(ch)) { | ||
| text = text.slice(0, -1) + ch; | ||
| state = STATE_ESCAPE; | ||
| } | ||
| else { | ||
| text += ch; | ||
| state = STATE_TEXT; | ||
| } | ||
| break; | ||
| case STATE_ESCAPE: | ||
| if (ch === CHAR_ESCAPE) { | ||
| state = STATE_TEXT; | ||
| } | ||
| else { | ||
| text += ch; | ||
| state = STATE_ESCAPE; | ||
| } | ||
| break; | ||
| case STATE_PARAM: | ||
| if (ch === '}') { | ||
| addParam(); | ||
| state = STATE_TEXT; | ||
| } | ||
| else if (!isWhitespace(ch)) { | ||
| addParamChar(); | ||
| state = STATE_PARAM; | ||
| } | ||
| else if (param !== '') { | ||
| addParam(); | ||
| state = STATE_PARAM_AFTER; | ||
| } | ||
| break; | ||
| case STATE_PARAM_AFTER: | ||
| if (ch == '}') { | ||
| state = STATE_TEXT; | ||
| } | ||
| else if (isWhitespace(ch)) { | ||
| state = STATE_PARAM_AFTER; | ||
| } | ||
| else { | ||
| parsingError(ERROR_UNEXPECTED_CHAR); | ||
| } | ||
| } | ||
| } | ||
| if (!END_STATES.has(state)) { | ||
| parsingError(ERROR_UNEXPECTED_END); | ||
| } | ||
| addText(); | ||
| return [texts, params]; | ||
| } | ||
| function formatter(translation, params) { | ||
| const [texts, pars] = formatParser(translation); | ||
| const result = [texts[0]]; | ||
| for (let i = 1; i < texts.length; i++) { | ||
| const parameter = params === null || params === void 0 ? void 0 : params[pars[i - 1]]; | ||
| if (parameter === undefined) { | ||
| throw new Error(`Missing parameter "${pars[i - 1]}" in "${translation}"`); | ||
| } | ||
| result.push(String(parameter)); | ||
| result.push(texts[i]); | ||
| } | ||
| return result.join(''); | ||
| } | ||
| function FormatSimpleCreator() { | ||
| return { | ||
| format: ({ translation, params }) => formatter(translation, params), | ||
| }; | ||
| } | ||
| const FormatSimple = () => (tolgee, tools) => { | ||
| tools.setFinalFormatter(FormatSimpleCreator()); | ||
| return tolgee; | ||
| }; | ||
| const RESTRICTED_ASCENDANT_ATTRIBUTE = 'data-tolgee-restricted'; | ||
| const TOLGEE_ATTRIBUTE_NAME = '_tolgee'; | ||
| const TOLGEE_HIGHLIGHTER_CLASS = '_tolgee-highlighter'; | ||
| const TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE = 'data-tolgee-key-only'; | ||
| // needs to be same as in @tolgee/ui package | ||
| const DEVTOOLS_ID = '__tolgee_dev_tools'; | ||
| export { DEVTOOLS_ID, RESTRICTED_ASCENDANT_ATTRIBUTE, TOLGEE_ATTRIBUTE_NAME, TOLGEE_HIGHLIGHTER_CLASS, TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE, Tolgee, getFallback, getFallbackArray, getTranslateParams }; | ||
| export { FormatSimple, Tolgee, getFallback, getFallbackArray, getTranslateParams }; | ||
| //# sourceMappingURL=tolgee.esm.js.map |
@@ -52,18 +52,9 @@ (function (global, factory) { | ||
| } | ||
| function sanitizeUrl(url) { | ||
| return url ? url.replace(/\/+$/, '') : url; | ||
| } | ||
| function incrementInMap(map, value) { | ||
| const currNum = map.get(value) || 0; | ||
| map.set(value, currNum + 1); | ||
| } | ||
| function decrementInMap(map, value) { | ||
| let currNum = map.get(value) || 1; | ||
| currNum -= 1; | ||
| if (currNum <= 0) { | ||
| map.delete(value); | ||
| } | ||
| else { | ||
| map.set(value, currNum); | ||
| } | ||
| } | ||
| const EventEmitterSelective = (getFallbackNamespaces) => { | ||
| const DEFAULT_NS = 0; | ||
| const FALLBACK_NS = 1; | ||
| const EventEmitterSelective = (getFallbackNs, getDefaultNs) => { | ||
| const listeners = new Set(); | ||
@@ -85,4 +76,4 @@ const partialListeners = new Set(); | ||
| }, | ||
| keys: new Map(), | ||
| namespaces: new Map(), | ||
| keys: new Set(), | ||
| namespaces: new Set(), | ||
| }; | ||
@@ -95,27 +86,19 @@ partialListeners.add(handlerWrapper); | ||
| subscribeNs: (ns) => { | ||
| getFallbackArray(ns).forEach((val) => incrementInMap(handlerWrapper.namespaces, val)); | ||
| return result; | ||
| }, | ||
| unsubscribeNs: (ns) => { | ||
| getFallbackArray(ns).forEach((val) => decrementInMap(handlerWrapper.namespaces, val)); | ||
| return result; | ||
| }, | ||
| subscribeKey: (descriptor) => { | ||
| const { key, ns } = descriptor; | ||
| incrementInMap(handlerWrapper.keys, key); | ||
| getFallbackArray(ns).forEach((val) => incrementInMap(handlerWrapper.namespaces, val)); | ||
| getFallbackArray(ns).forEach((val) => handlerWrapper.namespaces.add(val)); | ||
| if (ns === undefined) { | ||
| // subscribing to all namespaces | ||
| incrementInMap(handlerWrapper.namespaces, undefined); | ||
| // subscribing to default ns | ||
| handlerWrapper.namespaces.add(DEFAULT_NS); | ||
| } | ||
| return result; | ||
| }, | ||
| unsubscribeKey: (descriptor) => { | ||
| subscribeKey: (descriptor) => { | ||
| const { key, ns } = descriptor; | ||
| decrementInMap(handlerWrapper.keys, key); | ||
| getFallbackArray(ns).forEach((val) => decrementInMap(handlerWrapper.namespaces, val)); | ||
| handlerWrapper.keys.add(key); | ||
| getFallbackArray(ns).forEach((val) => handlerWrapper.namespaces.add(val)); | ||
| if (ns === undefined) { | ||
| // subscribing to all namespaces | ||
| decrementInMap(handlerWrapper.namespaces, undefined); | ||
| // subscribing to default ns | ||
| handlerWrapper.namespaces.add(DEFAULT_NS); | ||
| } | ||
| // always subscribe to fallback namespaces | ||
| handlerWrapper.namespaces.add(FALLBACK_NS); | ||
| return result; | ||
@@ -127,6 +110,12 @@ }, | ||
| const namespacesWithFallbacks = (namespaces) => { | ||
| if (namespaces.has(undefined)) { | ||
| if (namespaces.has(FALLBACK_NS) || namespaces.has(DEFAULT_NS)) { | ||
| const result = new Set(namespaces.keys()); | ||
| result.delete(undefined); | ||
| getFallbackNamespaces().forEach((ns) => result.add(ns)); | ||
| if (namespaces.has(FALLBACK_NS)) { | ||
| result.delete(FALLBACK_NS); | ||
| getFallbackNs().forEach((ns) => result.add(ns)); | ||
| } | ||
| if (namespaces.has(DEFAULT_NS)) { | ||
| result.delete(DEFAULT_NS); | ||
| result.add(getDefaultNs()); | ||
| } | ||
| return result; | ||
@@ -156,10 +145,10 @@ } | ||
| }); | ||
| const namespaces = new Set(); | ||
| let namespaces = new Set(); | ||
| let keys = new Set(); | ||
| queue.forEach((descriptor) => { | ||
| if ((descriptor === null || descriptor === void 0 ? void 0 : descriptor.ns) === undefined) { | ||
| // when no ns specified, it affets all fallback namespaces | ||
| namespaces.add(undefined); | ||
| // when no ns specified, it affects all namespaces | ||
| namespaces = undefined; | ||
| } | ||
| else { | ||
| else if (namespaces !== undefined) { | ||
| descriptor.ns.forEach((ns) => namespaces.add(ns)); | ||
@@ -175,3 +164,5 @@ } | ||
| }); | ||
| const namespacesArray = Array.from(namespacesWithFallbacks(namespaces).keys()); | ||
| const namespacesArray = namespaces | ||
| ? Array.from(namespaces.keys()) | ||
| : undefined; | ||
| (keys || [undefined]).forEach((key) => { | ||
@@ -188,5 +179,3 @@ callHandlers(key, namespacesArray); | ||
| else { | ||
| Promise.resolve().then(() => { | ||
| solveQueue(); | ||
| }); | ||
| setTimeout(solveQueue, 0); | ||
| } | ||
@@ -197,3 +186,3 @@ }; | ||
| const Events = (getFallbackNamespaces) => { | ||
| const Events = (getFallbackNs, getDefaultNs) => { | ||
| const onPendingLanguageChange = EventEmitter(); | ||
@@ -205,3 +194,3 @@ const onLanguageChange = EventEmitter(); | ||
| const onInitialLoaded = EventEmitter(); | ||
| const onKeyUpdate = EventEmitterSelective(getFallbackNamespaces); | ||
| const onKeyUpdate = EventEmitterSelective(getFallbackNs, getDefaultNs); | ||
| const onCacheChange = EventEmitter(); | ||
@@ -266,3 +255,5 @@ const onRunningChange = EventEmitter(); | ||
| const decodeCacheKey = (key) => { | ||
| const [firstPart, secondPart] = key.split(':'); | ||
| const [firstPart, ...rest] = key.split(':'); | ||
| // if namespaces contains ":" it won't get lost | ||
| const secondPart = rest.join(':'); | ||
| return { language: firstPart, namespace: secondPart || '' }; | ||
@@ -335,7 +326,7 @@ }; | ||
| if (value !== undefined && value !== null) { | ||
| return namespace; | ||
| return [namespace]; | ||
| } | ||
| } | ||
| } | ||
| return Array.from(new Set(namespaces)); | ||
| return unique(namespaces); | ||
| } | ||
@@ -394,6 +385,2 @@ function getTranslationFallback(namespaces, languages, key) { | ||
| } | ||
| if (!dataPromise) { | ||
| // return empty data, so we know it has already been attempted to fetch | ||
| dataPromise = Promise.resolve({}); | ||
| } | ||
| return dataPromise; | ||
@@ -430,3 +417,3 @@ } | ||
| } | ||
| const dataPromise = fetchData(keyObject, isDev); | ||
| const dataPromise = fetchData(keyObject, isDev) || Promise.resolve(undefined); | ||
| asyncRequests.set(cacheKey, dataPromise); | ||
@@ -453,2 +440,6 @@ return { | ||
| } | ||
| else if (!getRecord(value.keyObject)) { | ||
| // if no data exist, put empty object | ||
| addRecord(value.keyObject, {}); | ||
| } | ||
| } | ||
@@ -496,3 +487,5 @@ }); | ||
| const PluginService = (getLanguage, getInitialOptions, getObserverOptions, getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation) => { | ||
| const PluginService = (getLanguage, getInitialOptions, getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation) => { | ||
| let prepared = false; | ||
| let onPrepareQueue = []; | ||
| const plugins = { | ||
@@ -514,32 +507,15 @@ ui: undefined, | ||
| var _a; | ||
| const withNs = keysAndDefaults.map(({ key, ns, defaultValue }) => ({ | ||
| key, | ||
| defaultValue, | ||
| ns: getFallbackArray(getTranslationNs({ key, ns, defaultValue })), | ||
| translation: getTranslation({ | ||
| const withNs = keysAndDefaults.map(({ key, ns, defaultValue }) => { | ||
| return { | ||
| key, | ||
| ns, | ||
| }), | ||
| })); | ||
| defaultValue, | ||
| ns: getTranslationNs({ key, ns }), | ||
| translation: getTranslation({ | ||
| key, | ||
| ns, | ||
| }), | ||
| }; | ||
| }); | ||
| (_a = instances.ui) === null || _a === void 0 ? void 0 : _a.handleElementClick(event, withNs); | ||
| }; | ||
| const run = (isDev) => { | ||
| var _a, _b; | ||
| if (!instances.ui && plugins.ui) { | ||
| instances.ui = new plugins.ui({ | ||
| apiKey: getInitialOptions().apiKey, | ||
| apiUrl: getInitialOptions().apiUrl, | ||
| highlight, | ||
| changeTranslation, | ||
| }); | ||
| } | ||
| if (!instances.observer) { | ||
| instances.observer = (_a = plugins.observer) === null || _a === void 0 ? void 0 : _a.call(plugins, { | ||
| translate, | ||
| onClick, | ||
| options: getObserverOptions(), | ||
| }); | ||
| } | ||
| (_b = instances.observer) === null || _b === void 0 ? void 0 : _b.run({ mouseHighlight: isDev }); | ||
| }; | ||
| const stop = () => { | ||
@@ -555,3 +531,6 @@ var _a; | ||
| const translate = (props) => { | ||
| const translation = getTranslation(props); | ||
| const translation = getTranslation({ | ||
| key: props.key, | ||
| ns: props.ns, | ||
| }); | ||
| return formatTranslation(Object.assign(Object.assign({}, props), { translation, formatEnabled: true })); | ||
@@ -582,5 +561,2 @@ }; | ||
| }; | ||
| const getLanguageStorage = () => { | ||
| return instances.languageStorage; | ||
| }; | ||
| const setStoredLanguage = (language) => { | ||
@@ -625,2 +601,23 @@ var _a; | ||
| }; | ||
| const run = (isDev) => { | ||
| var _a, _b; | ||
| if (!instances.ui && plugins.ui) { | ||
| const { apiKey, apiUrl, projectId } = getInitialOptions(); | ||
| instances.ui = new plugins.ui({ | ||
| apiKey: apiKey, | ||
| apiUrl: apiUrl, | ||
| projectId, | ||
| highlight, | ||
| changeTranslation, | ||
| }); | ||
| } | ||
| if (!instances.observer) { | ||
| instances.observer = (_a = plugins.observer) === null || _a === void 0 ? void 0 : _a.call(plugins, { | ||
| translate, | ||
| onClick, | ||
| options: getInitialOptions().observerOptions, | ||
| }); | ||
| } | ||
| (_b = instances.observer) === null || _b === void 0 ? void 0 : _b.run({ mouseHighlight: isDev }); | ||
| }; | ||
| const getDevBackend = () => { | ||
@@ -631,5 +628,7 @@ return instances.devBackend; | ||
| var _a; | ||
| const { apiKey, apiUrl, projectId } = getInitialOptions(); | ||
| return (_a = instances.devBackend) === null || _a === void 0 ? void 0 : _a.getRecord({ | ||
| apiKey: getInitialOptions().apiKey, | ||
| apiUrl: getInitialOptions().apiUrl, | ||
| apiKey, | ||
| apiUrl, | ||
| projectId, | ||
| language, | ||
@@ -655,4 +654,37 @@ namespace, | ||
| }; | ||
| const formatTranslation = ({ key, translation, defaultValue, noWrap, params, orEmpty, ns, formatEnabled, }) => { | ||
| const unwrap = (text) => { | ||
| var _a; | ||
| if (instances.observer) { | ||
| return (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.unwrap(text); | ||
| } | ||
| return { text, keys: [] }; | ||
| }; | ||
| const retranslate = () => { | ||
| var _a; | ||
| (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.retranslate(); | ||
| }; | ||
| const onPrepare = (callback) => { | ||
| onPrepareQueue.push(callback); | ||
| }; | ||
| function addPlugin(tolgeeInstance, plugin) { | ||
| const pluginTools = Object.freeze({ | ||
| setFinalFormatter, | ||
| addFormatter, | ||
| setObserver, | ||
| hasObserver, | ||
| setUi, | ||
| hasUi, | ||
| setDevBackend, | ||
| addBackend, | ||
| setLanguageDetector, | ||
| setLanguageStorage, | ||
| onPrepare, | ||
| }); | ||
| plugin(tolgeeInstance, pluginTools); | ||
| if (prepared) { | ||
| prepare(); | ||
| } | ||
| } | ||
| function formatTranslation({ key, translation, defaultValue, noWrap, params, orEmpty, ns, formatEnabled, }) { | ||
| var _a; | ||
| const formattableTranslation = translation || defaultValue; | ||
@@ -691,3 +723,6 @@ let result = formattableTranslation || (orEmpty ? '' : key); | ||
| return result; | ||
| }; | ||
| } | ||
| function hasDevBackend() { | ||
| return Boolean(getDevBackend()); | ||
| } | ||
| const wrap = (params) => { | ||
@@ -700,30 +735,18 @@ var _a; | ||
| }; | ||
| const unwrap = (text) => { | ||
| var _a; | ||
| if (instances.observer) { | ||
| return (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.unwrap(text); | ||
| function prepare() { | ||
| prepared = true; | ||
| while (onPrepareQueue.length) { | ||
| const queue = onPrepareQueue; | ||
| onPrepareQueue = []; | ||
| queue.forEach((callback) => callback()); | ||
| } | ||
| return { text, keys: [] }; | ||
| }; | ||
| const retranslate = () => { | ||
| var _a; | ||
| (_a = instances.observer) === null || _a === void 0 ? void 0 : _a.retranslate(); | ||
| }; | ||
| } | ||
| return Object.freeze({ | ||
| setFinalFormatter, | ||
| addFormatter, | ||
| prepare, | ||
| addPlugin, | ||
| formatTranslation, | ||
| setObserver, | ||
| hasObserver, | ||
| setUi, | ||
| hasUi, | ||
| addBackend, | ||
| setDevBackend, | ||
| getDevBackend, | ||
| getBackendRecord, | ||
| getBackendDevRecord, | ||
| setLanguageDetector, | ||
| getLanguageDetector, | ||
| setLanguageStorage, | ||
| getLanguageStorage, | ||
| getInitialLanguage, | ||
@@ -735,4 +758,5 @@ setStoredLanguage, | ||
| highlight, | ||
| unwrap, | ||
| wrap, | ||
| unwrap, | ||
| hasDevBackend, | ||
| }); | ||
@@ -759,3 +783,3 @@ }; | ||
| const defaultValues$1 = { | ||
| const defaultObserverOptions = { | ||
| tagAttributes: { | ||
@@ -775,14 +799,19 @@ textarea: ['placeholder'], | ||
| }; | ||
| const initObserverOptions = (options) => { | ||
| return Object.assign(Object.assign({}, defaultValues$1), options); | ||
| }; | ||
| const defaultValues = { | ||
| defaultNs: '', | ||
| observerOptions: defaultObserverOptions, | ||
| observerType: 'invisible', | ||
| }; | ||
| const combineOptions = (...states) => { | ||
| let result = {}; | ||
| states.forEach((state) => { | ||
| result = Object.assign(Object.assign(Object.assign({}, result), state), { observerOptions: Object.assign(Object.assign({}, result.observerOptions), state === null || state === void 0 ? void 0 : state.observerOptions) }); | ||
| }); | ||
| return result; | ||
| }; | ||
| const initState = (options, previousState) => { | ||
| const initialOptions = Object.assign(Object.assign(Object.assign({}, defaultValues), previousState === null || previousState === void 0 ? void 0 : previousState.initialOptions), options); | ||
| const initialOptions = combineOptions(defaultValues, previousState === null || previousState === void 0 ? void 0 : previousState.initialOptions, options); | ||
| // remove extra '/' from url end | ||
| const apiUrl = initialOptions.apiUrl; | ||
| initialOptions.apiUrl = apiUrl ? apiUrl.replace(/\/+$/, '') : apiUrl; | ||
| initialOptions.apiUrl = sanitizeUrl(initialOptions.apiUrl); | ||
| return { | ||
@@ -800,3 +829,2 @@ initialOptions, | ||
| let state = initState(); | ||
| let observerOptions = initObserverOptions(); | ||
| let devCredentials = undefined; | ||
@@ -869,2 +897,3 @@ function init(options) { | ||
| ...(state.initialOptions.ns || [state.initialOptions.defaultNs]), | ||
| ...getFallbackArray(state.initialOptions.fallbackNs), | ||
| ...state.activeNamespaces.keys(), | ||
@@ -883,8 +912,8 @@ ]); | ||
| } | ||
| function getFallbackNamespaces() { | ||
| const defaultNs = state.initialOptions.defaultNs; | ||
| const fallbackNs = state.initialOptions.fallbackNs; | ||
| const fallbackNamespaces = typeof defaultNs === 'string' ? [defaultNs] : []; | ||
| return unique([...fallbackNamespaces, ...getFallbackArray(fallbackNs)]); | ||
| function getFallbackNs() { | ||
| return getFallbackArray(state.initialOptions.fallbackNs); | ||
| } | ||
| function getDefaultNs(ns) { | ||
| return ns === undefined ? state.initialOptions.defaultNs : ns; | ||
| } | ||
| function getAvailableLanguages() { | ||
@@ -908,10 +937,9 @@ if (state.initialOptions.availableLanguages) { | ||
| function overrideCredentials(credentials) { | ||
| devCredentials = credentials; | ||
| if (credentials) { | ||
| devCredentials = Object.assign(Object.assign({}, credentials), { apiUrl: sanitizeUrl(credentials.apiUrl) }); | ||
| } | ||
| else { | ||
| devCredentials = undefined; | ||
| } | ||
| } | ||
| function setObserverOptions(options) { | ||
| observerOptions = initObserverOptions(options); | ||
| } | ||
| function getObserverOptions() { | ||
| return observerOptions; | ||
| } | ||
| return Object.freeze({ | ||
@@ -932,8 +960,7 @@ init, | ||
| getFallbackLangs, | ||
| getFallbackNamespaces, | ||
| getFallbackNs, | ||
| getDefaultNs, | ||
| getAvailableLanguages, | ||
| withDefaultNs, | ||
| overrideCredentials, | ||
| setObserverOptions, | ||
| getObserverOptions, | ||
| }); | ||
@@ -975,5 +1002,4 @@ }; | ||
| orEmpty: orEmpty, | ||
| params: Object.assign(Object.assign({}, rest), params), | ||
| }; | ||
| return options; | ||
| return Object.assign(Object.assign({}, options), { params: Object.assign({}, rest) }); | ||
| } | ||
@@ -1003,7 +1029,7 @@ const getTranslateParams = (keyOrProps, ...params) => { | ||
| const Controller = ({ options }) => { | ||
| const events = Events(getFallbackNamespaces); | ||
| const events = Events(getFallbackNs, getDefaultNs); | ||
| const fetchingObserver = ValueObserver(false, () => cache.isFetching(), events.onFetchingChange.emit); | ||
| const loadingObserver = ValueObserver(false, () => isLoading(), events.onLoadingChange.emit); | ||
| const state = State(events.onLanguageChange, events.onPendingLanguageChange, events.onRunningChange); | ||
| const pluginService = PluginService(state.getLanguage, state.getInitialOptions, state.getObserverOptions, state.getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation); | ||
| const pluginService = PluginService(state.getLanguage, state.getInitialOptions, state.getAvailableLanguages, getTranslationNs, getTranslation, changeTranslation); | ||
| const cache = Cache(events.onCacheChange, pluginService.getBackendRecord, pluginService.getBackendDevRecord, state.withDefaultNs, state.isInitialLoading, fetchingObserver, loadingObserver); | ||
@@ -1018,2 +1044,21 @@ if (options) { | ||
| }); | ||
| function getFallbackNs() { | ||
| return state.getFallbackNs(); | ||
| } | ||
| function getDefaultNs(ns) { | ||
| return state.getDefaultNs(ns); | ||
| } | ||
| // gets all namespaces where translation could be located | ||
| // takes (ns|default, fallback ns) | ||
| function getDefaultAndFallbackNs(ns) { | ||
| return [...getFallbackArray(getDefaultNs(ns)), ...getFallbackNs()]; | ||
| } | ||
| // gets all namespaces which need to be loaded | ||
| // takes (ns|default, initial ns, fallback ns, active ns) | ||
| function getRequiredNamespaces(ns) { | ||
| return [ | ||
| ...getFallbackArray(ns || getDefaultNs()), | ||
| ...state.getRequiredNamespaces(), | ||
| ]; | ||
| } | ||
| function changeTranslation(descriptor, key, value) { | ||
@@ -1029,5 +1074,2 @@ const keyObject = state.withDefaultNs(descriptor); | ||
| } | ||
| function getFallbackNamespaces() { | ||
| return state.getFallbackNamespaces(); | ||
| } | ||
| function init(options) { | ||
@@ -1041,5 +1083,3 @@ state.init(options); | ||
| function isDev() { | ||
| return Boolean(state.getInitialOptions().apiKey && | ||
| state.getInitialOptions().apiUrl && | ||
| pluginService.getDevBackend()); | ||
| return Boolean(state.getInitialOptions().apiKey && state.getInitialOptions().apiUrl); | ||
| } | ||
@@ -1056,3 +1096,3 @@ async function addActiveNs(ns, forget) { | ||
| const languages = state.getFallbackLangs(lang); | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getRequiredNamespaces(); | ||
| const namespaces = getRequiredNamespaces(ns); | ||
| const result = []; | ||
@@ -1074,3 +1114,3 @@ languages.forEach((language) => { | ||
| const languages = state.getFallbackLangs(language); | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getRequiredNamespaces(); | ||
| const namespaces = getRequiredNamespaces(ns); | ||
| const result = []; | ||
@@ -1108,9 +1148,9 @@ languages.forEach((language) => { | ||
| } | ||
| function getTranslationNs({ key, ns, }) { | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getFallbackNamespaces(); | ||
| function getTranslationNs({ key, ns }) { | ||
| const languages = state.getFallbackLangs(); | ||
| const namespaces = getDefaultAndFallbackNs(ns); | ||
| return cache.getTranslationNs(namespaces, languages, key); | ||
| } | ||
| function getTranslation({ key, ns, }) { | ||
| const namespaces = ns !== undefined ? getFallbackArray(ns) : state.getFallbackNamespaces(); | ||
| function getTranslation({ key, ns }) { | ||
| const namespaces = getDefaultAndFallbackNs(ns); | ||
| const languages = state.getFallbackLangs(); | ||
@@ -1207,3 +1247,2 @@ return cache.getTranslationFallback(namespaces, languages, key); | ||
| addActiveNs, | ||
| loadRequiredRecords, | ||
| loadRecords, | ||
@@ -1219,19 +1258,7 @@ loadRecord, | ||
| const Tolgee = (options) => { | ||
| const TolgeeInstanceCreator = (options) => { | ||
| const controller = Controller({ | ||
| options, | ||
| }); | ||
| const pluginTools = Object.freeze({ | ||
| setFinalFormatter: controller.setFinalFormatter, | ||
| addFormatter: controller.addFormatter, | ||
| setObserver: controller.setObserver, | ||
| hasObserver: controller.hasObserver, | ||
| setUi: controller.setUi, | ||
| hasUi: controller.hasUi, | ||
| setDevBackend: controller.setDevBackend, | ||
| addBackend: controller.addBackend, | ||
| setLanguageDetector: controller.setLanguageDetector, | ||
| setLanguageStorage: controller.setLanguageStorage, | ||
| overrideCredentials: controller.overrideCredentials, | ||
| }); | ||
| // restarts tolgee while applying callback | ||
| const withRestart = (callback) => { | ||
@@ -1244,61 +1271,337 @@ const wasRunning = controller.isRunning(); | ||
| const tolgee = Object.freeze({ | ||
| // event listeners | ||
| /** | ||
| * Listen to tolgee events. | ||
| */ | ||
| on: controller.on, | ||
| /** | ||
| * Listen for specific keys/namespaces changes. | ||
| */ | ||
| onKeyUpdate: controller.onKeyUpdate.listenSome, | ||
| // state | ||
| /** | ||
| * @return current language if set. | ||
| */ | ||
| getLanguage: controller.getLanguage, | ||
| /** | ||
| * `pendingLanguage` represents language which is currently being loaded. | ||
| * @return current `pendingLanguage` if set. | ||
| */ | ||
| getPendingLanguage: controller.getPendingLanguage, | ||
| /** | ||
| * Change current language. | ||
| * - if not running sets `pendingLanguage`, `language` to the new value | ||
| * - if running sets `pendingLanguage` to the value, fetches necessary data and then changes `language` | ||
| * | ||
| * @return Promise which is resolved when `language` is changed. | ||
| */ | ||
| changeLanguage: controller.changeLanguage, | ||
| /** | ||
| * Temporarily change translation in cache. | ||
| * @return object with revert method. | ||
| */ | ||
| changeTranslation: controller.changeTranslation, | ||
| /** | ||
| * Adds namespace(s) list of active namespaces. And if tolgee is running, loads required data. | ||
| */ | ||
| addActiveNs: controller.addActiveNs, | ||
| /** | ||
| * Remove namespace(s) from active namespaces. | ||
| * | ||
| * Tolgee internally counts how many times was each active namespace added, | ||
| * so this method will remove namespace only if the counter goes down to 0. | ||
| */ | ||
| removeActiveNs: controller.removeActiveNs, | ||
| /** | ||
| * Manually load multiple records from `Backend` (or `DevBackend` when in dev mode) | ||
| * | ||
| * It loads data together and adds them to cache in one operation, to prevent partly loaded state. | ||
| */ | ||
| loadRecords: controller.loadRecords, | ||
| /** | ||
| * Manually load record from `Backend` (or `DevBackend` when in dev mode) | ||
| */ | ||
| loadRecord: controller.loadRecord, | ||
| /** | ||
| * | ||
| */ | ||
| addStaticData: controller.addStaticData, | ||
| /** | ||
| * Get record from cache. | ||
| */ | ||
| getRecord: controller.getRecord, | ||
| /** | ||
| * Get all records from cache. | ||
| */ | ||
| getAllRecords: controller.getAllRecords, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if there are data that need to be fetched. | ||
| */ | ||
| isLoaded: controller.isLoaded, | ||
| /** | ||
| * @return `true` if tolgee is loading initial data (triggered by `run`). | ||
| */ | ||
| isInitialLoading: controller.isInitialLoading, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if tolgee is loading some translations for the first time. | ||
| */ | ||
| isLoading: controller.isLoading, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if tolgee is fetching some translations. | ||
| */ | ||
| isFetching: controller.isFetching, | ||
| /** | ||
| * @return `true` if tolgee is running. | ||
| */ | ||
| isRunning: controller.isRunning, | ||
| /** | ||
| * Changes internal state to running: true and loads initial files. | ||
| * Runs runnable plugins mainly Observer if present. | ||
| */ | ||
| run: controller.run, | ||
| /** | ||
| * Changes internal state to running: false and stops runnable plugins. | ||
| */ | ||
| stop: controller.stop, | ||
| /** | ||
| * Returns translated and formatted key. | ||
| * If Observer is present and tolgee is running, wraps result to be identifiable in the DOM. | ||
| */ | ||
| t: controller.t, | ||
| /** | ||
| * Highlight keys that match selection. | ||
| */ | ||
| highlight: controller.highlight, | ||
| /** | ||
| * @return current Tolgee options. | ||
| */ | ||
| getInitialOptions: controller.getInitialOptions, | ||
| /** | ||
| * Tolgee is in dev mode if `DevTools` plugin is used and `apiKey` + `apiUrl` are specified. | ||
| * @return `true` if tolgee is in dev mode. | ||
| */ | ||
| isDev: controller.isDev, | ||
| /** | ||
| * Wraps translation if there is `Observer` plugin | ||
| */ | ||
| wrap: controller.wrap, | ||
| /** | ||
| * Unwrap translation | ||
| */ | ||
| unwrap: controller.unwrap, | ||
| // plugins | ||
| setObserverOptions: (options) => { | ||
| controller.setObserverOptions(options); | ||
| return tolgee; | ||
| /** | ||
| * Override creadentials passed on initialization | ||
| */ | ||
| overrideCredentials(credentials) { | ||
| withRestart(() => controller.overrideCredentials(credentials)); | ||
| }, | ||
| use: (plugin) => { | ||
| /** | ||
| * Add tolgee plugin. | ||
| */ | ||
| addPlugin(plugin) { | ||
| if (plugin) { | ||
| withRestart(() => plugin(tolgee, pluginTools)); | ||
| withRestart(() => controller.addPlugin(tolgee, plugin)); | ||
| } | ||
| return tolgee; | ||
| }, | ||
| init: (options) => { | ||
| withRestart(() => controller.init(options)); | ||
| /** | ||
| * Updates options after instance creation. Extends existing options, | ||
| * so it only changes the fields, that are listed. | ||
| * | ||
| * When called in running state, tolgee stops and runs again. | ||
| */ | ||
| updateOptions(options) { | ||
| if (options) { | ||
| withRestart(() => controller.init(options)); | ||
| } | ||
| }, | ||
| }); | ||
| return tolgee; | ||
| }; | ||
| /** | ||
| * Tolgee chainable constructor. | ||
| * | ||
| * Usage: | ||
| * ``` | ||
| * const tolgee = Tolgee().use(...).init(...) | ||
| * ``` | ||
| */ | ||
| const Tolgee = () => { | ||
| const state = { | ||
| plugins: [], | ||
| options: {}, | ||
| }; | ||
| const tolgeeChain = Object.freeze({ | ||
| use(plugin) { | ||
| state.plugins.push(plugin); | ||
| return tolgeeChain; | ||
| }, | ||
| updateDefaults(options) { | ||
| state.options = combineOptions(state.options, options); | ||
| return tolgeeChain; | ||
| }, | ||
| init(options) { | ||
| const tolgee = TolgeeInstanceCreator(combineOptions(state.options, options)); | ||
| state.plugins.forEach(tolgee.addPlugin); | ||
| return tolgee; | ||
| }, | ||
| }); | ||
| return tolgeeChain; | ||
| }; | ||
| const ERROR_PARAM_EMPTY = 0, ERROR_UNEXPECTED_CHAR = 1, ERROR_UNEXPECTED_END = 2; | ||
| class FormatError extends Error { | ||
| constructor(code, index, text) { | ||
| let error; | ||
| if (code === ERROR_PARAM_EMPTY) { | ||
| error = 'Empty parameter'; | ||
| } | ||
| else if (code === ERROR_UNEXPECTED_CHAR) { | ||
| error = 'Unexpected character'; | ||
| } | ||
| else { | ||
| error = 'Unexpected end'; | ||
| } | ||
| super(`Tolgee parser: ${error} at ${index} in "${text}"`); | ||
| this.code = code; | ||
| this.index = index; | ||
| } | ||
| } | ||
| function isWhitespace(ch) { | ||
| return /\s/.test(ch); | ||
| } | ||
| const STATE_TEXT = 0, STATE_ESCAPE_MAYBE = 1, STATE_ESCAPE = 2, STATE_PARAM = 3, STATE_PARAM_AFTER = 4; | ||
| const END_STATES = new Set([ | ||
| STATE_ESCAPE, | ||
| STATE_ESCAPE_MAYBE, | ||
| STATE_TEXT, | ||
| ]); | ||
| const CHAR_ESCAPE = "'"; | ||
| const ESCAPABLE = new Set(['{', '}', CHAR_ESCAPE]); | ||
| const isAllowedInParam = (char) => { | ||
| return /[0-9a-zA-Z_]/.test(char); | ||
| }; | ||
| function formatParser(translation) { | ||
| let state = STATE_TEXT; | ||
| let text = ''; | ||
| let param = ''; | ||
| let ch = ''; | ||
| const texts = []; | ||
| const params = []; | ||
| let i = 0; | ||
| function parsingError(code) { | ||
| throw new FormatError(code, i, translation); | ||
| } | ||
| const addText = () => { | ||
| texts.push(text); | ||
| text = ''; | ||
| }; | ||
| const addParamChar = () => { | ||
| if (!isAllowedInParam(ch)) { | ||
| parsingError(ERROR_UNEXPECTED_CHAR); | ||
| } | ||
| param += ch; | ||
| }; | ||
| const addParam = () => { | ||
| if (param === '') { | ||
| parsingError(ERROR_PARAM_EMPTY); | ||
| } | ||
| params.push(param); | ||
| param = ''; | ||
| }; | ||
| for (i = 0; i < translation.length; i++) { | ||
| ch = translation[i]; | ||
| switch (state) { | ||
| case STATE_TEXT: | ||
| if (ch === CHAR_ESCAPE) { | ||
| text += ch; | ||
| state = STATE_ESCAPE_MAYBE; | ||
| } | ||
| else if (ch === '{') { | ||
| addText(); | ||
| state = STATE_PARAM; | ||
| } | ||
| else { | ||
| text += ch; | ||
| state = STATE_TEXT; | ||
| } | ||
| break; | ||
| case STATE_ESCAPE_MAYBE: | ||
| if (ESCAPABLE.has(ch)) { | ||
| text = text.slice(0, -1) + ch; | ||
| state = STATE_ESCAPE; | ||
| } | ||
| else { | ||
| text += ch; | ||
| state = STATE_TEXT; | ||
| } | ||
| break; | ||
| case STATE_ESCAPE: | ||
| if (ch === CHAR_ESCAPE) { | ||
| state = STATE_TEXT; | ||
| } | ||
| else { | ||
| text += ch; | ||
| state = STATE_ESCAPE; | ||
| } | ||
| break; | ||
| case STATE_PARAM: | ||
| if (ch === '}') { | ||
| addParam(); | ||
| state = STATE_TEXT; | ||
| } | ||
| else if (!isWhitespace(ch)) { | ||
| addParamChar(); | ||
| state = STATE_PARAM; | ||
| } | ||
| else if (param !== '') { | ||
| addParam(); | ||
| state = STATE_PARAM_AFTER; | ||
| } | ||
| break; | ||
| case STATE_PARAM_AFTER: | ||
| if (ch == '}') { | ||
| state = STATE_TEXT; | ||
| } | ||
| else if (isWhitespace(ch)) { | ||
| state = STATE_PARAM_AFTER; | ||
| } | ||
| else { | ||
| parsingError(ERROR_UNEXPECTED_CHAR); | ||
| } | ||
| } | ||
| } | ||
| if (!END_STATES.has(state)) { | ||
| parsingError(ERROR_UNEXPECTED_END); | ||
| } | ||
| addText(); | ||
| return [texts, params]; | ||
| } | ||
| function formatter(translation, params) { | ||
| const [texts, pars] = formatParser(translation); | ||
| const result = [texts[0]]; | ||
| for (let i = 1; i < texts.length; i++) { | ||
| const parameter = params === null || params === void 0 ? void 0 : params[pars[i - 1]]; | ||
| if (parameter === undefined) { | ||
| throw new Error(`Missing parameter "${pars[i - 1]}" in "${translation}"`); | ||
| } | ||
| result.push(String(parameter)); | ||
| result.push(texts[i]); | ||
| } | ||
| return result.join(''); | ||
| } | ||
| function FormatSimpleCreator() { | ||
| return { | ||
| format: ({ translation, params }) => formatter(translation, params), | ||
| }; | ||
| } | ||
| const FormatSimple = () => (tolgee, tools) => { | ||
| tools.setFinalFormatter(FormatSimpleCreator()); | ||
| return tolgee; | ||
| }; | ||
| const RESTRICTED_ASCENDANT_ATTRIBUTE = 'data-tolgee-restricted'; | ||
| const TOLGEE_ATTRIBUTE_NAME = '_tolgee'; | ||
| const TOLGEE_HIGHLIGHTER_CLASS = '_tolgee-highlighter'; | ||
| const TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE = 'data-tolgee-key-only'; | ||
| // needs to be same as in @tolgee/ui package | ||
| const DEVTOOLS_ID = '__tolgee_dev_tools'; | ||
| exports.DEVTOOLS_ID = DEVTOOLS_ID; | ||
| exports.RESTRICTED_ASCENDANT_ATTRIBUTE = RESTRICTED_ASCENDANT_ATTRIBUTE; | ||
| exports.TOLGEE_ATTRIBUTE_NAME = TOLGEE_ATTRIBUTE_NAME; | ||
| exports.TOLGEE_HIGHLIGHTER_CLASS = TOLGEE_HIGHLIGHTER_CLASS; | ||
| exports.TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE = TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE; | ||
| exports.FormatSimple = FormatSimple; | ||
| exports.Tolgee = Tolgee; | ||
@@ -1305,0 +1608,0 @@ exports.getFallback = getFallback; |
@@ -1,2 +0,2 @@ | ||
| !function(e,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports):"function"==typeof define&&define.amd?define(["exports"],n):n((e="undefined"!=typeof globalThis?globalThis:e||self)["@tolgee/core"]={})}(this,(function(e){"use strict";const n=()=>{let e=[];return Object.freeze({listen:n=>{const t=e=>{n(e)};return e.push(t),{unsubscribe:()=>{e=e.filter((e=>t!==e))}}},emit:n=>{e.forEach((e=>e({value:n})))}})};function t(e){return"string"==typeof e?[e]:Array.isArray(e)?e:void 0}function a(e){return t(e)||[]}function i(e,n){return"object"!=typeof(t=n)||Array.isArray(t)||null===t?a(n):a(null==n?void 0:n[e]);var t}function o(e){return Array.from(new Set(e))}function r(e,n){const t=e.get(n)||0;e.set(n,t+1)}function s(e,n){let t=e.get(n)||1;t-=1,t<=0?e.delete(n):e.set(n,t)}const g=e=>{const n=new Set,t=new Set,i=n=>{if(n.has(void 0)){const t=new Set(n.keys());return t.delete(void 0),e().forEach((e=>t.add(e))),t}return n};let o=[];const g=()=>{if(0===o.length)return;n.forEach((e=>{e({value:void 0})}));const e=new Set;let a=new Set;o.forEach((n=>{void 0===(null==n?void 0:n.ns)?e.add(void 0):n.ns.forEach((n=>e.add(n))),void 0===(null==n?void 0:n.key)?a=void 0:void 0!==a&&a.add(n.key)}));const r=Array.from(i(e).keys());(a||[void 0]).forEach((e=>{((e,n)=>{t.forEach((t=>{const a=i(t.namespaces),o=void 0===n||-1!==(null==n?void 0:n.findIndex((e=>a.has(e)))),r=void 0===e||t.keys.has(e)||0===t.keys.size;o&&r&&t.fn({value:void 0})}))})(e,r)})),o=[]};return Object.freeze({listenSome:e=>{const n={fn:n=>{e(n)},keys:new Map,namespaces:new Map};t.add(n);const i={unsubscribe:()=>{t.delete(n)},subscribeNs:e=>(a(e).forEach((e=>r(n.namespaces,e))),i),unsubscribeNs:e=>(a(e).forEach((e=>s(n.namespaces,e))),i),subscribeKey:e=>{const{key:t,ns:o}=e;return r(n.keys,t),a(o).forEach((e=>r(n.namespaces,e))),void 0===o&&r(n.namespaces,void 0),i},unsubscribeKey:e=>{const{key:t,ns:o}=e;return s(n.keys,t),a(o).forEach((e=>s(n.namespaces,e))),void 0===o&&s(n.namespaces,void 0),i}};return i},listen:e=>{n.add(e);return{unsubscribe:()=>{n.delete(e)}}},emit:(e,n)=>{o.push(e),n?Promise.resolve().then((()=>{g()})):g()}})},c=e=>{const n=new Map;return Object.entries(e).forEach((([e,t])=>{null!=t&&("object"!=typeof t?n.set(e,t):c(t).forEach(((t,a)=>{n.set(e+"."+a,t)})))})),n},u=e=>{const[n,t]=e.split(":");return{language:n,namespace:t||""}},l=({language:e,namespace:n})=>n?`${e}:${n}`:e,d=(e,n,t,i,o,r,s)=>{const g=new Map,d=new Map;let f={},p=0;function v(n,t,a){const i=l(n);d.set(i,{data:c(t),version:a}),e.emit(n)}function b(e,n){v(e,n,p)}function h(e,n=!1){const t=d.get(l(e));return t&&n?t.version===p:Boolean(t)}function m(e){var n;return null===(n=d.get(l(i(e))))||void 0===n?void 0:n.data}function y(e){let t;if(!t){const n=f[l(e)];"function"==typeof n&&(t=n())}return t||(t=n(e)),t||(t=Promise.resolve({})),t}return Object.freeze({addStaticData:function(e){e&&(f=Object.assign(Object.assign({},f),e),Object.entries(e).forEach((([e,n])=>{if("function"!=typeof n){const t=u(e),a=d.get(e);a&&0!==a.version||v(t,n,0)}})))},invalidate:function(){g.clear(),p+=1},addRecord:b,exists:h,getRecord:m,getTranslation:function(e,n){var t;return null===(t=d.get(l(e)))||void 0===t?void 0:t.data.get(n)},getTranslationNs:function(e,n,t){var a;for(const i of e)for(const e of n){const n=null===(a=d.get(l({language:e,namespace:i})))||void 0===a?void 0:a.data.get(t);if(null!=n)return i}return Array.from(new Set(e))},getTranslationFallback:function(e,n,t){var a;for(const i of e)for(const e of n){const n=null===(a=d.get(l({language:e,namespace:i})))||void 0===a?void 0:a.data.get(t);if(null!=n)return n}},changeTranslation:function(n,t,a){var i;const o=null===(i=d.get(l(n)))||void 0===i?void 0:i.data;null==o||o.set(t,a),e.emit(Object.assign(Object.assign({},n),{key:t}))},isFetching:function(e){if(o())return!0;if(void 0===e)return g.size>0;const n=a(e);return Boolean(Array.from(g.keys()).find((e=>n.includes(u(e).namespace))))},isLoading:function(e,n){const t=a(n);return Boolean(o()||Array.from(g.keys()).find((n=>{const a=u(n);return(!t.length||t.includes(a.namespace))&&!h({namespace:a.namespace,language:e})})))},loadRecords:async function(e,n){const a=e.map((e=>{const a=i(e),o=l(a),r=g.get(o);if(r)return{new:!1,promise:r,keyObject:a,cacheKey:o};const s=function(e,n){var a;let i;return n&&(i=null===(a=t(e))||void 0===a?void 0:a.catch((()=>(console.warn("Tolgee: Failed to fetch data from dev backend"),y(e))))),i||(i=y(e)),i}(a,n);return g.set(o,s),{new:!0,promise:s,keyObject:a,cacheKey:o}}));r.notify(),s.notify();const o=await Promise.all(a.map((e=>e.promise)));return a.forEach(((e,n)=>{const t=g.get(e.cacheKey)!==e.promise;if(e.new&&!t){g.delete(e.cacheKey);const t=o[n];t&&b(e.keyObject,t)}})),r.notify(),s.notify(),a.map((e=>m(e.keyObject)))},getAllRecords:function(){return Array.from(d.entries()).map((([e,n])=>Object.assign(Object.assign({},u(e)),{data:n.data})))}})};function f(e){return Boolean(e&&"function"==typeof e.then)}const p=(e,n)=>f(e)?Promise.resolve(e).then(n):n(e),v=e=>`Tolgee: You need to specify '${e}' option`,b=(e,n,t,i,o,r,s)=>{const g={ui:void 0,observer:void 0},c={formatters:[],finalFormatter:void 0,observer:void 0,devBackend:void 0,backends:[],ui:void 0,languageDetector:void 0,languageStorage:void 0},u=async(e,{keysAndDefaults:n})=>{var t;const i=n.map((({key:e,ns:n,defaultValue:t})=>({key:e,defaultValue:t,ns:a(o({key:e,ns:n,defaultValue:t})),translation:r({key:e,ns:n})})));null===(t=c.ui)||void 0===t||t.handleElementClick(e,i)},l=(e,n)=>{var t,a;return(null===(a=null===(t=c.observer)||void 0===t?void 0:t.highlight)||void 0===a?void 0:a.call(t,e,n))||{unhighlight(){}}},d=e=>{const n=r(e);return v(Object.assign(Object.assign({},e),{translation:n,formatEnabled:!0}))},v=({key:n,translation:t,defaultValue:a,noWrap:i,params:o,orEmpty:r,ns:s,formatEnabled:g})=>{var u;const l=t||a;let d=l||(r?"":n);c.observer&&!i&&(d=c.observer.wrap({key:n,translation:d,defaultValue:a,params:o,ns:s}));const f=e(),p=g||!(null===(u=c.observer)||void 0===u?void 0:u.outputNotFormattable);if(l&&f&&p)for(const e of c.formatters)d=e.format({translation:d,language:f,params:o});return c.finalFormatter&&l&&f&&p&&(d=c.finalFormatter.format({translation:d,language:f,params:o})),d};return Object.freeze({setFinalFormatter:e=>{c.finalFormatter=e},addFormatter:e=>{e&&c.formatters.push(e)},formatTranslation:v,setObserver:e=>{g.observer=e},hasObserver:()=>Boolean(g.observer),setUi:e=>{g.ui=(null==e?void 0:e.UI)||e},hasUi:()=>Boolean(g.ui),addBackend:e=>{e&&c.backends.push(e)},setDevBackend:e=>{c.devBackend=e},getDevBackend:()=>c.devBackend,getBackendRecord:({language:e,namespace:n})=>{for(const t of c.backends){const a=t.getRecord({language:e,namespace:n});if(f(a))return null==a?void 0:a.catch((e=>(console.error(e),{})));if(void 0!==a)return a}},getBackendDevRecord:({language:e,namespace:t})=>{var a;return null===(a=c.devBackend)||void 0===a?void 0:a.getRecord({apiKey:n().apiKey,apiUrl:n().apiUrl,language:e,namespace:t})},setLanguageDetector:e=>{c.languageDetector=e},getLanguageDetector:()=>c.languageDetector,setLanguageStorage:e=>{c.languageStorage=e},getLanguageStorage:()=>c.languageStorage,getInitialLanguage:()=>{var e;const n=i(),t=null===(e=c.languageStorage)||void 0===e?void 0:e.getLanguage();return p(t,(e=>n&&!n.includes(e)||!e?(()=>{if(!c.languageDetector)return;const e=i();return c.languageDetector.getLanguage({availableLanguages:e})})():e))},setStoredLanguage:e=>{var n;null===(n=c.languageStorage)||void 0===n||n.setLanguage(e)},run:e=>{var a,i;!c.ui&&g.ui&&(c.ui=new g.ui({apiKey:n().apiKey,apiUrl:n().apiUrl,highlight:l,changeTranslation:s})),c.observer||(c.observer=null===(a=g.observer)||void 0===a?void 0:a.call(g,{translate:d,onClick:u,options:t()})),null===(i=c.observer)||void 0===i||i.run({mouseHighlight:e})},stop:()=>{var e;c.ui=void 0,null===(e=c.observer)||void 0===e||e.stop()},retranslate:()=>{var e;null===(e=c.observer)||void 0===e||e.retranslate()},highlight:l,wrap:e=>{var n;return c.observer?null===(n=c.observer)||void 0===n?void 0:n.wrap(e):e.translation},unwrap:e=>{var n;return c.observer?null===(n=c.observer)||void 0===n?void 0:n.unwrap(e):{text:e,keys:[]}}})},h=(e,n,t)=>{let a=e;return Object.freeze({init:function(e){a=e},notify:function(){const e=n();a!==e&&t(e),a=e}})},m={tagAttributes:{textarea:["placeholder"],input:["value","placeholder"],img:["alt"],"*":["aria-label","title"]},restrictedElements:["script","style"],highlightKeys:["Alt"],highlightColor:"rgb(255, 0, 0)",highlightWidth:5,inputPrefix:"%-%tolgee:",inputSuffix:"%-%",passToParent:["option","optgroup"]},y=e=>Object.assign(Object.assign({},m),e),O={defaultNs:""},L=(e,n)=>{const t=Object.assign(Object.assign(Object.assign({},O),null==n?void 0:n.initialOptions),e),a=t.apiUrl;return t.apiUrl=a?a.replace(/\/+$/,""):a,{initialOptions:t,activeNamespaces:(null==n?void 0:n.activeNamespaces)||new Map,language:null==n?void 0:n.language,pendingLanguage:null==n?void 0:n.language,isInitialLoading:!1,isRunning:!1}};function k(e){var{ns:n,noWrap:t,orEmpty:a,params:i}=e,o=function(e,n){var t={};for(var a in e)Object.prototype.hasOwnProperty.call(e,a)&&n.indexOf(a)<0&&(t[a]=e[a]);if(null!=e&&"function"==typeof Object.getOwnPropertySymbols){var i=0;for(a=Object.getOwnPropertySymbols(e);i<a.length;i++)n.indexOf(a[i])<0&&Object.prototype.propertyIsEnumerable.call(e,a[i])&&(t[a[i]]=e[a[i]])}return t}(e,["ns","noWrap","orEmpty","params"]);return{ns:n,noWrap:t,orEmpty:a,params:Object.assign(Object.assign({},o),i)}}const j=(e,...n)=>{let t,a={};return"object"==typeof e?a=e:(a.key=e,"string"==typeof n[0]?(a.defaultValue=n[0],t=n[1]):"object"==typeof n[0]&&(t=n[0])),t&&(a=Object.assign(Object.assign({},k(t)),a)),a},R=({options:e})=>{const t=(e=>{const t=n(),a=n(),i=n(),o=n(),r=n(),s=n(),c=g(e),u=n(),l=n();return s.listen((()=>c.emit())),a.listen((()=>c.emit())),u.listen((({value:e})=>{c.emit({ns:[e.namespace],key:e.key},!0)})),Object.freeze({onPendingLanguageChange:t,onLanguageChange:a,onKeyChange:i,onKeyUpdate:c,onLoadingChange:o,onFetchingChange:r,onInitialLoaded:s,onRunningChange:l,onCacheChange:u,on:(e,n)=>{switch(e){case"pendingLanguage":return t.listen(n);case"language":return a.listen(n);case"loading":return o.listen(n);case"fetching":return r.listen(n);case"initialLoad":return s.listen(n);case"running":return l.listen(n);case"cache":return u.listen(n);case"keyUpdate":return c.listen(n)}}})})((function(){return c.getFallbackNamespaces()})),r=h(!1,(()=>m.isFetching()),t.onFetchingChange.emit),s=h(!1,(()=>R()),t.onLoadingChange.emit),c=((e,n,t)=>{let r,s=L(),g=y();function c(){return s.language||s.initialOptions.language}function l(){return Object.assign(Object.assign({},s.initialOptions),r)}return Object.freeze({init:function(e){s=L(e,s)},isRunning:function(){return s.isRunning},setRunning:function(e){s.isRunning!==e&&(s.isRunning=e,t.emit(e))},isInitialLoading:function(){return s.isInitialLoading},setInitialLoading:function(e){s.isInitialLoading=e},getLanguage:c,setLanguage:function(n){s.language!==n&&(s.language=n,e.emit(n))},getPendingLanguage:function(){return s.pendingLanguage||c()},setPendingLanguage:function(e){s.pendingLanguage!==e&&(s.pendingLanguage=e,n.emit(e))},getInitialOptions:l,addActiveNs:function(e){a(e).forEach((e=>{const n=s.activeNamespaces.get(e);void 0!==n?s.activeNamespaces.set(e,n+1):s.activeNamespaces.set(e,1)}))},removeActiveNs:function(e){a(e).forEach((e=>{const n=s.activeNamespaces.get(e);void 0!==n&&n>1?s.activeNamespaces.set(e,n-1):s.activeNamespaces.delete(e)}))},getRequiredNamespaces:function(){return o([...s.initialOptions.ns||[s.initialOptions.defaultNs],...s.activeNamespaces.keys()])},getFallbackLangs:function(e){const n=e||c();return n?o([n,...i(n,s.initialOptions.fallbackLanguage)]):[]},getFallbackNamespaces:function(){const e=s.initialOptions.defaultNs;return o([..."string"==typeof e?[e]:[],...a(s.initialOptions.fallbackNs)])},getAvailableLanguages:function(){if(s.initialOptions.availableLanguages)return s.initialOptions.availableLanguages;if(s.initialOptions.staticData){const e=Object.keys(s.initialOptions.staticData).map((e=>u(e).language));return Array.from(new Set(e))}},withDefaultNs:function(e){return{namespace:void 0===e.namespace?l().defaultNs:e.namespace,language:e.language}},overrideCredentials:function(e){r=e},setObserverOptions:function(e){g=y(e)},getObserverOptions:function(){return g}})})(t.onLanguageChange,t.onPendingLanguageChange,t.onRunningChange),l=b(c.getLanguage,c.getInitialOptions,c.getObserverOptions,c.getAvailableLanguages,(function({key:e,ns:n}){const t=void 0!==n?a(n):c.getFallbackNamespaces(),i=c.getFallbackLangs();return m.getTranslationNs(t,i,e)}),N,O),m=d(t.onCacheChange,l.getBackendRecord,l.getBackendDevRecord,c.withDefaultNs,c.isInitialLoading,r,s);function O(e,n,t){const a=c.withDefaultNs(e),i=m.getTranslation(a,n);return m.changeTranslation(a,n,t),{revert:()=>{m.changeTranslation(a,n,i)}}}function k(e){c.init(e),m.addStaticData(c.getInitialOptions().staticData)}function R(e){return m.isLoading(c.getLanguage(),e)}function E(){return Boolean(c.getInitialOptions().apiKey&&c.getInitialOptions().apiUrl&&l.getDevBackend())}function w(e,n){const t=function(e,n){const t=c.getFallbackLangs(e),i=void 0!==n?a(n):c.getRequiredNamespaces(),o=[];return t.forEach((e=>{i.forEach((n=>{m.exists({language:e,namespace:n},!0)||o.push({language:e,namespace:n})}))})),o}(e,n);if(t.length)return p(A(t),(()=>{}))}function N({key:e,ns:n}){const t=void 0!==n?a(n):c.getFallbackNamespaces(),i=c.getFallbackLangs();return m.getTranslationFallback(t,i,e)}function T(){const e=p(function(){if(c.getLanguage())return;if(!c.getInitialOptions().defaultLanguage)throw new Error(v("defaultLanguage"));const e=l.getInitialLanguage();return p(e,(e=>{const n=e||c.getInitialOptions().defaultLanguage;n&&c.setLanguage(n)}))}(),(()=>w()));if(f(e))return c.setInitialLoading(!0),r.notify(),s.notify(),Promise.resolve(e).then((()=>{c.setInitialLoading(!1),r.notify(),s.notify(),t.onInitialLoaded.emit()}));t.onInitialLoaded.emit()}function A(e){return m.loadRecords(e,E())}e&&k(e),t.onKeyUpdate.listen((()=>{c.isRunning()&&l.retranslate()}));return Object.freeze(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({},t),c),l),m),{init:k,changeLanguage:async function(e){c.getPendingLanguage()===e&&c.getLanguage()===e||(c.setPendingLanguage(e),c.isRunning()&&await w(e),e===c.getPendingLanguage()&&(c.setLanguage(e),l.setStoredLanguage(e)))},getTranslation:N,changeTranslation:O,addActiveNs:async function(e,n){n||c.addActiveNs(e),c.isRunning()&&await w(void 0,e)},loadRequiredRecords:w,loadRecords:A,loadRecord:async function(e){return(await A([e]))[0]},isLoading:R,isLoaded:function(e){const n=c.getLanguage();if(!n)return!1;const t=c.getFallbackLangs(n),i=void 0!==e?a(e):c.getRequiredNamespaces(),o=[];return t.forEach((e=>{i.forEach((n=>{m.exists({language:e,namespace:n})||o.push({language:e,namespace:n})}))})),0===o.length},t:(...e)=>{const n=j(...e),t=N(n);return l.formatTranslation(Object.assign(Object.assign({},n),{translation:t}))},isDev:E,run:function(){let e;return(()=>{const e=l.getLanguageDetector();if(e&&!c.getAvailableLanguages())throw new Error(v("availableLanguages"));if(!c.getLanguage()&&!c.getInitialOptions().defaultLanguage)throw e?new Error(v("defaultLanguage")):new Error(v("language"))})(),c.isRunning()||(E()&&m.invalidate(),c.setRunning(!0),l.run(E()),e=T()),Promise.resolve(e)},stop:function(){c.isRunning()&&(l.stop(),c.setRunning(!1))}}))};e.DEVTOOLS_ID="__tolgee_dev_tools",e.RESTRICTED_ASCENDANT_ATTRIBUTE="data-tolgee-restricted",e.TOLGEE_ATTRIBUTE_NAME="_tolgee",e.TOLGEE_HIGHLIGHTER_CLASS="_tolgee-highlighter",e.TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE="data-tolgee-key-only",e.Tolgee=e=>{const n=R({options:e}),t=Object.freeze({setFinalFormatter:n.setFinalFormatter,addFormatter:n.addFormatter,setObserver:n.setObserver,hasObserver:n.hasObserver,setUi:n.setUi,hasUi:n.hasUi,setDevBackend:n.setDevBackend,addBackend:n.addBackend,setLanguageDetector:n.setLanguageDetector,setLanguageStorage:n.setLanguageStorage,overrideCredentials:n.overrideCredentials}),a=e=>{const t=n.isRunning();t&&n.stop(),e(),t&&n.run()},i=Object.freeze({on:n.on,onKeyUpdate:n.onKeyUpdate.listenSome,getLanguage:n.getLanguage,getPendingLanguage:n.getPendingLanguage,changeLanguage:n.changeLanguage,changeTranslation:n.changeTranslation,addActiveNs:n.addActiveNs,removeActiveNs:n.removeActiveNs,loadRecords:n.loadRecords,loadRecord:n.loadRecord,addStaticData:n.addStaticData,getRecord:n.getRecord,getAllRecords:n.getAllRecords,isLoaded:n.isLoaded,isInitialLoading:n.isInitialLoading,isLoading:n.isLoading,isFetching:n.isFetching,isRunning:n.isRunning,run:n.run,stop:n.stop,t:n.t,highlight:n.highlight,getInitialOptions:n.getInitialOptions,isDev:n.isDev,wrap:n.wrap,unwrap:n.unwrap,setObserverOptions:e=>(n.setObserverOptions(e),i),use:e=>(e&&a((()=>e(i,t))),i),init:e=>(a((()=>n.init(e))),i)});return i},e.getFallback=t,e.getFallbackArray=a,e.getTranslateParams=j,Object.defineProperty(e,"__esModule",{value:!0})})); | ||
| !function(e,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports):"function"==typeof define&&define.amd?define(["exports"],n):n((e="undefined"!=typeof globalThis?globalThis:e||self)["@tolgee/core"]={})}(this,(function(e){"use strict";const n=()=>{let e=[];return Object.freeze({listen:n=>{const t=e=>{n(e)};return e.push(t),{unsubscribe:()=>{e=e.filter((e=>t!==e))}}},emit:n=>{e.forEach((e=>e({value:n})))}})};function t(e){return"string"==typeof e?[e]:Array.isArray(e)?e:void 0}function a(e){return t(e)||[]}function i(e,n){return"object"!=typeof(t=n)||Array.isArray(t)||null===t?a(n):a(null==n?void 0:n[e]);var t}function o(e){return Array.from(new Set(e))}function r(e){return e?e.replace(/\/+$/,""):e}const s=(e,n)=>{const t=new Set,i=new Set,o=(t,a)=>{i.forEach((i=>{const o=(t=>{if(t.has(1)||t.has(0)){const a=new Set(t.keys());return t.has(1)&&(a.delete(1),e().forEach((e=>a.add(e)))),t.has(0)&&(a.delete(0),a.add(n())),a}return t})(i.namespaces),r=void 0===a||-1!==(null==a?void 0:a.findIndex((e=>o.has(e)))),s=void 0===t||i.keys.has(t)||0===i.keys.size;r&&s&&i.fn({value:void 0})}))};let r=[];const s=()=>{if(0===r.length)return;t.forEach((e=>{e({value:void 0})}));let e=new Set,n=new Set;r.forEach((t=>{void 0===(null==t?void 0:t.ns)?e=void 0:void 0!==e&&t.ns.forEach((n=>e.add(n))),void 0===(null==t?void 0:t.key)?n=void 0:void 0!==n&&n.add(t.key)}));const a=e?Array.from(e.keys()):void 0;(n||[void 0]).forEach((e=>{o(e,a)})),r=[]};return Object.freeze({listenSome:e=>{const n={fn:n=>{e(n)},keys:new Set,namespaces:new Set};i.add(n);const t={unsubscribe:()=>{i.delete(n)},subscribeNs:e=>(a(e).forEach((e=>n.namespaces.add(e))),void 0===e&&n.namespaces.add(0),t),subscribeKey:e=>{const{key:i,ns:o}=e;return n.keys.add(i),a(o).forEach((e=>n.namespaces.add(e))),void 0===o&&n.namespaces.add(0),n.namespaces.add(1),t}};return t},listen:e=>{t.add(e);return{unsubscribe:()=>{t.delete(e)}}},emit:(e,n)=>{r.push(e),n?setTimeout(s,0):s()}})},c=e=>{const n=new Map;return Object.entries(e).forEach((([e,t])=>{null!=t&&("object"!=typeof t?n.set(e,t):c(t).forEach(((t,a)=>{n.set(e+"."+a,t)})))})),n},u=e=>{const[n,...t]=e.split(":");return{language:n,namespace:t.join(":")||""}},g=({language:e,namespace:n})=>n?`${e}:${n}`:e,l=(e,n,t,i,r,s,l)=>{const d=new Map,f=new Map;let p={},v=0;function h(n,t,a){const i=g(n);f.set(i,{data:c(t),version:a}),e.emit(n)}function b(e,n){h(e,n,v)}function m(e,n=!1){const t=f.get(g(e));return t&&n?t.version===v:Boolean(t)}function y(e){var n;return null===(n=f.get(g(i(e))))||void 0===n?void 0:n.data}function O(e){let t;if(!t){const n=p[g(e)];"function"==typeof n&&(t=n())}return t||(t=n(e)),t}return Object.freeze({addStaticData:function(e){e&&(p=Object.assign(Object.assign({},p),e),Object.entries(e).forEach((([e,n])=>{if("function"!=typeof n){const t=u(e),a=f.get(e);a&&0!==a.version||h(t,n,0)}})))},invalidate:function(){d.clear(),v+=1},addRecord:b,exists:m,getRecord:y,getTranslation:function(e,n){var t;return null===(t=f.get(g(e)))||void 0===t?void 0:t.data.get(n)},getTranslationNs:function(e,n,t){var a;for(const i of e)for(const e of n){const n=null===(a=f.get(g({language:e,namespace:i})))||void 0===a?void 0:a.data.get(t);if(null!=n)return[i]}return o(e)},getTranslationFallback:function(e,n,t){var a;for(const i of e)for(const e of n){const n=null===(a=f.get(g({language:e,namespace:i})))||void 0===a?void 0:a.data.get(t);if(null!=n)return n}},changeTranslation:function(n,t,a){var i;const o=null===(i=f.get(g(n)))||void 0===i?void 0:i.data;null==o||o.set(t,a),e.emit(Object.assign(Object.assign({},n),{key:t}))},isFetching:function(e){if(r())return!0;if(void 0===e)return d.size>0;const n=a(e);return Boolean(Array.from(d.keys()).find((e=>n.includes(u(e).namespace))))},isLoading:function(e,n){const t=a(n);return Boolean(r()||Array.from(d.keys()).find((n=>{const a=u(n);return(!t.length||t.includes(a.namespace))&&!m({namespace:a.namespace,language:e})})))},loadRecords:async function(e,n){const a=e.map((e=>{const a=i(e),o=g(a),r=d.get(o);if(r)return{new:!1,promise:r,keyObject:a,cacheKey:o};const s=function(e,n){var a;let i;return n&&(i=null===(a=t(e))||void 0===a?void 0:a.catch((()=>(console.warn("Tolgee: Failed to fetch data from dev backend"),O(e))))),i||(i=O(e)),i}(a,n)||Promise.resolve(void 0);return d.set(o,s),{new:!0,promise:s,keyObject:a,cacheKey:o}}));s.notify(),l.notify();const o=await Promise.all(a.map((e=>e.promise)));return a.forEach(((e,n)=>{const t=d.get(e.cacheKey)!==e.promise;if(e.new&&!t){d.delete(e.cacheKey);const t=o[n];t?b(e.keyObject,t):y(e.keyObject)||b(e.keyObject,{})}})),s.notify(),l.notify(),a.map((e=>y(e.keyObject)))},getAllRecords:function(){return Array.from(f.entries()).map((([e,n])=>Object.assign(Object.assign({},u(e)),{data:n.data})))}})};function d(e){return Boolean(e&&"function"==typeof e.then)}const f=(e,n)=>d(e)?Promise.resolve(e).then(n):n(e),p=e=>`Tolgee: You need to specify '${e}' option`,v=(e,n,t,a,i,o)=>{let r=!1,s=[];const c={ui:void 0,observer:void 0},u={formatters:[],finalFormatter:void 0,observer:void 0,devBackend:void 0,backends:[],ui:void 0,languageDetector:void 0,languageStorage:void 0},g=async(e,{keysAndDefaults:n})=>{var t;const o=n.map((({key:e,ns:n,defaultValue:t})=>({key:e,defaultValue:t,ns:a({key:e,ns:n}),translation:i({key:e,ns:n})})));null===(t=u.ui)||void 0===t||t.handleElementClick(e,o)},l=(e,n)=>{var t,a;return(null===(a=null===(t=u.observer)||void 0===t?void 0:t.highlight)||void 0===a?void 0:a.call(t,e,n))||{unhighlight(){}}},p=e=>{const n=i({key:e.key,ns:e.ns});return N(Object.assign(Object.assign({},e),{translation:n,formatEnabled:!0}))},v=e=>{c.observer=e},h=()=>Boolean(c.observer),b=e=>{e&&u.formatters.push(e)},m=e=>{u.finalFormatter=e},y=e=>{c.ui=(null==e?void 0:e.UI)||e},O=()=>Boolean(c.ui),L=e=>{u.languageStorage=e},k=e=>{u.languageDetector=e},j=e=>{e&&u.backends.push(e)},w=e=>{u.devBackend=e},R=()=>u.devBackend,E=e=>{s.push(e)};function N({key:n,translation:t,defaultValue:a,noWrap:i,params:o,orEmpty:r,ns:s,formatEnabled:c}){var g;const l=t||a;let d=l||(r?"":n);u.observer&&!i&&(d=u.observer.wrap({key:n,translation:d,defaultValue:a,params:o,ns:s}));const f=e(),p=c||!(null===(g=u.observer)||void 0===g?void 0:g.outputNotFormattable);if(l&&f&&p)for(const e of u.formatters)d=e.format({translation:d,language:f,params:o});return u.finalFormatter&&l&&f&&p&&(d=u.finalFormatter.format({translation:d,language:f,params:o})),d}function I(){for(r=!0;s.length;){const e=s;s=[],e.forEach((e=>e()))}}return Object.freeze({prepare:I,addPlugin:function(e,n){n(e,Object.freeze({setFinalFormatter:m,addFormatter:b,setObserver:v,hasObserver:h,setUi:y,hasUi:O,setDevBackend:w,addBackend:j,setLanguageDetector:k,setLanguageStorage:L,onPrepare:E})),r&&I()},formatTranslation:N,getDevBackend:R,getBackendRecord:({language:e,namespace:n})=>{for(const t of u.backends){const a=t.getRecord({language:e,namespace:n});if(d(a))return null==a?void 0:a.catch((e=>(console.error(e),{})));if(void 0!==a)return a}},getBackendDevRecord:({language:e,namespace:t})=>{var a;const{apiKey:i,apiUrl:o,projectId:r}=n();return null===(a=u.devBackend)||void 0===a?void 0:a.getRecord({apiKey:i,apiUrl:o,projectId:r,language:e,namespace:t})},getLanguageDetector:()=>u.languageDetector,getInitialLanguage:()=>{var e;const n=t(),a=null===(e=u.languageStorage)||void 0===e?void 0:e.getLanguage();return f(a,(e=>n&&!n.includes(e)||!e?(()=>{if(!u.languageDetector)return;const e=t();return u.languageDetector.getLanguage({availableLanguages:e})})():e))},setStoredLanguage:e=>{var n;null===(n=u.languageStorage)||void 0===n||n.setLanguage(e)},run:e=>{var t,a;if(!u.ui&&c.ui){const{apiKey:e,apiUrl:t,projectId:a}=n();u.ui=new c.ui({apiKey:e,apiUrl:t,projectId:a,highlight:l,changeTranslation:o})}u.observer||(u.observer=null===(t=c.observer)||void 0===t?void 0:t.call(c,{translate:p,onClick:g,options:n().observerOptions})),null===(a=u.observer)||void 0===a||a.run({mouseHighlight:e})},stop:()=>{var e;u.ui=void 0,null===(e=u.observer)||void 0===e||e.stop()},retranslate:()=>{var e;null===(e=u.observer)||void 0===e||e.retranslate()},highlight:l,unwrap:e=>{var n;return u.observer?null===(n=u.observer)||void 0===n?void 0:n.unwrap(e):{text:e,keys:[]}},wrap:e=>{var n;return u.observer?null===(n=u.observer)||void 0===n?void 0:n.wrap(e):e.translation},hasDevBackend:function(){return Boolean(R())}})},h=(e,n,t)=>{let a=e;return Object.freeze({init:function(e){a=e},notify:function(){const e=n();a!==e&&t(e),a=e}})},b={defaultNs:"",observerOptions:{tagAttributes:{textarea:["placeholder"],input:["value","placeholder"],img:["alt"],"*":["aria-label","title"]},restrictedElements:["script","style"],highlightKeys:["Alt"],highlightColor:"rgb(255, 0, 0)",highlightWidth:5,inputPrefix:"%-%tolgee:",inputSuffix:"%-%",passToParent:["option","optgroup"]},observerType:"invisible"},m=(...e)=>{let n={};return e.forEach((e=>{n=Object.assign(Object.assign(Object.assign({},n),e),{observerOptions:Object.assign(Object.assign({},n.observerOptions),null==e?void 0:e.observerOptions)})})),n},y=(e,n)=>{const t=m(b,null==n?void 0:n.initialOptions,e);return t.apiUrl=r(t.apiUrl),{initialOptions:t,activeNamespaces:(null==n?void 0:n.activeNamespaces)||new Map,language:null==n?void 0:n.language,pendingLanguage:null==n?void 0:n.language,isInitialLoading:!1,isRunning:!1}};function O(e){var{ns:n,noWrap:t,orEmpty:a,params:i}=e,o=function(e,n){var t={};for(var a in e)Object.prototype.hasOwnProperty.call(e,a)&&n.indexOf(a)<0&&(t[a]=e[a]);if(null!=e&&"function"==typeof Object.getOwnPropertySymbols){var i=0;for(a=Object.getOwnPropertySymbols(e);i<a.length;i++)n.indexOf(a[i])<0&&Object.prototype.propertyIsEnumerable.call(e,a[i])&&(t[a[i]]=e[a[i]])}return t}(e,["ns","noWrap","orEmpty","params"]);const r={ns:n,noWrap:t,orEmpty:a};return Object.assign(Object.assign({},r),{params:Object.assign({},o)})}const L=(e,...n)=>{let t,a={};return"object"==typeof e?a=e:(a.key=e,"string"==typeof n[0]?(a.defaultValue=n[0],t=n[1]):"object"==typeof n[0]&&(t=n[0])),t&&(a=Object.assign(Object.assign({},O(t)),a)),a},k=({options:e})=>{const t=((e,t)=>{const a=n(),i=n(),o=n(),r=n(),c=n(),u=n(),g=s(e,t),l=n(),d=n();return u.listen((()=>g.emit())),i.listen((()=>g.emit())),l.listen((({value:e})=>{g.emit({ns:[e.namespace],key:e.key},!0)})),Object.freeze({onPendingLanguageChange:a,onLanguageChange:i,onKeyChange:o,onKeyUpdate:g,onLoadingChange:r,onFetchingChange:c,onInitialLoaded:u,onRunningChange:d,onCacheChange:l,on:(e,n)=>{switch(e){case"pendingLanguage":return a.listen(n);case"language":return i.listen(n);case"loading":return r.listen(n);case"fetching":return c.listen(n);case"initialLoad":return u.listen(n);case"running":return d.listen(n);case"cache":return l.listen(n);case"keyUpdate":return g.listen(n)}}})})(k,j),c=h(!1,(()=>O.isFetching()),t.onFetchingChange.emit),g=h(!1,(()=>I()),t.onLoadingChange.emit),b=((e,n,t)=>{let s,c=y();function g(){return c.language||c.initialOptions.language}function l(){return Object.assign(Object.assign({},c.initialOptions),s)}return Object.freeze({init:function(e){c=y(e,c)},isRunning:function(){return c.isRunning},setRunning:function(e){c.isRunning!==e&&(c.isRunning=e,t.emit(e))},isInitialLoading:function(){return c.isInitialLoading},setInitialLoading:function(e){c.isInitialLoading=e},getLanguage:g,setLanguage:function(n){c.language!==n&&(c.language=n,e.emit(n))},getPendingLanguage:function(){return c.pendingLanguage||g()},setPendingLanguage:function(e){c.pendingLanguage!==e&&(c.pendingLanguage=e,n.emit(e))},getInitialOptions:l,addActiveNs:function(e){a(e).forEach((e=>{const n=c.activeNamespaces.get(e);void 0!==n?c.activeNamespaces.set(e,n+1):c.activeNamespaces.set(e,1)}))},removeActiveNs:function(e){a(e).forEach((e=>{const n=c.activeNamespaces.get(e);void 0!==n&&n>1?c.activeNamespaces.set(e,n-1):c.activeNamespaces.delete(e)}))},getRequiredNamespaces:function(){return o([...c.initialOptions.ns||[c.initialOptions.defaultNs],...a(c.initialOptions.fallbackNs),...c.activeNamespaces.keys()])},getFallbackLangs:function(e){const n=e||g();return n?o([n,...i(n,c.initialOptions.fallbackLanguage)]):[]},getFallbackNs:function(){return a(c.initialOptions.fallbackNs)},getDefaultNs:function(e){return void 0===e?c.initialOptions.defaultNs:e},getAvailableLanguages:function(){if(c.initialOptions.availableLanguages)return c.initialOptions.availableLanguages;if(c.initialOptions.staticData){const e=Object.keys(c.initialOptions.staticData).map((e=>u(e).language));return Array.from(new Set(e))}},withDefaultNs:function(e){return{namespace:void 0===e.namespace?l().defaultNs:e.namespace,language:e.language}},overrideCredentials:function(e){s=e?Object.assign(Object.assign({},e),{apiUrl:r(e.apiUrl)}):void 0}})})(t.onLanguageChange,t.onPendingLanguageChange,t.onRunningChange),m=v(b.getLanguage,b.getInitialOptions,b.getAvailableLanguages,(function({key:e,ns:n}){const t=b.getFallbackLangs(),a=w(n);return O.getTranslationNs(a,t,e)}),F,E),O=l(t.onCacheChange,m.getBackendRecord,m.getBackendDevRecord,b.withDefaultNs,b.isInitialLoading,c,g);function k(){return b.getFallbackNs()}function j(e){return b.getDefaultNs(e)}function w(e){return[...a(j(e)),...k()]}function R(e){return[...a(e||j()),...b.getRequiredNamespaces()]}function E(e,n,t){const a=b.withDefaultNs(e),i=O.getTranslation(a,n);return O.changeTranslation(a,n,t),{revert:()=>{O.changeTranslation(a,n,i)}}}function N(e){b.init(e),O.addStaticData(b.getInitialOptions().staticData)}function I(e){return O.isLoading(b.getLanguage(),e)}function D(){return Boolean(b.getInitialOptions().apiKey&&b.getInitialOptions().apiUrl)}function A(e,n){const t=function(e,n){const t=b.getFallbackLangs(e),a=R(n),i=[];return t.forEach((e=>{a.forEach((n=>{O.exists({language:e,namespace:n},!0)||i.push({language:e,namespace:n})}))})),i}(e,n);if(t.length)return f(P(t),(()=>{}))}function F({key:e,ns:n}){const t=w(n),a=b.getFallbackLangs();return O.getTranslationFallback(t,a,e)}function S(){const e=f(function(){if(b.getLanguage())return;if(!b.getInitialOptions().defaultLanguage)throw new Error(p("defaultLanguage"));const e=m.getInitialLanguage();return f(e,(e=>{const n=e||b.getInitialOptions().defaultLanguage;n&&b.setLanguage(n)}))}(),(()=>A()));if(d(e))return b.setInitialLoading(!0),c.notify(),g.notify(),Promise.resolve(e).then((()=>{b.setInitialLoading(!1),c.notify(),g.notify(),t.onInitialLoaded.emit()}));t.onInitialLoaded.emit()}function P(e){return O.loadRecords(e,D())}e&&N(e),t.onKeyUpdate.listen((()=>{b.isRunning()&&m.retranslate()}));return Object.freeze(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({},t),b),m),O),{init:N,changeLanguage:async function(e){b.getPendingLanguage()===e&&b.getLanguage()===e||(b.setPendingLanguage(e),b.isRunning()&&await A(e),e===b.getPendingLanguage()&&(b.setLanguage(e),m.setStoredLanguage(e)))},getTranslation:F,changeTranslation:E,addActiveNs:async function(e,n){n||b.addActiveNs(e),b.isRunning()&&await A(void 0,e)},loadRecords:P,loadRecord:async function(e){return(await P([e]))[0]},isLoading:I,isLoaded:function(e){const n=b.getLanguage();if(!n)return!1;const t=b.getFallbackLangs(n),a=R(e),i=[];return t.forEach((e=>{a.forEach((n=>{O.exists({language:e,namespace:n})||i.push({language:e,namespace:n})}))})),0===i.length},t:(...e)=>{const n=L(...e),t=F(n);return m.formatTranslation(Object.assign(Object.assign({},n),{translation:t}))},isDev:D,run:function(){let e;return(()=>{const e=m.getLanguageDetector();if(e&&!b.getAvailableLanguages())throw new Error(p("availableLanguages"));if(!b.getLanguage()&&!b.getInitialOptions().defaultLanguage)throw e?new Error(p("defaultLanguage")):new Error(p("language"))})(),b.isRunning()||(D()&&O.invalidate(),b.setRunning(!0),m.run(D()),e=S()),Promise.resolve(e)},stop:function(){b.isRunning()&&(m.stop(),b.setRunning(!1))}}))};class j extends Error{constructor(e,n,t){let a;a=0===e?"Empty parameter":1===e?"Unexpected character":"Unexpected end",super(`Tolgee parser: ${a} at ${n} in "${t}"`),this.code=e,this.index=n}}function w(e){return/\s/.test(e)}const R=new Set([2,1,0]),E=new Set(["{","}","'"]);function N(e,n){const[t,a]=function(e){let n=0,t="",a="",i="";const o=[],r=[];let s=0;function c(n){throw new j(n,s,e)}const u=()=>{o.push(t),t=""},g=()=>{""===a&&c(0),r.push(a),a=""};for(s=0;s<e.length;s++)switch(i=e[s],n){case 0:"'"===i?(t+=i,n=1):"{"===i?(u(),n=3):(t+=i,n=0);break;case 1:E.has(i)?(t=t.slice(0,-1)+i,n=2):(t+=i,n=0);break;case 2:"'"===i?n=0:(t+=i,n=2);break;case 3:"}"===i?(g(),n=0):w(i)?""!==a&&(g(),n=4):(/[0-9a-zA-Z_]/.test(i)||c(1),a+=i,n=3);break;case 4:"}"==i?n=0:w(i)?n=4:c(1)}return R.has(n)||c(2),u(),[o,r]}(e),i=[t[0]];for(let o=1;o<t.length;o++){const r=null==n?void 0:n[a[o-1]];if(void 0===r)throw new Error(`Missing parameter "${a[o-1]}" in "${e}"`);i.push(String(r)),i.push(t[o])}return i.join("")}e.FormatSimple=()=>(e,n)=>(n.setFinalFormatter({format:({translation:e,params:n})=>N(e,n)}),e),e.Tolgee=()=>{const e={plugins:[],options:{}},n=Object.freeze({use:t=>(e.plugins.push(t),n),updateDefaults:t=>(e.options=m(e.options,t),n),init(n){const t=(e=>{const n=k({options:e}),t=e=>{const t=n.isRunning();t&&n.stop(),e(),t&&n.run()},a=Object.freeze({on:n.on,onKeyUpdate:n.onKeyUpdate.listenSome,getLanguage:n.getLanguage,getPendingLanguage:n.getPendingLanguage,changeLanguage:n.changeLanguage,changeTranslation:n.changeTranslation,addActiveNs:n.addActiveNs,removeActiveNs:n.removeActiveNs,loadRecords:n.loadRecords,loadRecord:n.loadRecord,addStaticData:n.addStaticData,getRecord:n.getRecord,getAllRecords:n.getAllRecords,isLoaded:n.isLoaded,isInitialLoading:n.isInitialLoading,isLoading:n.isLoading,isFetching:n.isFetching,isRunning:n.isRunning,run:n.run,stop:n.stop,t:n.t,highlight:n.highlight,getInitialOptions:n.getInitialOptions,isDev:n.isDev,wrap:n.wrap,unwrap:n.unwrap,overrideCredentials(e){t((()=>n.overrideCredentials(e)))},addPlugin(e){e&&t((()=>n.addPlugin(a,e)))},updateOptions(e){e&&t((()=>n.init(e)))}});return a})(m(e.options,n));return e.plugins.forEach(t.addPlugin),t}});return n},e.getFallback=t,e.getFallbackArray=a,e.getTranslateParams=L,Object.defineProperty(e,"__esModule",{value:!0})})); | ||
| //# sourceMappingURL=tolgee.umd.min.js.map |
@@ -1,5 +0,6 @@ | ||
| import { CacheDescriptor, CacheDescriptorInternal, CacheDescriptorWithKey, EventEmitterInstance, FallbackNSTranslation, Options, TranslationsFlat, TranslationValue, TreeTranslationsData, BackendGetRecord, BackendGetDevRecord } from '../../types'; | ||
| import { CacheDescriptor, CacheDescriptorInternal, CacheDescriptorWithKey, EventEmitterInstance, FallbackNsTranslation, TranslationsFlat, TranslationValue, TreeTranslationsData, BackendGetRecord, BackendGetDevRecord } from '../../types'; | ||
| import { TolgeeStaticData } from '../State/initState'; | ||
| import { ValueObserverInstance } from '../ValueObserver'; | ||
| export declare const Cache: (onCacheChange: EventEmitterInstance<CacheDescriptorWithKey>, backendGetRecord: BackendGetRecord, backendGetDevRecord: BackendGetDevRecord, withDefaultNs: (descriptor: CacheDescriptor) => CacheDescriptorInternal, isInitialLoading: () => boolean, fetchingObserver: ValueObserverInstance<boolean>, loadingObserver: ValueObserverInstance<boolean>) => Readonly<{ | ||
| addStaticData: (data: Options['staticData']) => void; | ||
| addStaticData: (data: TolgeeStaticData | undefined) => void; | ||
| invalidate: () => void; | ||
@@ -10,7 +11,7 @@ addRecord: (descriptor: CacheDescriptorInternal, data: TreeTranslationsData) => void; | ||
| getTranslation: (descriptor: CacheDescriptorInternal, key: string) => TranslationValue; | ||
| getTranslationNs: (namespaces: string[], languages: string[], key: string) => string | string[]; | ||
| getTranslationNs: (namespaces: string[], languages: string[], key: string) => string[]; | ||
| getTranslationFallback: (namespaces: string[], languages: string[], key: string) => string | undefined; | ||
| changeTranslation: (descriptor: CacheDescriptorInternal, key: string, value: TranslationValue) => void; | ||
| isFetching: (ns?: FallbackNSTranslation) => boolean; | ||
| isLoading: (language: string | undefined, ns?: FallbackNSTranslation) => boolean; | ||
| isFetching: (ns?: FallbackNsTranslation) => boolean; | ||
| isLoading: (language: string | undefined, ns?: FallbackNsTranslation) => boolean; | ||
| loadRecords: (descriptors: CacheDescriptor[], isDev: boolean) => Promise<TranslationsFlat[]>; | ||
@@ -17,0 +18,0 @@ getAllRecords: () => { |
@@ -1,18 +0,17 @@ | ||
| import { CacheDescriptor, FallbackNSTranslation, Options, TFnType, TranslatePropsInternal } from '../types'; | ||
| import { CacheDescriptor, FallbackNsTranslation, TolgeeOptions, TFnType, KeyAndNamespacesInternal } from '../types'; | ||
| declare type StateServiceProps = { | ||
| options?: Partial<Options>; | ||
| options?: Partial<TolgeeOptions>; | ||
| }; | ||
| export declare const Controller: ({ options }: StateServiceProps) => Readonly<{ | ||
| init: (options: Partial<Options>) => void; | ||
| init: (options: Partial<TolgeeOptions>) => void; | ||
| changeLanguage: (language: string) => Promise<void>; | ||
| getTranslation: ({ key, ns, }: Pick<TranslatePropsInternal, 'key' | 'ns'>) => string | undefined; | ||
| getTranslation: ({ key, ns }: KeyAndNamespacesInternal) => string | undefined; | ||
| changeTranslation: (descriptor: CacheDescriptor, key: string, value: string) => { | ||
| revert: () => void; | ||
| }; | ||
| addActiveNs: (ns: FallbackNSTranslation, forget?: boolean) => Promise<void>; | ||
| loadRequiredRecords: (lang?: string, ns?: FallbackNSTranslation) => void | Promise<void>; | ||
| addActiveNs: (ns: FallbackNsTranslation, forget?: boolean) => Promise<void>; | ||
| loadRecords: (descriptors: CacheDescriptor[]) => Promise<import("../types").TranslationsFlat[]>; | ||
| loadRecord: (descriptor: CacheDescriptor) => Promise<import("../types").TranslationsFlat>; | ||
| isLoading: (ns?: FallbackNSTranslation) => boolean; | ||
| isLoaded: (ns?: FallbackNSTranslation) => boolean; | ||
| isLoading: (ns?: FallbackNsTranslation) => boolean; | ||
| isLoaded: (ns?: FallbackNsTranslation) => boolean; | ||
| t: TFnType<import("../types").DefaultParamType, string>; | ||
@@ -22,5 +21,3 @@ isDev: () => boolean; | ||
| stop: () => void; | ||
| addStaticData: (data: { | ||
| [key: string]: import("../types").TreeTranslationsData | (() => Promise<import("../types").TreeTranslationsData>); | ||
| } | undefined) => void; | ||
| addStaticData: (data: import("./State/initState").TolgeeStaticData | undefined) => void; | ||
| invalidate: () => void; | ||
@@ -30,5 +27,5 @@ addRecord: (descriptor: import("../types").CacheDescriptorInternal, data: import("../types").TreeTranslationsData) => void; | ||
| getRecord: (descriptor: CacheDescriptor) => import("../types").TranslationsFlat | undefined; | ||
| getTranslationNs: (namespaces: string[], languages: string[], key: string) => string | string[]; | ||
| getTranslationNs: (namespaces: string[], languages: string[], key: string) => string[]; | ||
| getTranslationFallback: (namespaces: string[], languages: string[], key: string) => string | undefined; | ||
| isFetching: (ns?: FallbackNSTranslation) => boolean; | ||
| isFetching: (ns?: FallbackNsTranslation) => boolean; | ||
| getAllRecords: () => { | ||
@@ -39,8 +36,59 @@ data: import("../types").TranslationsFlat; | ||
| }[]; | ||
| setFinalFormatter: (formatter: import("../types").FinalFormatterInterface | undefined) => void; | ||
| addFormatter: (formatter: import("../types").FormatterInterface | undefined) => void; | ||
| prepare: () => void; | ||
| addPlugin: (tolgeeInstance: Readonly<{ | ||
| on: import("..").TolgeeOn<keyof import("..").EventType>; | ||
| onKeyUpdate: (handler: import("../types").ListenerHandler<undefined>) => import("../types").ListenerSelective; | ||
| getLanguage: () => string | undefined; | ||
| getPendingLanguage: () => string | undefined; | ||
| changeLanguage: (language: string) => Promise<void>; | ||
| changeTranslation: (descriptor: CacheDescriptor, key: string, value: string) => { | ||
| revert: () => void; | ||
| }; | ||
| addActiveNs: (ns: FallbackNsTranslation, forget?: boolean) => Promise<void>; | ||
| removeActiveNs: (ns: FallbackNsTranslation) => void; | ||
| loadRecords: (descriptors: CacheDescriptor[]) => Promise<import("../types").TranslationsFlat[]>; | ||
| loadRecord: (descriptor: CacheDescriptor) => Promise<import("../types").TranslationsFlat>; | ||
| addStaticData: (data: import("./State/initState").TolgeeStaticData | undefined) => void; | ||
| getRecord: (descriptor: CacheDescriptor) => import("../types").TranslationsFlat | undefined; | ||
| getAllRecords: () => { | ||
| data: import("../types").TranslationsFlat; | ||
| language: string; | ||
| namespace: string; | ||
| }[]; | ||
| isLoaded: (ns?: FallbackNsTranslation) => boolean; | ||
| isInitialLoading: () => boolean; | ||
| isLoading: (ns?: FallbackNsTranslation) => boolean; | ||
| isFetching: (ns?: FallbackNsTranslation) => boolean; | ||
| isRunning: () => boolean; | ||
| run: () => Promise<void | undefined>; | ||
| stop: () => void; | ||
| t: TFnType<import("../types").DefaultParamType, string>; | ||
| highlight: import("../types").HighlightInterface; | ||
| getInitialOptions: () => { | ||
| apiUrl?: string | undefined; | ||
| apiKey?: string | undefined; | ||
| projectId?: string | number | undefined; | ||
| language?: string | undefined; | ||
| defaultLanguage?: string | undefined; | ||
| availableLanguages?: string[] | undefined; | ||
| fallbackLanguage?: import("../types").FallbackLanguageOption; | ||
| ns?: string[] | undefined; | ||
| fallbackNs?: import("../types").FallbackGeneral; | ||
| defaultNs: string; | ||
| staticData?: import("./State/initState").TolgeeStaticData | undefined; | ||
| observerOptions: import("./State/observerOptions").ObserverOptionsInternal; | ||
| observerType: "invisible" | "text"; | ||
| }; | ||
| isDev: () => boolean; | ||
| wrap: (params: import("../types").WrapperWrapProps) => string | undefined; | ||
| unwrap: (text: string) => import("../types").Unwrapped; | ||
| overrideCredentials(credentials: import("../types").DevCredentials): void; | ||
| addPlugin(plugin: import("../types").TolgeePlugin | undefined): void; | ||
| updateOptions(options?: TolgeeOptions | undefined): void; | ||
| }>, plugin: import("../types").TolgeePlugin) => void; | ||
| formatTranslation: ({ key, translation, defaultValue, noWrap, params, orEmpty, ns, formatEnabled, }: { | ||
| key: string; | ||
| defaultValue?: string | undefined; | ||
| } & import("../types").TranslateOptions<import("../types").DefaultParamType> & { | ||
| params?: import("../types").TranslateParams<import("../types").DefaultParamType> | undefined; | ||
| } & import("../types").TranslateOptions & { | ||
| translation?: string | undefined; | ||
@@ -50,15 +98,6 @@ } & { | ||
| }) => string; | ||
| setObserver: (observer: import("../types").ObserverInterface | undefined) => void; | ||
| hasObserver: () => boolean; | ||
| setUi: (ui: import("../types").UiType | undefined) => void; | ||
| hasUi: () => boolean; | ||
| addBackend: (backend: import("../types").BackendInterface | undefined) => void; | ||
| setDevBackend: (backend: import("../types").BackendDevInterface | undefined) => void; | ||
| getDevBackend: () => import("../types").BackendDevInterface | undefined; | ||
| getBackendRecord: import("../types").BackendGetRecord; | ||
| getBackendDevRecord: import("../types").BackendGetRecord; | ||
| setLanguageDetector: (detector: import("../types").LanguageDetectorInterface | undefined) => void; | ||
| getLanguageDetector: () => import("../types").LanguageDetectorInterface | undefined; | ||
| setLanguageStorage: (storage: import("../types").LanguageStorageInterface | undefined) => void; | ||
| getLanguageStorage: () => import("../types").LanguageStorageInterface | undefined; | ||
| getInitialLanguage: () => string | Promise<string | undefined> | Promise<string | Promise<string | undefined> | undefined> | undefined; | ||
@@ -68,4 +107,5 @@ setStoredLanguage: (language: string) => void; | ||
| highlight: import("../types").HighlightInterface; | ||
| unwrap: (text: string) => import("../types").Unwrapped; | ||
| wrap: (params: import("../types").WrapperWrapProps) => string | undefined; | ||
| unwrap: (text: string) => import("../types").Unwrapped; | ||
| hasDevBackend: () => boolean; | ||
| isRunning: () => boolean; | ||
@@ -82,4 +122,4 @@ setRunning: (value: boolean) => void; | ||
| apiKey?: string | undefined; | ||
| projectId?: string | number | undefined; | ||
| language?: string | undefined; | ||
| projectId?: number | undefined; | ||
| defaultLanguage?: string | undefined; | ||
@@ -91,15 +131,14 @@ availableLanguages?: string[] | undefined; | ||
| defaultNs: string; | ||
| staticData?: { | ||
| [key: string]: import("../types").TreeTranslationsData | (() => Promise<import("../types").TreeTranslationsData>); | ||
| } | undefined; | ||
| staticData?: import("./State/initState").TolgeeStaticData | undefined; | ||
| observerOptions: import("./State/observerOptions").ObserverOptionsInternal; | ||
| observerType: "invisible" | "text"; | ||
| }; | ||
| removeActiveNs: (ns: FallbackNSTranslation) => void; | ||
| removeActiveNs: (ns: FallbackNsTranslation) => void; | ||
| getRequiredNamespaces: () => string[]; | ||
| getFallbackLangs: (lang?: string | undefined) => string[]; | ||
| getFallbackNamespaces: () => string[]; | ||
| getFallbackNs: () => string[]; | ||
| getDefaultNs: (ns?: string | undefined) => string; | ||
| getAvailableLanguages: () => string[] | undefined; | ||
| withDefaultNs: (descriptor: CacheDescriptor) => import("../types").CacheDescriptorInternal; | ||
| overrideCredentials: (credentials: import("../types").DevCredentials) => void; | ||
| setObserverOptions: (options: Partial<import("./State/initObserverOptions").ObserverOptions>) => void; | ||
| getObserverOptions: () => import("./State/initObserverOptions").ObserverOptions; | ||
| onPendingLanguageChange: import("./Events/EventEmitter").EventEmitterInstance<string>; | ||
@@ -114,5 +153,5 @@ onLanguageChange: import("./Events/EventEmitter").EventEmitterInstance<string>; | ||
| onCacheChange: import("./Events/EventEmitter").EventEmitterInstance<import("../types").CacheDescriptorWithKey>; | ||
| on: import("../types").TolgeeOn; | ||
| on: import("..").TolgeeOn<keyof import("..").EventType>; | ||
| }>; | ||
| export declare type StateServiceType = ReturnType<typeof Controller>; | ||
| export {}; |
| import { KeyDescriptorInternal, Listener, ListenerHandler, ListenerSelective } from '../../types'; | ||
| export declare const EventEmitterSelective: (getFallbackNamespaces: () => string[]) => EventEmitterSelectiveInstance; | ||
| export declare const EventEmitterSelective: (getFallbackNs: () => string[], getDefaultNs: () => string) => EventEmitterSelectiveInstance; | ||
| export declare type EventEmitterSelectiveInstance = { | ||
@@ -4,0 +4,0 @@ readonly listenSome: (handler: ListenerHandler<undefined>) => ListenerSelective; |
@@ -1,3 +0,4 @@ | ||
| import { CacheDescriptorWithKey, KeyDescriptorInternal, TolgeeOn } from '../../types'; | ||
| export declare const Events: (getFallbackNamespaces: () => string[]) => Readonly<{ | ||
| import { CacheDescriptorWithKey, KeyDescriptorInternal } from '../../types'; | ||
| import { TolgeeOn } from '../../types/event'; | ||
| export declare const Events: (getFallbackNs: () => string[], getDefaultNs: () => string) => Readonly<{ | ||
| onPendingLanguageChange: import("./EventEmitter").EventEmitterInstance<string>; | ||
@@ -12,4 +13,4 @@ onLanguageChange: import("./EventEmitter").EventEmitterInstance<string>; | ||
| onCacheChange: import("./EventEmitter").EventEmitterInstance<CacheDescriptorWithKey>; | ||
| on: TolgeeOn; | ||
| on: TolgeeOn<keyof import("../../types/event").EventType>; | ||
| }>; | ||
| export declare type EventServiceType = ReturnType<typeof Events>; |
@@ -1,10 +0,11 @@ | ||
| import { BackendDevInterface, BackendGetRecord, BackendInterface, FormatterInterface, ObserverInterface, TranslatePropsInternal, UiType, FinalFormatterInterface, HighlightInterface, LanguageDetectorInterface, LanguageStorageInterface, Options, ChangeTranslationInterface, WrapperWrapProps, Unwrapped } from '../../types'; | ||
| import { ObserverOptions } from '../State/initObserverOptions'; | ||
| export declare const PluginService: (getLanguage: () => string | undefined, getInitialOptions: () => Options, getObserverOptions: () => ObserverOptions, getAvailableLanguages: () => string[] | undefined, getTranslationNs: (props: TranslatePropsInternal) => string[] | string, getTranslation: (props: TranslatePropsInternal) => string | undefined, changeTranslation: ChangeTranslationInterface) => Readonly<{ | ||
| setFinalFormatter: (formatter: FinalFormatterInterface | undefined) => void; | ||
| addFormatter: (formatter: FormatterInterface | undefined) => void; | ||
| import { BackendDevInterface, BackendGetRecord, TranslatePropsInternal, HighlightInterface, LanguageDetectorInterface, ChangeTranslationInterface, WrapperWrapProps, Unwrapped, KeyAndNamespacesInternal, TolgeePlugin, TolgeeInstance } from '../../types'; | ||
| import { TolgeeOptionsInternal } from '../State/initState'; | ||
| export declare const PluginService: (getLanguage: () => string | undefined, getInitialOptions: () => TolgeeOptionsInternal, getAvailableLanguages: () => string[] | undefined, getTranslationNs: (props: KeyAndNamespacesInternal) => string[], getTranslation: (props: KeyAndNamespacesInternal) => string | undefined, changeTranslation: ChangeTranslationInterface) => Readonly<{ | ||
| prepare: () => void; | ||
| addPlugin: (tolgeeInstance: TolgeeInstance, plugin: TolgeePlugin) => void; | ||
| formatTranslation: ({ key, translation, defaultValue, noWrap, params, orEmpty, ns, formatEnabled, }: { | ||
| key: string; | ||
| defaultValue?: string | undefined; | ||
| } & import("../../types").TranslateOptions<import("../../types").DefaultParamType> & { | ||
| params?: import("../../types").TranslateParams<import("../../types").DefaultParamType> | undefined; | ||
| } & import("../../types").TranslateOptions & { | ||
| translation?: string | undefined; | ||
@@ -14,15 +15,6 @@ } & { | ||
| }) => string; | ||
| setObserver: (observer: ObserverInterface | undefined) => void; | ||
| hasObserver: () => boolean; | ||
| setUi: (ui: UiType | undefined) => void; | ||
| hasUi: () => boolean; | ||
| addBackend: (backend: BackendInterface | undefined) => void; | ||
| setDevBackend: (backend: BackendDevInterface | undefined) => void; | ||
| getDevBackend: () => BackendDevInterface | undefined; | ||
| getBackendRecord: BackendGetRecord; | ||
| getBackendDevRecord: BackendGetRecord; | ||
| setLanguageDetector: (detector: LanguageDetectorInterface | undefined) => void; | ||
| getLanguageDetector: () => LanguageDetectorInterface | undefined; | ||
| setLanguageStorage: (storage: LanguageStorageInterface | undefined) => void; | ||
| getLanguageStorage: () => LanguageStorageInterface | undefined; | ||
| getInitialLanguage: () => string | Promise<string | undefined> | Promise<string | Promise<string | undefined> | undefined> | undefined; | ||
@@ -34,5 +26,6 @@ setStoredLanguage: (language: string) => void; | ||
| highlight: HighlightInterface; | ||
| unwrap: (text: string) => Unwrapped; | ||
| wrap: (params: WrapperWrapProps) => string | undefined; | ||
| unwrap: (text: string) => Unwrapped; | ||
| hasDevBackend: () => boolean; | ||
| }>; | ||
| export declare type PluginServiceType = ReturnType<typeof PluginService>; |
@@ -7,1 +7,2 @@ import { FallbackGeneral, FallbackLanguageOption } from '../../types'; | ||
| export declare function unique<T>(arr: T[]): T[]; | ||
| export declare function sanitizeUrl(url: string | undefined): string | undefined; |
@@ -1,3 +0,7 @@ | ||
| import { FallbackLanguageOption, FallbackNS, TreeTranslationsData } from '../../types'; | ||
| export declare type Options = { | ||
| import { FallbackLanguageOption, FallbackNs, TreeTranslationsData } from '../../types'; | ||
| import { ObserverOptions, ObserverOptionsInternal } from './observerOptions'; | ||
| export declare type TolgeeStaticData = { | ||
| [key: string]: TreeTranslationsData | (() => Promise<TreeTranslationsData>); | ||
| }; | ||
| export declare type TolgeeOptionsInternal = { | ||
| /** | ||
@@ -7,6 +11,15 @@ * Initial language | ||
| language?: string; | ||
| /** | ||
| * Tolgee instance url (e.g. https://app.tolgee.io) | ||
| */ | ||
| apiUrl?: string; | ||
| /** | ||
| * Project API key (PAK) or Personal Access Token (PAT) | ||
| */ | ||
| apiKey?: string; | ||
| projectId?: number; | ||
| /** | ||
| * Project id is necessary if you are using PAT | ||
| */ | ||
| projectId?: number | string; | ||
| /** | ||
| * Used when auto detection is not available or is turned off | ||
@@ -31,3 +44,3 @@ */ | ||
| */ | ||
| fallbackNs?: FallbackNS; | ||
| fallbackNs?: FallbackNs; | ||
| /** | ||
@@ -37,8 +50,22 @@ * Default namespace when no namespace defined (default: '') | ||
| defaultNs: string; | ||
| staticData?: { | ||
| [key: string]: TreeTranslationsData | (() => Promise<TreeTranslationsData>); | ||
| }; | ||
| /** | ||
| * These data go directly to cache or you can specify async | ||
| * function which will be used to get the data. Use `:` to add namespace: | ||
| * | ||
| * ```ts | ||
| * { | ||
| * 'locale': <translations | async function> | ||
| * 'locale:namespace': <translations | async function> | ||
| * } | ||
| * ``` | ||
| */ | ||
| staticData?: TolgeeStaticData; | ||
| observerOptions: ObserverOptionsInternal; | ||
| observerType: 'invisible' | 'text'; | ||
| }; | ||
| export declare type TolgeeOptions = Partial<Omit<TolgeeOptionsInternal, 'observerOptions'>> & { | ||
| observerOptions?: ObserverOptions; | ||
| }; | ||
| export declare type State = { | ||
| initialOptions: Options; | ||
| initialOptions: TolgeeOptionsInternal; | ||
| activeNamespaces: Map<string, number>; | ||
@@ -50,2 +77,3 @@ language: string | undefined; | ||
| }; | ||
| export declare const initState: (options?: Partial<Options>, previousState?: State) => State; | ||
| export declare const combineOptions: <T extends TolgeeOptions>(...states: (T | undefined)[]) => T; | ||
| export declare const initState: (options?: Partial<TolgeeOptions>, previousState?: State) => State; |
@@ -1,6 +0,5 @@ | ||
| import { CacheDescriptor, CacheDescriptorInternal, DevCredentials, EventEmitterInstance, FallbackNSTranslation } from '../../types'; | ||
| import { ObserverOptions } from './initObserverOptions'; | ||
| import { Options } from './initState'; | ||
| import { CacheDescriptor, CacheDescriptorInternal, DevCredentials, EventEmitterInstance, FallbackNsTranslation, NsType } from '../../types'; | ||
| import { TolgeeOptions } from './initState'; | ||
| export declare const State: (onLanguageChange: EventEmitterInstance<string>, onPendingLanguageChange: EventEmitterInstance<string>, onRunningChange: EventEmitterInstance<boolean>) => Readonly<{ | ||
| init: (options?: Partial<Options>) => void; | ||
| init: (options?: Partial<TolgeeOptions>) => void; | ||
| isRunning: () => boolean; | ||
@@ -17,4 +16,4 @@ setRunning: (value: boolean) => void; | ||
| apiKey?: string | undefined; | ||
| projectId?: string | number | undefined; | ||
| language?: string | undefined; | ||
| projectId?: number | undefined; | ||
| defaultLanguage?: string | undefined; | ||
@@ -26,16 +25,15 @@ availableLanguages?: string[] | undefined; | ||
| defaultNs: string; | ||
| staticData?: { | ||
| [key: string]: import("../../types").TreeTranslationsData | (() => Promise<import("../../types").TreeTranslationsData>); | ||
| } | undefined; | ||
| staticData?: import("./initState").TolgeeStaticData | undefined; | ||
| observerOptions: import("./observerOptions").ObserverOptionsInternal; | ||
| observerType: "invisible" | "text"; | ||
| }; | ||
| addActiveNs: (ns: FallbackNSTranslation) => void; | ||
| removeActiveNs: (ns: FallbackNSTranslation) => void; | ||
| addActiveNs: (ns: FallbackNsTranslation) => void; | ||
| removeActiveNs: (ns: FallbackNsTranslation) => void; | ||
| getRequiredNamespaces: () => string[]; | ||
| getFallbackLangs: (lang?: string) => string[]; | ||
| getFallbackNamespaces: () => string[]; | ||
| getFallbackNs: () => string[]; | ||
| getDefaultNs: (ns?: NsType) => string; | ||
| getAvailableLanguages: () => string[] | undefined; | ||
| withDefaultNs: (descriptor: CacheDescriptor) => CacheDescriptorInternal; | ||
| overrideCredentials: (credentials: DevCredentials) => void; | ||
| setObserverOptions: (options: Partial<ObserverOptions>) => void; | ||
| getObserverOptions: () => ObserverOptions; | ||
| }>; |
| export { Tolgee } from './Tolgee'; | ||
| export { RESTRICTED_ASCENDANT_ATTRIBUTE, DEVTOOLS_ID, TOLGEE_ATTRIBUTE_NAME, TOLGEE_HIGHLIGHTER_CLASS, TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE, } from './constants'; | ||
| export * from './types'; | ||
| export { getTranslateParams } from './TranslateParams'; | ||
| export { getFallback, getFallbackArray } from './Controller/State/helpers'; | ||
| export { FormatSimple } from './FormatSimple/FormatSimple'; | ||
| export * from './types/event'; |
@@ -1,2 +0,190 @@ | ||
| import { Options, TolgeeInstance } from './types'; | ||
| export declare const Tolgee: (options?: Partial<Options>) => TolgeeInstance; | ||
| import { TolgeeOptions, TolgeePlugin, DevCredentials } from './types'; | ||
| declare const TolgeeInstanceCreator: (options: TolgeeOptions) => Readonly<{ | ||
| /** | ||
| * Listen to tolgee events. | ||
| */ | ||
| on: import(".").TolgeeOn<keyof import(".").EventType>; | ||
| /** | ||
| * Listen for specific keys/namespaces changes. | ||
| */ | ||
| onKeyUpdate: (handler: import("./types").ListenerHandler<undefined>) => import("./types").ListenerSelective; | ||
| /** | ||
| * @return current language if set. | ||
| */ | ||
| getLanguage: () => string | undefined; | ||
| /** | ||
| * `pendingLanguage` represents language which is currently being loaded. | ||
| * @return current `pendingLanguage` if set. | ||
| */ | ||
| getPendingLanguage: () => string | undefined; | ||
| /** | ||
| * Change current language. | ||
| * - if not running sets `pendingLanguage`, `language` to the new value | ||
| * - if running sets `pendingLanguage` to the value, fetches necessary data and then changes `language` | ||
| * | ||
| * @return Promise which is resolved when `language` is changed. | ||
| */ | ||
| changeLanguage: (language: string) => Promise<void>; | ||
| /** | ||
| * Temporarily change translation in cache. | ||
| * @return object with revert method. | ||
| */ | ||
| changeTranslation: (descriptor: import("./types").CacheDescriptor, key: string, value: string) => { | ||
| revert: () => void; | ||
| }; | ||
| /** | ||
| * Adds namespace(s) list of active namespaces. And if tolgee is running, loads required data. | ||
| */ | ||
| addActiveNs: (ns: import("./types").FallbackNsTranslation, forget?: boolean | undefined) => Promise<void>; | ||
| /** | ||
| * Remove namespace(s) from active namespaces. | ||
| * | ||
| * Tolgee internally counts how many times was each active namespace added, | ||
| * so this method will remove namespace only if the counter goes down to 0. | ||
| */ | ||
| removeActiveNs: (ns: import("./types").FallbackNsTranslation) => void; | ||
| /** | ||
| * Manually load multiple records from `Backend` (or `DevBackend` when in dev mode) | ||
| * | ||
| * It loads data together and adds them to cache in one operation, to prevent partly loaded state. | ||
| */ | ||
| loadRecords: (descriptors: import("./types").CacheDescriptor[]) => Promise<import("./types").TranslationsFlat[]>; | ||
| /** | ||
| * Manually load record from `Backend` (or `DevBackend` when in dev mode) | ||
| */ | ||
| loadRecord: (descriptor: import("./types").CacheDescriptor) => Promise<import("./types").TranslationsFlat>; | ||
| /** | ||
| * | ||
| */ | ||
| addStaticData: (data: import("./types").TolgeeStaticData | undefined) => void; | ||
| /** | ||
| * Get record from cache. | ||
| */ | ||
| getRecord: (descriptor: import("./types").CacheDescriptor) => import("./types").TranslationsFlat | undefined; | ||
| /** | ||
| * Get all records from cache. | ||
| */ | ||
| getAllRecords: () => { | ||
| data: import("./types").TranslationsFlat; | ||
| language: string; | ||
| namespace: string; | ||
| }[]; | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if there are data that need to be fetched. | ||
| */ | ||
| isLoaded: (ns?: import("./types").FallbackNsTranslation) => boolean; | ||
| /** | ||
| * @return `true` if tolgee is loading initial data (triggered by `run`). | ||
| */ | ||
| isInitialLoading: () => boolean; | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if tolgee is loading some translations for the first time. | ||
| */ | ||
| isLoading: (ns?: import("./types").FallbackNsTranslation) => boolean; | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if tolgee is fetching some translations. | ||
| */ | ||
| isFetching: (ns?: import("./types").FallbackNsTranslation) => boolean; | ||
| /** | ||
| * @return `true` if tolgee is running. | ||
| */ | ||
| isRunning: () => boolean; | ||
| /** | ||
| * Changes internal state to running: true and loads initial files. | ||
| * Runs runnable plugins mainly Observer if present. | ||
| */ | ||
| run: () => Promise<void | undefined>; | ||
| /** | ||
| * Changes internal state to running: false and stops runnable plugins. | ||
| */ | ||
| stop: () => void; | ||
| /** | ||
| * Returns translated and formatted key. | ||
| * If Observer is present and tolgee is running, wraps result to be identifiable in the DOM. | ||
| */ | ||
| t: import("./types").TFnType<import("./types").DefaultParamType, string>; | ||
| /** | ||
| * Highlight keys that match selection. | ||
| */ | ||
| highlight: import("./types").HighlightInterface; | ||
| /** | ||
| * @return current Tolgee options. | ||
| */ | ||
| getInitialOptions: () => { | ||
| apiUrl?: string | undefined; | ||
| apiKey?: string | undefined; | ||
| projectId?: string | number | undefined; | ||
| language?: string | undefined; | ||
| defaultLanguage?: string | undefined; | ||
| availableLanguages?: string[] | undefined; | ||
| fallbackLanguage?: import("./types").FallbackLanguageOption; | ||
| ns?: string[] | undefined; | ||
| fallbackNs?: import("./types").FallbackGeneral; | ||
| defaultNs: string; | ||
| staticData?: import("./types").TolgeeStaticData | undefined; /** | ||
| * Remove namespace(s) from active namespaces. | ||
| * | ||
| * Tolgee internally counts how many times was each active namespace added, | ||
| * so this method will remove namespace only if the counter goes down to 0. | ||
| */ | ||
| observerOptions: import("./types").ObserverOptionsInternal; | ||
| observerType: "invisible" | "text"; | ||
| }; | ||
| /** | ||
| * Tolgee is in dev mode if `DevTools` plugin is used and `apiKey` + `apiUrl` are specified. | ||
| * @return `true` if tolgee is in dev mode. | ||
| */ | ||
| isDev: () => boolean; | ||
| /** | ||
| * Wraps translation if there is `Observer` plugin | ||
| */ | ||
| wrap: (params: import("./types").WrapperWrapProps) => string | undefined; | ||
| /** | ||
| * Unwrap translation | ||
| */ | ||
| unwrap: (text: string) => import("./types").Unwrapped; | ||
| /** | ||
| * Override creadentials passed on initialization | ||
| */ | ||
| overrideCredentials(credentials: DevCredentials): void; | ||
| /** | ||
| * Add tolgee plugin. | ||
| */ | ||
| addPlugin(plugin: TolgeePlugin | undefined): void; | ||
| /** | ||
| * Updates options after instance creation. Extends existing options, | ||
| * so it only changes the fields, that are listed. | ||
| * | ||
| * When called in running state, tolgee stops and runs again. | ||
| */ | ||
| updateOptions(options?: TolgeeOptions): void; | ||
| }>; | ||
| export declare type TolgeeInstance = ReturnType<typeof TolgeeInstanceCreator>; | ||
| export declare type TolgeeChainer = { | ||
| /** | ||
| * Add plugin, plugins are applied when `init` method is called. | ||
| */ | ||
| use: (plugin: TolgeePlugin | undefined) => TolgeeChainer; | ||
| /** | ||
| * Update default options before tolgee is initialized. | ||
| */ | ||
| updateDefaults: (options: TolgeeOptions) => TolgeeChainer; | ||
| /** | ||
| * Initialize tolgee options and apply plugins | ||
| * @returns tolgee instance | ||
| */ | ||
| init(options?: TolgeeOptions): TolgeeInstance; | ||
| }; | ||
| /** | ||
| * Tolgee chainable constructor. | ||
| * | ||
| * Usage: | ||
| * ``` | ||
| * const tolgee = Tolgee().use(...).init(...) | ||
| * ``` | ||
| */ | ||
| export declare const Tolgee: () => TolgeeChainer; | ||
| export {}; |
@@ -1,20 +0,34 @@ | ||
| import type { Options } from './Controller/State/initState'; | ||
| import type { ObserverOptions } from './Controller/State/initObserverOptions'; | ||
| export type { State, Options } from './Controller/State/initState'; | ||
| export type { ObserverOptions, ModifierKey, } from './Controller/State/initObserverOptions'; | ||
| import { TolgeeInstance } from './Tolgee'; | ||
| export type { TolgeeChainer, TolgeeInstance } from './Tolgee'; | ||
| import type { ObserverOptionsInternal } from './Controller/State/observerOptions'; | ||
| export type { State, TolgeeOptions, TolgeeOptionsInternal, TolgeeStaticData, } from './Controller/State/initState'; | ||
| export type { ObserverOptions, ObserverOptionsInternal, ModifierKey, } from './Controller/State/observerOptions'; | ||
| export type { EventEmitterInstance } from './Controller/Events/EventEmitter'; | ||
| export type { EventEmitterSelectiveInstance } from './Controller/Events/EventEmitterSelective'; | ||
| export declare type PluginTools = Readonly<{ | ||
| setFinalFormatter: (formatter: FinalFormatterInterface | undefined) => void; | ||
| addFormatter: (formatter: FormatterInterface | undefined) => void; | ||
| setObserver: (observer: ObserverInterface | undefined) => void; | ||
| hasObserver: () => boolean; | ||
| setUi: (ui: UiLibInterface | undefined) => void; | ||
| hasUi: () => boolean; | ||
| addBackend: (backend: BackendInterface | undefined) => void; | ||
| setDevBackend: (backend: BackendInterface | undefined) => void; | ||
| setLanguageDetector: (languageDetector: LanguageDetectorInterface | undefined) => void; | ||
| setLanguageStorage: (languageStorage: LanguageStorageInterface | undefined) => void; | ||
| onPrepare: (callback: () => void) => void; | ||
| }>; | ||
| export declare type TolgeePlugin = (tolgee: TolgeeInstance, tools: PluginTools) => TolgeeInstance; | ||
| export declare type FallbackGeneral = undefined | false | string | string[]; | ||
| export declare type FallbackNS = FallbackGeneral; | ||
| export declare type FallbackNs = FallbackGeneral; | ||
| export declare type NsType = string; | ||
| export declare type KeyType = string; | ||
| export declare type FallbackNSTranslation = undefined | NsType | NsType[]; | ||
| export declare type FallbackNsTranslation = undefined | NsType | NsType[]; | ||
| export declare type FallbackLanguage = FallbackGeneral; | ||
| export declare type FallbackLanguageObject = Record<string, FallbackLanguage>; | ||
| export declare type FallbackLanguageOption = FallbackLanguage | FallbackLanguageObject; | ||
| export declare type TranslateOptions<T> = { | ||
| ns?: FallbackNSTranslation; | ||
| export declare type TranslateOptions = { | ||
| ns?: NsType; | ||
| noWrap?: boolean; | ||
| orEmpty?: boolean; | ||
| params?: TranslateParams<T>; | ||
| }; | ||
@@ -24,6 +38,8 @@ export declare type TranslateProps<T = DefaultParamType> = { | ||
| defaultValue?: string; | ||
| } & TranslateOptions<T>; | ||
| params?: TranslateParams<T>; | ||
| } & TranslateOptions; | ||
| export declare type TranslatePropsInternal = TranslateProps & { | ||
| translation?: string; | ||
| }; | ||
| export declare type KeyAndNamespacesInternal = Pick<TranslatePropsInternal, 'key' | 'ns'>; | ||
| export declare type TranslationValue = string | undefined | null; | ||
@@ -50,3 +66,3 @@ export declare type TranslationsFlat = Map<string, TranslationValue>; | ||
| defaultValue?: string; | ||
| ns?: FallbackNSTranslation; | ||
| ns?: NsType; | ||
| }; | ||
@@ -62,4 +78,4 @@ export declare type Unwrapped = { | ||
| }; | ||
| export declare type CombinedOptions<T> = TranslateOptions<T> & { | ||
| [key: string]: T | PropType<TranslateOptions<T>>; | ||
| export declare type CombinedOptions<T> = TranslateOptions & { | ||
| [key: string]: T | PropType<TranslateOptions>; | ||
| }; | ||
@@ -98,7 +114,8 @@ export declare type TFnType<T = DefaultParamType, R = string> = { | ||
| onClick: TranslationOnClick; | ||
| options: ObserverOptions; | ||
| options: ObserverOptionsInternal; | ||
| }; | ||
| export declare type HighlightInterface = (key?: string, ns?: FallbackNSTranslation) => { | ||
| export declare type Highlighter = { | ||
| unhighlight(): void; | ||
| }; | ||
| export declare type HighlightInterface = (key?: string, ns?: FallbackNsTranslation) => Highlighter; | ||
| export declare type ObserverRunProps = { | ||
@@ -129,2 +146,3 @@ mouseHighlight: boolean; | ||
| apiKey?: string; | ||
| projectId?: string | number; | ||
| }; | ||
@@ -134,3 +152,3 @@ export declare type BackendDevProps = { | ||
| apiKey?: string; | ||
| projectId?: number; | ||
| projectId?: number | string; | ||
| }; | ||
@@ -149,58 +167,2 @@ export declare type BackendGetRecordProps = { | ||
| }; | ||
| export declare type TolgeeEvent = 'pendingLanguage' | 'language' | 'key' | 'loading' | 'fetching' | 'initialLoad' | 'running' | 'cache' | 'keyUpdate'; | ||
| export declare type TolgeeOn = { | ||
| (event: 'pendingLanguage', handler: ListenerHandler<string>): Listener; | ||
| (event: 'language', handler: ListenerHandler<string>): Listener; | ||
| (event: 'key', handler: ListenerHandler<string>): Listener; | ||
| (event: 'loading', handler: ListenerHandler<boolean>): Listener; | ||
| (event: 'fetching', handler: ListenerHandler<boolean>): Listener; | ||
| (event: 'initialLoad', handler: ListenerHandler<void>): Listener; | ||
| (event: 'running', handler: ListenerHandler<boolean>): Listener; | ||
| (event: 'keyUpdate', handler: ListenerHandler<void>): Listener; | ||
| (event: TolgeeEvent, handler: ListenerHandler<any>): Listener; | ||
| }; | ||
| export declare type TolgeeInstance = Readonly<{ | ||
| on: TolgeeOn; | ||
| onKeyUpdate: (handler: ListenerHandler<void>) => ListenerSelective; | ||
| use: (plugin: TolgeePlugin | undefined) => TolgeeInstance; | ||
| getLanguage: () => string | undefined; | ||
| getPendingLanguage: () => string | undefined; | ||
| changeLanguage: (language: string) => Promise<void>; | ||
| changeTranslation: ChangeTranslationInterface; | ||
| addActiveNs: (ns: FallbackNSTranslation, forget?: boolean) => Promise<void>; | ||
| removeActiveNs: (ns: FallbackNSTranslation) => void; | ||
| loadRecords: (descriptors: CacheDescriptor[]) => Promise<TranslationsFlat[]>; | ||
| loadRecord: (descriptors: CacheDescriptor) => Promise<TranslationsFlat>; | ||
| addStaticData: (data: Options['staticData']) => void; | ||
| getRecord: (descriptor: CacheDescriptor) => TranslationsFlat | undefined; | ||
| getAllRecords: () => CachePublicRecord[]; | ||
| isInitialLoading: () => boolean; | ||
| isLoading: (ns?: FallbackNSTranslation) => boolean; | ||
| isLoaded: (ns?: FallbackNSTranslation) => boolean; | ||
| isFetching: (ns?: FallbackNSTranslation) => boolean; | ||
| isRunning: () => boolean; | ||
| highlight: HighlightInterface; | ||
| getInitialOptions: () => Options; | ||
| isDev: () => boolean; | ||
| init: (options: Partial<Options>) => TolgeeInstance; | ||
| run: () => Promise<void>; | ||
| stop: () => void; | ||
| t: TFnType; | ||
| wrap: (params: TranslatePropsInternal) => string | undefined; | ||
| unwrap: (text: string) => Unwrapped; | ||
| setObserverOptions: (options: Partial<ObserverOptions>) => TolgeeInstance; | ||
| }>; | ||
| export declare type PluginServicePublic = Readonly<{ | ||
| setFinalFormatter: (formatter: FinalFormatterInterface | undefined) => void; | ||
| addFormatter: (formatter: FormatterInterface | undefined) => void; | ||
| setObserver: (observer: ObserverInterface | undefined) => void; | ||
| hasObserver: () => boolean; | ||
| setUi: (ui: UiLibInterface | undefined) => void; | ||
| hasUi: () => boolean; | ||
| addBackend: (backend: BackendInterface | undefined) => void; | ||
| setDevBackend: (backend: BackendInterface | undefined) => void; | ||
| setLanguageDetector: (languageDetector: LanguageDetectorInterface | undefined) => void; | ||
| setLanguageStorage: (languageStorage: LanguageStorageInterface | undefined) => void; | ||
| overrideCredentials: (credentials: DevCredentials) => void; | ||
| }>; | ||
| export declare type NodeMeta = { | ||
@@ -230,8 +192,10 @@ oldTextContent: string; | ||
| }; | ||
| export declare type ChangeTranslationInterface = (descriptor: CacheDescriptor, key: string, value: string) => { | ||
| export declare type TranslationChanger = { | ||
| revert: () => void; | ||
| }; | ||
| export declare type ChangeTranslationInterface = (descriptor: CacheDescriptor, key: string, value: string) => TranslationChanger; | ||
| export declare type UiProps = { | ||
| apiUrl: string; | ||
| apiKey: string; | ||
| projectId: number | string | undefined; | ||
| highlight: HighlightInterface; | ||
@@ -251,12 +215,7 @@ changeTranslation: ChangeTranslationInterface; | ||
| defaultValue?: string; | ||
| ns: FallbackNSTranslation; | ||
| ns: string[]; | ||
| translation: string | undefined; | ||
| }; | ||
| export declare type KeyWithDefault = { | ||
| key: string; | ||
| defaultValue?: string; | ||
| ns: FallbackNSTranslation; | ||
| }; | ||
| export declare type TranslationOnClick = (event: MouseEvent, data: { | ||
| keysAndDefaults: KeyWithDefault[]; | ||
| keysAndDefaults: KeyAndParams[]; | ||
| el: Element; | ||
@@ -274,10 +233,14 @@ meta: ElementMeta; | ||
| key: string; | ||
| ns?: string | string[]; | ||
| ns?: NsType | undefined; | ||
| }; | ||
| export declare type ListenerSelective = { | ||
| unsubscribe: () => void; | ||
| subscribeNs: (ns: FallbackNSTranslation) => ListenerSelective; | ||
| unsubscribeNs: (ns: FallbackNSTranslation) => ListenerSelective; | ||
| /** | ||
| * Subscribes to namespace(s) (if not specified to defaultNs) | ||
| */ | ||
| subscribeNs: (ns?: FallbackNsTranslation) => ListenerSelective; | ||
| /** | ||
| * Subscribes to namespace (if not specified to defaultNs) | ||
| */ | ||
| subscribeKey: (descriptor: KeyDescriptor) => ListenerSelective; | ||
| unsubscribeKey: (descriptor: KeyDescriptor) => ListenerSelective; | ||
| }; | ||
@@ -288,3 +251,2 @@ export declare type ListenerHandlerEvent<T> = { | ||
| export declare type ListenerHandler<T> = (e: ListenerHandlerEvent<T>) => void; | ||
| export declare type TolgeePlugin = (tolgee: TolgeeInstance, tools: PluginServicePublic) => TolgeeInstance; | ||
| export declare type CachePublicRecord = { | ||
@@ -291,0 +253,0 @@ data: TranslationsFlat; |
| { | ||
| "name": "@tolgee/core", | ||
| "version": "4.9.3-rc.e39950d.0", | ||
| "version": "4.9.4-rc.6a51a7a.0", | ||
| "description": "Library providing ability to translate messages directly in context of developed application.", | ||
@@ -52,2 +52,3 @@ "main": "./dist/tolgee.cjs.js", | ||
| "concurrently": "7.3.0", | ||
| "intl-messageformat": "^9.9.1", | ||
| "jest": "^27.2.4", | ||
@@ -65,3 +66,3 @@ "jest-fetch-mock": "^3.0.3", | ||
| }, | ||
| "gitHead": "f3fdf65fcb985f8deac4de8b3e0834d957da7474" | ||
| "gitHead": "5a3d6bb6836cf248ee2546482a6d0236d8ba0e28" | ||
| } |
@@ -44,3 +44,3 @@ import { Tolgee } from '../Tolgee'; | ||
| tolgee.stop(); | ||
| tolgee.init({ apiUrl: 'asdfasdf', apiKey: 'test' }); | ||
| tolgee.overrideCredentials({ apiUrl: 'asdfasdf', apiKey: 'test' }); | ||
| await tolgee.run(); | ||
@@ -47,0 +47,0 @@ expect(tolgee.t({ key: 'cancel', ns: 'common' })).toEqual('Dev'); |
@@ -1,3 +0,3 @@ | ||
| import { Tolgee } from '../Tolgee'; | ||
| import { TolgeeInstance, TolgeePlugin, TreeTranslationsData } from '../types'; | ||
| import { Tolgee, TolgeeInstance } from '../Tolgee'; | ||
| import { TolgeePlugin, TreeTranslationsData } from '../types'; | ||
| import { resolvablePromise } from './testTools'; | ||
@@ -16,3 +16,3 @@ | ||
| (tolgee, tools) => { | ||
| tolgee.init({ apiKey: 'test', apiUrl: 'test' }); | ||
| tolgee.updateOptions({ apiKey: 'test', apiUrl: 'test' }); | ||
| tools.setDevBackend({ | ||
@@ -28,2 +28,12 @@ getRecord({ language, namespace }) { | ||
| const DevToolsThrow = (): TolgeePlugin => (tolgee, tools) => { | ||
| tolgee.updateOptions({ apiKey: 'test', apiUrl: 'test' }); | ||
| tools.setDevBackend({ | ||
| getRecord() { | ||
| return Promise.reject(); | ||
| }, | ||
| }); | ||
| return tolgee; | ||
| }; | ||
| describe('cache', () => { | ||
@@ -33,3 +43,3 @@ let tolgee: TolgeeInstance; | ||
| beforeEach(async () => { | ||
| tolgee = Tolgee({ | ||
| tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -64,3 +74,3 @@ staticData: { | ||
| expect(tolgee.t('test.sub')).toEqual('subtestEn'); | ||
| tolgee.use(DevToolsPlugin()); | ||
| tolgee.addPlugin(DevToolsPlugin()); | ||
| await tolgee.run(); | ||
@@ -77,3 +87,3 @@ expect(tolgee.t('test.sub')).toEqual('en.default'); | ||
| expect(tolgee.t('test.sub')).toEqual('subtestEn'); | ||
| tolgee.use(DevToolsPlugin()); | ||
| tolgee.addPlugin(DevToolsPlugin()); | ||
| expect(tolgee.t('test.sub')).toEqual('subtestEn'); | ||
@@ -91,6 +101,6 @@ | ||
| it('works with switching to different dev backend', async () => { | ||
| tolgee.use(DevToolsPlugin()); | ||
| tolgee.addPlugin(DevToolsPlugin()); | ||
| await tolgee.run(); | ||
| expect(tolgee.t('test.sub')).toEqual('en.default'); | ||
| tolgee.use(DevToolsPlugin('.new')); | ||
| tolgee.addPlugin(DevToolsPlugin('.new')); | ||
| expect(tolgee.t('test.sub')).toEqual('en.default'); | ||
@@ -102,2 +112,14 @@ | ||
| it('keeps data when dev backend throws', async () => { | ||
| const keyUpdateHandler = jest.fn(); | ||
| tolgee.on('keyUpdate', keyUpdateHandler); | ||
| await tolgee.run(); | ||
| expect(keyUpdateHandler).toBeCalledTimes(1); | ||
| expect(tolgee.t('test.sub')).toEqual('subtestEn'); | ||
| tolgee.addPlugin(DevToolsThrow()); | ||
| await waitForInitialLoad(tolgee); | ||
| expect(keyUpdateHandler).toBeCalledTimes(2); | ||
| expect(tolgee.t('test.sub')).toEqual('subtestEn'); | ||
| }); | ||
| it('updates initial data correctly', async () => { | ||
@@ -111,3 +133,3 @@ await tolgee.run(); | ||
| it('ignores new initial data when already in dev mode', async () => { | ||
| tolgee.use(DevToolsPlugin()); | ||
| tolgee.addPlugin(DevToolsPlugin()); | ||
| await tolgee.run(); | ||
@@ -125,3 +147,3 @@ expect(tolgee.t('test.sub')).toEqual('en.default'); | ||
| it('fetching works with namespaces', async () => { | ||
| tolgee.use(DevToolsPlugin()); | ||
| tolgee.addPlugin(DevToolsPlugin()); | ||
| const runPromise = tolgee.run(); | ||
@@ -140,5 +162,22 @@ expect(tolgee.isFetching()).toBeTruthy(); | ||
| it('works with namespaces containing colon', async () => { | ||
| const [promiseEn, resolveEn] = resolvablePromise<TreeTranslationsData>(); | ||
| tolgee.updateOptions({ | ||
| language: 'en', | ||
| staticData: { | ||
| 'en:common:test': () => promiseEn, | ||
| }, | ||
| }); | ||
| await tolgee.run(); | ||
| expect(tolgee.t('test.sub', { ns: 'common:test' })).toEqual('test.sub'); | ||
| const nsPromise = tolgee.addActiveNs('common:test'); | ||
| expect(tolgee.isLoading('common:test')).toBeTruthy(); | ||
| resolveEn({ test: { sub: 'Test' } }); | ||
| await nsPromise; | ||
| expect(tolgee.t('test.sub', { ns: 'common:test' })).toEqual('Test'); | ||
| }); | ||
| it("pending requests won't rewrite cache when reinitialized", async () => { | ||
| const [promiseEn, resolveEn] = resolvablePromise<TreeTranslationsData>(); | ||
| tolgee = Tolgee({ | ||
| tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -151,3 +190,3 @@ staticData: { | ||
| await Promise.resolve(); | ||
| tolgee.use(DevToolsPlugin()); | ||
| tolgee.addPlugin(DevToolsPlugin()); | ||
| await waitForInitialLoad(tolgee); | ||
@@ -154,0 +193,0 @@ expect(tolgee.t('test.sub')).toEqual('en.default'); |
@@ -14,3 +14,3 @@ import { Tolgee } from '../index'; | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -17,0 +17,0 @@ ns: ['common'], |
@@ -5,3 +5,3 @@ import { Tolgee } from '../index'; | ||
| it('emits language change event', async () => { | ||
| const tolgee = Tolgee({ language: 'en' }); | ||
| const tolgee = Tolgee().init({ language: 'en' }); | ||
| const handler = jest.fn((lang) => {}); | ||
@@ -14,3 +14,3 @@ tolgee.on('language', handler); | ||
| it('correctly emits translation change listeners', async () => { | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -17,0 +17,0 @@ staticData: { |
@@ -14,3 +14,3 @@ import { Tolgee } from '../index'; | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -52,3 +52,3 @@ ns: ['common'], | ||
| it("won't start loading when nothing to load", async () => { | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -77,3 +77,3 @@ staticData: { | ||
| it('emits keyUpdate on initialLoad', async () => { | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -80,0 +80,0 @@ staticData: { en: { hello: 'world' } }, |
@@ -6,3 +6,3 @@ import { Tolgee, TreeTranslationsData } from '../index'; | ||
| it('changes language', async () => { | ||
| const tolgee = Tolgee({ language: 'en' }); | ||
| const tolgee = Tolgee().init({ language: 'en' }); | ||
| expect(tolgee.getLanguage()).toEqual('en'); | ||
@@ -14,3 +14,3 @@ await tolgee.changeLanguage('es'); | ||
| it('returns correct translation', async () => { | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -29,3 +29,3 @@ staticData: { en: { hello: 'World' }, es: { hello: 'Mundo' } }, | ||
| const [promiseEs, resolveEs] = resolvablePromise<TreeTranslationsData>(); | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -59,3 +59,3 @@ staticData: { | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'es', | ||
@@ -102,3 +102,3 @@ staticData: { | ||
| it('will fallback to default value', () => { | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| defaultLanguage: 'en', | ||
@@ -113,6 +113,24 @@ }); | ||
| it('will throw error when no language specified', () => { | ||
| const tolgee = Tolgee({}); | ||
| const tolgee = Tolgee().init({}); | ||
| expect(() => tolgee.run()).toThrow(/'language'/); | ||
| }); | ||
| it('loads fallback languages and namespaces', async () => { | ||
| const loadNs = jest.fn(() => Promise.resolve(undefined as any)); | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
| fallbackNs: ['fallback'], | ||
| staticData: { | ||
| en: loadNs, | ||
| 'en:fallback': loadNs, | ||
| cs: loadNs, | ||
| 'cs:fallback': loadNs, | ||
| }, | ||
| }); | ||
| tolgee.run(); | ||
| expect(loadNs).toBeCalledTimes(2); | ||
| await tolgee.changeLanguage('cs'); | ||
| expect(loadNs).toBeCalledTimes(4); | ||
| }); | ||
| }); |
@@ -10,3 +10,3 @@ import { Tolgee, TreeTranslationsData } from '../index'; | ||
| const onFetchingHandler = jest.fn(() => {}); | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -13,0 +13,0 @@ staticData: { |
@@ -11,5 +11,6 @@ import { Tolgee } from '../index'; | ||
| return Tolgee({ | ||
| return Tolgee().init({ | ||
| language: 'en', | ||
| ns: ['common'], | ||
| defaultNs: 'common', | ||
| staticData: { | ||
@@ -26,3 +27,3 @@ 'en:common': promiseEnCommon, | ||
| it('returns correct translation from namespace', () => { | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -40,3 +41,3 @@ staticData: { | ||
| it('uses defaultNs', async () => { | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
@@ -82,5 +83,5 @@ defaultNs: 'common', | ||
| const tolgee = tolgeeWithNamespaces(); | ||
| await tolgee.run(); | ||
| const handler = jest.fn(); | ||
| tolgee.on('cache', handler); | ||
| await tolgee.run(); | ||
@@ -91,3 +92,3 @@ expect(tolgee.t({ key: 'cancel', ns: 'common' })).toEqual('Cancel'); | ||
| await tolgee.addActiveNs('test'); | ||
| expect(handler).toBeCalledTimes(1); | ||
| expect(handler).toBeCalledTimes(2); | ||
@@ -99,3 +100,3 @@ expect(tolgee.t({ key: 'cancel', ns: 'common' })).toEqual('Cancel'); | ||
| await tolgee.changeLanguage('es'); | ||
| expect(handler).toBeCalledTimes(2); | ||
| expect(handler).toBeCalledTimes(3); | ||
@@ -102,0 +103,0 @@ expect(tolgee.t({ key: 'cancel', ns: 'common' })).toEqual('Cancellar'); |
@@ -9,11 +9,7 @@ import { Tolgee } from '../Tolgee'; | ||
| WrapperWrapFunction, | ||
| ObserverOptions, | ||
| } from '../types'; | ||
| const testObserver = | ||
| ( | ||
| outputNotFormattable: boolean, | ||
| onCreate?: (options: ObserverOptions) => void | ||
| ): ObserverInterface => | ||
| ({ options }) => { | ||
| (outputNotFormattable: boolean): ObserverInterface => | ||
| () => { | ||
| const wrap: WrapperWrapFunction = ({ key, translation }) => { | ||
@@ -32,4 +28,2 @@ return `${key}|${translation}`; | ||
| onCreate?.(options); | ||
| return Object.freeze({ | ||
@@ -65,8 +59,5 @@ wrap, | ||
| const observerPlugin = | ||
| ( | ||
| outputNotFormattable: boolean, | ||
| onCreate?: (options: ObserverOptions) => void | ||
| ): TolgeePlugin => | ||
| (outputNotFormattable: boolean): TolgeePlugin => | ||
| (tolgee, tools) => { | ||
| tools.setObserver(testObserver(outputNotFormattable, onCreate)); | ||
| tools.setObserver(testObserver(outputNotFormattable)); | ||
| return tolgee; | ||
@@ -84,11 +75,11 @@ }; | ||
| it('wraps and formats translation', () => { | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
| staticData: { en: { hello: 'world' } }, | ||
| }); | ||
| tolgee.use(observerPlugin(false)); | ||
| tolgee.addPlugin(observerPlugin(false)); | ||
| tolgee.run(); | ||
| expect(tolgee.t({ key: 'hello' })).toEqual('hello|world'); | ||
| tolgee.use(formattersPlugin); | ||
| tolgee.addPlugin(formattersPlugin); | ||
| expect(tolgee.t({ key: 'hello' })).toEqual({ final: '(2(1hello|world))' }); | ||
@@ -99,11 +90,11 @@ tolgee.stop(); | ||
| it("won't format when observer doesn't return formattable text", () => { | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
| staticData: { en: { hello: 'world' } }, | ||
| }); | ||
| tolgee.use(observerPlugin(true)); | ||
| tolgee.addPlugin(observerPlugin(true)); | ||
| tolgee.run(); | ||
| expect(tolgee.t({ key: 'hello' })).toEqual('hello|world'); | ||
| tolgee.use(formattersPlugin); | ||
| tolgee.addPlugin(formattersPlugin); | ||
| expect(tolgee.t({ key: 'hello' })).toEqual('hello|world'); | ||
@@ -114,7 +105,7 @@ tolgee.stop(); | ||
| it("won't wrap before run", () => { | ||
| const tolgee = Tolgee({ | ||
| const tolgee = Tolgee().init({ | ||
| language: 'en', | ||
| staticData: { en: { hello: 'world' } }, | ||
| }); | ||
| tolgee.use(observerPlugin(false)); | ||
| tolgee.addPlugin(observerPlugin(false)); | ||
| expect(tolgee.t({ key: 'hello' })).toEqual('world'); | ||
@@ -124,20 +115,2 @@ tolgee.run(); | ||
| }); | ||
| it('observer recieves options', () => { | ||
| const tolgee = Tolgee({ | ||
| language: 'en', | ||
| staticData: { en: { hello: 'world' } }, | ||
| }); | ||
| const restrictedElements = ['test']; | ||
| tolgee.setObserverOptions({ | ||
| restrictedElements, | ||
| }); | ||
| const onCreate = jest.fn(); | ||
| tolgee.use(observerPlugin(false, onCreate)); | ||
| tolgee.run(); | ||
| expect(onCreate).toBeCalledTimes(1); | ||
| expect(onCreate.mock.calls[0][0].restrictedElements).toEqual( | ||
| restrictedElements | ||
| ); | ||
| }); | ||
| }); |
@@ -7,4 +7,3 @@ import { | ||
| EventEmitterInstance, | ||
| FallbackNSTranslation, | ||
| Options, | ||
| FallbackNsTranslation, | ||
| TranslationsFlat, | ||
@@ -16,3 +15,4 @@ TranslationValue, | ||
| } from '../../types'; | ||
| import { getFallbackArray } from '../State/helpers'; | ||
| import { getFallbackArray, unique } from '../State/helpers'; | ||
| import { TolgeeStaticData } from '../State/initState'; | ||
| import { ValueObserverInstance } from '../ValueObserver'; | ||
@@ -40,6 +40,6 @@ | ||
| const cache: StateCache = new Map(); | ||
| let staticData: NonNullable<Options['staticData']> = {}; | ||
| let staticData: NonNullable<TolgeeStaticData> = {}; | ||
| let version = 0; | ||
| function addStaticData(data: Options['staticData']) { | ||
| function addStaticData(data: TolgeeStaticData | undefined) { | ||
| if (data) { | ||
@@ -111,7 +111,7 @@ staticData = { ...staticData, ...data }; | ||
| if (value !== undefined && value !== null) { | ||
| return namespace; | ||
| return [namespace]; | ||
| } | ||
| } | ||
| } | ||
| return Array.from(new Set(namespaces)); | ||
| return unique(namespaces); | ||
| } | ||
@@ -147,3 +147,3 @@ | ||
| function isFetching(ns?: FallbackNSTranslation) { | ||
| function isFetching(ns?: FallbackNsTranslation) { | ||
| if (isInitialLoading()) { | ||
@@ -164,3 +164,3 @@ return true; | ||
| function isLoading(language: string | undefined, ns?: FallbackNSTranslation) { | ||
| function isLoading(language: string | undefined, ns?: FallbackNsTranslation) { | ||
| const namespaces = getFallbackArray(ns); | ||
@@ -198,6 +198,2 @@ | ||
| if (!dataPromise) { | ||
| // return empty data, so we know it has already been attempted to fetch | ||
| dataPromise = Promise.resolve({}); | ||
| } | ||
| return dataPromise; | ||
@@ -240,3 +236,4 @@ } | ||
| } | ||
| const dataPromise = fetchData(keyObject, isDev); | ||
| const dataPromise = | ||
| fetchData(keyObject, isDev) || Promise.resolve(undefined); | ||
| asyncRequests.set(cacheKey, dataPromise); | ||
@@ -265,2 +262,5 @@ return { | ||
| addRecord(value.keyObject, data); | ||
| } else if (!getRecord(value.keyObject)) { | ||
| // if no data exist, put empty object | ||
| addRecord(value.keyObject, {}); | ||
| } | ||
@@ -267,0 +267,0 @@ } |
@@ -24,3 +24,5 @@ import { CacheDescriptorInternal, TreeTranslationsData } from '../../types'; | ||
| export const decodeCacheKey = (key: string): CacheDescriptorInternal => { | ||
| const [firstPart, secondPart] = key.split(':'); | ||
| const [firstPart, ...rest] = key.split(':'); | ||
| // if namespaces contains ":" it won't get lost | ||
| const secondPart = rest.join(':'); | ||
| return { language: firstPart, namespace: secondPart || '' }; | ||
@@ -27,0 +29,0 @@ }; |
| import { Events } from './Events/Events'; | ||
| import { | ||
| CacheDescriptor, | ||
| FallbackNSTranslation, | ||
| Options, | ||
| FallbackNsTranslation, | ||
| TolgeeOptions, | ||
| TFnType, | ||
| TranslatePropsInternal, | ||
| NsType, | ||
| KeyAndNamespacesInternal, | ||
| } from '../types'; | ||
@@ -18,7 +19,7 @@ import { Cache } from './Cache/Cache'; | ||
| type StateServiceProps = { | ||
| options?: Partial<Options>; | ||
| options?: Partial<TolgeeOptions>; | ||
| }; | ||
| export const Controller = ({ options }: StateServiceProps) => { | ||
| const events = Events(getFallbackNamespaces); | ||
| const events = Events(getFallbackNs, getDefaultNs); | ||
| const fetchingObserver = ValueObserver<boolean>( | ||
@@ -44,3 +45,2 @@ false, | ||
| state.getInitialOptions, | ||
| state.getObserverOptions, | ||
| state.getAvailableLanguages, | ||
@@ -72,2 +72,25 @@ getTranslationNs, | ||
| function getFallbackNs() { | ||
| return state.getFallbackNs(); | ||
| } | ||
| function getDefaultNs(ns?: NsType) { | ||
| return state.getDefaultNs(ns); | ||
| } | ||
| // gets all namespaces where translation could be located | ||
| // takes (ns|default, fallback ns) | ||
| function getDefaultAndFallbackNs(ns?: NsType) { | ||
| return [...getFallbackArray(getDefaultNs(ns)), ...getFallbackNs()]; | ||
| } | ||
| // gets all namespaces which need to be loaded | ||
| // takes (ns|default, initial ns, fallback ns, active ns) | ||
| function getRequiredNamespaces(ns: FallbackNsTranslation) { | ||
| return [ | ||
| ...getFallbackArray(ns || getDefaultNs()), | ||
| ...state.getRequiredNamespaces(), | ||
| ]; | ||
| } | ||
| function changeTranslation( | ||
@@ -88,7 +111,3 @@ descriptor: CacheDescriptor, | ||
| function getFallbackNamespaces() { | ||
| return state.getFallbackNamespaces(); | ||
| } | ||
| function init(options: Partial<Options>) { | ||
| function init(options: Partial<TolgeeOptions>) { | ||
| state.init(options); | ||
@@ -98,3 +117,3 @@ cache.addStaticData(state.getInitialOptions().staticData); | ||
| function isLoading(ns?: FallbackNSTranslation) { | ||
| function isLoading(ns?: FallbackNsTranslation) { | ||
| return cache.isLoading(state.getLanguage()!, ns); | ||
@@ -105,9 +124,7 @@ } | ||
| return Boolean( | ||
| state.getInitialOptions().apiKey && | ||
| state.getInitialOptions().apiUrl && | ||
| pluginService.getDevBackend() | ||
| state.getInitialOptions().apiKey && state.getInitialOptions().apiUrl | ||
| ); | ||
| } | ||
| async function addActiveNs(ns: FallbackNSTranslation, forget?: boolean) { | ||
| async function addActiveNs(ns: FallbackNsTranslation, forget?: boolean) { | ||
| if (!forget) { | ||
@@ -121,6 +138,5 @@ state.addActiveNs(ns); | ||
| function getRequiredRecords(lang?: string, ns?: FallbackNSTranslation) { | ||
| function getRequiredRecords(lang?: string, ns?: FallbackNsTranslation) { | ||
| const languages = state.getFallbackLangs(lang); | ||
| const namespaces = | ||
| ns !== undefined ? getFallbackArray(ns) : state.getRequiredNamespaces(); | ||
| const namespaces = getRequiredNamespaces(ns); | ||
| const result: CacheDescriptor[] = []; | ||
@@ -137,3 +153,3 @@ languages.forEach((language) => { | ||
| function isLoaded(ns?: FallbackNSTranslation) { | ||
| function isLoaded(ns?: FallbackNsTranslation) { | ||
| const language = state.getLanguage(); | ||
@@ -144,4 +160,3 @@ if (!language) { | ||
| const languages = state.getFallbackLangs(language); | ||
| const namespaces = | ||
| ns !== undefined ? getFallbackArray(ns) : state.getRequiredNamespaces(); | ||
| const namespaces = getRequiredNamespaces(ns); | ||
| const result: CacheDescriptor[] = []; | ||
@@ -158,3 +173,3 @@ languages.forEach((language) => { | ||
| function loadRequiredRecords(lang?: string, ns?: FallbackNSTranslation) { | ||
| function loadRequiredRecords(lang?: string, ns?: FallbackNsTranslation) { | ||
| const descriptors = getRequiredRecords(lang, ns); | ||
@@ -187,18 +202,10 @@ if (descriptors.length) { | ||
| function getTranslationNs({ | ||
| key, | ||
| ns, | ||
| }: Pick<TranslatePropsInternal, 'key' | 'ns'>) { | ||
| const namespaces = | ||
| ns !== undefined ? getFallbackArray(ns) : state.getFallbackNamespaces(); | ||
| function getTranslationNs({ key, ns }: KeyAndNamespacesInternal) { | ||
| const languages = state.getFallbackLangs(); | ||
| const namespaces = getDefaultAndFallbackNs(ns); | ||
| return cache.getTranslationNs(namespaces, languages, key); | ||
| } | ||
| function getTranslation({ | ||
| key, | ||
| ns, | ||
| }: Pick<TranslatePropsInternal, 'key' | 'ns'>) { | ||
| const namespaces = | ||
| ns !== undefined ? getFallbackArray(ns) : state.getFallbackNamespaces(); | ||
| function getTranslation({ key, ns }: KeyAndNamespacesInternal) { | ||
| const namespaces = getDefaultAndFallbackNs(ns); | ||
| const languages = state.getFallbackLangs(); | ||
@@ -309,3 +316,2 @@ return cache.getTranslationFallback(namespaces, languages, key); | ||
| addActiveNs, | ||
| loadRequiredRecords, | ||
| loadRecords, | ||
@@ -312,0 +318,0 @@ loadRecord, |
| import { EventEmitterSelective } from './EventEmitterSelective'; | ||
| describe('event emitter selective', () => { | ||
| it('handles correctly fallback namespaces', () => { | ||
| const emitter = EventEmitterSelective(() => ['a', 'b']); | ||
| it('handles correctly default namespace', () => { | ||
| const emitter = EventEmitterSelective( | ||
| () => [], | ||
| () => 'default' | ||
| ); | ||
| const handler = jest.fn(); | ||
| const listener = emitter.listenSome(handler); | ||
| // subscribe to fallback namespaces | ||
| listener.subscribeKey({ key: 'test' }); | ||
| // subscribe to default ns | ||
| listener.subscribeNs(); | ||
| // emmit | ||
| emitter.emit({ key: 'test' }); | ||
| emitter.emit({ ns: ['a'] }); | ||
| emitter.emit({ ns: ['default'] }); | ||
| // should be ignored | ||
@@ -21,4 +24,7 @@ emitter.emit({ ns: ['c'] }); | ||
| it('subscribes to key', () => { | ||
| const emitter = EventEmitterSelective(() => ['']); | ||
| it('subscribes to key only', () => { | ||
| const emitter = EventEmitterSelective( | ||
| () => [], | ||
| () => '' | ||
| ); | ||
| const handler = jest.fn(); | ||
@@ -38,3 +44,6 @@ const listener = emitter.listenSome(handler); | ||
| it('subscribes to key with namespaces', () => { | ||
| const emitter = EventEmitterSelective(() => []); | ||
| const emitter = EventEmitterSelective( | ||
| () => [], | ||
| () => '' | ||
| ); | ||
| const handler = jest.fn(); | ||
@@ -44,3 +53,3 @@ const listener = emitter.listenSome(handler); | ||
| listener.subscribeKey({ key: 'test', ns: 'common' }); | ||
| listener.subscribeKey({ key: 'abcd', ns: ['test', 'abcd'] }); | ||
| listener.subscribeKey({ key: 'abcd', ns: 'test' }); | ||
@@ -50,36 +59,31 @@ emitter.emit({ key: 'youda', ns: ['common'] }); | ||
| expect(handler).toBeCalledTimes(0); | ||
| emitter.emit({ key: 'abcd', ns: ['abcd'] }); | ||
| emitter.emit({ ns: ['test'] }); | ||
| expect(handler).toBeCalledTimes(2); | ||
| expect(handler).toBeCalledTimes(1); | ||
| listener.unsubscribe(); | ||
| emitter.emit(); | ||
| expect(handler).toBeCalledTimes(2); | ||
| expect(handler).toBeCalledTimes(1); | ||
| }); | ||
| it('unsubscribes', () => { | ||
| const emitter = EventEmitterSelective(() => []); | ||
| const emitter = EventEmitterSelective( | ||
| () => [], | ||
| () => '' | ||
| ); | ||
| const handler = jest.fn(); | ||
| const listener = emitter.listenSome(handler); | ||
| const listener = emitter.listen(handler); | ||
| listener.subscribeKey({ key: 'test', ns: 'common' }); | ||
| listener.subscribeKey({ key: 'abcd', ns: ['test', 'abcd'] }); | ||
| emitter.emit(); | ||
| emitter.emit({ key: 'youda', ns: ['common'] }); | ||
| emitter.emit({ key: 'test', ns: ['youda'] }); | ||
| expect(handler).toBeCalledTimes(0); | ||
| emitter.emit({ key: 'abcd', ns: ['abcd'] }); | ||
| emitter.emit({ ns: ['test'] }); | ||
| expect(handler).toBeCalledTimes(2); | ||
| listener.unsubscribeKey({ key: 'abcd', ns: ['test', 'abcd'] }); | ||
| emitter.emit({ key: 'abcd' }); | ||
| emitter.emit({ ns: ['test'] }); | ||
| listener.unsubscribe(); | ||
| emitter.emit(); | ||
| expect(handler).toBeCalledTimes(2); | ||
| expect(handler).toBeCalledTimes(1); | ||
| }); | ||
| it('groups events correctly', async () => { | ||
| const emitter = EventEmitterSelective(() => ['test', 'opqrst']); | ||
| const emitter = EventEmitterSelective( | ||
| () => ['test', 'opqrst'], | ||
| () => '' | ||
| ); | ||
| const handler = jest.fn(); | ||
@@ -90,3 +94,3 @@ const hanlderAll = jest.fn(); | ||
| listener.subscribeKey({ key: 'abcd', ns: ['test'] }); | ||
| listener.subscribeKey({ key: 'abcd', ns: 'test' }); | ||
@@ -96,3 +100,3 @@ emitter.emit({ key: 'abcd' }, true); | ||
| await Promise.resolve(); | ||
| await new Promise((resolve) => setTimeout(resolve)); | ||
@@ -113,7 +117,10 @@ expect(hanlderAll).toBeCalledTimes(1); | ||
| it('subscribes to ns only', async () => { | ||
| const emitter = EventEmitterSelective(() => ['test', 'youda']); | ||
| it('always subscribes to fallback ns', async () => { | ||
| const emitter = EventEmitterSelective( | ||
| () => ['test', 'youda'], | ||
| () => '' | ||
| ); | ||
| const handler = jest.fn(); | ||
| const listener = emitter.listenSome(handler); | ||
| listener.subscribeNs(['test']); | ||
| listener.subscribeNs('test'); | ||
@@ -120,0 +127,0 @@ emitter.emit({ key: 'youda' }); |
| import { getFallbackArray } from '../State/helpers'; | ||
| import { | ||
| FallbackNSTranslation, | ||
| FallbackNsTranslation, | ||
| KeyDescriptor, | ||
@@ -10,27 +10,19 @@ KeyDescriptorInternal, | ||
| ListenerSelective, | ||
| NsType, | ||
| } from '../../types'; | ||
| const DEFAULT_NS = 0; | ||
| const FALLBACK_NS = 1; | ||
| type NsListType = string | typeof DEFAULT_NS | typeof FALLBACK_NS; | ||
| type HandlerWrapperType = { | ||
| fn: ListenerHandler<undefined>; | ||
| keys: Map<string, number>; | ||
| namespaces: Map<string | undefined, number>; | ||
| keys: Set<string>; | ||
| namespaces: Set<NsListType>; | ||
| }; | ||
| function incrementInMap(map: Map<any, number>, value: any) { | ||
| const currNum = map.get(value) || 0; | ||
| map.set(value, currNum + 1); | ||
| } | ||
| function decrementInMap(map: Map<any, number>, value: any) { | ||
| let currNum = map.get(value) || 1; | ||
| currNum -= 1; | ||
| if (currNum <= 0) { | ||
| map.delete(value); | ||
| } else { | ||
| map.set(value, currNum); | ||
| } | ||
| } | ||
| export const EventEmitterSelective = ( | ||
| getFallbackNamespaces: () => string[] | ||
| getFallbackNs: () => string[], | ||
| getDefaultNs: () => string | ||
| ): EventEmitterSelectiveInstance => { | ||
@@ -55,4 +47,4 @@ const listeners: Set<ListenerHandler<undefined>> = new Set(); | ||
| }, | ||
| keys: new Map<string, number>(), | ||
| namespaces: new Map<string | undefined, number>(), | ||
| keys: new Set<string>(), | ||
| namespaces: new Set<NsListType>(), | ||
| }; | ||
@@ -66,36 +58,26 @@ | ||
| }, | ||
| subscribeNs: (ns: FallbackNSTranslation) => { | ||
| subscribeNs: (ns: FallbackNsTranslation) => { | ||
| getFallbackArray(ns).forEach((val) => | ||
| incrementInMap(handlerWrapper.namespaces, val) | ||
| handlerWrapper.namespaces.add(val) | ||
| ); | ||
| return result; | ||
| }, | ||
| unsubscribeNs: (ns: FallbackNSTranslation) => { | ||
| getFallbackArray(ns).forEach((val) => | ||
| decrementInMap(handlerWrapper.namespaces, val) | ||
| ); | ||
| return result; | ||
| }, | ||
| subscribeKey: (descriptor: KeyDescriptor) => { | ||
| const { key, ns } = descriptor; | ||
| incrementInMap(handlerWrapper.keys, key); | ||
| getFallbackArray(ns).forEach((val) => | ||
| incrementInMap(handlerWrapper.namespaces, val) | ||
| ); | ||
| if (ns === undefined) { | ||
| // subscribing to all namespaces | ||
| incrementInMap(handlerWrapper.namespaces, undefined); | ||
| // subscribing to default ns | ||
| handlerWrapper.namespaces.add(DEFAULT_NS); | ||
| } | ||
| return result; | ||
| }, | ||
| unsubscribeKey: (descriptor: KeyDescriptor) => { | ||
| subscribeKey: (descriptor: KeyDescriptor) => { | ||
| const { key, ns } = descriptor; | ||
| decrementInMap(handlerWrapper.keys, key); | ||
| handlerWrapper.keys.add(key); | ||
| getFallbackArray(ns).forEach((val) => | ||
| decrementInMap(handlerWrapper.namespaces, val) | ||
| handlerWrapper.namespaces.add(val) | ||
| ); | ||
| if (ns === undefined) { | ||
| // subscribing to all namespaces | ||
| decrementInMap(handlerWrapper.namespaces, undefined); | ||
| // subscribing to default ns | ||
| handlerWrapper.namespaces.add(DEFAULT_NS); | ||
| } | ||
| // always subscribe to fallback namespaces | ||
| handlerWrapper.namespaces.add(FALLBACK_NS); | ||
| return result; | ||
@@ -109,8 +91,14 @@ }, | ||
| const namespacesWithFallbacks = ( | ||
| namespaces: Map<string | undefined, number> | Set<string | undefined> | ||
| namespaces: Map<NsListType, number> | Set<NsListType> | ||
| ) => { | ||
| if (namespaces.has(undefined)) { | ||
| if (namespaces.has(FALLBACK_NS) || namespaces.has(DEFAULT_NS)) { | ||
| const result = new Set(namespaces.keys()); | ||
| result.delete(undefined); | ||
| getFallbackNamespaces().forEach((ns) => result.add(ns)); | ||
| if (namespaces.has(FALLBACK_NS)) { | ||
| result.delete(FALLBACK_NS); | ||
| getFallbackNs().forEach((ns) => result.add(ns)); | ||
| } | ||
| if (namespaces.has(DEFAULT_NS)) { | ||
| result.delete(DEFAULT_NS); | ||
| result.add(getDefaultNs()); | ||
| } | ||
| return result as Set<string>; | ||
@@ -121,3 +109,6 @@ } | ||
| const callHandlers = (key: string | undefined, ns: string[] | undefined) => { | ||
| const callHandlers = ( | ||
| key: string | undefined, | ||
| ns: Array<string> | undefined | ||
| ) => { | ||
| partialListeners.forEach((handler) => { | ||
@@ -127,3 +118,3 @@ const handlerNamespaces = namespacesWithFallbacks(handler.namespaces); | ||
| ns === undefined || | ||
| ns?.findIndex((ns) => handlerNamespaces.has(ns)) !== -1; | ||
| ns?.findIndex((ns) => handlerNamespaces.has(ns!)) !== -1; | ||
| const keyMatches = | ||
@@ -147,10 +138,10 @@ key === undefined || handler.keys.has(key) || handler.keys.size === 0; | ||
| const namespaces = new Set<string | undefined>(); | ||
| let namespaces: Set<NsType> | undefined = new Set<NsType>(); | ||
| let keys: Set<string> | undefined = new Set<string>(); | ||
| queue.forEach((descriptor) => { | ||
| if (descriptor?.ns === undefined) { | ||
| // when no ns specified, it affets all fallback namespaces | ||
| namespaces.add(undefined); | ||
| } else { | ||
| descriptor.ns.forEach((ns) => namespaces.add(ns)); | ||
| // when no ns specified, it affects all namespaces | ||
| namespaces = undefined; | ||
| } else if (namespaces !== undefined) { | ||
| descriptor.ns.forEach((ns) => namespaces!.add(ns)); | ||
| } | ||
@@ -164,5 +155,5 @@ if (descriptor?.key === undefined) { | ||
| }); | ||
| const namespacesArray = Array.from( | ||
| namespacesWithFallbacks(namespaces).keys() | ||
| ); | ||
| const namespacesArray = namespaces | ||
| ? Array.from(namespaces.keys()) | ||
| : undefined; | ||
| (keys || [undefined]).forEach((key) => { | ||
@@ -178,5 +169,3 @@ callHandlers(key, namespacesArray); | ||
| } else { | ||
| Promise.resolve().then(() => { | ||
| solveQueue(); | ||
| }); | ||
| setTimeout(solveQueue, 0); | ||
| } | ||
@@ -183,0 +172,0 @@ }; |
| import { EventEmitter } from './EventEmitter'; | ||
| import { EventEmitterSelective } from './EventEmitterSelective'; | ||
| import { | ||
| CacheDescriptorWithKey, | ||
| KeyDescriptorInternal, | ||
| ListenerHandler, | ||
| TolgeeOn, | ||
| } from '../../types'; | ||
| import { CacheDescriptorWithKey, KeyDescriptorInternal } from '../../types'; | ||
| import { TolgeeOn } from '../../types/event'; | ||
| export const Events = (getFallbackNamespaces: () => string[]) => { | ||
| export const Events = ( | ||
| getFallbackNs: () => string[], | ||
| getDefaultNs: () => string | ||
| ) => { | ||
| const onPendingLanguageChange = EventEmitter<string>(); | ||
@@ -17,3 +16,3 @@ const onLanguageChange = EventEmitter<string>(); | ||
| const onInitialLoaded = EventEmitter<void>(); | ||
| const onKeyUpdate = EventEmitterSelective(getFallbackNamespaces); | ||
| const onKeyUpdate = EventEmitterSelective(getFallbackNs, getDefaultNs); | ||
| const onCacheChange = EventEmitter<CacheDescriptorWithKey>(); | ||
@@ -31,21 +30,17 @@ const onRunningChange = EventEmitter<boolean>(); | ||
| case 'pendingLanguage': | ||
| return onPendingLanguageChange.listen( | ||
| handler as ListenerHandler<string> | ||
| ); | ||
| return onPendingLanguageChange.listen(handler as any); | ||
| case 'language': | ||
| return onLanguageChange.listen(handler as ListenerHandler<string>); | ||
| return onLanguageChange.listen(handler as any); | ||
| case 'loading': | ||
| return onLoadingChange.listen(handler as ListenerHandler<boolean>); | ||
| return onLoadingChange.listen(handler as any); | ||
| case 'fetching': | ||
| return onFetchingChange.listen(handler as ListenerHandler<boolean>); | ||
| return onFetchingChange.listen(handler as any); | ||
| case 'initialLoad': | ||
| return onInitialLoaded.listen(handler as ListenerHandler<void>); | ||
| return onInitialLoaded.listen(handler as any); | ||
| case 'running': | ||
| return onRunningChange.listen(handler as ListenerHandler<boolean>); | ||
| return onRunningChange.listen(handler as any); | ||
| case 'cache': | ||
| return onCacheChange.listen( | ||
| handler as ListenerHandler<CacheDescriptorWithKey> | ||
| ); | ||
| return onCacheChange.listen(handler as any); | ||
| case 'keyUpdate': | ||
| return onKeyUpdate.listen(handler as ListenerHandler<void>); | ||
| return onKeyUpdate.listen(handler as any); | ||
| } | ||
@@ -52,0 +47,0 @@ }; |
@@ -19,19 +19,21 @@ import { isPromise, valueOrPromise } from '../../helpers'; | ||
| LanguageStorageInterface, | ||
| Options, | ||
| ChangeTranslationInterface, | ||
| WrapperWrapProps, | ||
| Unwrapped, | ||
| KeyAndNamespacesInternal, | ||
| TolgeePlugin, | ||
| TolgeeInstance, | ||
| } from '../../types'; | ||
| import { getFallbackArray } from '../State/helpers'; | ||
| import { ObserverOptions } from '../State/initObserverOptions'; | ||
| import { TolgeeOptionsInternal } from '../State/initState'; | ||
| export const PluginService = ( | ||
| getLanguage: () => string | undefined, | ||
| getInitialOptions: () => Options, | ||
| getObserverOptions: () => ObserverOptions, | ||
| getInitialOptions: () => TolgeeOptionsInternal, | ||
| getAvailableLanguages: () => string[] | undefined, | ||
| getTranslationNs: (props: TranslatePropsInternal) => string[] | string, | ||
| getTranslation: (props: TranslatePropsInternal) => string | undefined, | ||
| getTranslationNs: (props: KeyAndNamespacesInternal) => string[], | ||
| getTranslation: (props: KeyAndNamespacesInternal) => string | undefined, | ||
| changeTranslation: ChangeTranslationInterface | ||
| ) => { | ||
| let prepared = false; | ||
| let onPrepareQueue: (() => void)[] = []; | ||
| const plugins = { | ||
@@ -55,11 +57,13 @@ ui: undefined as UiConstructor | undefined, | ||
| const withNs: UiKeyOption[] = keysAndDefaults.map( | ||
| ({ key, ns, defaultValue }) => ({ | ||
| key, | ||
| defaultValue, | ||
| ns: getFallbackArray(getTranslationNs({ key, ns, defaultValue })), | ||
| translation: getTranslation({ | ||
| ({ key, ns, defaultValue }) => { | ||
| return { | ||
| key, | ||
| ns, | ||
| }), | ||
| }) | ||
| defaultValue, | ||
| ns: getTranslationNs({ key, ns }), | ||
| translation: getTranslation({ | ||
| key, | ||
| ns, | ||
| }), | ||
| }; | ||
| } | ||
| ); | ||
@@ -69,21 +73,2 @@ instances.ui?.handleElementClick(event, withNs); | ||
| const run = (isDev: boolean) => { | ||
| if (!instances.ui && plugins.ui) { | ||
| instances.ui = new plugins.ui({ | ||
| apiKey: getInitialOptions().apiKey!, | ||
| apiUrl: getInitialOptions().apiUrl!, | ||
| highlight, | ||
| changeTranslation, | ||
| }); | ||
| } | ||
| if (!instances.observer) { | ||
| instances.observer = plugins.observer?.({ | ||
| translate, | ||
| onClick, | ||
| options: getObserverOptions(), | ||
| }); | ||
| } | ||
| instances.observer?.run({ mouseHighlight: isDev }); | ||
| }; | ||
| const stop = () => { | ||
@@ -99,3 +84,6 @@ instances.ui = undefined; | ||
| const translate = (props: TranslatePropsInternal) => { | ||
| const translation = getTranslation(props); | ||
| const translation = getTranslation({ | ||
| key: props.key, | ||
| ns: props.ns, | ||
| }); | ||
| return formatTranslation({ ...props, translation, formatEnabled: true }); | ||
@@ -138,6 +126,2 @@ }; | ||
| const getLanguageStorage = () => { | ||
| return instances.languageStorage; | ||
| }; | ||
| const setStoredLanguage = (language: string) => { | ||
@@ -194,2 +178,23 @@ instances.languageStorage?.setLanguage(language); | ||
| const run = (isDev: boolean) => { | ||
| if (!instances.ui && plugins.ui) { | ||
| const { apiKey, apiUrl, projectId } = getInitialOptions(); | ||
| instances.ui = new plugins.ui({ | ||
| apiKey: apiKey!, | ||
| apiUrl: apiUrl!, | ||
| projectId, | ||
| highlight, | ||
| changeTranslation, | ||
| }); | ||
| } | ||
| if (!instances.observer) { | ||
| instances.observer = plugins.observer?.({ | ||
| translate, | ||
| onClick, | ||
| options: getInitialOptions().observerOptions, | ||
| }); | ||
| } | ||
| instances.observer?.run({ mouseHighlight: isDev }); | ||
| }; | ||
| const getDevBackend = () => { | ||
@@ -200,5 +205,7 @@ return instances.devBackend; | ||
| const getBackendDevRecord: BackendGetRecord = ({ language, namespace }) => { | ||
| const { apiKey, apiUrl, projectId } = getInitialOptions(); | ||
| return instances.devBackend?.getRecord({ | ||
| apiKey: getInitialOptions().apiKey, | ||
| apiUrl: getInitialOptions().apiUrl, | ||
| apiKey, | ||
| apiUrl, | ||
| projectId, | ||
| language, | ||
@@ -226,3 +233,38 @@ namespace, | ||
| const formatTranslation = ({ | ||
| const unwrap = (text: string): Unwrapped => { | ||
| if (instances.observer) { | ||
| return instances.observer?.unwrap(text); | ||
| } | ||
| return { text, keys: [] }; | ||
| }; | ||
| const retranslate = () => { | ||
| instances.observer?.retranslate(); | ||
| }; | ||
| const onPrepare = (callback: () => void) => { | ||
| onPrepareQueue.push(callback); | ||
| }; | ||
| function addPlugin(tolgeeInstance: TolgeeInstance, plugin: TolgeePlugin) { | ||
| const pluginTools = Object.freeze({ | ||
| setFinalFormatter, | ||
| addFormatter, | ||
| setObserver, | ||
| hasObserver, | ||
| setUi, | ||
| hasUi, | ||
| setDevBackend, | ||
| addBackend, | ||
| setLanguageDetector, | ||
| setLanguageStorage, | ||
| onPrepare, | ||
| }); | ||
| plugin(tolgeeInstance, pluginTools); | ||
| if (prepared) { | ||
| prepare(); | ||
| } | ||
| } | ||
| function formatTranslation({ | ||
| key, | ||
@@ -236,3 +278,3 @@ translation, | ||
| formatEnabled, | ||
| }: TranslatePropsInternal & { formatEnabled?: boolean }) => { | ||
| }: TranslatePropsInternal & { formatEnabled?: boolean }) { | ||
| const formattableTranslation = translation || defaultValue; | ||
@@ -276,4 +318,8 @@ let result = formattableTranslation || (orEmpty ? '' : key); | ||
| return result; | ||
| }; | ||
| } | ||
| function hasDevBackend() { | ||
| return Boolean(getDevBackend()); | ||
| } | ||
| const wrap = (params: WrapperWrapProps) => { | ||
@@ -286,30 +332,19 @@ if (instances.observer) { | ||
| const unwrap = (text: string): Unwrapped => { | ||
| if (instances.observer) { | ||
| return instances.observer?.unwrap(text); | ||
| function prepare() { | ||
| prepared = true; | ||
| while (onPrepareQueue.length) { | ||
| const queue = onPrepareQueue; | ||
| onPrepareQueue = []; | ||
| queue.forEach((callback) => callback()); | ||
| } | ||
| return { text, keys: [] }; | ||
| }; | ||
| } | ||
| const retranslate = () => { | ||
| instances.observer?.retranslate(); | ||
| }; | ||
| return Object.freeze({ | ||
| setFinalFormatter, | ||
| addFormatter, | ||
| prepare, | ||
| addPlugin, | ||
| formatTranslation, | ||
| setObserver, | ||
| hasObserver, | ||
| setUi, | ||
| hasUi, | ||
| addBackend, | ||
| setDevBackend, | ||
| getDevBackend, | ||
| getBackendRecord, | ||
| getBackendDevRecord, | ||
| setLanguageDetector, | ||
| getLanguageDetector, | ||
| setLanguageStorage, | ||
| getLanguageStorage, | ||
| getInitialLanguage, | ||
@@ -321,4 +356,5 @@ setStoredLanguage, | ||
| highlight, | ||
| unwrap, | ||
| wrap, | ||
| unwrap, | ||
| hasDevBackend, | ||
| }); | ||
@@ -325,0 +361,0 @@ }; |
@@ -42,1 +42,5 @@ import { | ||
| } | ||
| export function sanitizeUrl(url: string | undefined) { | ||
| return url ? url.replace(/\/+$/, '') : url; | ||
| } |
| import { | ||
| FallbackLanguageOption, | ||
| FallbackNS, | ||
| FallbackNs, | ||
| TreeTranslationsData, | ||
| } from '../../types'; | ||
| import { sanitizeUrl } from './helpers'; | ||
| import { | ||
| defaultObserverOptions, | ||
| ObserverOptions, | ||
| ObserverOptionsInternal, | ||
| } from './observerOptions'; | ||
| export type Options = { | ||
| export type TolgeeStaticData = { | ||
| [key: string]: TreeTranslationsData | (() => Promise<TreeTranslationsData>); | ||
| }; | ||
| export type TolgeeOptionsInternal = { | ||
| /** | ||
@@ -12,9 +22,23 @@ * Initial language | ||
| language?: string; | ||
| /** | ||
| * Tolgee instance url (e.g. https://app.tolgee.io) | ||
| */ | ||
| apiUrl?: string; | ||
| /** | ||
| * Project API key (PAK) or Personal Access Token (PAT) | ||
| */ | ||
| apiKey?: string; | ||
| projectId?: number; | ||
| /** | ||
| * Project id is necessary if you are using PAT | ||
| */ | ||
| projectId?: number | string; | ||
| /** | ||
| * Used when auto detection is not available or is turned off | ||
| */ | ||
| defaultLanguage?: string; | ||
| /** | ||
@@ -25,2 +49,3 @@ * Languages which can be used for language detection | ||
| availableLanguages?: string[]; | ||
| /** | ||
@@ -30,2 +55,3 @@ * Language which is used when no translation is available for current one | ||
| fallbackLanguage?: FallbackLanguageOption; | ||
| /** | ||
@@ -35,6 +61,8 @@ * Namespaces which should be always fetched | ||
| ns?: string[]; | ||
| /** | ||
| * Namespaces to be used to find translation when no explicit namespace set. | ||
| */ | ||
| fallbackNs?: FallbackNS; | ||
| fallbackNs?: FallbackNs; | ||
| /** | ||
@@ -44,9 +72,29 @@ * Default namespace when no namespace defined (default: '') | ||
| defaultNs: string; | ||
| staticData?: { | ||
| [key: string]: TreeTranslationsData | (() => Promise<TreeTranslationsData>); | ||
| }; | ||
| /** | ||
| * These data go directly to cache or you can specify async | ||
| * function which will be used to get the data. Use `:` to add namespace: | ||
| * | ||
| * ```ts | ||
| * { | ||
| * 'locale': <translations | async function> | ||
| * 'locale:namespace': <translations | async function> | ||
| * } | ||
| * ``` | ||
| */ | ||
| staticData?: TolgeeStaticData; | ||
| observerOptions: ObserverOptionsInternal; | ||
| observerType: 'invisible' | 'text'; | ||
| }; | ||
| export type TolgeeOptions = Partial< | ||
| Omit<TolgeeOptionsInternal, 'observerOptions'> | ||
| > & { | ||
| observerOptions?: ObserverOptions; | ||
| }; | ||
| export type State = { | ||
| initialOptions: Options; | ||
| initialOptions: TolgeeOptionsInternal; | ||
| activeNamespaces: Map<string, number>; | ||
@@ -59,19 +107,37 @@ language: string | undefined; | ||
| const defaultValues: Options = { | ||
| const defaultValues: TolgeeOptionsInternal = { | ||
| defaultNs: '', | ||
| observerOptions: defaultObserverOptions, | ||
| observerType: 'invisible', | ||
| }; | ||
| export const combineOptions = <T extends TolgeeOptions>( | ||
| ...states: (T | undefined)[] | ||
| ) => { | ||
| let result = {} as T; | ||
| states.forEach((state) => { | ||
| result = { | ||
| ...result, | ||
| ...state, | ||
| observerOptions: { | ||
| ...result.observerOptions, | ||
| ...state?.observerOptions, | ||
| }, | ||
| }; | ||
| }); | ||
| return result; | ||
| }; | ||
| export const initState = ( | ||
| options?: Partial<Options>, | ||
| options?: Partial<TolgeeOptions>, | ||
| previousState?: State | ||
| ): State => { | ||
| const initialOptions = { | ||
| ...defaultValues, | ||
| ...previousState?.initialOptions, | ||
| ...options, | ||
| }; | ||
| const initialOptions = combineOptions( | ||
| defaultValues, | ||
| previousState?.initialOptions, | ||
| options | ||
| ) as TolgeeOptionsInternal; | ||
| // remove extra '/' from url end | ||
| const apiUrl = initialOptions.apiUrl; | ||
| initialOptions.apiUrl = apiUrl ? apiUrl.replace(/\/+$/, '') : apiUrl; | ||
| initialOptions.apiUrl = sanitizeUrl(initialOptions.apiUrl); | ||
@@ -78,0 +144,0 @@ return { |
@@ -6,8 +6,13 @@ import { | ||
| EventEmitterInstance, | ||
| FallbackNSTranslation, | ||
| FallbackNsTranslation, | ||
| NsType, | ||
| } from '../../types'; | ||
| import { decodeCacheKey } from '../Cache/helpers'; | ||
| import { getFallbackArray, getFallbackFromStruct, unique } from './helpers'; | ||
| import { initObserverOptions, ObserverOptions } from './initObserverOptions'; | ||
| import { initState, Options } from './initState'; | ||
| import { | ||
| getFallbackArray, | ||
| getFallbackFromStruct, | ||
| sanitizeUrl, | ||
| unique, | ||
| } from './helpers'; | ||
| import { initState, TolgeeOptions } from './initState'; | ||
@@ -20,6 +25,5 @@ export const State = ( | ||
| let state = initState(); | ||
| let observerOptions = initObserverOptions(); | ||
| let devCredentials: DevCredentials = undefined; | ||
| function init(options?: Partial<Options>) { | ||
| function init(options?: Partial<TolgeeOptions>) { | ||
| state = initState(options, state); | ||
@@ -73,3 +77,3 @@ } | ||
| function addActiveNs(ns: FallbackNSTranslation) { | ||
| function addActiveNs(ns: FallbackNsTranslation) { | ||
| const namespaces = getFallbackArray(ns); | ||
@@ -86,3 +90,3 @@ namespaces.forEach((namespace) => { | ||
| function removeActiveNs(ns: FallbackNSTranslation) { | ||
| function removeActiveNs(ns: FallbackNsTranslation) { | ||
| const namespaces = getFallbackArray(ns); | ||
@@ -102,2 +106,3 @@ namespaces.forEach((namespace) => { | ||
| ...(state.initialOptions.ns || [state.initialOptions.defaultNs]), | ||
| ...getFallbackArray(state.initialOptions.fallbackNs), | ||
| ...state.activeNamespaces.keys(), | ||
@@ -118,9 +123,10 @@ ]); | ||
| function getFallbackNamespaces() { | ||
| const defaultNs = state.initialOptions.defaultNs; | ||
| const fallbackNs = state.initialOptions.fallbackNs; | ||
| const fallbackNamespaces = typeof defaultNs === 'string' ? [defaultNs] : []; | ||
| return unique([...fallbackNamespaces, ...getFallbackArray(fallbackNs)]); | ||
| function getFallbackNs() { | ||
| return getFallbackArray(state.initialOptions.fallbackNs); | ||
| } | ||
| function getDefaultNs(ns?: NsType) { | ||
| return ns === undefined ? state.initialOptions.defaultNs : ns; | ||
| } | ||
| function getAvailableLanguages() { | ||
@@ -148,13 +154,12 @@ if (state.initialOptions.availableLanguages) { | ||
| function overrideCredentials(credentials: DevCredentials) { | ||
| devCredentials = credentials; | ||
| if (credentials) { | ||
| devCredentials = { | ||
| ...credentials, | ||
| apiUrl: sanitizeUrl(credentials.apiUrl), | ||
| }; | ||
| } else { | ||
| devCredentials = undefined; | ||
| } | ||
| } | ||
| function setObserverOptions(options: Partial<ObserverOptions>) { | ||
| observerOptions = initObserverOptions(options); | ||
| } | ||
| function getObserverOptions() { | ||
| return observerOptions; | ||
| } | ||
| return Object.freeze({ | ||
@@ -175,9 +180,8 @@ init, | ||
| getFallbackLangs, | ||
| getFallbackNamespaces, | ||
| getFallbackNs, | ||
| getDefaultNs, | ||
| getAvailableLanguages, | ||
| withDefaultNs, | ||
| overrideCredentials, | ||
| setObserverOptions, | ||
| getObserverOptions, | ||
| }); | ||
| }; |
| export { Tolgee } from './Tolgee'; | ||
| export { | ||
| RESTRICTED_ASCENDANT_ATTRIBUTE, | ||
| DEVTOOLS_ID, | ||
| TOLGEE_ATTRIBUTE_NAME, | ||
| TOLGEE_HIGHLIGHTER_CLASS, | ||
| TOLGEE_WRAPPED_ONLY_DATA_ATTRIBUTE, | ||
| } from './constants'; | ||
| export * from './types'; | ||
| export { getTranslateParams } from './TranslateParams'; | ||
| export { getFallback, getFallbackArray } from './Controller/State/helpers'; | ||
| export { FormatSimple } from './FormatSimple/FormatSimple'; | ||
| export * from './types/event'; |
| import { Controller } from './Controller/Controller'; | ||
| import { | ||
| Options, | ||
| TolgeeInstance, | ||
| TolgeePlugin, | ||
| ObserverOptions, | ||
| } from './types'; | ||
| import { combineOptions } from './Controller/State/initState'; | ||
| import { TolgeeOptions, TolgeePlugin, DevCredentials } from './types'; | ||
| export const Tolgee = (options?: Partial<Options>): TolgeeInstance => { | ||
| const TolgeeInstanceCreator = (options: TolgeeOptions) => { | ||
| const controller = Controller({ | ||
@@ -14,16 +10,3 @@ options, | ||
| const pluginTools = Object.freeze({ | ||
| setFinalFormatter: controller.setFinalFormatter, | ||
| addFormatter: controller.addFormatter, | ||
| setObserver: controller.setObserver, | ||
| hasObserver: controller.hasObserver, | ||
| setUi: controller.setUi, | ||
| hasUi: controller.hasUi, | ||
| setDevBackend: controller.setDevBackend, | ||
| addBackend: controller.addBackend, | ||
| setLanguageDetector: controller.setLanguageDetector, | ||
| setLanguageStorage: controller.setLanguageStorage, | ||
| overrideCredentials: controller.overrideCredentials, | ||
| }); | ||
| // restarts tolgee while applying callback | ||
| const withRestart = (callback: () => void) => { | ||
@@ -36,47 +19,176 @@ const wasRunning = controller.isRunning(); | ||
| const tolgee: TolgeeInstance = Object.freeze({ | ||
| // event listeners | ||
| const tolgee = Object.freeze({ | ||
| /** | ||
| * Listen to tolgee events. | ||
| */ | ||
| on: controller.on, | ||
| /** | ||
| * Listen for specific keys/namespaces changes. | ||
| */ | ||
| onKeyUpdate: controller.onKeyUpdate.listenSome, | ||
| // state | ||
| /** | ||
| * @return current language if set. | ||
| */ | ||
| getLanguage: controller.getLanguage, | ||
| /** | ||
| * `pendingLanguage` represents language which is currently being loaded. | ||
| * @return current `pendingLanguage` if set. | ||
| */ | ||
| getPendingLanguage: controller.getPendingLanguage, | ||
| /** | ||
| * Change current language. | ||
| * - if not running sets `pendingLanguage`, `language` to the new value | ||
| * - if running sets `pendingLanguage` to the value, fetches necessary data and then changes `language` | ||
| * | ||
| * @return Promise which is resolved when `language` is changed. | ||
| */ | ||
| changeLanguage: controller.changeLanguage, | ||
| /** | ||
| * Temporarily change translation in cache. | ||
| * @return object with revert method. | ||
| */ | ||
| changeTranslation: controller.changeTranslation, | ||
| /** | ||
| * Adds namespace(s) list of active namespaces. And if tolgee is running, loads required data. | ||
| */ | ||
| addActiveNs: controller.addActiveNs, | ||
| /** | ||
| * Remove namespace(s) from active namespaces. | ||
| * | ||
| * Tolgee internally counts how many times was each active namespace added, | ||
| * so this method will remove namespace only if the counter goes down to 0. | ||
| */ | ||
| removeActiveNs: controller.removeActiveNs, | ||
| /** | ||
| * Manually load multiple records from `Backend` (or `DevBackend` when in dev mode) | ||
| * | ||
| * It loads data together and adds them to cache in one operation, to prevent partly loaded state. | ||
| */ | ||
| loadRecords: controller.loadRecords, | ||
| /** | ||
| * Manually load record from `Backend` (or `DevBackend` when in dev mode) | ||
| */ | ||
| loadRecord: controller.loadRecord, | ||
| /** | ||
| * | ||
| */ | ||
| addStaticData: controller.addStaticData, | ||
| /** | ||
| * Get record from cache. | ||
| */ | ||
| getRecord: controller.getRecord, | ||
| /** | ||
| * Get all records from cache. | ||
| */ | ||
| getAllRecords: controller.getAllRecords, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if there are data that need to be fetched. | ||
| */ | ||
| isLoaded: controller.isLoaded, | ||
| /** | ||
| * @return `true` if tolgee is loading initial data (triggered by `run`). | ||
| */ | ||
| isInitialLoading: controller.isInitialLoading, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if tolgee is loading some translations for the first time. | ||
| */ | ||
| isLoading: controller.isLoading, | ||
| /** | ||
| * @param ns optional list of namespaces that you are interested in | ||
| * @return `true` if tolgee is fetching some translations. | ||
| */ | ||
| isFetching: controller.isFetching, | ||
| /** | ||
| * @return `true` if tolgee is running. | ||
| */ | ||
| isRunning: controller.isRunning, | ||
| /** | ||
| * Changes internal state to running: true and loads initial files. | ||
| * Runs runnable plugins mainly Observer if present. | ||
| */ | ||
| run: controller.run, | ||
| /** | ||
| * Changes internal state to running: false and stops runnable plugins. | ||
| */ | ||
| stop: controller.stop, | ||
| /** | ||
| * Returns translated and formatted key. | ||
| * If Observer is present and tolgee is running, wraps result to be identifiable in the DOM. | ||
| */ | ||
| t: controller.t, | ||
| /** | ||
| * Highlight keys that match selection. | ||
| */ | ||
| highlight: controller.highlight, | ||
| /** | ||
| * @return current Tolgee options. | ||
| */ | ||
| getInitialOptions: controller.getInitialOptions, | ||
| /** | ||
| * Tolgee is in dev mode if `DevTools` plugin is used and `apiKey` + `apiUrl` are specified. | ||
| * @return `true` if tolgee is in dev mode. | ||
| */ | ||
| isDev: controller.isDev, | ||
| /** | ||
| * Wraps translation if there is `Observer` plugin | ||
| */ | ||
| wrap: controller.wrap, | ||
| /** | ||
| * Unwrap translation | ||
| */ | ||
| unwrap: controller.unwrap, | ||
| // plugins | ||
| setObserverOptions: (options: Partial<ObserverOptions>) => { | ||
| controller.setObserverOptions(options); | ||
| return tolgee; | ||
| /** | ||
| * Override creadentials passed on initialization | ||
| */ | ||
| overrideCredentials(credentials: DevCredentials) { | ||
| withRestart(() => controller.overrideCredentials(credentials)); | ||
| }, | ||
| use: (plugin: TolgeePlugin | undefined) => { | ||
| /** | ||
| * Add tolgee plugin. | ||
| */ | ||
| addPlugin(plugin: TolgeePlugin | undefined) { | ||
| if (plugin) { | ||
| withRestart(() => plugin(tolgee, pluginTools)); | ||
| withRestart(() => controller.addPlugin(tolgee, plugin)); | ||
| } | ||
| return tolgee; | ||
| }, | ||
| init: (options: Partial<Options>) => { | ||
| withRestart(() => controller.init(options)); | ||
| return tolgee; | ||
| /** | ||
| * Updates options after instance creation. Extends existing options, | ||
| * so it only changes the fields, that are listed. | ||
| * | ||
| * When called in running state, tolgee stops and runs again. | ||
| */ | ||
| updateOptions(options?: TolgeeOptions) { | ||
| if (options) { | ||
| withRestart(() => controller.init(options)); | ||
| } | ||
| }, | ||
@@ -87,1 +199,55 @@ }); | ||
| }; | ||
| export type TolgeeInstance = ReturnType<typeof TolgeeInstanceCreator>; | ||
| export type TolgeeChainer = { | ||
| /** | ||
| * Add plugin, plugins are applied when `init` method is called. | ||
| */ | ||
| use: (plugin: TolgeePlugin | undefined) => TolgeeChainer; | ||
| /** | ||
| * Update default options before tolgee is initialized. | ||
| */ | ||
| updateDefaults: (options: TolgeeOptions) => TolgeeChainer; | ||
| /** | ||
| * Initialize tolgee options and apply plugins | ||
| * @returns tolgee instance | ||
| */ | ||
| init(options?: TolgeeOptions): TolgeeInstance; | ||
| }; | ||
| /** | ||
| * Tolgee chainable constructor. | ||
| * | ||
| * Usage: | ||
| * ``` | ||
| * const tolgee = Tolgee().use(...).init(...) | ||
| * ``` | ||
| */ | ||
| export const Tolgee = (): TolgeeChainer => { | ||
| const state = { | ||
| plugins: [] as (TolgeePlugin | undefined)[], | ||
| options: {} as TolgeeOptions, | ||
| }; | ||
| const tolgeeChain = Object.freeze({ | ||
| use(plugin: TolgeePlugin | undefined) { | ||
| state.plugins.push(plugin); | ||
| return tolgeeChain; | ||
| }, | ||
| updateDefaults(options: TolgeeOptions) { | ||
| state.options = combineOptions(state.options, options); | ||
| return tolgeeChain; | ||
| }, | ||
| init(options?: TolgeeOptions) { | ||
| const tolgee = TolgeeInstanceCreator( | ||
| combineOptions(state.options, options) | ||
| ); | ||
| state.plugins.forEach(tolgee.addPlugin); | ||
| return tolgee; | ||
| }, | ||
| }); | ||
| return tolgeeChain; | ||
| }; |
@@ -8,5 +8,5 @@ import { getTranslateParams } from './TranslateParams'; | ||
| noWrap: true, | ||
| ns: [], | ||
| ns: 'test', | ||
| orEmpty: true, | ||
| params: { yo: 'yo', ns: '(this is param not namespace)' }, | ||
| params: { yo: 'yo' }, | ||
| }; | ||
@@ -33,8 +33,5 @@ | ||
| noWrap: true, | ||
| ns: [], | ||
| ns: 'test', | ||
| orEmpty: true, | ||
| yo: 'yo', | ||
| params: { | ||
| ns: '(this is param not namespace)', | ||
| }, | ||
| }); | ||
@@ -41,0 +38,0 @@ expect(result).toEqual(testParams); |
@@ -14,13 +14,14 @@ import { | ||
| ...rest | ||
| }: CombinedOptions<any>): Partial<TranslateProps> { | ||
| const options: Required<TranslateOptions<any>> = { | ||
| }: Partial<TranslateProps>): Partial<TranslateProps> { | ||
| const options: Required<TranslateOptions> = { | ||
| ns: ns!, | ||
| noWrap: noWrap!, | ||
| orEmpty: orEmpty!, | ||
| }; | ||
| return { | ||
| ...options, | ||
| params: { | ||
| ...rest, | ||
| ...params, | ||
| }, | ||
| }; | ||
| return options; | ||
| } | ||
@@ -27,0 +28,0 @@ |
186
src/types.ts
@@ -1,9 +0,17 @@ | ||
| import type { Options } from './Controller/State/initState'; | ||
| import type { ObserverOptions } from './Controller/State/initObserverOptions'; | ||
| import { TolgeeInstance } from './Tolgee'; | ||
| export type { TolgeeChainer, TolgeeInstance } from './Tolgee'; | ||
| import type { ObserverOptionsInternal } from './Controller/State/observerOptions'; | ||
| export type { State, Options } from './Controller/State/initState'; | ||
| export type { | ||
| State, | ||
| TolgeeOptions, | ||
| TolgeeOptionsInternal, | ||
| TolgeeStaticData, | ||
| } from './Controller/State/initState'; | ||
| export type { | ||
| ObserverOptions, | ||
| ObserverOptionsInternal, | ||
| ModifierKey, | ||
| } from './Controller/State/initObserverOptions'; | ||
| } from './Controller/State/observerOptions'; | ||
@@ -13,5 +21,28 @@ export type { EventEmitterInstance } from './Controller/Events/EventEmitter'; | ||
| export type PluginTools = Readonly<{ | ||
| setFinalFormatter: (formatter: FinalFormatterInterface | undefined) => void; | ||
| addFormatter: (formatter: FormatterInterface | undefined) => void; | ||
| setObserver: (observer: ObserverInterface | undefined) => void; | ||
| hasObserver: () => boolean; | ||
| setUi: (ui: UiLibInterface | undefined) => void; | ||
| hasUi: () => boolean; | ||
| addBackend: (backend: BackendInterface | undefined) => void; | ||
| setDevBackend: (backend: BackendInterface | undefined) => void; | ||
| setLanguageDetector: ( | ||
| languageDetector: LanguageDetectorInterface | undefined | ||
| ) => void; | ||
| setLanguageStorage: ( | ||
| languageStorage: LanguageStorageInterface | undefined | ||
| ) => void; | ||
| onPrepare: (callback: () => void) => void; | ||
| }>; | ||
| export type TolgeePlugin = ( | ||
| tolgee: TolgeeInstance, | ||
| tools: PluginTools | ||
| ) => TolgeeInstance; | ||
| export type FallbackGeneral = undefined | false | string | string[]; | ||
| export type FallbackNS = FallbackGeneral; | ||
| export type FallbackNs = FallbackGeneral; | ||
@@ -22,3 +53,3 @@ export type NsType = string; | ||
| export type FallbackNSTranslation = undefined | NsType | NsType[]; | ||
| export type FallbackNsTranslation = undefined | NsType | NsType[]; | ||
@@ -31,7 +62,6 @@ export type FallbackLanguage = FallbackGeneral; | ||
| export type TranslateOptions<T> = { | ||
| ns?: FallbackNSTranslation; | ||
| export type TranslateOptions = { | ||
| ns?: NsType; | ||
| noWrap?: boolean; | ||
| orEmpty?: boolean; | ||
| params?: TranslateParams<T>; | ||
| }; | ||
@@ -42,3 +72,4 @@ | ||
| defaultValue?: string; | ||
| } & TranslateOptions<T>; | ||
| params?: TranslateParams<T>; | ||
| } & TranslateOptions; | ||
@@ -49,2 +80,7 @@ export type TranslatePropsInternal = TranslateProps & { | ||
| export type KeyAndNamespacesInternal = Pick< | ||
| TranslatePropsInternal, | ||
| 'key' | 'ns' | ||
| >; | ||
| export type TranslationValue = string | undefined | null; | ||
@@ -81,3 +117,3 @@ | ||
| defaultValue?: string; | ||
| ns?: FallbackNSTranslation; | ||
| ns?: NsType; | ||
| }; | ||
@@ -95,4 +131,4 @@ | ||
| export type CombinedOptions<T> = TranslateOptions<T> & { | ||
| [key: string]: T | PropType<TranslateOptions<T>>; | ||
| export type CombinedOptions<T> = TranslateOptions & { | ||
| [key: string]: T | PropType<TranslateOptions>; | ||
| }; | ||
@@ -142,12 +178,14 @@ | ||
| onClick: TranslationOnClick; | ||
| options: ObserverOptions; | ||
| options: ObserverOptionsInternal; | ||
| }; | ||
| export type HighlightInterface = ( | ||
| key?: string, | ||
| ns?: FallbackNSTranslation | ||
| ) => { | ||
| export type Highlighter = { | ||
| unhighlight(): void; | ||
| }; | ||
| export type HighlightInterface = ( | ||
| key?: string, | ||
| ns?: FallbackNsTranslation | ||
| ) => Highlighter; | ||
| export type ObserverRunProps = { | ||
@@ -187,2 +225,3 @@ mouseHighlight: boolean; | ||
| apiKey?: string; | ||
| projectId?: string | number; | ||
| }; | ||
@@ -193,3 +232,3 @@ | ||
| apiKey?: string; | ||
| projectId?: number; | ||
| projectId?: number | string; | ||
| }; | ||
@@ -218,77 +257,2 @@ | ||
| export type TolgeeEvent = | ||
| | 'pendingLanguage' | ||
| | 'language' | ||
| | 'key' | ||
| | 'loading' | ||
| | 'fetching' | ||
| | 'initialLoad' | ||
| | 'running' | ||
| | 'cache' | ||
| | 'keyUpdate'; | ||
| export type TolgeeOn = { | ||
| (event: 'pendingLanguage', handler: ListenerHandler<string>): Listener; | ||
| (event: 'language', handler: ListenerHandler<string>): Listener; | ||
| (event: 'key', handler: ListenerHandler<string>): Listener; | ||
| (event: 'loading', handler: ListenerHandler<boolean>): Listener; | ||
| (event: 'fetching', handler: ListenerHandler<boolean>): Listener; | ||
| (event: 'initialLoad', handler: ListenerHandler<void>): Listener; | ||
| (event: 'running', handler: ListenerHandler<boolean>): Listener; | ||
| (event: 'keyUpdate', handler: ListenerHandler<void>): Listener; | ||
| (event: TolgeeEvent, handler: ListenerHandler<any>): Listener; | ||
| }; | ||
| export type TolgeeInstance = Readonly<{ | ||
| on: TolgeeOn; | ||
| onKeyUpdate: (handler: ListenerHandler<void>) => ListenerSelective; | ||
| use: (plugin: TolgeePlugin | undefined) => TolgeeInstance; | ||
| getLanguage: () => string | undefined; | ||
| getPendingLanguage: () => string | undefined; | ||
| changeLanguage: (language: string) => Promise<void>; | ||
| changeTranslation: ChangeTranslationInterface; | ||
| addActiveNs: (ns: FallbackNSTranslation, forget?: boolean) => Promise<void>; | ||
| removeActiveNs: (ns: FallbackNSTranslation) => void; | ||
| loadRecords: (descriptors: CacheDescriptor[]) => Promise<TranslationsFlat[]>; | ||
| loadRecord: (descriptors: CacheDescriptor) => Promise<TranslationsFlat>; | ||
| addStaticData: (data: Options['staticData']) => void; | ||
| getRecord: (descriptor: CacheDescriptor) => TranslationsFlat | undefined; | ||
| getAllRecords: () => CachePublicRecord[]; | ||
| isInitialLoading: () => boolean; | ||
| isLoading: (ns?: FallbackNSTranslation) => boolean; | ||
| isLoaded: (ns?: FallbackNSTranslation) => boolean; | ||
| isFetching: (ns?: FallbackNSTranslation) => boolean; | ||
| isRunning: () => boolean; | ||
| highlight: HighlightInterface; | ||
| getInitialOptions: () => Options; | ||
| isDev: () => boolean; | ||
| init: (options: Partial<Options>) => TolgeeInstance; | ||
| run: () => Promise<void>; | ||
| stop: () => void; | ||
| t: TFnType; | ||
| wrap: (params: TranslatePropsInternal) => string | undefined; | ||
| unwrap: (text: string) => Unwrapped; | ||
| setObserverOptions: (options: Partial<ObserverOptions>) => TolgeeInstance; | ||
| }>; | ||
| export type PluginServicePublic = Readonly<{ | ||
| setFinalFormatter: (formatter: FinalFormatterInterface | undefined) => void; | ||
| addFormatter: (formatter: FormatterInterface | undefined) => void; | ||
| setObserver: (observer: ObserverInterface | undefined) => void; | ||
| hasObserver: () => boolean; | ||
| setUi: (ui: UiLibInterface | undefined) => void; | ||
| hasUi: () => boolean; | ||
| addBackend: (backend: BackendInterface | undefined) => void; | ||
| setDevBackend: (backend: BackendInterface | undefined) => void; | ||
| setLanguageDetector: ( | ||
| languageDetector: LanguageDetectorInterface | undefined | ||
| ) => void; | ||
| setLanguageStorage: ( | ||
| languageStorage: LanguageStorageInterface | undefined | ||
| ) => void; | ||
| overrideCredentials: (credentials: DevCredentials) => void; | ||
| }>; | ||
| export type NodeMeta = { | ||
@@ -321,2 +285,6 @@ oldTextContent: string; | ||
| export type TranslationChanger = { | ||
| revert: () => void; | ||
| }; | ||
| export type ChangeTranslationInterface = ( | ||
@@ -326,3 +294,3 @@ descriptor: CacheDescriptor, | ||
| value: string | ||
| ) => { revert: () => void }; | ||
| ) => TranslationChanger; | ||
@@ -332,2 +300,3 @@ export type UiProps = { | ||
| apiKey: string; | ||
| projectId: number | string | undefined; | ||
| highlight: HighlightInterface; | ||
@@ -355,16 +324,10 @@ changeTranslation: ChangeTranslationInterface; | ||
| defaultValue?: string; | ||
| ns: FallbackNSTranslation; | ||
| ns: string[]; | ||
| translation: string | undefined; | ||
| }; | ||
| export type KeyWithDefault = { | ||
| key: string; | ||
| defaultValue?: string; | ||
| ns: FallbackNSTranslation; | ||
| }; | ||
| export type TranslationOnClick = ( | ||
| event: MouseEvent, | ||
| data: { | ||
| keysAndDefaults: KeyWithDefault[]; | ||
| keysAndDefaults: KeyAndParams[]; | ||
| el: Element; | ||
@@ -386,3 +349,3 @@ meta: ElementMeta; | ||
| key: string; | ||
| ns?: string | string[]; | ||
| ns?: NsType | undefined; | ||
| }; | ||
@@ -392,6 +355,10 @@ | ||
| unsubscribe: () => void; | ||
| subscribeNs: (ns: FallbackNSTranslation) => ListenerSelective; | ||
| unsubscribeNs: (ns: FallbackNSTranslation) => ListenerSelective; | ||
| /** | ||
| * Subscribes to namespace(s) (if not specified to defaultNs) | ||
| */ | ||
| subscribeNs: (ns?: FallbackNsTranslation) => ListenerSelective; | ||
| /** | ||
| * Subscribes to namespace (if not specified to defaultNs) | ||
| */ | ||
| subscribeKey: (descriptor: KeyDescriptor) => ListenerSelective; | ||
| unsubscribeKey: (descriptor: KeyDescriptor) => ListenerSelective; | ||
| }; | ||
@@ -402,7 +369,2 @@ | ||
| export type TolgeePlugin = ( | ||
| tolgee: TolgeeInstance, | ||
| tools: PluginServicePublic | ||
| ) => TolgeeInstance; | ||
| export type CachePublicRecord = { | ||
@@ -409,0 +371,0 @@ data: TranslationsFlat; |
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
No alert changes
Improved metrics
- Total package byte prevSize
681230
13.68%- Number of package files
77
16.67%- Lines of code
9367
24.3%Worsened metrics
- Dev dependency count
16
6.67%No dependency changes