@zfqh/uview-x 0.0.5 → 0.0.6

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.0.6](http://10.10.10.16/caoben/front-end-tools/compare/@zfqh/uview-x@0.0.5...@zfqh/uview-x@0.0.6) (2026-11-11)
+
+**Note:** Version bump only for package @zfqh/uview-x
+
+
+
+
+
 ## [0.0.5](http://10.10.10.16/caoben/front-end-tools/compare/@zfqh/uview-x@0.0.4...@zfqh/uview-x@0.0.5) (2026-11-11)
 
 

package/README.md

@@ -67,12 +67,12 @@ dev 阶段也可使用 easycom（`pages.json`）：
 
 ## 国际化
 
-默认简体中文；其他语言按需引入并合并（可选：`en`、`es`、`fr`、`ru`、`zh-Hant`）：
+默认简体中文；其他语言按需引入并合并（可选：`zh-CN`、`zh-TW`、`en-US`、`es-ES`、`fr-FR`、`ru-RU`）：
 
 ```ts
-import en from '@zfqh/uview-x/locales/en';
-// createI18n({ messages: { en: { ...en, ...自定义 } } })
-// 其他语言将路径中的 en 换成对应 locale 即可
+import enUS from '@zfqh/uview-x/locales/en-US';
+// createI18n({ messages: { 'en-US': { ...enUS, ...自定义 } } })
+// 其他语言将路径中的 en-US 换成对应 locale 即可
 ```
 
 ## 文档

package/locales/{en.ts → en-US.ts}

@@ -1,11 +1,11 @@
 /**
- * uview-x 可选组件语言包：英文（en）。
+ * uview-x 可选组件语言包：英文（en-US）。
  *
  * 不参与内部聚合、不会被 `createI18n` 自动合并；需要英文时由使用方显式引入并合并：
- * `import en from '@zfqh/uview-x/locales/en'`，再在 `createI18n({ messages: { en } })` 中使用。
+ * `import enUS from '@zfqh/uview-x/locales/en-US'`，再在 `createI18n({ messages: { 'en-US': enUS } })` 中使用。
  * 键空间固定为 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 完全对齐，`%s` 占位符由校验器替换。
  */
-const en = {
+const enUS = {
   uv: {
     dialog: {
       title: 'Tips',
@@ -76,4 +76,4 @@ const en = {
   },
 };
 
-export default en;
+export default enUS;

package/locales/{es.ts → es-ES.ts}

@@ -1,11 +1,11 @@
 /**
- * uview-x 可选组件语言包：西班牙语（es）。
+ * uview-x 可选组件语言包：西班牙语（es-ES）。
  *
  * 不参与内部聚合、不会被 `createI18n` 自动合并；需要西班牙语时由使用方显式引入并合并：
- * `import es from '@zfqh/uview-x/locales/es'`，再在 `createI18n({ messages: { es } })` 中使用。
+ * `import esES from '@zfqh/uview-x/locales/es-ES'`，再在 `createI18n({ messages: { 'es-ES': esES } })` 中使用。
  * 键空间固定为 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 完全对齐，`%s` 占位符由校验器替换。
  */
-const es = {
+const esES = {
   uv: {
     dialog: {
       title: 'Consejo',
@@ -76,4 +76,4 @@ const es = {
   },
 };
 
-export default es;
+export default esES;

package/locales/{fr.ts → fr-FR.ts}

@@ -1,11 +1,11 @@
 /**
- * uview-x 可选组件语言包：法语（fr）。
+ * uview-x 可选组件语言包：法语（fr-FR）。
  *
  * 不参与内部聚合、不会被 `createI18n` 自动合并；需要法语时由使用方显式引入并合并：
- * `import fr from '@zfqh/uview-x/locales/fr'`，再在 `createI18n({ messages: { fr } })` 中使用。
+ * `import frFR from '@zfqh/uview-x/locales/fr-FR'`，再在 `createI18n({ messages: { 'fr-FR': frFR } })` 中使用。
  * 键空间固定为 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 完全对齐，`%s` 占位符由校验器替换。
  */
-const fr = {
+const frFR = {
   uv: {
     dialog: {
       title: 'Conseil',
@@ -76,4 +76,4 @@ const fr = {
   },
 };
 
-export default fr;
+export default frFR;

package/locales/index.ts

@@ -1,11 +1,11 @@
 import type { I18nMessages } from '../utils/locale';
-import zhHans from './zh-Hans';
+import zhCN from './zh-CN';
 
 /**
  * uview-x 默认语言包与查询工具。
  *
- * - 内部只聚合默认语言 `zh-Hans`；其他语言（如 `en` / `es` / `fr` / `ru` / `zh-Hant`）是独立文件，不进入内部聚合，
- *   由使用方 `import en from '@zfqh/uview-x/locales/en'` 后自行合并进 `createI18n`；
+ * - 内部只聚合默认语言 `zh-CN`；其他语言（如 `en-US` / `es-ES` / `fr-FR` / `ru-RU` / `zh-TW`）是独立文件，不进入内部聚合，
+ *   由使用方 `import enUS from '@zfqh/uview-x/locales/en-US'` 后自行合并进 `createI18n`；
  * - 纯数据 / 纯函数模块：不 import `vue` / `vue-i18n`，避免与 `utils/locale.ts` 形成值循环；
  * - 组件内置文案统一使用 `uv.*` 键空间，用户可在 `createI18n({ messages })` 中按同名 key 覆盖；
  * - 用户未创建 i18n 实例时，`utils/locale.ts` 的 `appTranslate` 会回退到这里的中文默认语言包。
@@ -19,9 +19,9 @@ export interface LocaleMessages {
   [key: string]: LocaleMessageValue;
 }
 
-/** 内部聚合的默认组件语言包：仅 `zh-Hans`（其他语言按需从 `locales/<locale>.ts` 引入） */
+/** 内部聚合的默认组件语言包：仅 `zh-CN`（其他语言按需从 `locales/<locale>.ts` 引入） */
 export const componentMessages: Record<string, LocaleMessages> = {
-  'zh-Hans': zhHans,
+  'zh-CN': zhCN,
 };
 
 function isLocaleMessages(value: LocaleMessageValue | undefined): value is LocaleMessages {
@@ -59,20 +59,20 @@ function mergeMessages(builtinMessages: LocaleMessages, userMessages: LocaleMess
 }
 
 /**
- * 把默认语言（`zh-Hans`）合并进用户 messages（返回新对象，不修改入参）。
+ * 把默认语言（`zh-CN`）合并进用户 messages（返回新对象，不修改入参）。
  *
- * - 仅对内置 `zh-Hans` 深合并，用户同名 key 优先，未覆盖的中文默认文案保留；
- * - 用户传入的其他 locale（如自行合并的 `en`）原样保留，不做补全或内置合并；
+ * - 仅对内置 `zh-CN` 深合并，用户同名 key 优先，未覆盖的中文默认文案保留；
+ * - 用户传入的其他 locale（如自行合并的 `en-US`）原样保留，不做补全或内置合并；
  * - 用户未传 messages 时返回仅含中文默认语言包的副本。
  */
 export function mergeDefaultMessages(userMessages?: I18nMessages): I18nMessages {
-  const userZhHans = userMessages ? userMessages['zh-Hans'] : undefined;
+  const userZhCN = userMessages ? userMessages['zh-CN'] : undefined;
   const merged: I18nMessages = {
-    'zh-Hans': mergeMessages(componentMessages['zh-Hans'], isLocaleMessages(userZhHans) ? userZhHans : {}),
+    'zh-CN': mergeMessages(componentMessages['zh-CN'], isLocaleMessages(userZhCN) ? userZhCN : {}),
   };
   if (userMessages) {
     for (const locale of Object.keys(userMessages)) {
-      if (locale !== 'zh-Hans') {
+      if (locale !== 'zh-CN') {
         merged[locale] = userMessages[locale];
       }
     }

package/locales/{ru.ts → ru-RU.ts}

@@ -1,11 +1,11 @@
 /**
- * uview-x 可选组件语言包：俄语（ru）。
+ * uview-x 可选组件语言包：俄语（ru-RU）。
  *
  * 不参与内部聚合、不会被 `createI18n` 自动合并；需要俄语时由使用方显式引入并合并：
- * `import ru from '@zfqh/uview-x/locales/ru'`，再在 `createI18n({ messages: { ru } })` 中使用。
+ * `import ruRU from '@zfqh/uview-x/locales/ru-RU'`，再在 `createI18n({ messages: { 'ru-RU': ruRU } })` 中使用。
  * 键空间固定为 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 完全对齐，`%s` 占位符由校验器替换。
  */
-const ru = {
+const ruRU = {
   uv: {
     dialog: {
       title: 'Подсказка',
@@ -76,4 +76,4 @@ const ru = {
   },
 };
 
-export default ru;
+export default ruRU;

package/locales/{zh-Hans.ts → zh-CN.ts}

@@ -1,11 +1,11 @@
 /**
- * uview-x 默认组件语言包：简体中文（zh-Hans）。
+ * uview-x 默认组件语言包：简体中文（zh-CN）。
  *
- * 默认语言由 `createI18n` 自动注入（可传 `messages['zh-Hans']` 覆盖同名 key）；
+ * 默认语言由 `createI18n` 自动注入（可传 `messages['zh-CN']` 覆盖同名 key）；
  * 键空间固定为 `uv.*`；
  * `uv.form.*` 与 `components/uv-form/valid.ts` 的 async-validator 默认 messages 对齐，`%s` 占位符由校验器替换。
  */
-const zhHans = {
+const zhCN = {
   uv: {
     dialog: {
       title: '提示',
@@ -76,4 +76,4 @@ const zhHans = {
   },
 };
 
-export default zhHans;
+export default zhCN;

package/locales/{zh-Hant.ts → zh-TW.ts}

@@ -1,11 +1,11 @@
 /**
- * uview-x 可选组件语言包：繁体中文（zh-Hant）。
+ * uview-x 可选组件语言包：繁体中文（zh-TW）。
  *
  * 不参与内部聚合、不会被 `createI18n` 自动合并；需要繁体中文时由使用方显式引入并合并：
- * `import zhHant from '@zfqh/uview-x/locales/zh-Hant'`，再在 `createI18n({ messages: { 'zh-Hant': zhHant } })` 中使用。
+ * `import zhTW from '@zfqh/uview-x/locales/zh-TW'`，再在 `createI18n({ messages: { 'zh-TW': zhTW } })` 中使用。
  * 键空间固定为 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 完全对齐，`%s` 占位符由校验器替换。
  */
-const zhHant = {
+const zhTW = {
   uv: {
     dialog: {
       title: '提示',
@@ -76,4 +76,4 @@ const zhHant = {
   },
 };
 
-export default zhHant;
+export default zhTW;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zfqh/uview-x",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "uview-x：面向 uni-app x 蒸汽模式（Vapor）、经典 uni-app Vue3 与 nvue 的 UV UI 组件库，组件保持 uv-ui API。",
   "main": "index.ts",
   "types": "types/index.d.ts",
@@ -39,5 +39,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "d9f4a73af79882b88161f2b898b9de28c4630532"
+  "gitHead": "cc5d98c2352fc99519a4660779a24cf992faad32"
 }

package/types/index.d.ts

@@ -11,13 +11,6 @@ import type { I18n, I18nOptions } from 'vue-i18n';
 type UviewX$uv = (typeof import('../utils'))['$uv'];
 
 declare global {
-  namespace UniNamespace {
-    interface GetAppBaseInfoResult {
-      /** uni-app x App 返回的语言，如 en / zh-Hans / zh-Hant / fr / es（经典端用 language 兜底） */
-      appLanguage?: string;
-    }
-  }
-
   interface Uni {
     $uv: UviewX$uv;
     /** `createI18n` 创建的全局 i18n 实例 */
@@ -50,9 +43,9 @@ declare module 'vue' {
 declare module '@zfqh/uview-x' {
   /** 运行时配置；颜色通过 `config.color` 访问（键为 camelCase，如 `primary`）；H5 滚动条通过 `config.scrollbar` 控制（默认隐藏） */
   export const config: (typeof import('../utils'))['config'];
-  /** 创建 i18n 实例并挂到 `uni.$i18n`（仅注入并深合并默认中文 `zh-Hans`；其他语言需自行 import 语言包后合并） */
+  /** 创建 i18n 实例并挂到 `uni.$i18n`（仅注入并深合并默认中文 `zh-CN`；其他语言需自行 import 语言包后合并） */
   export function createI18n(opts: I18nOptions): I18n;
-  /** 获取当前语言（storage `UNI_LOCALE` → `uni.getLocale` → `getAppBaseInfo` → `zh-Hans`） */
+  /** 获取当前语言（storage `UNI_LOCALE` → `getAppBaseInfo` 的 `language` / `osLanguage` / `hostLanguage` → `zh-CN`） */
   export function getLocale(): string;
   /** 按当前语言取词（优先全局语言包，其次默认中文语言包；支持 `a.b.c` 路径与 `{name}` 占位符） */
   export function getLocaleMessage(key: string, values?: Record<string, string | number>): string;

package/utils/locale.ts

@@ -7,8 +7,8 @@ import { getBuiltinMessage, mergeDefaultMessages } from '../locales';
 /**
  * 国际化能力（默认中文 + 可选语言包 + 4 个公共 API）。
  *
- * 默认语言只有简体中文（`zh-Hans`），`createI18n` 只注入并深合并内置中文；
- * 英文等其他语言为独立语言包（`locales/en.ts`），由使用方显式引入后合并进 `messages`。
+ * 默认语言只有简体中文（`zh-CN`），`createI18n` 只注入并深合并内置中文；
+ * 英文等其他语言为独立语言包（`locales/en-US.ts`），由使用方显式引入后合并进 `messages`。
  *
  * 公共 API（由 `utils/index.ts` 导出到包入口）：
  * `createI18n`、`getLocale`、`getLocaleMessage`、`setLocale`。
@@ -35,45 +35,17 @@ interface RefLike<T> {
   value: T;
 }
 
-/**
- * `uni` 全局对象的最小运行时视图（含 i18n 实例挂载点）。
- *
- * 对外 `$i18n` 声明在 `types/index.d.ts`；这里再留一份最小结构，保证其他包深引用
- * `@zfqh/uview-x/utils/locale`（不会加载本包 types 入口）时仍能编译。
- * 纯 Node / 单测环境可能没有 `uni` 全局，所有访问都要容错。
- */
-interface UniWithI18n {
-  $i18n?: I18n;
-  getStorageSync?: (key: string) => unknown;
-  setStorageSync?: (key: string, value: unknown) => void;
-  getLocale?: () => string;
-  setLocale?: (locale: string) => void;
-  getAppBaseInfo?: () => { appLanguage?: string; language?: string };
-}
-
-/** 读取 uni 全局对象；不存在时返回 undefined */
-function getUni(): UniWithI18n | undefined {
-  return typeof uni === 'undefined' ? undefined : (uni as unknown as UniWithI18n);
-}
-
-/** 读取挂到 `uni.$i18n` 上的 i18n 实例 */
-function getUniI18n(): I18n | undefined {
-  const uniApi = getUni();
-  return uniApi ? uniApi.$i18n : undefined;
-}
-
 /** 语言持久化 key：App 端切换语言可能触发重启，必须先落盘 */
 const STORAGE_KEY = 'UNI_LOCALE';
 
 /** 回退语言（内部使用，不对外导出） */
-const fallbackLocale = 'zh-Hans';
+const fallbackLocale = 'zh-CN';
 
 /** 读取上次选择的语言；storage 不可用或无有效值时返回空字符串 */
 function readStorageLocale(): string {
-  const uniApi = getUni();
-  if (uniApi && typeof uniApi.getStorageSync === 'function') {
+  if (typeof uni !== 'undefined' && typeof uni.getStorageSync === 'function') {
     try {
-      const stored: unknown = uniApi.getStorageSync(STORAGE_KEY);
+      const stored: unknown = uni.getStorageSync(STORAGE_KEY);
       if (typeof stored === 'string' && stored) {
         return stored;
       }
@@ -102,26 +74,19 @@ function readStorageLocale(): string {
  *
  * 顺序：
  * 1. 本地存储 `UNI_LOCALE`（用户上次通过 `setLocale` 选择的语言）；
- * 2. `uni.getLocale()`（H5 / 小程序 / 经典 App）；
- * 3. `uni.getAppBaseInfo().appLanguage`（uni-app x App）；
- * 4. `uni.getAppBaseInfo().language`（经典端已废弃字段，兜底）；
- * 5. `zh-Hans`。
+ * 2. `uni.getAppBaseInfo().language`；
+ * 3. `uni.getAppBaseInfo().osLanguage`；
+ * 4. `uni.getAppBaseInfo().hostLanguage`；
+ * 5. `zh-CN`。
  */
 export function getLocale(): string {
   const stored = readStorageLocale();
   if (stored) {
     return stored;
   }
-  const uniApi = getUni();
-  if (uniApi && typeof uniApi.getLocale === 'function') {
-    const systemLocale = uniApi.getLocale();
-    if (systemLocale) {
-      return systemLocale;
-    }
-  }
-  if (uniApi && typeof uniApi.getAppBaseInfo === 'function') {
-    const info = uniApi.getAppBaseInfo();
-    const systemLocale = info.appLanguage || info.language;
+  if (typeof uni !== 'undefined' && typeof uni.getAppBaseInfo === 'function') {
+    const info = uni.getAppBaseInfo() as { language?: string; osLanguage?: string; hostLanguage?: string };
+    const systemLocale = info.language || info.osLanguage || info.hostLanguage;
     if (systemLocale) {
       return systemLocale;
     }
@@ -157,7 +122,10 @@ function isI18nGlobalLike(value: unknown): value is I18nGlobalLike {
 
 /** 当前 `uni.$i18n.global` 的运行时视图；实例不存在时返回 undefined */
 export function getI18nGlobal(): I18nGlobalLike | undefined {
-  const global = getUniI18n()?.global;
+  if (typeof uni === 'undefined') {
+    return undefined;
+  }
+  const global = uni.$i18n?.global;
   return isI18nGlobalLike(global) ? global : undefined;
 }
 
@@ -189,7 +157,7 @@ function getMessage(messages: I18nMessages, locale: string, key: string): string
 /**
  * 翻译（App / 小程序 / 无 i18n 实例时的统一实现）。
  *
- * locale 优先级：storage `UNI_LOCALE` → `uni.$i18n.global.locale` → 内部 `localeState` → `zh-Hans`；
+ * locale 优先级：storage `UNI_LOCALE` → `uni.$i18n.global.locale` → 内部 `localeState` → `zh-CN`；
  * 消息优先级：全局语言包（当前语言 → 中文回退）→ 内置中文默认语言包 → key。
  * 其他语言（如英文）由使用方在 `createI18n` 中显式合并，未合并时回退中文。
  * storage 优先用于 nvue 等页面上下文模块副本不同、实例未共享的场景（setLocale 已先落盘）。
@@ -210,9 +178,9 @@ export function appTranslate(key: string, values?: Record<string, string | numbe
 /**
  * 创建 i18n 实例并挂到 `uni.$i18n`。
  *
- * - 只注入内置默认中文：`mergeDefaultMessages(opts.messages)` 仅深合并 `zh-Hans`，
- *   用户同名 key 优先；其他 locale（如显式引入的 `en`）原样透传，不做内置补全；
- * - 未显式传 `fallbackLocale` 时默认 `zh-Hans`，未合并的语言回退中文；
+ * - 只注入内置默认中文：`mergeDefaultMessages(opts.messages)` 仅深合并 `zh-CN`，
+ *   用户同名 key 优先；其他 locale（如显式引入的 `en-US`）原样透传，不做内置补全；
+ * - 未显式传 `fallbackLocale` 时默认 `zh-CN`，未合并的语言回退中文；
  * - App 端不依赖 vue-i18n 注入，直接把 `global.t` 替换为包内 `appTranslate`；
  * - 用 `opts.locale` 初始化内部 `localeState`，无实例时也能保持语言一致。
  */
@@ -234,9 +202,8 @@ export function createI18n(opts: I18nOptions): I18n {
   // #ifdef APP
   i18n.global.t = appTranslate as unknown as typeof i18n.global.t;
   // #endif
-  const uniApi = getUni();
-  if (uniApi) {
-    uniApi.$i18n = i18n;
+  if (typeof uni !== 'undefined') {
+    uni.$i18n = i18n;
   }
   if (typeof opts.locale === 'string' && opts.locale) {
     localeState.value = opts.locale;
@@ -277,17 +244,16 @@ export function setLocale(locale: string): void {
       // 实例不可写时忽略，继续持久化
     }
   }
-  const uniApi = getUni();
-  if (uniApi && typeof uniApi.setStorageSync === 'function') {
+  if (typeof uni !== 'undefined' && typeof uni.setStorageSync === 'function') {
     try {
-      uniApi.setStorageSync(STORAGE_KEY, locale);
+      uni.setStorageSync(STORAGE_KEY, locale);
     } catch (e) {
       // storage 不可用时忽略
     }
   }
-  if (uniApi && typeof uniApi.setLocale === 'function') {
+  if (typeof uni !== 'undefined' && typeof uni.setLocale === 'function') {
     try {
-      uniApi.setLocale(locale);
+      uni.setLocale(locale);
     } catch (e) {
       // App 端 setLocale 可能触发重启 / 平台不支持，忽略
     }