@tracearr/translations 0.1.0

package/dist/formatting.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Date, time, and number formatting utilities.
+ *
+ * Uses the native Intl API for locale-aware formatting.
+ * Works consistently across web and React Native environments.
+ */
+/**
+ * Format options for dates and times.
+ */
+export type DateFormatStyle = 'short' | 'medium' | 'long' | 'full';
+/**
+ * Format a date using the current locale.
+ *
+ * @param date - Date to format
+ * @param style - Format style ('short', 'medium', 'long', 'full')
+ * @returns Formatted date string
+ *
+ * @example
+ * formatDate(new Date(), 'short')  // "1/2/26" (en-US)
+ * formatDate(new Date(), 'long')   // "January 2, 2026" (en-US)
+ */
+export declare function formatDate(date: Date | number, style?: DateFormatStyle): string;
+/**
+ * Format a time using the current locale.
+ *
+ * @param date - Date to format
+ * @param style - Format style ('short', 'medium', 'long', 'full')
+ * @returns Formatted time string
+ *
+ * @example
+ * formatTime(new Date(), 'short')  // "3:30 PM" (en-US)
+ */
+export declare function formatTime(date: Date | number, style?: DateFormatStyle): string;
+/**
+ * Format a date and time using the current locale.
+ *
+ * @param date - Date to format
+ * @param dateStyle - Date format style
+ * @param timeStyle - Time format style
+ * @returns Formatted datetime string
+ *
+ * @example
+ * formatDateTime(new Date(), 'short', 'short')  // "1/2/26, 3:30 PM" (en-US)
+ */
+export declare function formatDateTime(date: Date | number, dateStyle?: DateFormatStyle, timeStyle?: DateFormatStyle): string;
+/**
+ * Format a relative time (e.g., "2 hours ago", "in 3 days").
+ *
+ * @param date - Date to compare to now
+ * @param now - Reference time (defaults to current time)
+ * @returns Formatted relative time string
+ *
+ * @example
+ * formatRelativeTime(Date.now() - 3600000)  // "1 hour ago"
+ * formatRelativeTime(Date.now() + 86400000) // "in 1 day"
+ */
+export declare function formatRelativeTime(date: Date | number, now?: Date | number): string;
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ *
+ * @param ms - Duration in milliseconds
+ * @param options - Formatting options
+ * @returns Formatted duration string
+ *
+ * @example
+ * formatDuration(3661000)           // "1h 1m 1s"
+ * formatDuration(3661000, { style: 'long' })  // "1 hour, 1 minute, 1 second"
+ */
+export declare function formatDuration(ms: number, options?: {
+    style?: 'short' | 'long';
+    maxUnits?: number;
+}): string;
+/**
+ * Format a number using the current locale.
+ *
+ * @param value - Number to format
+ * @param options - Intl.NumberFormat options
+ * @returns Formatted number string
+ *
+ * @example
+ * formatNumber(1234567.89)  // "1,234,567.89" (en-US)
+ */
+export declare function formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
+/**
+ * Format a number as a percentage.
+ *
+ * @param value - Number to format (0-1 or 0-100 depending on usePercent)
+ * @param decimals - Number of decimal places
+ * @param usePercent - If true, value is already a percentage (0-100)
+ * @returns Formatted percentage string
+ *
+ * @example
+ * formatPercent(0.75)        // "75%"
+ * formatPercent(75, 1, true) // "75.0%"
+ */
+export declare function formatPercent(value: number, decimals?: number, usePercent?: boolean): string;
+/**
+ * Format bytes to a human-readable size string.
+ *
+ * @param bytes - Number of bytes
+ * @param decimals - Number of decimal places
+ * @returns Formatted size string
+ *
+ * @example
+ * formatBytes(1024)       // "1 KB"
+ * formatBytes(1536, 1)    // "1.5 KB"
+ */
+export declare function formatBytes(bytes: number, decimals?: number): string;
+/**
+ * Format a bitrate to a human-readable string.
+ *
+ * @param bitsPerSecond - Bitrate in bits per second
+ * @param decimals - Number of decimal places
+ * @returns Formatted bitrate string
+ *
+ * @example
+ * formatBitrate(8000000)  // "8 Mbps"
+ */
+export declare function formatBitrate(bitsPerSecond: number, decimals?: number): string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../src/formatting.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,KAAK,GAAE,eAA0B,GAAG,MAAM,CAWzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,KAAK,GAAE,eAAyB,GAAG,MAAM,CAWxF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,GAAG,MAAM,EACnB,SAAS,GAAE,eAAyB,EACpC,SAAS,GAAE,eAAyB,GACnC,MAAM,CAYR;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,GAAG,GAAE,IAAI,GAAG,MAAmB,GAAG,MAAM,CAqD/F;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5D,MAAM,CA2BR;AAMD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAGtF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,UAAU,UAAQ,GAAG,MAAM,CASrF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAU/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAUzE"}

package/dist/formatting.js

@@ -0,0 +1,265 @@
+/**
+ * Date, time, and number formatting utilities.
+ *
+ * Uses the native Intl API for locale-aware formatting.
+ * Works consistently across web and React Native environments.
+ */
+import i18n from 'i18next';
+/**
+ * Format a date using the current locale.
+ *
+ * @param date - Date to format
+ * @param style - Format style ('short', 'medium', 'long', 'full')
+ * @returns Formatted date string
+ *
+ * @example
+ * formatDate(new Date(), 'short')  // "1/2/26" (en-US)
+ * formatDate(new Date(), 'long')   // "January 2, 2026" (en-US)
+ */
+export function formatDate(date, style = 'medium') {
+    const locale = i18n.language || 'en';
+    const d = typeof date === 'number' ? new Date(date) : date;
+    if (isNaN(d.getTime())) {
+        return '';
+    }
+    return new Intl.DateTimeFormat(locale, {
+        dateStyle: style,
+    }).format(d);
+}
+/**
+ * Format a time using the current locale.
+ *
+ * @param date - Date to format
+ * @param style - Format style ('short', 'medium', 'long', 'full')
+ * @returns Formatted time string
+ *
+ * @example
+ * formatTime(new Date(), 'short')  // "3:30 PM" (en-US)
+ */
+export function formatTime(date, style = 'short') {
+    const locale = i18n.language || 'en';
+    const d = typeof date === 'number' ? new Date(date) : date;
+    if (isNaN(d.getTime())) {
+        return '';
+    }
+    return new Intl.DateTimeFormat(locale, {
+        timeStyle: style,
+    }).format(d);
+}
+/**
+ * Format a date and time using the current locale.
+ *
+ * @param date - Date to format
+ * @param dateStyle - Date format style
+ * @param timeStyle - Time format style
+ * @returns Formatted datetime string
+ *
+ * @example
+ * formatDateTime(new Date(), 'short', 'short')  // "1/2/26, 3:30 PM" (en-US)
+ */
+export function formatDateTime(date, dateStyle = 'short', timeStyle = 'short') {
+    const locale = i18n.language || 'en';
+    const d = typeof date === 'number' ? new Date(date) : date;
+    if (isNaN(d.getTime())) {
+        return '';
+    }
+    return new Intl.DateTimeFormat(locale, {
+        dateStyle,
+        timeStyle,
+    }).format(d);
+}
+// ============================================================================
+// Relative Time Formatting
+// ============================================================================
+/**
+ * Format a relative time (e.g., "2 hours ago", "in 3 days").
+ *
+ * @param date - Date to compare to now
+ * @param now - Reference time (defaults to current time)
+ * @returns Formatted relative time string
+ *
+ * @example
+ * formatRelativeTime(Date.now() - 3600000)  // "1 hour ago"
+ * formatRelativeTime(Date.now() + 86400000) // "in 1 day"
+ */
+export function formatRelativeTime(date, now = Date.now()) {
+    const locale = i18n.language || 'en';
+    const d = typeof date === 'number' ? date : date.getTime();
+    const n = typeof now === 'number' ? now : now.getTime();
+    if (isNaN(d) || isNaN(n)) {
+        return '';
+    }
+    const diff = d - n;
+    const absDiff = Math.abs(diff);
+    // Select appropriate unit
+    const seconds = absDiff / 1000;
+    const minutes = seconds / 60;
+    const hours = minutes / 60;
+    const days = hours / 24;
+    const weeks = days / 7;
+    const months = days / 30;
+    const years = days / 365;
+    let value;
+    let unit;
+    if (seconds < 60) {
+        value = Math.round(seconds);
+        unit = 'second';
+    }
+    else if (minutes < 60) {
+        value = Math.round(minutes);
+        unit = 'minute';
+    }
+    else if (hours < 24) {
+        value = Math.round(hours);
+        unit = 'hour';
+    }
+    else if (days < 7) {
+        value = Math.round(days);
+        unit = 'day';
+    }
+    else if (weeks < 4) {
+        value = Math.round(weeks);
+        unit = 'week';
+    }
+    else if (months < 12) {
+        value = Math.round(months);
+        unit = 'month';
+    }
+    else {
+        value = Math.round(years);
+        unit = 'year';
+    }
+    // Adjust sign for past/future
+    const signedValue = diff < 0 ? -value : value;
+    return new Intl.RelativeTimeFormat(locale, {
+        numeric: 'auto',
+    }).format(signedValue, unit);
+}
+// ============================================================================
+// Duration Formatting
+// ============================================================================
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ *
+ * @param ms - Duration in milliseconds
+ * @param options - Formatting options
+ * @returns Formatted duration string
+ *
+ * @example
+ * formatDuration(3661000)           // "1h 1m 1s"
+ * formatDuration(3661000, { style: 'long' })  // "1 hour, 1 minute, 1 second"
+ */
+export function formatDuration(ms, options = {}) {
+    const { style = 'short', maxUnits = 3 } = options;
+    if (ms < 0)
+        ms = 0;
+    const seconds = Math.floor(ms / 1000) % 60;
+    const minutes = Math.floor(ms / 60000) % 60;
+    const hours = Math.floor(ms / 3600000) % 24;
+    const days = Math.floor(ms / 86400000);
+    const parts = [];
+    if (style === 'short') {
+        if (days > 0)
+            parts.push(`${days}d`);
+        if (hours > 0)
+            parts.push(`${hours}h`);
+        if (minutes > 0)
+            parts.push(`${minutes}m`);
+        if (seconds > 0 || parts.length === 0)
+            parts.push(`${seconds}s`);
+    }
+    else {
+        // Long style - use i18n translation keys with pluralization
+        if (days > 0)
+            parts.push(i18n.t('common:duration.day', { count: days }));
+        if (hours > 0)
+            parts.push(i18n.t('common:duration.hour', { count: hours }));
+        if (minutes > 0)
+            parts.push(i18n.t('common:duration.minute', { count: minutes }));
+        if (seconds > 0 || parts.length === 0)
+            parts.push(i18n.t('common:duration.second', { count: seconds }));
+    }
+    return parts.slice(0, maxUnits).join(style === 'short' ? ' ' : ', ');
+}
+// ============================================================================
+// Number Formatting
+// ============================================================================
+/**
+ * Format a number using the current locale.
+ *
+ * @param value - Number to format
+ * @param options - Intl.NumberFormat options
+ * @returns Formatted number string
+ *
+ * @example
+ * formatNumber(1234567.89)  // "1,234,567.89" (en-US)
+ */
+export function formatNumber(value, options) {
+    const locale = i18n.language || 'en';
+    return new Intl.NumberFormat(locale, options).format(value);
+}
+/**
+ * Format a number as a percentage.
+ *
+ * @param value - Number to format (0-1 or 0-100 depending on usePercent)
+ * @param decimals - Number of decimal places
+ * @param usePercent - If true, value is already a percentage (0-100)
+ * @returns Formatted percentage string
+ *
+ * @example
+ * formatPercent(0.75)        // "75%"
+ * formatPercent(75, 1, true) // "75.0%"
+ */
+export function formatPercent(value, decimals = 0, usePercent = false) {
+    const locale = i18n.language || 'en';
+    const normalizedValue = usePercent ? value / 100 : value;
+    return new Intl.NumberFormat(locale, {
+        style: 'percent',
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+    }).format(normalizedValue);
+}
+/**
+ * Format bytes to a human-readable size string.
+ *
+ * @param bytes - Number of bytes
+ * @param decimals - Number of decimal places
+ * @returns Formatted size string
+ *
+ * @example
+ * formatBytes(1024)       // "1 KB"
+ * formatBytes(1536, 1)    // "1.5 KB"
+ */
+export function formatBytes(bytes, decimals = 1) {
+    if (bytes === 0)
+        return '0 B';
+    if (bytes < 0)
+        bytes = 0;
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];
+    const i = Math.min(Math.floor(Math.log(bytes) / Math.log(k)), sizes.length - 1);
+    const value = bytes / Math.pow(k, i);
+    return `${formatNumber(value, { maximumFractionDigits: decimals })} ${sizes[i]}`;
+}
+/**
+ * Format a bitrate to a human-readable string.
+ *
+ * @param bitsPerSecond - Bitrate in bits per second
+ * @param decimals - Number of decimal places
+ * @returns Formatted bitrate string
+ *
+ * @example
+ * formatBitrate(8000000)  // "8 Mbps"
+ */
+export function formatBitrate(bitsPerSecond, decimals = 1) {
+    if (bitsPerSecond === 0)
+        return '0 bps';
+    if (bitsPerSecond < 0)
+        bitsPerSecond = 0;
+    const k = 1000;
+    const sizes = ['bps', 'Kbps', 'Mbps', 'Gbps'];
+    const i = Math.min(Math.floor(Math.log(bitsPerSecond) / Math.log(k)), sizes.length - 1);
+    const value = bitsPerSecond / Math.pow(k, i);
+    return `${formatNumber(value, { maximumFractionDigits: decimals })} ${sizes[i]}`;
+}
+//# sourceMappingURL=formatting.js.map

package/dist/formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.js","sourceRoot":"","sources":["../src/formatting.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @tracearr/translations
+ *
+ * Shared i18n translations package for Tracearr web and mobile apps.
+ * Provides type-safe translation keys with IDE autocomplete.
+ *
+ * @example
+ * ```tsx
+ * import { initI18n, useTranslation } from '@tracearr/translations';
+ *
+ * // Initialize once at app startup
+ * await initI18n();
+ *
+ * // Use in components
+ * function MyComponent() {
+ *   const { t } = useTranslation();
+ *   return <button>{t('common.actions.save')}</button>;
+ * }
+ *
+ * // With namespaces
+ * function RulesComponent() {
+ *   const { t } = useTranslation('pages');
+ *   return <span>{t('rules.impossibleTravel')}</span>;
+ * }
+ * ```
+ *
+ * @example Language detection
+ * ```tsx
+ * import { detectLanguage, changeLanguage, languageNames } from '@tracearr/translations';
+ *
+ * // Detect user's preferred language
+ * const lang = await detectLanguage();
+ *
+ * // Change language
+ * await changeLanguage('es-ES');
+ *
+ * // Get available languages with display names
+ * Object.entries(languageNames).map(([code, name]) => ({ code, name }));
+ * ```
+ */
+export { i18n, initI18n, loadLocale, defaultI18nConfig, defaultNS, namespaces, resources, supportedLanguages, type SupportedLanguage, type Namespace, } from './config.js';
+export { languageNames, getSupportedLanguages, isLanguageSupported, resolveLocale, detectLanguage, detectSystemLanguage, changeLanguage, getCurrentLanguage, getLanguageDisplayName, } from './language.js';
+export type { AllResources, TranslationResources, CommonTranslations, NotificationsTranslations, SettingsTranslations, NavTranslations, PagesTranslations, MobileTranslations, NestedKeyOf, TranslationValue, CommonKey, NotificationsKey, SettingsKey, NavKey, PagesKey, MobileKey, } from './types.js';
+export { formatDate, formatTime, formatDateTime, formatRelativeTime, formatDuration, formatNumber, formatPercent, formatBytes, formatBitrate, type DateFormatStyle, } from './formatting.js';
+export { useTranslation, Trans, I18nextProvider } from 'react-i18next';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,SAAS,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAElB,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,MAAM,EACN,QAAQ,EACR,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,UAAU,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,49 @@
+/**
+ * @tracearr/translations
+ *
+ * Shared i18n translations package for Tracearr web and mobile apps.
+ * Provides type-safe translation keys with IDE autocomplete.
+ *
+ * @example
+ * ```tsx
+ * import { initI18n, useTranslation } from '@tracearr/translations';
+ *
+ * // Initialize once at app startup
+ * await initI18n();
+ *
+ * // Use in components
+ * function MyComponent() {
+ *   const { t } = useTranslation();
+ *   return <button>{t('common.actions.save')}</button>;
+ * }
+ *
+ * // With namespaces
+ * function RulesComponent() {
+ *   const { t } = useTranslation('pages');
+ *   return <span>{t('rules.impossibleTravel')}</span>;
+ * }
+ * ```
+ *
+ * @example Language detection
+ * ```tsx
+ * import { detectLanguage, changeLanguage, languageNames } from '@tracearr/translations';
+ *
+ * // Detect user's preferred language
+ * const lang = await detectLanguage();
+ *
+ * // Change language
+ * await changeLanguage('es-ES');
+ *
+ * // Get available languages with display names
+ * Object.entries(languageNames).map(([code, name]) => ({ code, name }));
+ * ```
+ */
+// Core i18n exports
+export { i18n, initI18n, loadLocale, defaultI18nConfig, defaultNS, namespaces, resources, supportedLanguages, } from './config.js';
+// Language detection and management
+export { languageNames, getSupportedLanguages, isLanguageSupported, resolveLocale, detectLanguage, detectSystemLanguage, changeLanguage, getCurrentLanguage, getLanguageDisplayName, } from './language.js';
+// Formatting utilities
+export { formatDate, formatTime, formatDateTime, formatRelativeTime, formatDuration, formatNumber, formatPercent, formatBytes, formatBitrate, } from './formatting.js';
+// Re-export react-i18next hooks for convenience
+export { useTranslation, Trans, I18nextProvider } from 'react-i18next';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,oBAAoB;AACpB,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,SAAS,EACT,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AAErB,oCAAoC;AACpC,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAuBvB,uBAAuB;AACvB,OAAO,EACL,UAAU,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,EACX,aAAa,GAEd,MAAM,iBAAiB,CAAC;AAEzB,gDAAgD;AAChD,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/language.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Language detection and management utilities.
+ *
+ * Works in both web (browser) and mobile (React Native/Expo) environments.
+ * Language codes use full locale format (e.g., 'fr-FR', 'zh-CN') except for
+ * English which uses 'en' as the base/fallback language.
+ */
+/** @internal */
+export declare function _registerLocaleLoader(fn: (lang: string) => Promise<void>): void;
+/**
+ * Supported languages with display names.
+ * Add new languages here when adding translations.
+ */
+export declare const languageNames: {
+    readonly en: "English";
+    readonly 'af-ZA': "Afrikaans";
+    readonly 'ar-SA': "العربية";
+    readonly 'ca-ES': "Català";
+    readonly 'cs-CZ': "Čeština";
+    readonly 'da-DK': "Dansk";
+    readonly 'de-DE': "Deutsch";
+    readonly 'el-GR': "Ελληνικά";
+    readonly 'es-ES': "Español";
+    readonly 'fi-FI': "Suomi";
+    readonly 'fr-FR': "Français";
+    readonly 'he-IL': "עברית";
+    readonly 'hu-HU': "Magyar";
+    readonly 'it-IT': "Italiano";
+    readonly 'ja-JP': "日本語";
+    readonly 'ko-KR': "한국어";
+    readonly 'nl-NL': "Nederlands";
+    readonly 'no-NO': "Norsk";
+    readonly 'pl-PL': "Polski";
+    readonly 'pt-BR': "Português (Brasil)";
+    readonly 'pt-PT': "Português (Portugal)";
+    readonly 'ro-RO': "Română";
+    readonly 'ru-RU': "Русский";
+    readonly 'sr-SP': "Српски";
+    readonly 'sv-SE': "Svenska";
+    readonly 'tr-TR': "Türkçe";
+    readonly 'uk-UA': "Українська";
+    readonly 'vi-VN': "Tiếng Việt";
+    readonly 'zh-CN': "中文 (简体)";
+    readonly 'zh-TW': "中文 (繁體)";
+};
+export type LanguageCode = keyof typeof languageNames;
+/**
+ * Get the list of supported language codes.
+ */
+export declare function getSupportedLanguages(): string[];
+/**
+ * Check if a language code is supported (exact match).
+ */
+export declare function isLanguageSupported(lang: string): boolean;
+/**
+ * Resolve a language code to the best matching supported locale.
+ *
+ * Handles exact matches, legacy two-letter codes (e.g., 'fr' → 'fr-FR'),
+ * and browser locale strings (e.g., 'zh-Hant-TW' → 'zh-TW').
+ *
+ * Returns null if no match is found.
+ */
+export declare function resolveLocale(lang: string): string | null;
+/**
+ * Detect the user's preferred language.
+ *
+ * Priority order:
+ * 1. Stored preference (localStorage/AsyncStorage)
+ * 2. Browser/device language (checks all preferred languages)
+ * 3. Fallback to 'en'
+ *
+ * @param storage - Optional storage adapter for React Native (AsyncStorage)
+ */
+export declare function detectLanguage(storage?: {
+    getItem: (key: string) => Promise<string | null>;
+}): Promise<string>;
+/**
+ * Detect the system/browser language.
+ * Checks all preferred languages in order (navigator.languages).
+ * Works in both web and React Native environments.
+ */
+export declare function detectSystemLanguage(): string | null;
+/**
+ * Change the current language and persist the preference.
+ *
+ * @param lang - Locale code (e.g., 'en', 'fr-FR', 'zh-CN')
+ * @param storage - Optional storage adapter for React Native
+ * @throws Error if language code is invalid or unsupported
+ */
+export declare function changeLanguage(lang: string, storage?: {
+    setItem: (key: string, value: string) => Promise<void>;
+}): Promise<void>;
+/**
+ * Get the current language.
+ */
+export declare function getCurrentLanguage(): string;
+/**
+ * Get the display name for a language code.
+ */
+export declare function getLanguageDisplayName(lang: string): string;
+//# sourceMappingURL=language.d.ts.map

package/dist/language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../src/language.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,gBAAgB;AAChB,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAE/E;AAKD;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BhB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,aAAa,CAAC;AAEtD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBzD;AAaD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE;IAC7C,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClD,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBlB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAapD;AA8DD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GACnE,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D"}