@stacksjs/i18n 0.70.86 → 0.70.88

package/src/bootstrap.ts

@@ -1,107 +0,0 @@
-import { existsSync } from 'node:fs'
-import { config } from '@stacksjs/config'
-import { projectPath } from '@stacksjs/path'
-import { loadFromDirectory } from './loader'
-import { configure, getAvailableLocales, setLocale } from './translator'
-
-let localesLoaded = false
-
-/**
- * Load translation files from the project `locales/` directory once.
- * Locale subdirectories (`locales/de.yml`, `locales/en.yml`, …) are detected
- * automatically by `loadFromDirectory`.
- */
-export async function ensureLocalesLoaded(): Promise<void> {
-  if (localesLoaded)
-    return
-
-  const directory = projectPath('locales')
-  if (existsSync(directory)) {
-    await loadFromDirectory({
-      directory,
-      extensions: ['.yaml', '.yml', '.json'],
-    })
-  }
-
-  const app = (config as { app?: { locale?: string, fallbackLocale?: string, env?: string } }).app
-  const defaultLocale = app?.locale ?? 'en'
-  const fallback = app?.fallbackLocale ?? defaultLocale
-  const available = getAvailableLocales()
-  configure({
-    locale: defaultLocale,
-    fallbackLocale: fallback,
-    availableLocales: available.length > 0 ? available : [defaultLocale],
-    warnMissing: (app?.env ?? process.env.APP_ENV) !== 'production',
-  })
-
-  localesLoaded = true
-}
-
-/**
- * Resolve the active locale for an HTTP request.
- * Order: STX locale prefix (`/en/...`), `?locale=`, `locale` cookie,
- * Accept-Language, then `config.app.locale`.
- */
-export function resolveRequestLocale(request?: Request): string {
-  const app = (config as { app?: { locale?: string, fallbackLocale?: string } }).app
-  const defaultLocale = app?.locale ?? 'en'
-  const available = new Set(getAvailableLocales())
-  if (!available.size)
-    available.add(defaultLocale)
-
-  const pick = (code: string): string => {
-    const normalized = code.trim().toLowerCase()
-    if (available.has(normalized))
-      return normalized
-    const short = normalized.split('-')[0]
-    if (short && available.has(short))
-      return short
-    return defaultLocale
-  }
-
-  if (!request)
-    return defaultLocale
-
-  const url = new URL(request.url)
-  const pathname = url.pathname
-
-  const fromStx = request.headers.get('x-stx-locale')
-  if (fromStx)
-    return pick(fromStx)
-
-  // Non-default locales are served under `/<code>/…` by stx-serve i18n routing.
-  for (const code of available) {
-    if (code === defaultLocale)
-      continue
-    if (pathname === `/${code}` || pathname === `/${code}/`)
-      return pick(code)
-    if (pathname.startsWith(`/${code}/`))
-      return pick(code)
-  }
-
-  const fromQuery = url.searchParams.get('locale')
-  if (fromQuery)
-    return pick(fromQuery)
-
-  const cookie = request.headers.get('cookie') ?? ''
-  const match = cookie.match(/(?:^|;\s*)locale=([a-z]{2}(?:-[a-z]{2})?)(?:;|$)/i)
-  if (match?.[1])
-    return pick(match[1])
-
-  const accept = request.headers.get('accept-language') ?? ''
-  for (const part of accept.split(',')) {
-    const tag = part.split(';')[0]?.trim()
-    if (tag)
-      return pick(tag)
-  }
-
-  return defaultLocale
-}
-
-/** Load `locales/` and activate the global translator for this request. */
-export async function applyRequestLocale(request?: Request): Promise<string> {
-  await ensureLocalesLoaded()
-  const locale = resolveRequestLocale(request)
-  setLocale(locale)
-  return locale
-}

package/src/formatter.ts

@@ -1,399 +0,0 @@
-/**
- * Internationalized Formatting
- *
- * Provides locale-aware formatting for dates, numbers, currencies, and more.
- */
-
-import { getLocale } from './translator'
-
-// =============================================================================
-// Date Formatting
-// =============================================================================
-
-export type DateStyle = 'full' | 'long' | 'medium' | 'short'
-export type TimeStyle = 'full' | 'long' | 'medium' | 'short'
-
-export interface DateFormatOptions extends Intl.DateTimeFormatOptions {
-  dateStyle?: DateStyle
-  timeStyle?: TimeStyle
-}
-
-/**
- * Format a date
- */
-export function formatDate(
-  date: Date | number | string,
-  style: DateStyle | DateFormatOptions = 'medium',
-  locale?: string,
-): string {
-  const targetLocale = locale || getLocale()
-  const dateObj = toDate(date)
-
-  const options: Intl.DateTimeFormatOptions = typeof style === 'string'
-    ? { dateStyle: style }
-    : style
-
-  return new Intl.DateTimeFormat(targetLocale, options).format(dateObj)
-}
-
-/**
- * Format a time
- */
-export function formatTime(
-  date: Date | number | string,
-  style: TimeStyle | DateFormatOptions = 'short',
-  locale?: string,
-): string {
-  const targetLocale = locale || getLocale()
-  const dateObj = toDate(date)
-
-  const options: Intl.DateTimeFormatOptions = typeof style === 'string'
-    ? { timeStyle: style }
-    : style
-
-  return new Intl.DateTimeFormat(targetLocale, options).format(dateObj)
-}
-
-/**
- * Format a date and time
- */
-export function formatDateTime(
-  date: Date | number | string,
-  dateStyle: DateStyle = 'medium',
-  timeStyle: TimeStyle = 'short',
-  locale?: string,
-): string {
-  const targetLocale = locale || getLocale()
-  const dateObj = toDate(date)
-
-  return new Intl.DateTimeFormat(targetLocale, {
-    dateStyle,
-    timeStyle,
-  }).format(dateObj)
-}
-
-/**
- * Format relative time (e.g., "2 days ago", "in 3 hours")
- */
-export function formatRelativeTime(
-  date: Date | number | string,
-  baseDate: Date | number | string = new Date(),
-  style: 'long' | 'short' | 'narrow' = 'long',
-  locale?: string,
-): string {
-  const targetLocale = locale || getLocale()
-  const dateObj = toDate(date)
-  const baseDateObj = toDate(baseDate)
-
-  const diffMs = dateObj.getTime() - baseDateObj.getTime()
-  const diffSeconds = Math.round(diffMs / 1000)
-  const diffMinutes = Math.round(diffSeconds / 60)
-  const diffHours = Math.round(diffMinutes / 60)
-  const diffDays = Math.round(diffHours / 24)
-  const diffWeeks = Math.round(diffDays / 7)
-  const diffMonths = Math.round(diffDays / 30)
-  const diffYears = Math.round(diffDays / 365)
-
-  const rtf = new Intl.RelativeTimeFormat(targetLocale, { style })
-
-  // Choose appropriate unit
-  if (Math.abs(diffSeconds) < 60) {
-    return rtf.format(diffSeconds, 'second')
-  }
-  if (Math.abs(diffMinutes) < 60) {
-    return rtf.format(diffMinutes, 'minute')
-  }
-  if (Math.abs(diffHours) < 24) {
-    return rtf.format(diffHours, 'hour')
-  }
-  if (Math.abs(diffDays) < 7) {
-    return rtf.format(diffDays, 'day')
-  }
-  if (Math.abs(diffWeeks) < 4) {
-    return rtf.format(diffWeeks, 'week')
-  }
-  if (Math.abs(diffMonths) < 12) {
-    return rtf.format(diffMonths, 'month')
-  }
-  return rtf.format(diffYears, 'year')
-}
-
-// =============================================================================
-// Number Formatting
-// =============================================================================
-
-export interface NumberFormatOptions extends Intl.NumberFormatOptions {
-  compact?: boolean
-  precision?: number
-}
-
-/**
- * Format a number
- */
-export function formatNumber(
-  value: number,
-  options: NumberFormatOptions = {},
-  locale?: string,
-): string {
-  const targetLocale = locale || getLocale()
-
-  const formatOptions: Intl.NumberFormatOptions = { ...options }
-
-  if (options.compact) {
-    formatOptions.notation = 'compact'
-    formatOptions.compactDisplay = 'short'
-  }
-
-  if (options.precision !== undefined) {
-    formatOptions.minimumFractionDigits = options.precision
-    formatOptions.maximumFractionDigits = options.precision
-  }
-
-  return new Intl.NumberFormat(targetLocale, formatOptions).format(value)
-}
-
-/**
- * Format a currency value
- */
-export function formatCurrency(
-  value: number,
-  currency = 'USD',
-  options: Omit<NumberFormatOptions, 'style' | 'currency'> = {},
-  locale?: string,
-): string {
-  const targetLocale = locale || getLocale()
-
-  return new Intl.NumberFormat(targetLocale, {
-    style: 'currency',
-    currency,
-    ...options,
-  }).format(value)
-}
-
-/**
- * Format a percentage
- */
-export function formatPercent(
-  value: number,
-  options: Omit<NumberFormatOptions, 'style'> = {},
-  locale?: string,
-): string {
-  const targetLocale = locale || getLocale()
-
-  return new Intl.NumberFormat(targetLocale, {
-    style: 'percent',
-    ...options,
-  }).format(value)
-}
-
-/**
- * Format a number with units (e.g., "5 kilograms", "10 miles")
- */
-export function formatUnit(
-  value: number,
-  unit: string,
-  unitDisplay: 'long' | 'short' | 'narrow' = 'short',
-  locale?: string,
-): string {
-  const targetLocale = locale || getLocale()
-
-  return new Intl.NumberFormat(targetLocale, {
-    style: 'unit',
-    unit,
-    unitDisplay,
-  }).format(value)
-}
-
-/**
- * Format bytes to human-readable format
- */
-export function formatBytes(
-  bytes: number,
-  decimals = 2,
-  locale?: string,
-): string {
-  const targetLocale = locale || getLocale()
-
-  if (bytes === 0) return '0 B'
-
-  const k = 1024
-  const sizes = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']
-  const i = Math.floor(Math.log(bytes) / Math.log(k))
-
-  const value = bytes / Math.pow(k, i)
-  const formatted = new Intl.NumberFormat(targetLocale, {
-    minimumFractionDigits: 0,
-    maximumFractionDigits: decimals,
-  }).format(value)
-
-  return `${formatted} ${sizes[i]}`
-}
-
-// =============================================================================
-// List Formatting
-// =============================================================================
-
-export type ListType = 'conjunction' | 'disjunction' | 'unit'
-export type ListStyle = 'long' | 'short' | 'narrow'
-
-/**
- * Format a list of items
- */
-export function formatList(
-  items: string[],
-  type: ListType = 'conjunction',
-  style: ListStyle = 'long',
-  locale?: string,
-): string {
-  const targetLocale = locale || getLocale()
-
-  return new Intl.ListFormat(targetLocale, { type, style }).format(items)
-}
-
-// =============================================================================
-// Plural Formatting
-// =============================================================================
-
-/**
- * Get the plural category for a number
- */
-export function formatPlural(
-  value: number,
-  locale?: string,
-): Intl.LDMLPluralRule {
-  const targetLocale = locale || getLocale()
-  const pr = new Intl.PluralRules(targetLocale)
-  return pr.select(value)
-}
-
-/**
- * Select from plural options based on a number
- */
-export function selectPlural<T>(
-  value: number,
-  options: Partial<Record<Intl.LDMLPluralRule, T>> & { other: T },
-  locale?: string,
-): T {
-  const category = formatPlural(value, locale)
-  return options[category] ?? options.other
-}
-
-// =============================================================================
-// Display Names
-// =============================================================================
-
-export type DisplayNameType = 'language' | 'region' | 'script' | 'currency' | 'calendar' | 'dateTimeField'
-
-/**
- * Get display name for a code
- */
-export function getDisplayName(
-  code: string,
-  type: DisplayNameType = 'language',
-  style: 'long' | 'short' | 'narrow' = 'long',
-  locale?: string,
-): string | undefined {
-  const targetLocale = locale || getLocale()
-
-  try {
-    const dn = new Intl.DisplayNames(targetLocale, { type, style })
-    return dn.of(code)
-  }
-  catch {
-    return undefined
-  }
-}
-
-/**
- * Get language name
- */
-export function getLanguageName(
-  languageCode: string,
-  locale?: string,
-): string | undefined {
-  return getDisplayName(languageCode, 'language', 'long', locale)
-}
-
-/**
- * Get region/country name
- */
-export function getRegionName(
-  regionCode: string,
-  locale?: string,
-): string | undefined {
-  return getDisplayName(regionCode, 'region', 'long', locale)
-}
-
-/**
- * Get currency name
- */
-export function getCurrencyName(
-  currencyCode: string,
-  locale?: string,
-): string | undefined {
-  return getDisplayName(currencyCode, 'currency', 'long', locale)
-}
-
-// =============================================================================
-// Collation
-// =============================================================================
-
-/**
- * Compare strings in a locale-aware manner
- */
-export function compareStrings(
-  a: string,
-  b: string,
-  options: Intl.CollatorOptions = {},
-  locale?: string,
-): number {
-  const targetLocale = locale || getLocale()
-  const collator = new Intl.Collator(targetLocale, options)
-  return collator.compare(a, b)
-}
-
-/**
- * Sort an array of strings in locale-aware order
- */
-export function sortStrings(
-  strings: string[],
-  options: Intl.CollatorOptions = {},
-  locale?: string,
-): string[] {
-  const targetLocale = locale || getLocale()
-  const collator = new Intl.Collator(targetLocale, options)
-  return [...strings].sort((a, b) => collator.compare(a, b))
-}
-
-// =============================================================================
-// Helpers
-// =============================================================================
-
-/**
- * Convert various date formats to Date object
- */
-function toDate(date: Date | number | string): Date {
-  if (date instanceof Date) return date
-  if (typeof date === 'number') return new Date(date)
-  return new Date(date)
-}
-
-/**
- * Get the text direction for a locale
- */
-export function getTextDirection(locale?: string): 'ltr' | 'rtl' {
-  const targetLocale = locale || getLocale()
-  const lang = (targetLocale.split('-')[0] ?? targetLocale).toLowerCase()
-
-  // RTL languages
-  const rtlLanguages = ['ar', 'he', 'fa', 'ur', 'yi', 'ps', 'sd', 'ug', 'ku', 'ckb']
-
-  return rtlLanguages.includes(lang) ? 'rtl' : 'ltr'
-}
-
-/**
- * Check if a locale uses RTL text direction
- */
-export function isRTL(locale?: string): boolean {
-  return getTextDirection(locale) === 'rtl'
-}

package/src/index.ts

@@ -1,100 +0,0 @@
-/**
- * Stacks i18n - Internationalization System
- *
- * A comprehensive internationalization system with support for:
- * - Translation loading from JSON/YAML files
- * - Plural forms
- * - Variable interpolation
- * - Nested translations
- * - Date/time formatting
- * - Number formatting
- * - Currency formatting
- * - Relative time formatting
- *
- * @example
- * ```ts
- * import { t, setLocale, addTranslations } from '@stacksjs/i18n'
- *
- * // Add translations
- * addTranslations('en', {
- *   greeting: 'Hello, {name}!',
- *   items: '{count} item | {count} items',
- * })
- *
- * // Use translations
- * t('greeting', { name: 'World' }) // "Hello, World!"
- * t('items', { count: 1 }) // "1 item"
- * t('items', { count: 5 }) // "5 items"
- *
- * // Format dates and numbers
- * formatDate(new Date(), 'long') // "January 8, 2026"
- * formatNumber(1234567.89) // "1,234,567.89"
- * formatCurrency(99.99, 'USD') // "$99.99"
- * ```
- */
-
-export * from './translator'
-export * from './formatter'
-export * from './pluralization'
-export * from './loader'
-export * from './types'
-
-// Re-export the file-loading and type-generation surface from
-// `@stacksjs/ts-i18n`. The library handles disk loading (YAML / TS /
-// JSON), namespace resolution, and `.d.ts` codegen for translation
-// keys; the Stacks-side translator/formatter sits on top of that
-// data with locale management, ICU pluralization, and Intl-backed
-// formatters. Importing both names from `@stacksjs/i18n` keeps the
-// app side from caring which symbol comes from which package.
-export {
-  loadTranslations as loadTranslationsFromDisk,
-  generateTypes as generateI18nTypes,
-  generateTypesFromModule as generateI18nTypesFromModule,
-  generateSampleConfig as generateI18nSampleConfig,
-  writeOutputs as writeI18nOutputs,
-  createTranslator as createSimpleTranslator,
-} from '@stacksjs/ts-i18n'
-export type { I18nConfig as TsI18nConfig, TranslationTree, TranslationValue } from '@stacksjs/ts-i18n'
-
-// Re-export main functions for convenience
-export {
-  t,
-  trans,
-  tc,
-  te,
-  tm,
-  setLocale,
-  getLocale,
-  addTranslations,
-  loadTranslations,
-  getAvailableLocales,
-  hasTranslation,
-  I18n,
-  createI18n,
-  useI18n,
-} from './translator'
-
-export {
-  ensureLocalesLoaded,
-  resolveRequestLocale,
-  applyRequestLocale,
-} from './bootstrap'
-
-export {
-  createLocaleSwitchResponse,
-  localizePath,
-  stripLocalePrefix,
-  type LocaleSwitchConfig,
-} from './locale-switch'
-
-export {
-  formatDate,
-  formatTime,
-  formatDateTime,
-  formatNumber,
-  formatCurrency,
-  formatPercent,
-  formatRelativeTime,
-  formatList,
-  formatPlural,
-} from './formatter'