@zfqh/uview-x 0.0.5 → 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

@@ -1,79 +1,56 @@
-/**
- * uview-x 可选组件语言包：英文（en）。
- *
- * 不参与内部聚合、不会被 `createI18n` 自动合并；需要英文时由使用方显式引入并合并：
- * `import en from '@zfqh/uview-x/locales/en'`，再在 `createI18n({ messages: { en } })` 中使用。
- * 键空间固定为 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 完全对齐，`%s` 占位符由校验器替换。
- */
-const en = {
-  uv: {
-    dialog: {
-      title: 'Tips',
-      cancel: 'Cancel',
-      confirm: 'OK',
-    },
-    code: {
-      start: 'Get code',
-      // 组件会把 x / X 替换为剩余秒数
-      change: 'X seconds to resend',
-      end: 'Resend',
-    },
-    time: {
-      justNow: 'Just now',
-      minutesAgo: '{n} minutes ago',
-      hoursAgo: '{n} hours ago',
-      daysAgo: '{n} days ago',
-      monthsAgo: '{n} months ago',
-      yearsAgo: '{n} years ago',
-    },
-    form: {
-      default: 'Validation error on field %s',
-      required: '%s is required',
-      enum: '%s must be one of %s',
-      whitespace: '%s cannot be empty',
-      date: {
-        format: '%s date %s is invalid for format %s',
-        parse: '%s date could not be parsed, %s is invalid ',
-        invalid: '%s date %s is invalid',
-      },
-      types: {
-        string: '%s is not a %s',
-        method: '%s is not a %s (function)',
-        array: '%s is not an %s',
-        object: '%s is not an %s',
-        number: '%s is not a %s',
-        date: '%s is not a %s',
-        boolean: '%s is not a %s',
-        integer: '%s is not an %s',
-        float: '%s is not a %s',
-        regexp: '%s is not a valid %s',
-        email: '%s is not a valid %s',
-        url: '%s is not a valid %s',
-        hex: '%s is not a valid %s',
-      },
-      string: {
-        len: '%s must be exactly %s characters',
-        min: '%s must be at least %s characters',
-        max: '%s cannot be longer than %s characters',
-        range: '%s must be between %s and %s characters',
-      },
-      number: {
-        len: '%s must equal %s',
-        min: '%s cannot be less than %s',
-        max: '%s cannot be greater than %s',
-        range: '%s must be between %s and %s',
-      },
-      array: {
-        len: '%s must be exactly %s in length',
-        min: '%s cannot be less than %s in length',
-        max: '%s cannot be greater than %s in length',
-        range: '%s must be between %s and %s in length',
-      },
-      pattern: {
-        mismatch: '%s value %s does not match pattern %s',
-      },
-    },
-  },
-};
-
-export default en;
+/**
+ * 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

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

@@ -3,77 +3,55 @@
  *
  * 不参与内部聚合、不会被 `createI18n` 自动合并；需要法语时由使用方显式引入并合并：
  * `import fr from '@zfqh/uview-x/locales/fr'`，再在 `createI18n({ messages: { fr } })` 中使用。
- * 键空间固定为 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 完全对齐，`%s` 占位符由校验器替换。
+ * 键空间固定为扁平 `uv.*`，`uv.form.*` 与 async-validator 默认 messages 对齐，`%s` 占位符由校验器替换。
  */
 const fr = {
-  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',
-      },
-    },
-  },
+  '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;