@zfqh/uview-x 0.0.4 → 0.0.6

package/locales/fr-FR.ts

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

package/locales/index.ts

@@ -1,169 +1,166 @@
-import type { I18nMessages } from '../utils/locale';
-import zhHans from './zh-Hans';
-import en from './en';
-
-/**
- * uview-x 组件内置语言包与合并工具。
- *
- * - 纯数据 / 纯函数模块：不 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;
-}
-
-/** 组件内置语言包：locale → 语言包 */
-export const componentMessages: Record<string, LocaleMessages> = {
-  'zh-Hans': zhHans,
-  en,
-};
-
-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;
-}
-
-/**
- * 把组件内置语言包合并进用户 messages（返回新对象，不修改入参）。
- *
- * - 内置已有的 locale（`zh-Hans` / `en`）逐层深合并，用户同名 key 优先；
- * - 用户额外传入的 locale 原样保留；
- * - 用户未传 messages 时返回内置语言包副本。
- */
-export function mergeComponentMessages(userMessages?: I18nMessages): I18nMessages {
-  const locales: string[] = Object.keys(componentMessages);
-  if (userMessages) {
-    for (const locale of Object.keys(userMessages)) {
-      if (locales.indexOf(locale) === -1) {
-        locales.push(locale);
-      }
-    }
-  }
-  const merged: I18nMessages = {};
-  for (const locale of locales) {
-    const builtinMessages = componentMessages[locale] || {};
-    const userLocaleMessages = userMessages ? userMessages[locale] : undefined;
-    merged[locale] = mergeMessages(builtinMessages, isLocaleMessages(userLocaleMessages) ? userLocaleMessages : {});
-  }
-  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 : '';
-}
-
-/** 替换 `{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;
-}
-
-/**
- * 读取组件内置文案；按 `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);
-}
-
-/**
- * 用 `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'),
-    },
-  };
-}
+import type { I18nMessages } from '../utils/locale';
+import zhCN from './zh-CN';
+
+/**
+ * uview-x 默认语言包与查询工具。
+ *
+ * - 内部只聚合默认语言 `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（返回新对象，不修改入参）。
+ *
+ * - 仅对内置 `zh-CN` 深合并，用户同名 key 优先，未覆盖的中文默认文案保留；
+ * - 用户传入的其他 locale（如自行合并的 `en-US`）原样保留，不做补全或内置合并；
+ * - 用户未传 messages 时返回仅含中文默认语言包的副本。
+ */
+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 : '';
+}
+
+/** 替换 `{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;
+}
+
+/**
+ * 读取默认中文文案；按 `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);
+}
+
+/**
+ * 用 `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'),
+    },
+  };
+}

package/locales/ru-RU.ts

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

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

@@ -1,10 +1,11 @@
 /**
- * uview-x 组件内置语言包：简体中文（zh-Hans）。
+ * uview-x 默认组件语言包：简体中文（zh-CN）。
  *
- * 键空间固定为 `uv.*`，用户可通过 `createI18n({ messages })` 传同名 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: '提示',
@@ -75,4 +76,4 @@ const zhHans = {
   },
 };
 
-export default zhHans;
+export default zhCN;

package/locales/zh-TW.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zfqh/uview-x",
-  "version": "0.0.4",
+  "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",
@@ -36,9 +36,8 @@
     "types",
     "utils",
     "index.ts",
-    "theme.scss",
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "2394e0c70de5af7326243f154b4eb92c65baa7f5"
+  "gitHead": "cc5d98c2352fc99519a4660779a24cf992faad32"
 }