generaltranslation 8.2.13 → 8.2.14

package/dist/formatting/format.js

@@ -1,257 +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 { IntlMessageFormat } from 'intl-messageformat';
-import { formatI18nextWarning, formatJsxWarning } from '../logging/warnings';
-import { formattingLogger } from '../logging/logger';
-/**
- * Formats a string value with cutoff behavior according to the specified locales and options.
- *
- * @param {Object} params - The parameters for the cutoff formatting.
- * @param {string} params.value - The string value to format with cutoff behavior.
- * @param {string | string[]} [params.locales='en'] - The locales to use for formatting.
- * @param {CutoffFormatOptions} [params.options={}] - Additional options for cutoff formatting.
- * @param {number} [params.options.maxChars] - The maximum number of characters to display.
- * @param {CutoffFormatStyle} [params.options.style='ellipsis'] - The style of the terminator.
- * @param {string} [params.options.terminator] - Optional override for the terminator to use.
- * @param {string} [params.options.separator] - Optional override for the separator between terminator and value.
- *
- * @returns {string} The formatted string with terminator applied if cutoff occurs.
- * @internal
- *
- * @example
- * _formatCutoff({ value: 'Hello, world!', options: { maxChars: 8 } }); // Returns 'Hello, w...'
- */
-export function _formatCutoff(_a) {
-    var value = _a.value, _b = _a.locales, locales = _b === void 0 ? libraryDefaultLocale : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
-    return intlCache.get('CutoffFormat', locales, options).format(value);
-}
-/**
- * Formats a message according to the specified locales and options.
- *
- * @param {string} message - The message to format.
- * @param {string | string[]} [locales='en'] - The locales to use for formatting.
- * @param {Record<string, any>} [variables={}] - The variables to use for formatting.
- * @returns {string} The formatted message.
- * @internal
- *
- * Returns an empty string if IntlMessageFormat produces no output.
- * TODO: Add this to custom formats.
- */
-export function _formatMessageICU(message, locales, variables) {
-    var _a, _b;
-    if (locales === void 0) { locales = libraryDefaultLocale; }
-    if (variables === void 0) { variables = {}; }
-    var messageFormat = new IntlMessageFormat(message, locales);
-    return (_b = (_a = messageFormat.format(variables)) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : '';
-}
-/**
- * Returns the message as-is without any formatting.
- *
- * @param {string} message - The message to return.
- * @returns {string} The original message, unchanged.
- * @internal
- *
- * TODO: Add this to custom formats.
- */
-export function _formatMessageString(message) {
-    return message;
-}
-/**
- * Formats a number according to the specified locales and options.
- *
- * @param {Object} params - The parameters for the number formatting.
- * @param {number} params.value - The number to format.
- * @param {string | string[]} [params.locales=['en']] - The locales to use for formatting.
- * @param {Intl.NumberFormatOptions} [params.options={}] - Additional options for number formatting.
- *
- * @returns {string} The formatted number.
- * @internal
- */
-export function _formatNum(_a) {
-    var value = _a.value, _b = _a.locales, locales = _b === void 0 ? [libraryDefaultLocale] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
-    var res = intlCache
-        .get('NumberFormat', locales, __assign({ numberingSystem: 'latn' }, options))
-        .format(value);
-    return res;
-}
-/**
- * Formats a date according to the specified locales and options.
- *
- * @param {Object} params - The parameters for the date formatting.
- * @param {Date} params.value - The date to format.
- * @param {string | string[]} [params.locales='en'] - The locales to use for formatting.
- * @param {Intl.DateTimeFormatOptions} [params.options={}] - Additional options for date formatting.
- *
- * @returns {string} The formatted date.
- * @internal
- */
-export function _formatDateTime(_a) {
-    var value = _a.value, _b = _a.locales, locales = _b === void 0 ? [libraryDefaultLocale] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
-    return intlCache
-        .get('DateTimeFormat', locales, __assign({ calendar: 'gregory', numberingSystem: 'latn' }, options))
-        .format(value);
-}
-/**
- * Formats a currency value according to the specified locales, currency, and options.
- *
- * @param {Object} params - The parameters for the currency formatting.
- * @param {number} params.value - The currency value to format.
- * @param {string} params.currency - The currency code (e.g., 'USD').
- * @param {string | string[]} [params.locales=['en']] - The locales to use for formatting.
- * @param {Intl.NumberFormatOptions} [params.options={}] - Additional options for currency formatting.
- *
- * @returns {string} The formatted currency value.
- * @internal
- */
-export function _formatCurrency(_a) {
-    var value = _a.value, _b = _a.locales, locales = _b === void 0 ? [libraryDefaultLocale] : _b, _c = _a.currency, currency = _c === void 0 ? 'USD' : _c, _d = _a.options, options = _d === void 0 ? {} : _d;
-    return intlCache
-        .get('NumberFormat', locales, __assign({ style: 'currency', currency: currency, numberingSystem: 'latn' }, options))
-        .format(value);
-}
-/**
- * Formats a list of items according to the specified locales and options.
- *
- * @param {Object} params - The parameters for the list formatting.
- * @param {Array<string | number>} params.value - The list of items to format.
- * @param {string | string[]} [params.locales=['en']] - The locales to use for formatting.
- * @param {Intl.ListFormatOptions} [params.options={}] - Additional options for list formatting.
- *
- * @returns {string} The formatted list.
- * @internal
- */
-export function _formatList(_a) {
-    var value = _a.value, _b = _a.locales, locales = _b === void 0 ? [libraryDefaultLocale] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
-    return intlCache
-        .get('ListFormat', locales, __assign({ type: 'conjunction', style: 'long' }, options))
-        .format(value.map(String));
-}
-/**
- * Formats a list of items according to the specified locales and options.
- * @param {Object} params - The parameters for the list formatting.
- * @param {Array<T>} params.value - The list of items to format.
- * @param {string | string[]} [params.locales=['en']] - The locales to use for formatting.
- * @param {Intl.ListFormatOptions} [params.options={}] - Additional options for list formatting.
- * @returns {Array<T | string>} The formatted list parts.
- * @internal
- */
-export function _formatListToParts(_a) {
-    var value = _a.value, _b = _a.locales, locales = _b === void 0 ? [libraryDefaultLocale] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
-    var formatListParts = intlCache
-        .get('ListFormat', locales, __assign({ type: 'conjunction', style: 'long' }, options))
-        .formatToParts(value.map(function () { return '1'; }));
-    var partIndex = 0;
-    return formatListParts.map(function (part) {
-        if (part.type === 'element')
-            return value[partIndex++];
-        return part.value;
-    });
-}
-/**
- * Selects the best unit and computes the value for relative time formatting
- * based on the difference between a date and a base date.
- * @param {Date} date - The target date.
- * @param {Date} baseDate - The base date to compute relative time from. Must be provided by the caller for hydration safety.
- * @returns {{ value: number, unit: Intl.RelativeTimeFormatUnit }} The computed value and unit.
- * @internal
- */
-export function _selectRelativeTimeUnit(date, baseDate) {
-    var now = baseDate.getTime();
-    var diffMs = date.getTime() - now;
-    var absDiffMs = Math.abs(diffMs);
-    var sign = diffMs < 0 ? -1 : 1;
-    // Use Math.floor to avoid confusing jumps near boundaries
-    // (e.g. 3.5 days rounding to "1 week ago" instead of "3 days ago")
-    var seconds = Math.floor(absDiffMs / 1000);
-    var minutes = Math.floor(absDiffMs / (1000 * 60));
-    var hours = Math.floor(absDiffMs / (1000 * 60 * 60));
-    var days = Math.floor(absDiffMs / (1000 * 60 * 60 * 24));
-    var weeks = Math.floor(absDiffMs / (1000 * 60 * 60 * 24 * 7));
-    var months = Math.floor(absDiffMs / (1000 * 60 * 60 * 24 * 30));
-    var years = Math.floor(absDiffMs / (1000 * 60 * 60 * 24 * 365));
-    if (seconds < 60)
-        return { value: sign * seconds, unit: 'second' };
-    if (minutes < 60)
-        return { value: sign * minutes, unit: 'minute' };
-    if (hours < 24)
-        return { value: sign * hours, unit: 'hour' };
-    if (days < 7)
-        return { value: sign * days, unit: 'day' };
-    if (days < 28)
-        return { value: sign * weeks, unit: 'week' };
-    if (months < 1)
-        return { value: sign * weeks, unit: 'week' };
-    if (months < 12)
-        return { value: sign * months, unit: 'month' };
-    if (years < 1)
-        return { value: sign * months, unit: 'month' };
-    return { value: sign * years, unit: 'year' };
-}
-/**
- * Formats a relative time from a Date, automatically selecting the best unit.
- * @internal
- */
-export function _formatRelativeTimeFromDate(_a) {
-    var date = _a.date, baseDate = _a.baseDate, _b = _a.locales, locales = _b === void 0 ? [libraryDefaultLocale] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
-    var _d = _selectRelativeTimeUnit(date, baseDate), value = _d.value, unit = _d.unit;
-    return _formatRelativeTime({ value: value, unit: unit, locales: locales, options: options });
-}
-/**
- * Formats a relative time value according to the specified locales and options.
- *
- * @param {Object} params - The parameters for the relative time formatting.
- * @param {number} params.value - The relative time value to format.
- * @param {Intl.RelativeTimeFormatUnit} params.unit - The unit of time (e.g., 'second', 'minute', 'hour', 'day', 'week', 'month', 'year').
- * @param {string | string[]} [params.locales=['en']] - The locales to use for formatting.
- * @param {Intl.RelativeTimeFormatOptions} [params.options={}] - Additional options for relative time formatting.
- *
- * @returns {string} The formatted relative time string.
- * @internal
- */
-export function _formatRelativeTime(_a) {
-    var value = _a.value, unit = _a.unit, _b = _a.locales, locales = _b === void 0 ? [libraryDefaultLocale] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
-    return intlCache
-        .get('RelativeTimeFormat', locales, __assign({ style: 'long', numeric: 'auto' }, options))
-        .format(value, unit);
-}
-/**
- * @experimental This function is not currently supported but will be implemented in a future version.
- * Use {@link _formatMessageICU} for current ICU message format support.
- * Formats an I18next message according to the specified locales and options.
- *
- * @param message - The I18next message to format.
- * @param variables - The variables to use for formatting.
- * @returns The formatted I18next message.
- * @internal
- */
-export function _formatI18next(message, _variables) {
-    if (_variables === void 0) { _variables = {}; }
-    formattingLogger.warn(formatI18nextWarning);
-    return message;
-}
-/**
- * @experimental This function is not currently supported but will be implemented in a future version.
- * Use {@link _formatMessageICU} for current ICU message format support.
- * Formats a JSX message according to the specified locales and options.
- *
- * @param message - The JSX message to format.
- * @param variables - The variables to use for formatting.
- * @returns The formatted JSX message.
- * @internal
- */
-export function _formatJsx(message, _variables) {
-    if (_variables === void 0) { _variables = {}; }
-    formattingLogger.warn(formatJsxWarning);
-    return message;
-}

package/dist/locales/customLocaleMapping.d.ts

@@ -1,11 +0,0 @@
-import { LocaleProperties } from './getLocaleProperties';
-export type FullCustomMapping = Record<string, LocaleProperties>;
-export type CustomMapping = Record<string, string | Partial<LocaleProperties>>;
-export declare const getCustomProperty: (customMapping: CustomMapping, locale: string, property: keyof LocaleProperties) => string | undefined;
-/**
- * Checks if a given locale should use the canonical locale.
- * @param locale - The locale to check if it should use the canonical locale
- * @param customMapping - The custom mapping to use for checking if the locale should use the canonical locale
- * @returns True if the locale should use the canonical locale, false otherwise
- */
-export declare const shouldUseCanonicalLocale: (locale: string, customMapping: CustomMapping) => boolean;

package/dist/locales/customLocaleMapping.js

@@ -1,23 +0,0 @@
-import { _isValidLocale } from './isValidLocale';
-export var getCustomProperty = function (customMapping, locale, property) {
-    if (customMapping === null || customMapping === void 0 ? void 0 : customMapping[locale]) {
-        if (typeof customMapping[locale] === 'string') {
-            return property === 'name' ? customMapping[locale] : undefined;
-        }
-        return customMapping[locale][property];
-    }
-    return undefined;
-};
-/**
- * Checks if a given locale should use the canonical locale.
- * @param locale - The locale to check if it should use the canonical locale
- * @param customMapping - The custom mapping to use for checking if the locale should use the canonical locale
- * @returns True if the locale should use the canonical locale, false otherwise
- */
-export var shouldUseCanonicalLocale = function (locale, customMapping) {
-    return !!((customMapping === null || customMapping === void 0 ? void 0 : customMapping[locale]) &&
-        typeof customMapping[locale] === 'object' &&
-        'code' in customMapping[locale] &&
-        customMapping[locale].code &&
-        _isValidLocale(customMapping[locale].code));
-};

package/dist/locales/determineLocale.d.ts

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

package/dist/locales/determineLocale.js

@@ -1,72 +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);
-};
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-import { _isValidLocale, _standardizeLocale } from './isValidLocale';
-import _isSameLanguage from './isSameLanguage';
-import _getLocaleProperties from './getLocaleProperties';
-/**
- * Given a list of locales and a list of approved locales, sorted in preference order
- * Determines which locale is the best match among the approved locales, prioritizing exact matches and falling back to dialects of the same language
- * @internal
- */
-export default function _determineLocale(locales, approvedLocales, customMapping) {
-    if (typeof locales === 'string')
-        locales = [locales];
-    locales = locales
-        .filter(function (locale) { return _isValidLocale(locale, customMapping); })
-        .map(_standardizeLocale);
-    approvedLocales = approvedLocales
-        .filter(function (locale) { return _isValidLocale(locale, customMapping); })
-        .map(_standardizeLocale);
-    var _loop_1 = function (locale) {
-        var candidates = approvedLocales.filter(function (approvedLocale) {
-            return _isSameLanguage(locale, approvedLocale);
-        });
-        var getMatchingCode = function (_a) {
-            var locale = _a.locale, languageCode = _a.languageCode, minimizedCode = _a.minimizedCode, regionCode = _a.regionCode, scriptCode = _a.scriptCode;
-            var locales = [
-                locale, // If the full locale is supported under this language category
-                "".concat(languageCode, "-").concat(regionCode), // Attempt to match parts
-                "".concat(languageCode, "-").concat(scriptCode),
-                minimizedCode, // If a minimized variant of this locale is supported
-            ];
-            for (var _i = 0, locales_2 = locales; _i < locales_2.length; _i++) {
-                var l = locales_2[_i];
-                if (candidates.includes(l))
-                    return l;
-            }
-            return null;
-        };
-        var _a = _getLocaleProperties(locale), languageCode = _a.languageCode, codes = __rest(_a, ["languageCode"]);
-        var matchingCode = getMatchingCode(__assign({ locale: locale, languageCode: languageCode }, codes)) ||
-            getMatchingCode(__assign({ locale: languageCode }, _getLocaleProperties(languageCode)));
-        if (matchingCode)
-            return { value: matchingCode };
-    };
-    for (var _i = 0, locales_1 = locales; _i < locales_1.length; _i++) {
-        var locale = locales_1[_i];
-        var state_1 = _loop_1(locale);
-        if (typeof state_1 === "object")
-            return state_1.value;
-    }
-    return undefined;
-}

package/dist/locales/getLocaleDirection.d.ts

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

package/dist/locales/getLocaleDirection.js

@@ -1,89 +0,0 @@
-import { intlCache } from '../cache/IntlCache';
-import _getLocaleProperties from './getLocaleProperties';
-/**
- * Get the text direction for a given locale code using the Intl.Locale API.
- *
- * @param {string} code - The locale code to check.
- * @returns {string} 'rtl' if the language is right-to-left; otherwise 'ltr'.
- * @internal
- */
-export function _getLocaleDirection(code) {
-    // Extract via textInfo property
-    try {
-        var locale = intlCache.get('Locale', code);
-        var textInfoDirection = extractDirectionWithTextInfo(locale);
-        if (textInfoDirection) {
-            return textInfoDirection;
-        }
-    }
-    catch (_a) {
-        // silent
-    }
-    // Fallback to simple heuristics
-    var _b = _getLocaleProperties(code), scriptCode = _b.scriptCode, languageCode = _b.languageCode;
-    // Handle RTL script or language
-    if (scriptCode)
-        return isRtlScript(scriptCode) ? 'rtl' : 'ltr';
-    if (languageCode)
-        return isRtlLanguage(languageCode) ? 'rtl' : 'ltr';
-    return 'ltr';
-}
-// ===== HELPER CONSTANTS ===== //
-var RTL_SCRIPTS = new Set([
-    'arab',
-    'adlm',
-    'hebr',
-    'nkoo',
-    'rohg',
-    'samr',
-    'syrc',
-    'thaa',
-    'yezi',
-]);
-var RTL_LANGUAGES = new Set([
-    'ar',
-    'arc',
-    'ckb',
-    'dv',
-    'fa',
-    'he',
-    'iw',
-    'ku',
-    'lrc',
-    'nqo',
-    'ps',
-    'pnb',
-    'sd',
-    'syr',
-    'ug',
-    'ur',
-    'yi',
-]);
-// ===== HELPER FUNCTIONS ===== //
-/**
- * Handles extracting direction via textInfo property
- * @param locale - Intl.Locale object.
- * @returns {'ltr' | 'rtl'} - The direction of the locale
- *
- * Intl.Locale.prototype.getTextInfo() / textInfo property incorporated in ES2024 Specification.
- * This is not supported by all browsers yet.
- * See: {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getTextInfo#browser_compatibility}
- */
-function extractDirectionWithTextInfo(locale) {
-    var _a, _b, _c;
-    if ('textInfo' in locale &&
-        typeof locale.textInfo === 'object' &&
-        locale.textInfo !== null &&
-        'direction' in locale.textInfo &&
-        (((_a = locale.textInfo) === null || _a === void 0 ? void 0 : _a.direction) === 'rtl' ||
-            ((_b = locale.textInfo) === null || _b === void 0 ? void 0 : _b.direction) === 'ltr')) {
-        return (_c = locale.textInfo) === null || _c === void 0 ? void 0 : _c.direction;
-    }
-    return undefined;
-}
-function isRtlScript(script) {
-    return script ? RTL_SCRIPTS.has(script.toLowerCase()) : false;
-}
-function isRtlLanguage(language) {
-    return language ? RTL_LANGUAGES.has(language.toLowerCase()) : false;
-}

package/dist/locales/getLocaleEmoji.d.ts

@@ -1,2 +0,0 @@
-export declare const defaultEmoji = "\uD83C\uDF0D";
-export declare function getRegionEmoji(region: string): string;