generaltranslation 8.2.13 → 8.2.14

package/dist/locales/getRegionProperties.js

@@ -1,61 +0,0 @@
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-import { intlCache } from '../cache/IntlCache';
-import { libraryDefaultLocale } from '../settings/settings';
-import { defaultEmoji, getRegionEmoji } from './getLocaleEmoji';
-/**
- * Retrieves multiple properties for a given region code, including:
- * - `code`: the original region code
- * - `name`: the localized display name
- * - `emoji`: the associated flag or symbol
- *
- * Behavior:
- * - Accepts ISO 3166-1 alpha-2 or UN M.49 region codes (e.g., `"US"`, `"FR"`, `"419"`).
- * - If `customMapping` contains a `name` or `emoji` for the region, those override the default values.
- * - Otherwise, uses `Intl.DisplayNames` to get the localized region name in the given `defaultLocale`,
- *   falling back to `libraryDefaultLocale`.
- * - Falls back to the region code as `name` if display name resolution fails.
- * - Falls back to `defaultEmoji` if no emoji can be computed or found in `customMapping`.
- *
- * @param {string} region - The region code to look up (e.g., `"US"`, `"GB"`, `"DE"`).
- * @param {string} [defaultLocale=libraryDefaultLocale] - The locale to use when localizing the region name.
- * @param {CustomRegionMapping} [customMapping] - Optional mapping of region codes to custom names and/or emojis.
- * @returns {{ code: string, name: string, emoji: string }} An object containing:
- *  - `code`: the input region code
- *  - `name`: the localized or custom region name
- *  - `emoji`: the matching emoji flag or symbol
- * @internal
- *
- * @example
- * _getRegionProperties('US', 'en');
- * // => { code: 'US', name: 'United States', emoji: '🇺🇸' }
- *
- * @example
- * _getRegionProperties('US', 'fr');
- * // => { code: 'US', name: 'États-Unis', emoji: '🇺🇸' }
- *
- * @example
- * _getRegionProperties('US', 'en', { US: { name: 'USA', emoji: '🗽' } });
- * // => { code: 'US', name: 'USA', emoji: '🗽' }
- */
-export function _getRegionProperties(region, defaultLocale, customMapping) {
-    if (defaultLocale === void 0) { defaultLocale = libraryDefaultLocale; }
-    defaultLocale || (defaultLocale = libraryDefaultLocale);
-    try {
-        var displayNames = intlCache.get('DisplayNames', [defaultLocale, libraryDefaultLocale], // default language order
-        { type: 'region' });
-        return __assign({ code: region, name: displayNames.of(region) || region, emoji: getRegionEmoji(region) }, customMapping === null || customMapping === void 0 ? void 0 : customMapping[region]);
-    }
-    catch (_a) {
-        return __assign({ code: region, name: region, emoji: defaultEmoji }, customMapping === null || customMapping === void 0 ? void 0 : customMapping[region]);
-    }
-}

package/dist/locales/isSameDialect.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/locales/isSameDialect.js

@@ -1,41 +0,0 @@
-import { intlCache } from '../cache/IntlCache';
-import { _standardizeLocale } from './isValidLocale';
-function checkTwoLocalesAreSameDialect(codeA, codeB) {
-    var _a = intlCache.get('Locale', codeA), languageA = _a.language, regionA = _a.region, scriptA = _a.script;
-    var _b = intlCache.get('Locale', codeB), languageB = _b.language, regionB = _b.region, scriptB = _b.script;
-    if (languageA !== languageB)
-        return false;
-    if (regionA && regionB && regionA !== regionB)
-        return false;
-    if (scriptA && scriptB && scriptA !== scriptB)
-        return false;
-    return true;
-}
-/**
- * Test two or more language codes to determine if they are exactly the same
- * e.g. "en-US" and "en" would be exactly the same.
- * "en-GB" and "en" would be exactly the same.
- * "en-GB" and "en-US" would be different.
- * @internal
- */
-export default function _isSameDialect() {
-    var locales = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        locales[_i] = arguments[_i];
-    }
-    try {
-        // standardize codes
-        var flattenedCodes = locales.flat().map(_standardizeLocale);
-        for (var i = 0; i < flattenedCodes.length; i++) {
-            for (var j = i + 1; j < flattenedCodes.length; j++) {
-                if (!checkTwoLocalesAreSameDialect(flattenedCodes[i], flattenedCodes[j]))
-                    return false;
-            }
-        }
-        return true;
-    }
-    catch (error) {
-        console.error(error);
-        return false;
-    }
-}

package/dist/locales/isSameLanguage.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/locales/isSameLanguage.js

@@ -1,20 +0,0 @@
-import { intlCache } from '../cache/IntlCache';
-/**
- * @internal
- */
-export default function _isSameLanguage() {
-    var locales = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        locales[_i] = arguments[_i];
-    }
-    try {
-        var flattenedCodes = locales.flat();
-        // Get the language for each code
-        var languages_1 = flattenedCodes.map(function (locale) { return intlCache.get('Locale', locale).language; });
-        return languages_1.every(function (language) { return language === languages_1[0]; });
-    }
-    catch (error) {
-        console.error(error);
-        return false;
-    }
-}

package/dist/locales/isSupersetLocale.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/locales/isSupersetLocale.js

@@ -1,22 +0,0 @@
-import { intlCache } from '../cache/IntlCache';
-import { _standardizeLocale } from './isValidLocale';
-/**
- * @internal
- */
-export default function _isSupersetLocale(superLocale, subLocale) {
-    try {
-        var _a = intlCache.get('Locale', _standardizeLocale(superLocale)), languageSuper = _a.language, regionSuper = _a.region, scriptSuper = _a.script;
-        var _b = intlCache.get('Locale', _standardizeLocale(subLocale)), languageSub = _b.language, regionSub = _b.region, scriptSub = _b.script;
-        if (languageSuper !== languageSub)
-            return false;
-        if (regionSuper && regionSuper !== regionSub)
-            return false;
-        if (scriptSuper && scriptSuper !== scriptSub)
-            return false;
-        return true;
-    }
-    catch (error) {
-        console.error(error);
-        return false;
-    }
-}

package/dist/locales/isValidLocale.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/locales/isValidLocale.js

@@ -1,75 +0,0 @@
-import { intlCache } from '../cache/IntlCache';
-import { libraryDefaultLocale } from '../settings/settings';
-var scriptExceptions = ['Cham', 'Jamo', 'Kawi', 'Lisu', 'Toto', 'Thai'];
-//// According to BCP 47, the range qaa–qtz is reserved for private-use language codes
-var isCustomLanguage = function (language) {
-    return language >= 'qaa' && language <= 'qtz';
-};
-/**
- * Checks if a given BCP 47 language code is valid.
- * @param {string} code - The BCP 47 language code to validate.
- * @param {CustomMapping} [customMapping] - The custom mapping to use for validation.
- * @returns {boolean} True if the BCP 47 code is valid, false otherwise.
- * @internal
- */
-export var _isValidLocale = function (locale, customMapping) {
-    // If in custom mapping, return true
-    if ((customMapping === null || customMapping === void 0 ? void 0 : customMapping[locale]) &&
-        typeof customMapping[locale] === 'object' &&
-        'code' in customMapping[locale] &&
-        customMapping[locale].code) {
-        locale = customMapping[locale].code;
-    }
-    try {
-        var _a = intlCache.get('Locale', locale), language = _a.language, region_1 = _a.region, script_1 = _a.script;
-        if (locale.split('-').length !==
-            (function () {
-                var partCount = 1;
-                if (region_1)
-                    partCount += 1;
-                if (script_1)
-                    partCount += 1;
-                return partCount;
-            })())
-            return false;
-        var displayLanguageNames = intlCache.get('DisplayNames', [libraryDefaultLocale], {
-            type: 'language',
-        });
-        if (displayLanguageNames.of(language) === language &&
-            !isCustomLanguage(language))
-            return false;
-        if (region_1) {
-            var displayRegionNames = intlCache.get('DisplayNames', [libraryDefaultLocale], {
-                type: 'region',
-            });
-            if (displayRegionNames.of(region_1) === region_1)
-                return false;
-        }
-        if (script_1) {
-            var displayScriptNames = intlCache.get('DisplayNames', [libraryDefaultLocale], {
-                type: 'script',
-            });
-            if (displayScriptNames.of(script_1) === script_1 &&
-                !scriptExceptions.includes(script_1))
-                return false;
-        }
-        return true;
-    }
-    catch (_b) {
-        return false;
-    }
-};
-/**
- * Standardizes a BCP 47 locale to ensure correct formatting.
- * @param {string} locale - The BCP 47 locale to standardize.
- * @returns {string} The standardized BCP 47 locale, or the input string if it cannot be standardized.
- * @internal
- */
-export var _standardizeLocale = function (locale) {
-    try {
-        return Intl.getCanonicalLocales(locale)[0];
-    }
-    catch (_a) {
-        return locale;
-    }
-};

package/dist/locales/requiresTranslation.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/locales/requiresTranslation.js

@@ -1,32 +0,0 @@
-import _isSameDialect from './isSameDialect';
-import _isSameLanguage from './isSameLanguage';
-import { _isValidLocale } from './isValidLocale';
-/**
- * Given a target locale and a source locale, determines whether a translation is required
- * If the target locale and the source locale are the same, returns false, otherwise returns true
- * If a translation is not possible due to the target locale being outside of the optional approvedLanguages scope, also returns false
- * @internal
- */
-export default function _requiresTranslation(sourceLocale, targetLocale, approvedLocales, customMapping) {
-    // If codes are invalid
-    if (!_isValidLocale(sourceLocale, customMapping) ||
-        !_isValidLocale(targetLocale, customMapping) ||
-        (approvedLocales &&
-            approvedLocales.some(function (approvedLocale) { return !_isValidLocale(approvedLocale, customMapping); }))) {
-        return false;
-    }
-    // Check if the languages are identical, if so, a translation is not required
-    if (_isSameDialect(sourceLocale, targetLocale)) {
-        return false;
-    }
-    // Check that the target locale is within the approvedLocales scope, if not, a translation is not required
-    // isSameLanguage rather than checkTwoLocalesAreSameDialect so we can show different dialects as a fallback
-    if (approvedLocales &&
-        !approvedLocales.some(function (approvedLocale) {
-            return _isSameLanguage(targetLocale, approvedLocale);
-        })) {
-        return false;
-    }
-    // Otherwise, a translation is required!
-    return true;
-}

package/dist/locales/resolveAliasLocale.d.ts

@@ -1,8 +0,0 @@
-import { CustomMapping } from './customLocaleMapping';
-/**
- * Resolves the alias locale for a given locale.
- * @param locale - The locale to resolve the alias locale for
- * @param customMapping - The custom mapping to use for resolving the alias locale
- * @returns The configured alias for a canonical locale, or the input locale when already an alias or no alias mapping exists.
- */
-export declare function _resolveAliasLocale(locale: string, customMapping?: CustomMapping): string;

package/dist/locales/resolveAliasLocale.js

@@ -1,21 +0,0 @@
-/**
- * Resolves the alias locale for a given locale.
- * @param locale - The locale to resolve the alias locale for
- * @param customMapping - The custom mapping to use for resolving the alias locale
- * @returns The configured alias for a canonical locale, or the input locale when already an alias or no alias mapping exists.
- */
-export function _resolveAliasLocale(locale, customMapping) {
-    var reverseCustomMapping;
-    if (customMapping) {
-        reverseCustomMapping = Object.fromEntries(Object.entries(customMapping)
-            .filter(function (_a) {
-            var value = _a[1];
-            return value && typeof value === 'object' && 'code' in value;
-        })
-            .map(function (_a) {
-            var key = _a[0], value = _a[1];
-            return [value.code, key];
-        }));
-    }
-    return (reverseCustomMapping === null || reverseCustomMapping === void 0 ? void 0 : reverseCustomMapping[locale]) || locale;
-}

package/dist/locales/resolveCanonicalLocale.d.ts

@@ -1,8 +0,0 @@
-import { CustomMapping } from './customLocaleMapping';
-/**
- * Resolves the canonical locale for a given locale.
- * @param locale - The locale to resolve the canonical locale for
- * @param customMapping - The custom mapping to use for resolving the canonical locale
- * @returns The canonical locale, or the input locale when no canonical mapping exists.
- */
-export declare function _resolveCanonicalLocale(locale: string, customMapping?: CustomMapping): string;

package/dist/locales/resolveCanonicalLocale.js

@@ -1,13 +0,0 @@
-import { shouldUseCanonicalLocale } from './customLocaleMapping';
-/**
- * Resolves the canonical locale for a given locale.
- * @param locale - The locale to resolve the canonical locale for
- * @param customMapping - The custom mapping to use for resolving the canonical locale
- * @returns The canonical locale, or the input locale when no canonical mapping exists.
- */
-export function _resolveCanonicalLocale(locale, customMapping) {
-    if (customMapping && shouldUseCanonicalLocale(locale, customMapping)) {
-        return customMapping[locale].code;
-    }
-    return locale;
-}

package/dist/logging/warnings.d.ts

@@ -1,2 +0,0 @@
-export declare const formatI18nextWarning = "Warning: formatI18next is not currently supported but will be implemented in a future version. Use _formatMessageICU for current ICU message format support.";
-export declare const formatJsxWarning = "Warning: formatJsx is not currently supported but will be implemented in a future version. Use _formatMessageICU for current ICU message format support.";

package/dist/logging/warnings.js

@@ -1,2 +0,0 @@
-export var formatI18nextWarning = 'Warning: formatI18next is not currently supported but will be implemented in a future version. Use _formatMessageICU for current ICU message format support.';
-export var formatJsxWarning = 'Warning: formatJsx is not currently supported but will be implemented in a future version. Use _formatMessageICU for current ICU message format support.';

package/dist/types-dir/jsx/content.d.ts

@@ -1,61 +0,0 @@
-import { Variable } from './variables';
-/**
- * Map of data-_gt properties to their corresponding React props
- */
-export declare const HTML_CONTENT_PROPS: {
-    readonly pl: "placeholder";
-    readonly ti: "title";
-    readonly alt: "alt";
-    readonly arl: "aria-label";
-    readonly arb: "aria-labelledby";
-    readonly ard: "aria-describedby";
-};
-export type HtmlContentPropKeysRecord = Partial<Record<keyof typeof HTML_CONTENT_PROPS, string>>;
-export type HtmlContentPropValuesRecord = Partial<Record<(typeof HTML_CONTENT_PROPS)[keyof typeof HTML_CONTENT_PROPS], string>>;
-/**
- * GTProp is an internal property used to contain data for translating and rendering elements.
- * note, transformations are only read on the server side if they are 'plural' or 'branch'
- */
-export type GTProp = {
-    b?: Record<string, JsxChildren>;
-    t?: 'p' | 'b';
-} & HtmlContentPropKeysRecord;
-export type JsxElement = {
-    t?: string;
-    i?: number;
-    d?: GTProp;
-    c?: JsxChildren;
-};
-export type JsxChild = string | JsxElement | Variable;
-/**
- * The format of the string content
- */
-export type StringFormat = 'ICU' | 'I18NEXT' | 'STRING';
-/**
- * The format of the content.
- */
-export type DataFormat = 'JSX' | StringFormat;
-/**
- * String format content.
- */
-export type StringContent = IcuMessage | StringMessage | I18nextMessage;
-/**
- * A content type representing JSX, ICU, and I18next messages.
- */
-export type Content = JsxChildren | StringContent;
-/**
- * A content type representing JSX elements.
- */
-export type JsxChildren = JsxChild | JsxChild[];
-/**
- * A content type representing ICU messages.
- */
-export type IcuMessage = string;
-/**
- * A content type representing I18next messages.
- */
-export type I18nextMessage = string;
-/**
- * A content type representing plain strings.
- */
-export type StringMessage = string;

package/dist/types-dir/jsx/content.js

@@ -1,11 +0,0 @@
-/**
- * Map of data-_gt properties to their corresponding React props
- */
-export var HTML_CONTENT_PROPS = {
-    pl: 'placeholder',
-    ti: 'title',
-    alt: 'alt',
-    arl: 'aria-label',
-    arb: 'aria-labelledby',
-    ard: 'aria-describedby',
-};

package/dist/types-dir/jsx/variables.d.ts

@@ -1,9 +0,0 @@
-export type VariableType = 'v' | 'n' | 'd' | 'c' | 'rt';
-/**
- * Variables are used to store the variable name and type.
- */
-export type Variable = {
-    k: string;
-    i?: number;
-    v?: VariableType;
-};

package/dist/types-dir/jsx/variables.js

@@ -1 +0,0 @@
-export {};

package/dist/types.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.cjs","names":[],"sources":["../src/types-dir/jsx/content.ts"],"sourcesContent":["import { Variable } from './variables';\n\n/**\n * Map of data-_gt properties to their corresponding React props\n */\nexport const HTML_CONTENT_PROPS = {\n  pl: 'placeholder',\n  ti: 'title',\n  alt: 'alt',\n  arl: 'aria-label',\n  arb: 'aria-labelledby',\n  ard: 'aria-describedby',\n} as const;\n\nexport type HtmlContentPropKeysRecord = Partial<\n  Record<keyof typeof HTML_CONTENT_PROPS, string>\n>;\nexport type HtmlContentPropValuesRecord = Partial<\n  Record<(typeof HTML_CONTENT_PROPS)[keyof typeof HTML_CONTENT_PROPS], string>\n>;\n\n/**\n * GTProp is an internal property used to contain data for translating and rendering elements.\n * note, transformations are only read on the server side if they are 'plural' or 'branch'\n */\nexport type GTProp = {\n  b?: Record<string, JsxChildren>; // Branches\n  t?: 'p' | 'b'; // Branch Transformation\n} & HtmlContentPropKeysRecord;\n\nexport type JsxElement = {\n  t?: string; // tag name\n  i?: number; // id\n  d?: GTProp; // GT data\n  c?: JsxChildren; // children\n};\n\nexport type JsxChild = string | JsxElement | Variable;\n\n/**\n * The format of the string content\n */\nexport type StringFormat = 'ICU' | 'I18NEXT' | 'STRING';\n\n/**\n * The format of the content.\n */\nexport type DataFormat = 'JSX' | StringFormat;\n\n/**\n * String format content.\n */\nexport type StringContent = IcuMessage | StringMessage | I18nextMessage;\n\n/**\n * A content type representing JSX, ICU, and I18next messages.\n */\nexport type Content = JsxChildren | StringContent;\n\n/**\n * A content type representing JSX elements.\n */\nexport type JsxChildren = JsxChild | JsxChild[];\n\n/**\n * A content type representing ICU messages.\n */\nexport type IcuMessage = string;\n\n/**\n * A content type representing I18next messages.\n */\nexport type I18nextMessage = string;\n\n/**\n * A content type representing plain strings.\n */\nexport type StringMessage = string;\n"],"mappings":";;;;;AAKA,MAAa,qBAAqB;CAChC,IAAI;CACJ,IAAI;CACJ,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN"}

package/dist/types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../src/types-dir/jsx/content.ts"],"sourcesContent":["import { Variable } from './variables';\n\n/**\n * Map of data-_gt properties to their corresponding React props\n */\nexport const HTML_CONTENT_PROPS = {\n  pl: 'placeholder',\n  ti: 'title',\n  alt: 'alt',\n  arl: 'aria-label',\n  arb: 'aria-labelledby',\n  ard: 'aria-describedby',\n} as const;\n\nexport type HtmlContentPropKeysRecord = Partial<\n  Record<keyof typeof HTML_CONTENT_PROPS, string>\n>;\nexport type HtmlContentPropValuesRecord = Partial<\n  Record<(typeof HTML_CONTENT_PROPS)[keyof typeof HTML_CONTENT_PROPS], string>\n>;\n\n/**\n * GTProp is an internal property used to contain data for translating and rendering elements.\n * note, transformations are only read on the server side if they are 'plural' or 'branch'\n */\nexport type GTProp = {\n  b?: Record<string, JsxChildren>; // Branches\n  t?: 'p' | 'b'; // Branch Transformation\n} & HtmlContentPropKeysRecord;\n\nexport type JsxElement = {\n  t?: string; // tag name\n  i?: number; // id\n  d?: GTProp; // GT data\n  c?: JsxChildren; // children\n};\n\nexport type JsxChild = string | JsxElement | Variable;\n\n/**\n * The format of the string content\n */\nexport type StringFormat = 'ICU' | 'I18NEXT' | 'STRING';\n\n/**\n * The format of the content.\n */\nexport type DataFormat = 'JSX' | StringFormat;\n\n/**\n * String format content.\n */\nexport type StringContent = IcuMessage | StringMessage | I18nextMessage;\n\n/**\n * A content type representing JSX, ICU, and I18next messages.\n */\nexport type Content = JsxChildren | StringContent;\n\n/**\n * A content type representing JSX elements.\n */\nexport type JsxChildren = JsxChild | JsxChild[];\n\n/**\n * A content type representing ICU messages.\n */\nexport type IcuMessage = string;\n\n/**\n * A content type representing I18next messages.\n */\nexport type I18nextMessage = string;\n\n/**\n * A content type representing plain strings.\n */\nexport type StringMessage = string;\n"],"mappings":";;;;AAKA,MAAa,qBAAqB;CAChC,IAAI;CACJ,IAAI;CACJ,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN"}