@stacksjs/i18n 0.70.88 → 0.70.91

package/dist/types.d.ts

@@ -0,0 +1,213 @@
+/**
+ * Common locales with metadata
+ * @defaultValue
+ * ```ts
+ * {
+ *   en: { code: 'en', name: 'English', nativeName: 'English', direction: 'ltr' },
+ *   'en-US': {
+ *     code: 'en-US',
+ *     name: 'English (US)',
+ *     nativeName: 'English (US)',
+ *     direction: 'ltr',
+ *     region: 'US'
+ *   },
+ *   'en-GB': {
+ *     code: 'en-GB',
+ *     name: 'English (UK)',
+ *     nativeName: 'English (UK)',
+ *     direction: 'ltr',
+ *     region: 'GB'
+ *   },
+ *   es: { code: 'es', name: 'Spanish', nativeName: 'Espa\u00f1ol', direction: 'ltr' },
+ *   fr: { code: 'fr', name: 'French', nativeName: 'Fran\u00e7ais', direction: 'ltr' },
+ *   de: { code: 'de', name: 'German', nativeName: 'Deutsch', direction: 'ltr' },
+ *   it: { code: 'it', name: 'Italian', nativeName: 'Italiano', direction: 'ltr' },
+ *   pt: {
+ *     code: 'pt',
+ *     name: 'Portuguese',
+ *     nativeName: 'Portugu\u00eas',
+ *     direction: 'ltr'
+ *   },
+ *   'pt-BR': {
+ *     code: 'pt-BR',
+ *     name: 'Portuguese (Brazil)',
+ *     nativeName: 'Portugu\u00eas (Brasil)',
+ *     direction: 'ltr',
+ *     region: 'BR'
+ *   },
+ *   zh: { code: 'zh', name: 'Chinese', nativeName: '\u4e2d\u6587', direction: 'ltr' },
+ *   'zh-CN': {
+ *     code: 'zh-CN',
+ *     name: 'Chinese (Simplified)',
+ *     nativeName: '\u7b80\u4f53\u4e2d\u6587',
+ *     direction: 'ltr',
+ *     region: 'CN'
+ *   },
+ *   'zh-TW': {
+ *     code: 'zh-TW',
+ *     name: 'Chinese (Traditional)',
+ *     nativeName: '\u7e41\u9ad4\u4e2d\u6587',
+ *     direction: 'ltr',
+ *     region: 'TW'
+ *   },
+ *   ja: {
+ *     code: 'ja',
+ *     name: 'Japanese',
+ *     nativeName: '\u65e5\u672c\u8a9e',
+ *     direction: 'ltr'
+ *   },
+ *   ko: {
+ *     code: 'ko',
+ *     name: 'Korean',
+ *     nativeName: '\ud55c\uad6d\uc5b4',
+ *     direction: 'ltr'
+ *   },
+ *   ar: {
+ *     code: 'ar',
+ *     name: 'Arabic',
+ *     nativeName: '\u0627\u0644\u0639\u0631\u0628\u064a\u0629',
+ *     direction: 'rtl'
+ *   },
+ *   he: {
+ *     code: 'he',
+ *     name: 'Hebrew',
+ *     nativeName: '\u05e2\u05d1\u05e8\u05d9\u05ea',
+ *     direction: 'rtl'
+ *   },
+ *   ru: {
+ *     code: 'ru',
+ *     name: 'Russian',
+ *     nativeName: '\u0420\u0443\u0441\u0441\u043a\u0438\u0439',
+ *     direction: 'ltr'
+ *   },
+ *   nl: { code: 'nl', name: 'Dutch', nativeName: 'Nederlands', direction: 'ltr' },
+ *   pl: { code: 'pl', name: 'Polish', nativeName: 'Polski', direction: 'ltr' },
+ *   tr: {
+ *     code: 'tr',
+ *     name: 'Turkish',
+ *     nativeName: 'T\u00fcrk\u00e7e',
+ *     direction: 'ltr'
+ *   },
+ *   vi: {
+ *     code: 'vi',
+ *     name: 'Vietnamese',
+ *     nativeName: 'Ti\u1ebfng Vi\u1ec7t',
+ *     direction: 'ltr'
+ *   },
+ *   th: { code: 'th', name: 'Thai', nativeName: '\u0e44\u0e17\u0e22', direction: 'ltr' },
+ *   hi: {
+ *     code: 'hi',
+ *     name: 'Hindi',
+ *     nativeName: '\u0939\u093f\u0928\u094d\u0926\u0940',
+ *     direction: 'ltr'
+ *   }
+ * }
+ * ```
+ */
+export declare const LOCALE_INFO: Record<string, LocaleInfo>;
+/**
+ * Plural forms for a translation
+ */
+export declare interface PluralForms {
+  zero?: string
+  one: string
+  two?: string
+  few?: string
+  many?: string
+  other: string
+}
+/**
+ * i18n configuration options
+ */
+export declare interface I18nConfig {
+  locale: string
+  fallbackLocale: string
+  availableLocales?: string[]
+  messages?: Translations
+  missingHandler?: (locale: string, key: string) => string | undefined
+  warnMissing?: boolean
+  escapeValues?: boolean
+  keySeparator?: string
+  pluralSeparator?: string
+  dateTimeFormats?: DateTimeFormats
+  numberFormats?: NumberFormats
+}
+/**
+ * i18n instance interface
+ */
+export declare interface I18nInstance {
+  locale: string
+  fallbackLocale: string
+  availableLocales: string[]
+  t: TranslateFunction
+  tc: TranslatePluralFunction
+  te: (key: string, locale?: string) => boolean
+  tm: (key: string, locale?: string) => TranslationMessages | string | undefined
+  setLocale: (locale: string) => void
+  addTranslations: (locale: string, messages: TranslationMessages) => void
+  d: (value: Date | number, format?: string) => string
+  n: (value: number, format?: string) => string
+}
+/**
+ * Locale metadata
+ */
+export declare interface LocaleInfo {
+  code: string
+  name: string
+  nativeName: string
+  direction: 'ltr' | 'rtl'
+  region?: string
+  script?: string
+}
+/**
+ * i18n Type Definitions
+ */
+/**
+ * Translation messages - can be nested objects or strings
+ */
+export type TranslationMessages = {
+  [key: string]: string | TranslationMessages
+}
+/**
+ * All translations keyed by locale
+ */
+export type Translations = {
+  [locale: string]: TranslationMessages
+}
+/**
+ * Interpolation values for translations
+ */
+export type InterpolationValues = Record<string, string | number | boolean | null | undefined>;
+/**
+ * Date/time format configurations per locale
+ */
+export type DateTimeFormats = {
+  [locale: string]: {
+    [formatName: string]: Intl.DateTimeFormatOptions
+  }
+}
+/**
+ * Number format configurations per locale
+ */
+export type NumberFormats = {
+  [locale: string]: {
+    [formatName: string]: Intl.NumberFormatOptions
+  }
+}
+/**
+ * Translation function
+ */
+export type TranslateFunction = (
+  key: string,
+  values?: InterpolationValues,
+  locale?: string,
+) => string;
+/**
+ * Plural translation function
+ */
+export type TranslatePluralFunction = (
+  key: string,
+  count: number,
+  values?: InterpolationValues,
+  locale?: string,
+) => string;

package/dist/types.js

@@ -0,0 +1,25 @@
+export const LOCALE_INFO = {
+  en: { code: "en", name: "English", nativeName: "English", direction: "ltr" },
+  "en-US": { code: "en-US", name: "English (US)", nativeName: "English (US)", direction: "ltr", region: "US" },
+  "en-GB": { code: "en-GB", name: "English (UK)", nativeName: "English (UK)", direction: "ltr", region: "GB" },
+  es: { code: "es", name: "Spanish", nativeName: "Espa\xF1ol", direction: "ltr" },
+  fr: { code: "fr", name: "French", nativeName: "Fran\xE7ais", direction: "ltr" },
+  de: { code: "de", name: "German", nativeName: "Deutsch", direction: "ltr" },
+  it: { code: "it", name: "Italian", nativeName: "Italiano", direction: "ltr" },
+  pt: { code: "pt", name: "Portuguese", nativeName: "Portugu\xEAs", direction: "ltr" },
+  "pt-BR": { code: "pt-BR", name: "Portuguese (Brazil)", nativeName: "Portugu\xEAs (Brasil)", direction: "ltr", region: "BR" },
+  zh: { code: "zh", name: "Chinese", nativeName: "\u4E2D\u6587", direction: "ltr" },
+  "zh-CN": { code: "zh-CN", name: "Chinese (Simplified)", nativeName: "\u7B80\u4F53\u4E2D\u6587", direction: "ltr", region: "CN" },
+  "zh-TW": { code: "zh-TW", name: "Chinese (Traditional)", nativeName: "\u7E41\u9AD4\u4E2D\u6587", direction: "ltr", region: "TW" },
+  ja: { code: "ja", name: "Japanese", nativeName: "\u65E5\u672C\u8A9E", direction: "ltr" },
+  ko: { code: "ko", name: "Korean", nativeName: "\uD55C\uAD6D\uC5B4", direction: "ltr" },
+  ar: { code: "ar", name: "Arabic", nativeName: "\u0627\u0644\u0639\u0631\u0628\u064A\u0629", direction: "rtl" },
+  he: { code: "he", name: "Hebrew", nativeName: "\u05E2\u05D1\u05E8\u05D9\u05EA", direction: "rtl" },
+  ru: { code: "ru", name: "Russian", nativeName: "\u0420\u0443\u0441\u0441\u043A\u0438\u0439", direction: "ltr" },
+  nl: { code: "nl", name: "Dutch", nativeName: "Nederlands", direction: "ltr" },
+  pl: { code: "pl", name: "Polish", nativeName: "Polski", direction: "ltr" },
+  tr: { code: "tr", name: "Turkish", nativeName: "T\xFCrk\xE7e", direction: "ltr" },
+  vi: { code: "vi", name: "Vietnamese", nativeName: "Ti\u1EBFng Vi\u1EC7t", direction: "ltr" },
+  th: { code: "th", name: "Thai", nativeName: "\u0E44\u0E17\u0E22", direction: "ltr" },
+  hi: { code: "hi", name: "Hindi", nativeName: "\u0939\u093F\u0928\u094D\u0926\u0940", direction: "ltr" }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacksjs/i18n",
-  "version": "0.70.88",
+  "version": "0.70.91",
   "description": "Internationalization system for Stacks.js applications",
   "type": "module",
   "sideEffects": false,
@@ -40,7 +40,7 @@
     "@stacksjs/ts-i18n": "^0.1.9"
   },
   "devDependencies": {
-    "@stacksjs/development": "0.70.88"
+    "@stacksjs/development": "0.70.91"
   },
   "publishConfig": {
     "exports": {