@x-coins/locale

Lightweight locale engine shared by packages and apps.

Detailed API reference: ../../docs/api-reference.md.

Public Entry

import { install, locale, t } from '@x-coins/locale'

Engine

Locale stores messages by language and supports:

• reactive lang
• registerMessages(lang, messages)
• async registerLoader(loader)
• use(lang) to switch language and load dictionaries
• t(path, params, defaultValue) for dot-path lookup and interpolation
• BCP 47 fallback candidates such as zh-Hans-CN -> zh-Hans -> zh

Example:

locale.registerMessages('zh-CN', {
  proTable: { refresh: '刷新' },
})

locale.t('proTable.refresh')

Vue Plugin

install(app) provides the locale instance as x-locale and registers $translate on global properties.

Package Usage

Library packages should register namespaced messages, for example proTable, schemaForm, or pop. Avoid page-specific copy in packages; keep feature wording in the consuming app.