@zfqh/uview-x 0.0.6 → 0.0.7

package/index.ts

@@ -1,30 +1,51 @@
-import type { App } from 'vue';
-import { $uv } from './utils';
-// #ifdef WEB || H5
-import { applyScrollbar } from './utils/scrollbar';
-// #endif
-
-export * from './utils';
-export * from './hooks';
-export * from './libs';
-
-// 与 uv-ui 对齐：入口模块被引入后，脚本中即可使用 uni.$uv。
-// 这样商户项目里（先 import 包、再 import 含 uni.$uv.setConfig 的配置模块）的求值顺序不变。
-uni.$uv = $uv;
-
-/**
- * 注册 uview-x 插件。
- *
- * - 仅挂到 `app.config.globalProperties.$uv`，模板中可直接使用 `$uv`；
- * - `uni.$uv` 已在入口模块顶层赋值（脚本中使用）；
- * - H5 下按 `config.scrollbar` 注入全局滚动条样式（默认隐藏）；
+import type { App } from 'vue';
+import config, { setConfig } from './utils/config';
+import type { UViewConfigOptions, UViewColor, UViewConfig } from './utils/config';
+import type { UViewCompressOptions } from './utils/compress';
+import * as test from './utils/test';
+import { createI18n, getLocale, getLocaleMessage, setLocale } from './utils/locale';
+import type { UViewI18nMessages, UViewCreateI18nOptions, UViewI18nOptions } from './utils/locale';
+// #ifdef WEB || H5
+import { applyScrollbar } from './utils/scrollbar';
+// #endif
+
+export * from './hooks';
+export * from './utils/route';
+
+export { default as compress } from './utils/compress';
+export { default as debounce } from './utils/debounce';
+export { default as http } from './utils/http';
+export { default as throttle } from './utils/throttle';
+export { test };
+
+export { config, setConfig };
+export type { UViewCompressOptions, UViewConfigOptions, UViewColor, UViewConfig };
+
+export { createI18n, getLocale, getLocaleMessage, setLocale };
+export type { UViewI18nMessages, UViewCreateI18nOptions, UViewI18nOptions };
+
+/**
+ * uview-x 插件。
+ *
+ * - `app.use(UviewX, options)`：安装时应用初始化配置（runtime config + i18n）；
+ * - `app.use(UviewX)`：使用此前 `setConfig` 的配置或默认值；
+ * - 不向 app / uni 注入任何全局对象；
+ * - H5 下按 `config.scrollbar` 注入全局滚动条样式（默认隐藏）。
  */
-
-function install(app: App): void {
-  app.config.globalProperties.$uv = $uv;
-  // #ifdef WEB || H5
-  applyScrollbar($uv.config.scrollbar);
-  // #endif
-}
-
-export default { install };
+export interface UViewPlugin {
+  install(app: App, options?: UViewConfigOptions): void;
+}
+
+const plugin: UViewPlugin = {
+  install(app: App, options?: UViewConfigOptions): void {
+    void app;
+    if (options) {
+      setConfig(options);
+    }
+    // #ifdef WEB || H5
+    applyScrollbar(config.scrollbar);
+    // #endif
+  },
+};
+
+export default plugin;

package/locales/en.ts

@@ -0,0 +1,56 @@
+/**
+ * uview-x 默认组件语言包：英文（en），也是组件内置默认语言。
+ *
+ * 内部由 `utils/locale.ts` 聚合；`createI18n` 会自动注入并允许同名扁平 key 覆盖。
+ * 键空间固定为扁平 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 对齐，`%s` 占位符由校验器替换。
+ */
+const en = {
+  'uv.dialog.title': 'Tips',
+  'uv.dialog.cancel': 'Cancel',
+  'uv.dialog.confirm': 'OK',
+  'uv.code.start': 'Get code',
+  // 组件会把 x / X 替换为剩余秒数
+  'uv.code.change': 'X seconds to resend',
+  'uv.code.end': 'Resend',
+  'uv.time.justNow': 'Just now',
+  'uv.time.minutesAgo': '{n} minutes ago',
+  'uv.time.hoursAgo': '{n} hours ago',
+  'uv.time.daysAgo': '{n} days ago',
+  'uv.time.monthsAgo': '{n} months ago',
+  'uv.time.yearsAgo': '{n} years ago',
+  'uv.form.default': 'Validation error on field %s',
+  'uv.form.required': '%s is required',
+  'uv.form.enum': '%s must be one of %s',
+  'uv.form.whitespace': '%s cannot be empty',
+  'uv.form.date.format': '%s date %s is invalid for format %s',
+  'uv.form.date.parse': '%s date could not be parsed, %s is invalid',
+  'uv.form.date.invalid': '%s date %s is invalid',
+  'uv.form.types.string': '%s is not a %s',
+  'uv.form.types.method': '%s is not a %s (function)',
+  'uv.form.types.array': '%s is not an %s',
+  'uv.form.types.object': '%s is not an %s',
+  'uv.form.types.number': '%s is not a %s',
+  'uv.form.types.date': '%s is not a %s',
+  'uv.form.types.boolean': '%s is not a %s',
+  'uv.form.types.integer': '%s is not an %s',
+  'uv.form.types.float': '%s is not a %s',
+  'uv.form.types.regexp': '%s is not a valid %s',
+  'uv.form.types.email': '%s is not a valid %s',
+  'uv.form.types.url': '%s is not a valid %s',
+  'uv.form.types.hex': '%s is not a valid %s',
+  'uv.form.string.len': '%s must be exactly %s characters',
+  'uv.form.string.min': '%s must be at least %s characters',
+  'uv.form.string.max': '%s cannot be longer than %s characters',
+  'uv.form.string.range': '%s must be between %s and %s characters',
+  'uv.form.number.len': '%s must equal %s',
+  'uv.form.number.min': '%s cannot be less than %s',
+  'uv.form.number.max': '%s cannot be greater than %s',
+  'uv.form.number.range': '%s must be between %s and %s',
+  'uv.form.array.len': '%s must be exactly %s in length',
+  'uv.form.array.min': '%s cannot be less than %s in length',
+  'uv.form.array.max': '%s cannot be greater than %s in length',
+  'uv.form.array.range': '%s must be between %s and %s in length',
+  'uv.form.pattern.mismatch': '%s value %s does not match pattern %s',
+};
+
+export default en;

package/locales/es.ts

@@ -0,0 +1,57 @@
+/**
+ * uview-x 可选组件语言包：西班牙语（es）。
+ *
+ * 不参与内部聚合、不会被 `createI18n` 自动合并；需要西班牙语时由使用方显式引入并合并：
+ * `import es from '@zfqh/uview-x/locales/es'`，再在 `createI18n({ messages: { es } })` 中使用。
+ * 键空间固定为扁平 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 对齐，`%s` 占位符由校验器替换。
+ */
+const es = {
+  'uv.dialog.title': 'Consejo',
+  'uv.dialog.cancel': 'Cancelar',
+  'uv.dialog.confirm': 'Confirmar',
+  'uv.code.start': 'Obtener código',
+  // 组件会把 x / X 替换为剩余秒数
+  'uv.code.change': 'X segundos para reenviar',
+  'uv.code.end': 'Reenviar',
+  'uv.time.justNow': 'Ahora mismo',
+  'uv.time.minutesAgo': 'hace {n} minutos',
+  'uv.time.hoursAgo': 'hace {n} horas',
+  'uv.time.daysAgo': 'hace {n} días',
+  'uv.time.monthsAgo': 'hace {n} meses',
+  'uv.time.yearsAgo': 'hace {n} años',
+  'uv.form.default': 'Error de validación en el campo %s',
+  'uv.form.required': '%s es obligatorio',
+  'uv.form.enum': '%s debe ser uno de %s',
+  'uv.form.whitespace': '%s no puede estar vacío',
+  'uv.form.date.format': '%s la fecha %s no es válida para el formato %s',
+  'uv.form.date.parse': '%s no se pudo analizar la fecha, %s no es válido',
+  'uv.form.date.invalid': '%s la fecha %s no es válida',
+  'uv.form.types.string': '%s no es de tipo %s',
+  'uv.form.types.method': '%s no es de tipo %s (función)',
+  'uv.form.types.array': '%s no es de tipo %s',
+  'uv.form.types.object': '%s no es de tipo %s',
+  'uv.form.types.number': '%s no es de tipo %s',
+  'uv.form.types.date': '%s no es de tipo %s',
+  'uv.form.types.boolean': '%s no es de tipo %s',
+  'uv.form.types.integer': '%s no es de tipo %s',
+  'uv.form.types.float': '%s no es de tipo %s',
+  'uv.form.types.regexp': '%s no es un %s válido',
+  'uv.form.types.email': '%s no es un %s válido',
+  'uv.form.types.url': '%s no es un %s válido',
+  'uv.form.types.hex': '%s no es un %s válido',
+  'uv.form.string.len': '%s debe tener exactamente %s caracteres',
+  'uv.form.string.min': '%s debe tener al menos %s caracteres',
+  'uv.form.string.max': '%s no puede tener más de %s caracteres',
+  'uv.form.string.range': '%s debe tener entre %s y %s caracteres',
+  'uv.form.number.len': '%s debe ser igual a %s',
+  'uv.form.number.min': '%s no puede ser menor que %s',
+  'uv.form.number.max': '%s no puede ser mayor que %s',
+  'uv.form.number.range': '%s debe estar entre %s y %s',
+  'uv.form.array.len': '%s debe tener exactamente %s elementos',
+  'uv.form.array.min': '%s no puede tener menos de %s elementos',
+  'uv.form.array.max': '%s no puede tener más de %s elementos',
+  'uv.form.array.range': '%s debe tener entre %s y %s elementos',
+  'uv.form.pattern.mismatch': '%s el valor %s no coincide con el patrón %s',
+};
+
+export default es;

package/locales/fr.ts

@@ -0,0 +1,57 @@
+/**
+ * uview-x 可选组件语言包：法语（fr）。
+ *
+ * 不参与内部聚合、不会被 `createI18n` 自动合并；需要法语时由使用方显式引入并合并：
+ * `import fr from '@zfqh/uview-x/locales/fr'`，再在 `createI18n({ messages: { fr } })` 中使用。
+ * 键空间固定为扁平 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 对齐，`%s` 占位符由校验器替换。
+ */
+const fr = {
+  'uv.dialog.title': 'Conseil',
+  'uv.dialog.cancel': 'Annuler',
+  'uv.dialog.confirm': 'Confirmer',
+  'uv.code.start': 'Obtenir le code',
+  // 组件会把 x / X 替换为剩余秒数
+  'uv.code.change': 'X secondes avant de renvoyer',
+  'uv.code.end': 'Renvoyer',
+  'uv.time.justNow': "À l'instant",
+  'uv.time.minutesAgo': 'il y a {n} minutes',
+  'uv.time.hoursAgo': 'il y a {n} heures',
+  'uv.time.daysAgo': 'il y a {n} jours',
+  'uv.time.monthsAgo': 'il y a {n} mois',
+  'uv.time.yearsAgo': 'il y a {n} ans',
+  'uv.form.default': 'Erreur de validation du champ %s',
+  'uv.form.required': '%s est requis',
+  'uv.form.enum': "%s doit être l'un de %s",
+  'uv.form.whitespace': '%s ne peut pas être vide',
+  'uv.form.date.format': "%s la date %s n'est pas valide pour le format %s",
+  'uv.form.date.parse': "%s la date n'a pas pu être analysée, %s n'est pas valide",
+  'uv.form.date.invalid': "%s la date %s n'est pas valide",
+  'uv.form.types.string': "%s n'est pas de type %s",
+  'uv.form.types.method': "%s n'est pas de type %s (fonction)",
+  'uv.form.types.array': "%s n'est pas de type %s",
+  'uv.form.types.object': "%s n'est pas de type %s",
+  'uv.form.types.number': "%s n'est pas de type %s",
+  'uv.form.types.date': "%s n'est pas de type %s",
+  'uv.form.types.boolean': "%s n'est pas de type %s",
+  'uv.form.types.integer': "%s n'est pas de type %s",
+  'uv.form.types.float': "%s n'est pas de type %s",
+  'uv.form.types.regexp': "%s n'est pas un %s valide",
+  'uv.form.types.email': "%s n'est pas un %s valide",
+  'uv.form.types.url': "%s n'est pas un %s valide",
+  'uv.form.types.hex': "%s n'est pas un %s valide",
+  'uv.form.string.len': '%s doit contenir exactement %s caractères',
+  'uv.form.string.min': '%s doit contenir au moins %s caractères',
+  'uv.form.string.max': '%s ne peut pas dépasser %s caractères',
+  'uv.form.string.range': '%s doit contenir entre %s et %s caractères',
+  'uv.form.number.len': '%s doit être égal à %s',
+  'uv.form.number.min': '%s ne peut pas être inférieur à %s',
+  'uv.form.number.max': '%s ne peut pas être supérieur à %s',
+  'uv.form.number.range': '%s doit être compris entre %s et %s',
+  'uv.form.array.len': '%s doit contenir exactement %s éléments',
+  'uv.form.array.min': '%s ne peut pas contenir moins de %s éléments',
+  'uv.form.array.max': '%s ne peut pas contenir plus de %s éléments',
+  'uv.form.array.range': '%s doit contenir entre %s et %s éléments',
+  'uv.form.pattern.mismatch': '%s la valeur %s ne correspond pas au motif %s',
+};
+
+export default fr;

package/locales/index.ts

@@ -1,166 +1,22 @@
-import type { I18nMessages } from '../utils/locale';
-import zhCN from './zh-CN';
-
 /**
- * uview-x 默认语言包与查询工具。
+ * uview-x 语言包聚合入口（仅语言数据，不含组件 i18n 聚合逻辑）。
  *
- * - 内部只聚合默认语言 `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` 会回退到这里的中文默认语言包。
- */
-
-/** 语言包节点：字符串，或继续嵌套的语言包对象 */
-export type LocaleMessageValue = string | LocaleMessages;
-
-/** 单语言语言包 */
-export interface LocaleMessages {
-  [key: string]: LocaleMessageValue;
-}
-
-/** 内部聚合的默认组件语言包：仅 `zh-CN`（其他语言按需从 `locales/<locale>.ts` 引入） */
-export const componentMessages: Record<string, LocaleMessages> = {
-  'zh-CN': zhCN,
-};
-
-function isLocaleMessages(value: LocaleMessageValue | undefined): value is LocaleMessages {
-  return typeof value === 'object' && value !== null;
-}
-
-/** 深拷贝语言包节点，保证合并过程不修改内置 / 用户入参 */
-function cloneMessageValue(value: LocaleMessageValue): LocaleMessageValue {
-  if (!isLocaleMessages(value)) {
-    return value;
-  }
-  const cloned: LocaleMessages = {};
-  for (const key of Object.keys(value)) {
-    cloned[key] = cloneMessageValue(value[key]);
-  }
-  return cloned;
-}
-
-/** 深合并「内置 → 用户」：同名 key 用户覆盖，对象逐层合并，其余保留 */
-function mergeMessages(builtinMessages: LocaleMessages, userMessages: LocaleMessages): LocaleMessages {
-  const merged: LocaleMessages = {};
-  for (const key of Object.keys(builtinMessages)) {
-    merged[key] = cloneMessageValue(builtinMessages[key]);
-  }
-  for (const key of Object.keys(userMessages)) {
-    const builtinValue = merged[key];
-    const userValue = userMessages[key];
-    if (isLocaleMessages(builtinValue) && isLocaleMessages(userValue)) {
-      merged[key] = mergeMessages(builtinValue, userValue);
-    } else {
-      merged[key] = cloneMessageValue(userValue);
-    }
-  }
-  return merged;
-}
-
-/**
- * 把默认语言（`zh-CN`）合并进用户 messages（返回新对象，不修改入参）。
+ * 使用方可自行选择：
+ * - `import { en, zhHans } from '@zfqh/uview-x/locales'`；
+ * - `import locales from '@zfqh/uview-x/locales'`（默认对象）；
+ * - `import en from '@zfqh/uview-x/locales/en'`。
  *
- * - 仅对内置 `zh-CN` 深合并，用户同名 key 优先，未覆盖的中文默认文案保留；
- * - 用户传入的其他 locale（如自行合并的 `en-US`）原样保留，不做补全或内置合并；
- * - 用户未传 messages 时返回仅含中文默认语言包的副本。
+ * 组件内置默认语言为 `en`；该入口不会被包根入口 re-export。
  */
-export function mergeDefaultMessages(userMessages?: I18nMessages): I18nMessages {
-  const userZhCN = userMessages ? userMessages['zh-CN'] : undefined;
-  const merged: I18nMessages = {
-    'zh-CN': mergeMessages(componentMessages['zh-CN'], isLocaleMessages(userZhCN) ? userZhCN : {}),
-  };
-  if (userMessages) {
-    for (const locale of Object.keys(userMessages)) {
-      if (locale !== 'zh-CN') {
-        merged[locale] = userMessages[locale];
-      }
-    }
-  }
-  return merged;
-}
-
-/** 按 `a.b.c` 路径取字符串消息；非字符串 / 不存在返回空字符串 */
-function getMessageByPath(messages: LocaleMessages, key: string): string {
-  const segments = String(key).split('.');
-  let current: LocaleMessageValue | undefined = messages;
-  for (const segment of segments) {
-    if (current === undefined || typeof current === 'string') {
-      return '';
-    }
-    current = current[segment];
-  }
-  return typeof current === 'string' ? current : '';
-}
+import en from './en';
+import zhHans from './zh-Hans';
+import zhHant from './zh-Hant';
+import es from './es';
+import fr from './fr';
+import ru from './ru';
 
-/** 替换 `{name}` 占位符（App 端没有 vue-i18n 编译能力，需要手动替换） */
-function replacePlaceholders(str: string, values?: Record<string, string | number>): string {
-  if (!values || typeof str !== 'string') {
-    return str;
-  }
-  let out = str;
-  for (const key of Object.keys(values)) {
-    out = out.split(`{${key}}`).join(String(values[key]));
-  }
-  return out;
-}
+export { en, zhHans, zhHant, es, fr, ru };
 
-/**
- * 读取默认中文文案；按 `a.b.c` 路径查找并替换 `{name}` 占位符。
- *
- * 找不到时返回空字符串，由调用方（`appTranslate`）继续回退到 key。
- */
-export function getBuiltinMessage(locale: string, key: string, values?: Record<string, string | number>): string {
-  const messages = componentMessages[locale];
-  if (!messages) {
-    return '';
-  }
-  return replacePlaceholders(getMessageByPath(messages, key), values);
-}
+const locales = { en, zhHans, zhHant, es, fr, ru };
 
-/**
- * 用 `t` 构建 async-validator 的校验消息对象（结构与 `components/uv-form/valid.ts` 的 `newMessages()` 对齐）。
- *
- * 显式 `rules[].message` 仍由校验器优先使用；这里只提供默认文案。
- */
-export function buildFormValidationMessages(t: (key: string) => string): Record<string, unknown> {
-  const typeMessage = (type: string): string => t(`uv.form.types.${type}`);
-  const lengthMessages = (type: string): Record<string, string> => ({
-    len: t(`uv.form.${type}.len`),
-    min: t(`uv.form.${type}.min`),
-    max: t(`uv.form.${type}.max`),
-    range: t(`uv.form.${type}.range`),
-  });
-  return {
-    default: t('uv.form.default'),
-    required: t('uv.form.required'),
-    enum: t('uv.form.enum'),
-    whitespace: t('uv.form.whitespace'),
-    date: {
-      format: t('uv.form.date.format'),
-      parse: t('uv.form.date.parse'),
-      invalid: t('uv.form.date.invalid'),
-    },
-    types: {
-      string: typeMessage('string'),
-      method: typeMessage('method'),
-      array: typeMessage('array'),
-      object: typeMessage('object'),
-      number: typeMessage('number'),
-      date: typeMessage('date'),
-      boolean: typeMessage('boolean'),
-      integer: typeMessage('integer'),
-      float: typeMessage('float'),
-      regexp: typeMessage('regexp'),
-      email: typeMessage('email'),
-      url: typeMessage('url'),
-      hex: typeMessage('hex'),
-    },
-    string: lengthMessages('string'),
-    number: lengthMessages('number'),
-    array: lengthMessages('array'),
-    pattern: {
-      mismatch: t('uv.form.pattern.mismatch'),
-    },
-  };
-}
+export default locales;

package/locales/ru.ts

@@ -0,0 +1,57 @@
+/**
+ * uview-x 可选组件语言包：俄语（ru）。
+ *
+ * 不参与内部聚合、不会被 `createI18n` 自动合并；需要俄语时由使用方显式引入并合并：
+ * `import ru from '@zfqh/uview-x/locales/ru'`，再在 `createI18n({ messages: { ru } })` 中使用。
+ * 键空间固定为扁平 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 对齐，`%s` 占位符由校验器替换。
+ */
+const ru = {
+  'uv.dialog.title': 'Подсказка',
+  'uv.dialog.cancel': 'Отмена',
+  'uv.dialog.confirm': 'Подтвердить',
+  'uv.code.start': 'Получить код',
+  // 组件会把 x / X 替换为剩余秒数
+  'uv.code.change': 'Повторная отправка через X секунд',
+  'uv.code.end': 'Отправить повторно',
+  'uv.time.justNow': 'Только что',
+  'uv.time.minutesAgo': '{n} мин. назад',
+  'uv.time.hoursAgo': '{n} ч. назад',
+  'uv.time.daysAgo': '{n} дн. назад',
+  'uv.time.monthsAgo': '{n} мес. назад',
+  'uv.time.yearsAgo': '{n} г. назад',
+  'uv.form.default': 'Ошибка проверки поля %s',
+  'uv.form.required': '%s обязательно для заполнения',
+  'uv.form.enum': '%s должно быть одним из %s',
+  'uv.form.whitespace': '%s не может быть пустым',
+  'uv.form.date.format': '%s дата %s недействительна для формата %s',
+  'uv.form.date.parse': '%s не удалось разобрать дату, %s недействительна',
+  'uv.form.date.invalid': '%s дата %s недействительна',
+  'uv.form.types.string': '%s не является типом %s',
+  'uv.form.types.method': '%s не является типом %s (функция)',
+  'uv.form.types.array': '%s не является типом %s',
+  'uv.form.types.object': '%s не является типом %s',
+  'uv.form.types.number': '%s не является типом %s',
+  'uv.form.types.date': '%s не является типом %s',
+  'uv.form.types.boolean': '%s не является типом %s',
+  'uv.form.types.integer': '%s не является типом %s',
+  'uv.form.types.float': '%s не является типом %s',
+  'uv.form.types.regexp': '%s не является допустимым %s',
+  'uv.form.types.email': '%s не является допустимым %s',
+  'uv.form.types.url': '%s не является допустимым %s',
+  'uv.form.types.hex': '%s не является допустимым %s',
+  'uv.form.string.len': 'Длина %s должна быть ровно %s символов',
+  'uv.form.string.min': 'Длина %s должна быть не менее %s символов',
+  'uv.form.string.max': 'Длина %s не должна превышать %s символов',
+  'uv.form.string.range': 'Длина %s должна быть от %s до %s символов',
+  'uv.form.number.len': '%s должно быть равно %s',
+  'uv.form.number.min': '%s не может быть меньше %s',
+  'uv.form.number.max': '%s не может быть больше %s',
+  'uv.form.number.range': '%s должно быть между %s и %s',
+  'uv.form.array.len': 'Длина %s должна быть ровно %s элементов',
+  'uv.form.array.min': 'Длина %s должна быть не меньше %s элементов',
+  'uv.form.array.max': 'Длина %s не должна превышать %s элементов',
+  'uv.form.array.range': 'Длина %s должна быть от %s до %s элементов',
+  'uv.form.pattern.mismatch': '%s значение %s не соответствует шаблону %s',
+};
+
+export default ru;

package/locales/zh-Hans.ts

@@ -0,0 +1,57 @@
+/**
+ * uview-x 可选组件语言包：简体中文（zh-Hans）。
+ *
+ * 不参与内部聚合、不会被 `createI18n` 自动合并；需要简体中文时由使用方显式引入并合并：
+ * `import zhHans from '@zfqh/uview-x/locales/zh-Hans'`，再在 `createI18n({ messages: { 'zh-Hans': zhHans } })` 中使用。
+ * 键空间固定为扁平 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 对齐，`%s` 占位符由校验器替换。
+ */
+const zhHans = {
+  'uv.dialog.title': '提示',
+  'uv.dialog.cancel': '取消',
+  'uv.dialog.confirm': '确定',
+  'uv.code.start': '获取验证码',
+  // 组件会把 x / X 替换为剩余秒数
+  'uv.code.change': 'X秒重新获取',
+  'uv.code.end': '重新获取',
+  'uv.time.justNow': '刚刚',
+  'uv.time.minutesAgo': '{n}分钟前',
+  'uv.time.hoursAgo': '{n}小时前',
+  'uv.time.daysAgo': '{n}天前',
+  'uv.time.monthsAgo': '{n}个月前',
+  'uv.time.yearsAgo': '{n}年前',
+  'uv.form.default': '%s 校验失败',
+  'uv.form.required': '%s 是必填项',
+  'uv.form.enum': '%s 必须是 %s 之一',
+  'uv.form.whitespace': '%s 不能为空',
+  'uv.form.date.format': '%s 的日期 %s 格式 %s 无效',
+  'uv.form.date.parse': '%s 的日期无法解析，%s 无效',
+  'uv.form.date.invalid': '%s 的日期 %s 无效',
+  'uv.form.types.string': '%s 不是 %s 类型',
+  'uv.form.types.method': '%s 不是 %s 类型',
+  'uv.form.types.array': '%s 不是 %s 类型',
+  'uv.form.types.object': '%s 不是 %s 类型',
+  'uv.form.types.number': '%s 不是 %s 类型',
+  'uv.form.types.date': '%s 不是 %s 类型',
+  'uv.form.types.boolean': '%s 不是 %s 类型',
+  'uv.form.types.integer': '%s 不是 %s 类型',
+  'uv.form.types.float': '%s 不是 %s 类型',
+  'uv.form.types.regexp': '%s 不是有效的 %s 类型',
+  'uv.form.types.email': '%s 不是有效的 %s 类型',
+  'uv.form.types.url': '%s 不是有效的 %s 类型',
+  'uv.form.types.hex': '%s 不是有效的 %s 类型',
+  'uv.form.string.len': '%s 长度必须为 %s 个字符',
+  'uv.form.string.min': '%s 至少为 %s 个字符',
+  'uv.form.string.max': '%s 不能超过 %s 个字符',
+  'uv.form.string.range': '%s 长度必须在 %s 到 %s 个字符之间',
+  'uv.form.number.len': '%s 必须等于 %s',
+  'uv.form.number.min': '%s 不能小于 %s',
+  'uv.form.number.max': '%s 不能大于 %s',
+  'uv.form.number.range': '%s 必须在 %s 到 %s 之间',
+  'uv.form.array.len': '%s 长度必须为 %s',
+  'uv.form.array.min': '%s 长度不能小于 %s',
+  'uv.form.array.max': '%s 长度不能大于 %s',
+  'uv.form.array.range': '%s 长度必须在 %s 到 %s 之间',
+  'uv.form.pattern.mismatch': '%s 的值 %s 不匹配格式 %s',
+};
+
+export default zhHans;

package/locales/zh-Hant.ts

@@ -0,0 +1,57 @@
+/**
+ * uview-x 可选组件语言包：繁体中文（zh-Hant）。
+ *
+ * 不参与内部聚合、不会被 `createI18n` 自动合并；需要繁体中文时由使用方显式引入并合并：
+ * `import zhHant from '@zfqh/uview-x/locales/zh-Hant'`，再在 `createI18n({ messages: { 'zh-Hant': zhHant } })` 中使用。
+ * 键空间固定为扁平 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 对齐，`%s` 占位符由校验器替换。
+ */
+const zhHant = {
+  'uv.dialog.title': '提示',
+  'uv.dialog.cancel': '取消',
+  'uv.dialog.confirm': '確定',
+  'uv.code.start': '取得驗證碼',
+  // 组件会把 x / X 替换为剩余秒数
+  'uv.code.change': 'X秒重新取得',
+  'uv.code.end': '重新取得',
+  'uv.time.justNow': '剛剛',
+  'uv.time.minutesAgo': '{n}分鐘前',
+  'uv.time.hoursAgo': '{n}小時前',
+  'uv.time.daysAgo': '{n}天前',
+  'uv.time.monthsAgo': '{n}個月前',
+  'uv.time.yearsAgo': '{n}年前',
+  'uv.form.default': '%s 驗證失敗',
+  'uv.form.required': '%s 為必填項',
+  'uv.form.enum': '%s 必須是 %s 之一',
+  'uv.form.whitespace': '%s 不能為空',
+  'uv.form.date.format': '%s 的日期 %s 格式 %s 無效',
+  'uv.form.date.parse': '%s 的日期無法解析，%s 無效',
+  'uv.form.date.invalid': '%s 的日期 %s 無效',
+  'uv.form.types.string': '%s 不是 %s 類型',
+  'uv.form.types.method': '%s 不是 %s 類型',
+  'uv.form.types.array': '%s 不是 %s 類型',
+  'uv.form.types.object': '%s 不是 %s 類型',
+  'uv.form.types.number': '%s 不是 %s 類型',
+  'uv.form.types.date': '%s 不是 %s 類型',
+  'uv.form.types.boolean': '%s 不是 %s 類型',
+  'uv.form.types.integer': '%s 不是 %s 類型',
+  'uv.form.types.float': '%s 不是 %s 類型',
+  'uv.form.types.regexp': '%s 不是有效的 %s 類型',
+  'uv.form.types.email': '%s 不是有效的 %s 類型',
+  'uv.form.types.url': '%s 不是有效的 %s 類型',
+  'uv.form.types.hex': '%s 不是有效的 %s 類型',
+  'uv.form.string.len': '%s 長度必須為 %s 個字元',
+  'uv.form.string.min': '%s 至少為 %s 個字元',
+  'uv.form.string.max': '%s 不能超過 %s 個字元',
+  'uv.form.string.range': '%s 長度必須在 %s 到 %s 個字元之間',
+  'uv.form.number.len': '%s 必須等於 %s',
+  'uv.form.number.min': '%s 不能小於 %s',
+  'uv.form.number.max': '%s 不能大於 %s',
+  'uv.form.number.range': '%s 必須在 %s 到 %s 之間',
+  'uv.form.array.len': '%s 長度必須為 %s',
+  'uv.form.array.min': '%s 長度不能小於 %s',
+  'uv.form.array.max': '%s 長度不能大於 %s',
+  'uv.form.array.range': '%s 長度必須在 %s 到 %s 之間',
+  'uv.form.pattern.mismatch': '%s 的值 %s 與格式 %s 不符',
+};
+
+export default zhHant;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zfqh/uview-x",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "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": "cc5d98c2352fc99519a4660779a24cf992faad32"
+  "gitHead": "59595760375b8c8c71d6abe4e860d4ba8ca915a1"
 }