Initializes the translator utility.
The default language code (e.g. 'en', 'fr') to fallback to if a key is missing.
ProtecteddeepA helper method to perform recursive deep-merging of two dictionary objects.
The base target object.
The source object containing updates to merge.
The deep-merged dictionary object.
Dynamically extends and merges existing translation dictionaries. This allows consuming applications to register their specific UI translations at runtime.
A record mapping language keys (e.g. 'en', 'fr') to custom dictionaries.
Dynamically extends and merges an existing dictionary for a given language. This allows consuming applications to register their specific UI translations at runtime.
The language key code (e.g. 'en', 'fr').
The custom dictionary object containing terms to merge.
Returns a Proxy object representing a callable translation shortcut function t.
Optionallang: stringOptional default language code override for this proxy instance.
A callable and chainable translation Proxy.
Registers one or multiple translation language dictionaries.
A record mapping language keys (e.g. 'en', 'fr') to dictionaries.
Registers a specific translation language dictionary.
The language key code (e.g. 'en', 'fr').
The fully conforming Quatrain dictionary instance.
Translates a specific text label key inside a given dictionary scope. Supports both standard (scope, key) calls and dotted key path (e.g. "backends.title") notation.
The dictionary scope key (e.g. 'table') or a dotted key path (e.g. 'app.title').
OptionalkeyOrLang: stringThe specific term key inside the selected scope, or the language code if scope is a dotted key.
Optionallang: stringThe target language code to extract from (falls back to default language).
The localized translation string, or the raw key string if no match was found.
A standard, framework-agnostic translation manager and dictionary resolver. Handles language registration and scoped key extraction with safety fallbacks.