@bravobit/bb-foundation 0.22.4 → 0.23.0

package/fesm2015/bravobit-bb-foundation-localize.mjs

@@ -1,14 +1,15 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, Directive, Input, Component, ChangeDetectionStrategy, ViewEncapsulation, ContentChildren, Injectable, Optional, Inject, Pipe, APP_INITIALIZER, LOCALE_ID, NgModule } from '@angular/core';
+import { InjectionToken, Optional, Inject, Directive, Input, Component, ChangeDetectionStrategy, ViewEncapsulation, ContentChildren, Injectable, Pipe, APP_INITIALIZER, LOCALE_ID, NgModule } from '@angular/core';
 import * as i1 from '@angular/common';
 import { formatDate, DOCUMENT, CommonModule } from '@angular/common';
+import { __awaiter, __decorate, __param } from 'tslib';
 import { startWith } from 'rxjs/operators';
 import { Subscription } from 'rxjs';
 import * as i2 from '@bravobit/bb-foundation/utils';
 import { UtilsModule } from '@bravobit/bb-foundation/utils';
-import { __awaiter } from 'tslib';
-import * as i1$1 from '@bravobit/bb-foundation/storage';
 import * as i2$1 from '@bravobit/bb-foundation';
+import { WINDOW } from '@bravobit/bb-foundation';
+import * as i1$1 from '@bravobit/bb-foundation/storage';
 
 //
 // The configuration that can be passed when
@@ -24,6 +25,8 @@ class LocalizeConfig {
 //
 const LOCALIZE_FUNCTION = new InjectionToken('localize_function');
 
+const LOCALIZE_TRANSFORM = new InjectionToken('localize_transform');
+
 //
 // This function transform the value
 // to a lowercase variant of the value.
@@ -33,7 +36,7 @@ class LocalizeLowercaseFunction {
         return 'lowercase';
     }
     transform(value) {
-        return (value || '').toLowerCase();
+        return (value !== null && value !== void 0 ? value : '').toLowerCase();
     }
 }
 
@@ -46,7 +49,7 @@ class LocalizeUppercaseFunction {
         return 'uppercase';
     }
     transform(value) {
-        return (value || '').toUpperCase();
+        return (value !== null && value !== void 0 ? value : '').toUpperCase();
     }
 }
 
@@ -166,13 +169,250 @@ class LocalizeMissingHandler {
         // Log to the console when the token was not found
         // if the user did not mark it as optional.
         if (!(params === null || params === void 0 ? void 0 : params.optional)) {
-            this.log(`Localize: The token with name: "${params === null || params === void 0 ? void 0 : params.token}" was not found.`);
+            this.log(`The token with name: "${params === null || params === void 0 ? void 0 : params.token}" was not found.`);
         }
         // Return the default token back.
         return (_a = params === null || params === void 0 ? void 0 : params.token) !== null && _a !== void 0 ? _a : null;
     }
 }
 
+class LocalizeDictionaryData {
+    constructor(data) {
+        this.data = data;
+    }
+}
+
+class LocalizeDictionaryContext {
+    constructor() {
+        this.regexp = /^.*$/;
+    }
+    pattern(regexp) {
+        this.regexp = regexp;
+        return this;
+    }
+    matches(value) {
+        const formatted = this.formatValue(value);
+        const regex = (formatted !== null && formatted !== void 0 ? formatted : '')
+            .replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&')
+            .replace(/\\\*/g, '.*');
+        return this.pattern(new RegExp(`^${regex}$`));
+    }
+    group(value) {
+        const formatted = this.formatValue(value);
+        return this.matches([formatted, '*']);
+    }
+    formatValue(value) {
+        return Array.isArray(value)
+            ? value.filter(item => !!item).join('.')
+            : value;
+    }
+}
+
+class LocalizeDictionary {
+    constructor(_id, _locale, _supported, _dataValues, _localize) {
+        this._id = _id;
+        this._locale = _locale;
+        this._supported = _supported;
+        this._dataValues = _dataValues;
+        this._localize = _localize;
+        this._data = this.formatData(this._dataValues);
+    }
+    get id() {
+        var _a;
+        return (_a = this._id) !== null && _a !== void 0 ? _a : null;
+    }
+    get locale() {
+        var _a;
+        return (_a = this._locale) !== null && _a !== void 0 ? _a : null;
+    }
+    get supported() {
+        var _a;
+        return (_a = this._supported) !== null && _a !== void 0 ? _a : [];
+    }
+    get(token) {
+        var _a, _b;
+        const key = Array.isArray(token) ? token.join('.') : token;
+        return (_b = (_a = this._data) === null || _a === void 0 ? void 0 : _a[key]) !== null && _b !== void 0 ? _b : null;
+    }
+    has(token) {
+        return !!this.get(token);
+    }
+    all() {
+        return this.some(context => context);
+    }
+    some(callback) {
+        var _a;
+        const defaultContext = new LocalizeDictionaryContext();
+        const context = !!callback ? callback(defaultContext) : defaultContext;
+        return Object.keys((_a = this._data) !== null && _a !== void 0 ? _a : {})
+            .filter(key => context.regexp.test(key))
+            .reduce((previous, current) => ([
+            ...previous,
+            { token: current, value: this.get(current) }
+        ]), []);
+    }
+    compare(to) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            if ((typeof ngDevMode === 'undefined' || ngDevMode)) {
+                const dictionaryIds = (Array.isArray(to) ? to : [to]);
+                const dictionaries = [];
+                for (const dictionaryId of dictionaryIds) {
+                    console.log(`Making sure dictionary "${dictionaryId}" is loaded.`);
+                    const dictionary = yield this._localize.load(dictionaryId);
+                    dictionaries.push(dictionary);
+                }
+                const warnings = [];
+                const items = this.all();
+                for (const item of items) {
+                    for (const dictionary of dictionaries) {
+                        if (!dictionary.has(item === null || item === void 0 ? void 0 : item.token)) {
+                            warnings.push({ dictionary: dictionary === null || dictionary === void 0 ? void 0 : dictionary.id, value: item === null || item === void 0 ? void 0 : item.token });
+                        }
+                    }
+                }
+                for (const dictionary of dictionaries) {
+                    const items = dictionary.all();
+                    for (const item of items) {
+                        if (!this.has(item === null || item === void 0 ? void 0 : item.token)) {
+                            warnings.push({ dictionary: this.id, value: item === null || item === void 0 ? void 0 : item.token });
+                        }
+                    }
+                }
+                const compareDictionaryIds = dictionaries.map(dictionary => dictionary === null || dictionary === void 0 ? void 0 : dictionary.id).join(', ');
+                console.log(`Comparing currency dictionary [${this.id}] with [${compareDictionaryIds}]...`);
+                for (const warning of warnings) {
+                    (_a = console === null || console === void 0 ? void 0 : console.warn) === null || _a === void 0 ? void 0 : _a.call(console, `Dictionary "${warning.dictionary}" is missing token "${warning.value}"`);
+                }
+                (_b = console === null || console === void 0 ? void 0 : console.warn) === null || _b === void 0 ? void 0 : _b.call(console, `Total of ${warnings.length} warning(s) found.`);
+            }
+        });
+    }
+    count() {
+        var _a;
+        return Object.keys((_a = this._data) !== null && _a !== void 0 ? _a : {}).length;
+    }
+    formatData(data, scope = null) {
+        return Object.keys(data !== null && data !== void 0 ? data : {}).reduce((previous, current) => {
+            var _a;
+            const value = data === null || data === void 0 ? void 0 : data[current];
+            if (typeof value === 'object' && value !== null) {
+                const reformatted = this.formatData(value, current);
+                return Object.assign(Object.assign({}, previous), reformatted);
+            }
+            const token = [scope, current].filter(item => !!item).join('.');
+            if (previous[token] && (typeof ngDevMode === 'undefined' || ngDevMode)) {
+                (_a = console === null || console === void 0 ? void 0 : console.warn) === null || _a === void 0 ? void 0 : _a.call(console, `Duplicate key "${token}" was found, please verify your translation files.`);
+            }
+            return Object.assign(Object.assign({}, previous), { [token]: value });
+        }, {});
+    }
+}
+
+class LocalizeTransform {
+    getMatches(value, substitutions) {
+        // Validate our value exists, else return zero matches.
+        if (value === undefined || value === null) {
+            return [];
+        }
+        // Get the matching substitutions.
+        const { start, end } = this.getSubstitutions(substitutions);
+        // Compose a regex that will find the matches.
+        const regex = new RegExp(`${start}([^${end}]+)${end}`, 'g');
+        // Execute the regex to find matches.
+        let match = regex.exec(value);
+        const matches = [];
+        while (match !== null) {
+            matches.push({ match: match[0], token: match[1] });
+            match = regex.exec(value);
+        }
+        // Return the processed value.
+        return matches.filter(item => !!item);
+    }
+    getSubstitutions(value) {
+        // Escape both substitutions so that they can be used.
+        const escape = /[.*+?^${}()|[\]\\]/g;
+        const start = value[0].replace(escape, '\\$&');
+        const end = value[1].replace(escape, '\\$&');
+        // Return the substitutions.
+        return { start, end };
+    }
+}
+
+let LocalizeInterpolateTransform = class LocalizeInterpolateTransform extends LocalizeTransform {
+    constructor(config, functions) {
+        var _a, _b, _c, _d;
+        super();
+        this.config = config;
+        this.functions = functions;
+        this.substitutions = (_c = (_b = (_a = this.config) === null || _a === void 0 ? void 0 : _a.substitutions) === null || _b === void 0 ? void 0 : _b.references) !== null && _c !== void 0 ? _c : ['{{', '}}'];
+        this.functionsMap = ((_d = this.functions) !== null && _d !== void 0 ? _d : []).reduce((previous, current) => {
+            previous[current === null || current === void 0 ? void 0 : current.keyword()] = current;
+            return previous;
+        }, {});
+    }
+    execute(value, data, localize) {
+        const matches = this.getMatches(value, this.substitutions);
+        // Replace all matches with the translated value.
+        return matches.reduce((previous, current) => {
+            // Try to parse the token.
+            const interpolatedToken = this.parseInterpolationToken(current === null || current === void 0 ? void 0 : current.token, data, localize);
+            // Replace the match with the translated token.
+            return previous.replace(current === null || current === void 0 ? void 0 : current.match, interpolatedToken);
+        }, value);
+    }
+    parseInterpolationToken(value, data, localize) {
+        var _a;
+        // Get the token and the methods by splitting
+        // on the pipe symbol.
+        const [token, ...methods] = (value !== null && value !== void 0 ? value : '').split('|').map(item => item.trim());
+        // Get the value for the token from
+        // the interpolation data.
+        const interpolationValue = (_a = data === null || data === void 0 ? void 0 : data[token]) !== null && _a !== void 0 ? _a : 'null';
+        // Loop through all the middleware methods and try to
+        // conform the string to the given parameters.
+        return methods.reduce((string, middlewareName) => {
+            var _a, _b;
+            // Try to retrieve the middleware from the collection.
+            const middleware = (_a = this.functionsMap) === null || _a === void 0 ? void 0 : _a[middlewareName];
+            // If the middleware is missing return an error
+            // so that the user knows it was not found.
+            if (!middleware) {
+                return string;
+            }
+            // Execute the middleware function with the string.
+            return middleware.transform(string, (_b = localize === null || localize === void 0 ? void 0 : localize.current) === null || _b === void 0 ? void 0 : _b.locale);
+        }, `${interpolationValue}`);
+    }
+};
+LocalizeInterpolateTransform = __decorate([
+    __param(0, Optional()),
+    __param(1, Optional()),
+    __param(1, Inject(LOCALIZE_FUNCTION))
+], LocalizeInterpolateTransform);
+
+let LocalizeReferenceTransform = class LocalizeReferenceTransform extends LocalizeTransform {
+    constructor(config) {
+        var _a, _b, _c;
+        super();
+        this.config = config;
+        this.substitutions = (_c = (_b = (_a = this.config) === null || _a === void 0 ? void 0 : _a.substitutions) === null || _b === void 0 ? void 0 : _b.references) !== null && _c !== void 0 ? _c : ['#(', ')'];
+    }
+    execute(value, _, localize) {
+        const matches = this.getMatches(value, this.substitutions);
+        // Replace all matches with the translated value.
+        return matches.reduce((previous, current) => {
+            // Try to translate the token.
+            const translatedToken = localize.translate(current === null || current === void 0 ? void 0 : current.token);
+            // Replace the match with the translated token.
+            return previous.replace(current === null || current === void 0 ? void 0 : current.match, translatedToken);
+        }, value);
+    }
+};
+LocalizeReferenceTransform = __decorate([
+    __param(0, Optional())
+], LocalizeReferenceTransform);
+
 class BbLocalizeTemplate {
     constructor(templateRef) {
         this.templateRef = templateRef;
@@ -276,82 +516,34 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "14.2.0", ngImpor
                 type: Input
             }] } });
 
-class LocalizeDictionary {
-    constructor(data) {
-        this._data = this.formatData(data);
-    }
-    get(token) {
-        var _a, _b;
-        const key = Array.isArray(token) ? token.join('.') : token;
-        return (_b = (_a = this._data) === null || _a === void 0 ? void 0 : _a[key]) !== null && _b !== void 0 ? _b : null;
-    }
-    formatData(data, scope = null) {
-        return Object.keys(data).reduce((previous, current) => {
-            var _a;
-            const value = data === null || data === void 0 ? void 0 : data[current];
-            if (typeof value === 'object' && value !== null) {
-                const reformatted = this.formatData(value, current);
-                return Object.assign(Object.assign({}, previous), reformatted);
-            }
-            const token = [scope, current].filter(item => !!item).join('.');
-            if (previous[token] && (typeof ngDevMode === 'undefined' || ngDevMode)) {
-                (_a = console === null || console === void 0 ? void 0 : console.warn) === null || _a === void 0 ? void 0 : _a.call(console, `Localize: Duplicate key "${token}" was found, please verify your translation files.`);
-            }
-            return Object.assign(Object.assign({}, previous), { [token]: value });
-        }, {});
-    }
-}
-
 class Localize {
-    constructor(_storage, _languages, _config, _missingHandler, _document, _functions) {
+    constructor(_storage, _languages, _missingHandler, _config, _window, _document, _transforms) {
+        var _a, _b, _c, _d;
         this._storage = _storage;
         this._languages = _languages;
-        this._config = _config;
         this._missingHandler = _missingHandler;
+        this._config = _config;
+        this._window = _window;
         this._document = _document;
-        this._functions = _functions;
-        this._storageToken = 'bb-language-dictionary-id';
-        // Current language dictionary.
-        this._currentLanguage = null;
-        this._currentDictionary = null;
+        this._transforms = _transforms;
+        // Readonly data.
+        this._storageToken = (_b = (_a = this._config) === null || _a === void 0 ? void 0 : _a.storageToken) !== null && _b !== void 0 ? _b : 'bb-language-dictionary-id';
+        this._availableLanguages = (_d = (_c = this === null || this === void 0 ? void 0 : this._config) === null || _c === void 0 ? void 0 : _c.languages) !== null && _d !== void 0 ? _d : [];
+        this._bestMatchingLanguage = this.retrieveBestMatchingLanguage();
+        this._loadedDictionaries = new Map();
+        // Current dictionary.
+        this._current = null;
         this.convertToParams = (tokenOrParams) => {
             if (typeof tokenOrParams !== 'string') {
                 // Destruct the params from the object.
-                const { token, optional, data } = tokenOrParams;
+                const { token, optional, dictionary, data } = tokenOrParams;
                 // Make sure all parameters are valid
                 // by type safe adding them.
-                return { token: token, optional: optional !== null && optional !== void 0 ? optional : false, data: data !== null && data !== void 0 ? data : {} };
+                return { token: token, optional: optional !== null && optional !== void 0 ? optional : false, dictionary: dictionary !== null && dictionary !== void 0 ? dictionary : null, data: data !== null && data !== void 0 ? data : {} };
             }
             // If the parameter is a string fill in the blanks.
-            return { token: tokenOrParams, optional: false, data: {} };
-        };
-        this.getMatches = (value, substitutions) => {
-            // Get the matching substitutions.
-            const { start, end } = substitutions;
-            // Compose a regex that will find the matches.
-            const regex = new RegExp(`${start}([^${end}]+)${end}`, 'g');
-            // Execute the regex to find matches.
-            let match = regex.exec(value);
-            const matches = [];
-            while (match !== null) {
-                matches.push({ match: match[0], token: match[1] });
-                match = regex.exec(value);
-            }
-            // Return the processed value.
-            return matches.filter(item => !!item);
+            return { token: tokenOrParams, optional: false, dictionary: null, data: {} };
         };
-        // Check if at least one language was passed in the config.
-        this._availableLanguages = this._config.languages;
-        if (this._availableLanguages.length < 1) {
-            throw new Error('Localize: one or more languages should be supplied.');
-        }
-        // Gather all the localize functions.
-        this._functionMiddleware = this._functions.reduce((previous, current) => {
-            previous[current.keyword()] = current;
-            return previous;
-        }, {});
-        // Save the best matching current dictionary.
-        this._bestMatchingLanguage = this.retrieveBestMatchingLanguage();
         this.renderDocumentLanguage();
     }
     get languages() {
@@ -359,115 +551,77 @@ class Localize {
         return (_a = this._availableLanguages) !== null && _a !== void 0 ? _a : [];
     }
     get current() {
-        return this._currentLanguage;
+        return this._current;
     }
-    set(language, cache = true) {
-        var _a, _b;
+    load(id) {
+        var _a, _b, _c, _d, _e, _f;
         return __awaiter(this, void 0, void 0, function* () {
-            // Await the language data and set the current
-            // dictionary to the loaded data.
-            this._currentLanguage = language !== null && language !== void 0 ? language : (_a = this._availableLanguages) === null || _a === void 0 ? void 0 : _a[0];
-            if (this._currentLanguage) {
-                this._currentDictionary = yield this._currentLanguage.data();
+            if (id === null || id === undefined) {
+                throw new Error(`Cannot load language with id: "${id}".`);
+            }
+            if (this._loadedDictionaries.has(id)) {
+                return this._loadedDictionaries.get(id);
             }
-            // Save the selected language in the storage.
+            const language = (_a = this.languages) === null || _a === void 0 ? void 0 : _a.find(language => (language === null || language === void 0 ? void 0 : language.id) === id);
+            if (!language || !(language === null || language === void 0 ? void 0 : language.data)) {
+                (_b = console === null || console === void 0 ? void 0 : console.warn) === null || _b === void 0 ? void 0 : _b.call(console, `No language was found with id: "${id}"; Defaulting to first available language.`);
+                const languageId = (_e = (_d = (_c = this.languages) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.id) !== null && _e !== void 0 ? _e : null;
+                return this.load(languageId);
+            }
+            const dictionaryDataValues = yield ((_f = language === null || language === void 0 ? void 0 : language.data) === null || _f === void 0 ? void 0 : _f.call(language));
+            const dictionary = this.createDictionary(dictionaryDataValues, language);
+            this._loadedDictionaries.set(id, dictionary);
+            return dictionary;
+        });
+    }
+    switch(id, options) {
+        var _a, _b, _c, _d, _e, _f;
+        return __awaiter(this, void 0, void 0, function* () {
+            this._current = yield this.load(id);
+            const cache = (_a = options === null || options === void 0 ? void 0 : options.cache) !== null && _a !== void 0 ? _a : true;
             if (cache) {
-                this._storage.cookie.set(this._storageToken, (_b = this._currentLanguage) === null || _b === void 0 ? void 0 : _b.id, {});
+                this._storage.cookie.set(this._storageToken, (_b = this._current) === null || _b === void 0 ? void 0 : _b.id, {});
+            }
+            const reload = (_c = options === null || options === void 0 ? void 0 : options.reload) !== null && _c !== void 0 ? _c : false;
+            if (reload) {
+                (_f = (_e = (_d = this._window) === null || _d === void 0 ? void 0 : _d.location) === null || _e === void 0 ? void 0 : _e.reload) === null || _f === void 0 ? void 0 : _f.call(_e);
             }
+            return this._current;
         });
     }
+    select(id) {
+        if (!this._loadedDictionaries.has(id)) {
+            throw new Error(`Dictionary with id: "${id}" not loaded; Load dictionary first before using .select(:id).`);
+        }
+        return this._loadedDictionaries.get(id);
+    }
     initialize() {
-        return () => __awaiter(this, void 0, void 0, function* () { return this.set(this._bestMatchingLanguage, false); });
+        return () => __awaiter(this, void 0, void 0, function* () { var _a; return this.switch((_a = this._bestMatchingLanguage) === null || _a === void 0 ? void 0 : _a.id, { reload: false, cache: false }); });
     }
     clear() {
         this._storage.cookie.remove(this._storageToken);
     }
+    transform(value, data = {}) {
+        var _a;
+        return ((_a = this._transforms) !== null && _a !== void 0 ? _a : []).reduce((previous, current) => {
+            return current.execute(previous, data, this);
+        }, value);
+    }
     translate(tokenOrParams) {
         // 1. Convert to the params.
         const params = this.convertToParams(tokenOrParams);
         // 2. Try to find the translation in the dictionary.
-        const searchResult = this._currentDictionary.get(params === null || params === void 0 ? void 0 : params.token);
+        const dictionary = this.getDictionary(params === null || params === void 0 ? void 0 : params.dictionary);
+        const searchResult = !!dictionary ? dictionary.get(params === null || params === void 0 ? void 0 : params.token) : null;
         // 3. Verify the translation was found.
         if (!searchResult) {
             return this._missingHandler.handle(params);
         }
-        // 4. Find references in the translation that need to be translated as well.
-        const processResult = this.findReferencesInTranslation(searchResult);
-        // 5. Parse the interpolation data.
-        return this.parseInterpolationData(processResult, params === null || params === void 0 ? void 0 : params.data);
-    }
-    parseInterpolationData(value, data) {
-        // Get the interpolation substitutions.
-        const substitutions = this.getSubstitutions('interpolation', ['{{', '}}']);
-        // Get all matches in the value.
-        const matches = this.getMatches(value, substitutions);
-        // Replace all matches with the parsed value.
-        return matches.reduce((previous, current) => {
-            // Try to parse the token.
-            const interpolatedToken = this.interpolateFunctionData(current === null || current === void 0 ? void 0 : current.token, data);
-            // Replace the match with the parsed token.
-            return previous.replace(current === null || current === void 0 ? void 0 : current.match, interpolatedToken);
-        }, `${value}`);
-    }
-    interpolateFunctionData(value, interpolationData) {
-        var _a;
-        // Get the token and the methods by splitting
-        // on the pipe symbol.
-        const [token, ...methods] = value.split('|').map(item => item.trim());
-        // Get the value for the token from
-        // the interpolation data.
-        const interpolationValue = (_a = interpolationData === null || interpolationData === void 0 ? void 0 : interpolationData[token]) !== null && _a !== void 0 ? _a : token;
-        // Loop through all the middleware methods and try to
-        // conform the string to the given parameters.
-        return methods.reduce((string, middlewareName) => {
-            var _a;
-            // Try to retrieve the middleware from the collection.
-            const middleware = this._functionMiddleware[middlewareName];
-            // If the middleware is missing return an error
-            // so that the user knows it was not found.
-            if (!middleware) {
-                return string;
-            }
-            // Execute the middleware function with the string.
-            return middleware.transform(string, (_a = this.current) === null || _a === void 0 ? void 0 : _a.locale);
-        }, `${interpolationValue}`);
-    }
-    findReferencesInTranslation(value) {
-        // Get the reference substitutions.
-        const substitutions = this.getSubstitutions('references', ['#(', ')']);
-        // Get all matches in the value.
-        const matches = this.getMatches(value, substitutions);
-        // Replace all matches with the translated value.
-        return matches.reduce((previous, current) => {
-            // Try to translate the token.
-            const translatedToken = this.translate(current === null || current === void 0 ? void 0 : current.token);
-            // Replace the match with the translated token.
-            return previous.replace(current === null || current === void 0 ? void 0 : current.match, translatedToken);
-        }, value);
-    }
-    getSubstitutions(type, defaultValue) {
-        var _a, _b, _c;
-        // Get the substitutions.
-        const substitutions = (_c = (_b = (_a = this._config) === null || _a === void 0 ? void 0 : _a.substitutions) === null || _b === void 0 ? void 0 : _b[type]) !== null && _c !== void 0 ? _c : null;
-        const value = (!substitutions || substitutions.length !== 2)
-            ? defaultValue
-            : substitutions;
-        // Escape both substitutions so that they
-        // can be used.
-        const escape = /[.*+?^${}()|[\]\\]/g;
-        const start = value[0].replace(escape, '\\$&');
-        const end = value[1].replace(escape, '\\$&');
-        // Return the substitutions.
-        return { start, end };
+        return this.transform(searchResult, params === null || params === void 0 ? void 0 : params.data);
     }
     retrieveBestMatchingLanguage() {
-        var _a, _b;
-        // Get the language based on storage.
-        const storageLanguage = this.getLanguageFromStorage();
-        // Get the language based on the supported languages of the browser.
-        const browserLanguage = this.getBestBrowserMatchLanguage();
-        // Return the best matching language.
-        return (_a = storageLanguage !== null && storageLanguage !== void 0 ? storageLanguage : browserLanguage) !== null && _a !== void 0 ? _a : (_b = this._availableLanguages) === null || _b === void 0 ? void 0 : _b[0];
+        var _a, _b, _c;
+        return (_b = (_a = this.getLanguageFromStorage()) !== null && _a !== void 0 ? _a : this.getBestBrowserMatchLanguage()) !== null && _b !== void 0 ? _b : (_c = this._availableLanguages) === null || _c === void 0 ? void 0 : _c[0];
     }
     getLanguageFromStorage() {
         // Get id from the storage.
@@ -483,6 +637,15 @@ class Localize {
             return this._availableLanguages.find(item => { var _a; return (_a = item === null || item === void 0 ? void 0 : item.supported) === null || _a === void 0 ? void 0 : _a.includes(languageCode); });
         }).filter(item => !!item).find((_, index) => index === 0);
     }
+    createDictionary(data, language) {
+        return new LocalizeDictionary(language === null || language === void 0 ? void 0 : language.id, language === null || language === void 0 ? void 0 : language.locale, language === null || language === void 0 ? void 0 : language.supported, data === null || data === void 0 ? void 0 : data.data, this);
+    }
+    getDictionary(id) {
+        if (id === null || id === undefined) {
+            return this._current;
+        }
+        return this.select(id);
+    }
     renderDocumentLanguage() {
         var _a, _b, _c, _d, _e;
         const element = (_a = this._document) === null || _a === void 0 ? void 0 : _a.documentElement;
@@ -492,14 +655,19 @@ class Localize {
         element.lang = (_d = (_c = (_b = this._bestMatchingLanguage) === null || _b === void 0 ? void 0 : _b.supported) === null || _c === void 0 ? void 0 : _c[0]) !== null && _d !== void 0 ? _d : (_e = this._bestMatchingLanguage) === null || _e === void 0 ? void 0 : _e.locale;
     }
 }
-Localize.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "14.2.0", ngImport: i0, type: Localize, deps: [{ token: i1$1.Storage }, { token: i2$1.Languages }, { token: LocalizeConfig, optional: true }, { token: LocalizeMissingHandler }, { token: DOCUMENT, optional: true }, { token: LOCALIZE_FUNCTION, optional: true }], target: i0.ɵɵFactoryTarget.Injectable });
+Localize.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "14.2.0", ngImport: i0, type: Localize, deps: [{ token: i1$1.Storage }, { token: i2$1.Languages }, { token: LocalizeMissingHandler }, { token: LocalizeConfig, optional: true }, { token: WINDOW, optional: true }, { token: DOCUMENT, optional: true }, { token: LOCALIZE_TRANSFORM, optional: true }], target: i0.ɵɵFactoryTarget.Injectable });
 Localize.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "14.2.0", ngImport: i0, type: Localize });
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "14.2.0", ngImport: i0, type: Localize, decorators: [{
             type: Injectable
         }], ctorParameters: function () {
-        return [{ type: i1$1.Storage }, { type: i2$1.Languages }, { type: LocalizeConfig, decorators: [{
+        return [{ type: i1$1.Storage }, { type: i2$1.Languages }, { type: LocalizeMissingHandler }, { type: LocalizeConfig, decorators: [{
+                        type: Optional
+                    }] }, { type: Window, decorators: [{
                         type: Optional
-                    }] }, { type: LocalizeMissingHandler }, { type: Document, decorators: [{
+                    }, {
+                        type: Inject,
+                        args: [WINDOW]
+                    }] }, { type: Document, decorators: [{
                         type: Optional
                     }, {
                         type: Inject,
@@ -508,7 +676,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "14.2.0", ngImpor
                         type: Optional
                     }, {
                         type: Inject,
-                        args: [LOCALIZE_FUNCTION]
+                        args: [LOCALIZE_TRANSFORM]
                     }] }];
     } });
 
@@ -517,8 +685,7 @@ class BbLocalize {
         this._localize = _localize;
     }
     transform(tokenOrParams, args) {
-        // Validate that the localize service
-        // exists in the pipe.
+        // Validate that the localize service exists in the pipe.
         if (!this._localize) {
             return tokenOrParams;
         }
@@ -530,7 +697,7 @@ class BbLocalize {
     }
     combineParamsWithOptions(tokenOrParams, args) {
         // Gather the extras.
-        const extras = args || {};
+        const extras = args !== null && args !== void 0 ? args : {};
         // Loop through all the keys to find the set options.
         const options = Object.keys(extras).reduce((previous, current) => {
             if (typeof extras[current] === 'undefined') {
@@ -541,7 +708,7 @@ class BbLocalize {
         }, {});
         // Convert the string token to a params object.
         const params = typeof tokenOrParams === 'string'
-            ? { token: tokenOrParams, optional: false, data: {} }
+            ? { token: tokenOrParams, optional: false, data: {}, dictionary: null }
             : tokenOrParams;
         // Return the combined params and options.
         return Object.assign(Object.assign({}, params), options);
@@ -563,12 +730,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "14.2.0", ngImpor
 class LocalizeModule {
     static forRoot(config) {
         var _a;
-        const automatic = (_a = config === null || config === void 0 ? void 0 : config.automatic) !== null && _a !== void 0 ? _a : true;
+        if (((_a = config === null || config === void 0 ? void 0 : config.languages) === null || _a === void 0 ? void 0 : _a.length) <= 0) {
+            throw new Error('One or more languages should be supplied.');
+        }
         return {
             ngModule: LocalizeModule,
             providers: [
                 // Angular providers.
-                ...(automatic ? [
+                ...((config === null || config === void 0 ? void 0 : config.mode) === 'automatic' ? [
                     { provide: APP_INITIALIZER, deps: [Localize], useFactory: initializeLocale, multi: true },
                     { provide: LOCALE_ID, deps: [Localize], useFactory: getLocale }
                 ] : []),
@@ -578,6 +747,9 @@ class LocalizeModule {
                 { provide: LOCALIZE_FUNCTION, useClass: LocalizeLowercaseFunction, multi: true },
                 { provide: LOCALIZE_FUNCTION, useClass: LocalizeUppercaseFunction, multi: true },
                 { provide: LOCALIZE_FUNCTION, useClass: LocalizeDateFunction, multi: true },
+                // Transform providers.
+                { provide: LOCALIZE_TRANSFORM, useClass: LocalizeReferenceTransform, deps: [LocalizeConfig], multi: true },
+                { provide: LOCALIZE_TRANSFORM, useClass: LocalizeInterpolateTransform, deps: [LocalizeConfig, LOCALIZE_FUNCTION], multi: true },
                 // Handler providers.
                 { provide: LocalizeMissingHandler, useClass: LocalizeMissingHandler },
                 // Service providers.
@@ -621,5 +793,5 @@ function getLocale(localize) {
  * Generated bundle index. Do not edit.
  */
 
-export { BbLocalize, BbLocalizeString, BbLocalizeTemplate, LOCALIZE_FUNCTION, Localize, LocalizeConfig, LocalizeDateFunction, LocalizeDictionary, LocalizeLowercaseFunction, LocalizeMissingHandler, LocalizeModule, LocalizeUppercaseFunction, extraDutchDictionary, extraEnglishDictionary, getLocale, initializeLocale };
+export { BbLocalize, BbLocalizeString, BbLocalizeTemplate, LOCALIZE_FUNCTION, LOCALIZE_TRANSFORM, Localize, LocalizeConfig, LocalizeDateFunction, LocalizeDictionary, LocalizeDictionaryContext, LocalizeDictionaryData, LocalizeInterpolateTransform, LocalizeLowercaseFunction, LocalizeMissingHandler, LocalizeModule, LocalizeReferenceTransform, LocalizeTransform, LocalizeUppercaseFunction, extraDutchDictionary, extraEnglishDictionary, getLocale, initializeLocale };
 //# sourceMappingURL=bravobit-bb-foundation-localize.mjs.map