@zfqh/uview-x 0.0.4 → 0.0.6

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 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)
+
+
+### Bug Fixes
+
+* 国际化问题优化 ([b2dda3c](http://10.10.10.16/caoben/front-end-tools/commits/b2dda3c0b9ff45a42bf777db3bddf6f06c5d7e57))
+
+
+
+
+
 ## [0.0.4](http://10.10.10.16/caoben/front-end-tools/compare/@zfqh/uview-x@0.0.3...@zfqh/uview-x@0.0.4) (2026-11-10)
 
 **Note:** Version bump only for package @zfqh/uview-x

package/README.md

@@ -1,149 +1,83 @@
-# @zfqh/uview-x
-
-面向 uni-app x 蒸汽模式（Vapor）与经典 uni-app Vue3 的 UV UI 组件库，由 `@gmcb/uv-ui` fork 并完成多端适配：App 支持 uni-app x 蒸汽模式与经典 nvue，H5 / 微信小程序支持 uni-app x VDOM 与经典 Vue3 VDOM。组件保持 `.vue`，沿用 uv-ui 的 `uv-*` 组件名与主要 API。
-
-## 安装
-
-```bash
-npm i @zfqh/uview-x
-```
-
-## 接入
-
-`main.ts` 注册插件，注册后脚本可用 `uni.$uv`、模板可用 `$uv`：
-
-```ts
-import { createSSRApp } from 'vue';
-import App from './App.uvue';
-import uviewX from '@zfqh/uview-x';
-
-export function createApp() {
-  const app = createSSRApp(App);
-  app.use(uviewX as any);
-  return { app };
-}
-```
-
-`pages.json` 配置 easycom，组件按需自动引入：
-
-```json
-{
-  "easycom": {
-    "autoscan": true,
-    "custom": {
-      "^uv-(.*)": "@zfqh/uview-x/components/uv-$1/uv-$1.vue"
-    }
-  }
-}
-```
-
-以上 easycom 配置适用于 dev 阶段（H5 / 小程序 / 经典 uni-app）；uni-app x Vapor 的 build 阶段不支持 easycom，见下方显式 import。
-
-### 显式 import（推荐；Vapor build 必需）
-
-uni-app x Vapor（蒸汽模式）下，easycom 仅在 dev 阶段可用，build 阶段不支持；用户也可能主动关闭 easycom。为此 `components/uv-*` 内部已经全部改为显式 import，页面只需 import 自己用到的组件：
-
-```vue
-<script setup lang="ts">
-import UvButton from '@zfqh/uview-x/components/uv-button/uv-button.vue';
-import UvIcon from '@zfqh/uview-x/components/uv-icon/uv-icon.vue';
-</script>
-
-<template>
-  <uv-button type="primary" text="提交" @click="onSubmit" />
-  <uv-icon name="search" :size="24" />
-</template>
-```
-
-- 组件入口为 `@zfqh/uview-x/components/uv-<name>/uv-<name>.vue`，与 easycom 路径一致。
-- `examples/uview-vapor`、`examples/uniapp-vapor` 已关闭 easycom（`"easycom": { "autoscan": false }`），用于验证显式 import 在 dev / build 下都可用。
-- `app.use(uviewX)` 只安装 `$uv` 插件能力，不注册组件。
-
-`uni.scss` 引入主题变量，`App.uvue` 引入全局工具样式：
-
-```scss
-@import '@zfqh/uview-x/theme.scss';
-```
-
-```vue
-<style lang="scss">
-@import '@zfqh/uview-x/styles/index.scss';
-</style>
-```
-
-App x 需在 `manifest.json` 开启蒸汽模式：`"uni-app-x": { "vapor": true, "styleIsolationVersion": "2", "vapor-default-script-lang": "ts" }`，完整配置见 `examples/uview-vapor/manifest.json`。
-
-## 组件示例
-
-```vue
-<template>
-  <uv-button type="primary" text="提交" @click="onSubmit" />
-  <uv-icon name="search" :size="24" />
-  <uv-line />
-</template>
-```
-
-已适配组件以 `components/uv-*` 为准。业务对话框 `uv-dialog`（基于 `uv-popup`，`open()` 返回 Promise）示例见 `examples/uview-vapor/pages/feedback/dialog/` 与 `examples/uview-nvue/pages/feedback/dialog/`，完整说明见 `AGENTS.md`。
-
-## 工具与 hooks
-
-入口同时导出 `hooks`、`utils`、`libs` 的公共 API（`libs` 仅汇总第三方库公共入口），例如：
-
-```ts
-import { $uv, config, useDebounce, useThrottle, Request, dayjs } from '@zfqh/uview-x';
-
-config.color.primary;
-uni.$uv.config.color.primary; // 同一个对象
-
-// 组件全局 props；需在组件加载前调用，后续修改不影响已加载组件
-uni.$uv.setConfig({
-  props: {
-    button: { type: { default: 'primary' } },
-    input: { color: { default: '#303133' } },
-  },
-});
-```
-
-## 国际化
-
-组件内置文案（`uv-dialog` / `uv-code` / `uv-form` / `timeFrom`）随包提供 `zh-Hans`、`en` 两套语言包；`createI18n` 会自动合并，用户 `messages` 传同名 key 即可覆盖（键空间 `uv.*`）。
-
-```ts
-// main.ts：创建 i18n（自动合并组件内置语言包），再安装到 Vue app
-import { createI18n } from '@zfqh/uview-x';
-
-const i18n = createI18n({
-  legacy: false,
-  locale: 'zh-Hans',
-  fallbackLocale: 'zh-Hans',
-  messages: {
-    // 只覆盖想自定义的 key，未传的以内置文案兜底
-    'zh-Hans': { uv: { dialog: { title: '温馨提示' } } },
-    en: { uv: { dialog: { title: 'Notice' } } },
-  },
-});
-
-app.use(i18n);
-```
-
-```ts
-// 页面内
-import { useI18n, setLocale, getLocale } from '@zfqh/uview-x';
-
-const { t } = useI18n();
-
-t('uv.dialog.title'); // 未创建实例时也能取到内置文案（自动降级）
-setLocale('en'); // 更新实例 + 写入 storage 的 UNI_LOCALE + 调用 uni.setLocale
-getLocale(); // 读取当前语言（优先 storage UNI_LOCALE）
-```
-
-- 公共 API：`createI18n` / `getLocale` / `getLocaleMessage` / `setLocale` + `useI18n`；`useI18n` 在未创建实例时降级读组件内置语言包，不会抛错。
-- 内置文案键空间：`uv.dialog.title/cancel/confirm`、`uv.code.start/change/end`、`uv.time.*`、`uv.form.*`（async-validator 校验文案，保留 `%s` 占位符）。
-- `uv-dialog` 的 `title` / `cancelText` / `confirmText` 默认 `''` 时取内置文案；隐藏按钮用 `showCancelButton` / `showConfirmButton`（文本只能是 String，不能传 `false`）。
-- 完整 API、平台差异与降级规则见 `AGENTS.md` §12.1。
-
-## 文档
-
-- 开发约定、组件 API、平台差异与验证：[AGENTS.md](AGENTS.md)
-- 示例工程：`examples/uview-vapor`（蒸汽模式）、`examples/uview-nvue`（nvue）
-- 参考：[uni-app x 蒸汽模式](https://doc.dcloud.net.cn/uni-app-x/app-vapor.html) · [uv-ui 官方文档](https://www.uvui.cn)
+# @zfqh/uview-x
+
+面向 uni-app x 蒸汽模式（Vapor）、uni-app x H5 / 微信小程序（VDOM）与经典 uni-app Vue3 / nvue 的 UV UI 组件库，沿用 `uv-*` 组件名与 uv-ui API；入口同时提供 `$uv`、`config`、hooks 与第三方库导出。
+
+## 安装
+
+```bash
+npm i @zfqh/uview-x
+```
+
+## 快速开始
+
+`main.ts` 注册插件（仅安装 `$uv` 能力，不注册组件）：
+
+```ts
+import { createSSRApp } from 'vue';
+import App from './App.uvue';
+import uviewX from '@zfqh/uview-x';
+
+export function createApp() {
+  const app = createSSRApp(App);
+  app.use(uviewX);
+  return { app };
+}
+```
+
+页面推荐显式 import 组件（uni-app x Vapor 构建必需）：
+
+```vue
+<script setup lang="ts">
+import UvButton from '@zfqh/uview-x/components/uv-button/uv-button.vue';
+</script>
+
+<template>
+  <uv-button type="primary" text="提交" />
+</template>
+```
+
+dev 阶段也可使用 easycom（`pages.json`）：
+
+```json
+{
+  "easycom": {
+    "autoscan": true,
+    "custom": {
+      "^uv-(.*)": "@zfqh/uview-x/components/uv-$1/uv-$1.vue"
+    }
+  }
+}
+```
+
+> uni-app x Vapor 下 easycom 仅在 dev 阶段可用，build 阶段不支持。
+
+`uni.scss` 引入主题变量，`App.uvue` / `App.vue` 引入全局样式：
+
+```scss
+@import '@zfqh/uview-x/styles/theme.scss';
+```
+
+```vue
+<style lang="scss">
+@import '@zfqh/uview-x/styles/index.scss';
+</style>
+```
+
+全局配置（如 H5 滚动条，默认隐藏）需在 `app.use(uviewX)` 前通过 `uni.$uv.setConfig({ scrollbar: true })` 设置（安装时应用一次），详见 `AGENTS.md`。
+
+## 国际化
+
+默认简体中文；其他语言按需引入并合并（可选：`zh-CN`、`zh-TW`、`en-US`、`es-ES`、`fr-FR`、`ru-RU`）：
+
+```ts
+import enUS from '@zfqh/uview-x/locales/en-US';
+// createI18n({ messages: { 'en-US': { ...enUS, ...自定义 } } })
+// 其他语言将路径中的 en-US 换成对应 locale 即可
+```
+
+## 文档
+
+- 开发约定、组件清单、完整 API、平台差异与验证：[AGENTS.md](AGENTS.md)
+- 示例工程：`examples/uview-vapor`（蒸汽模式）、`examples/uview-nvue`（nvue）
+- 变更记录：[CHANGELOG.md](CHANGELOG.md)
+- 参考：[uni-app x 蒸汽模式](https://doc.dcloud.net.cn/uni-app-x/app-vapor.html) · [uv-ui 官方文档](https://www.uvui.cn)

package/components/uv-badge/uv-badge.vue

@@ -100,8 +100,7 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-	@import '../../styles/color.scss';
+	@import '../../styles/theme.scss';
 
 	$uv-badge-primary: $uv-primary !default;
 	$uv-badge-error: $uv-error !default;
@@ -120,7 +119,10 @@
 		border-top-left-radius: $uv-badge-dot-radius;
 		border-bottom-left-radius: $uv-badge-dot-radius;
 		border-bottom-right-radius: $uv-badge-dot-radius;
-		@include flex;
+		/* #ifndef APP-NVUE */
+		display: flex;
+		/* #endif */
+		flex-direction: row;
 		line-height: $uv-badge-text-font-size;
 		text-align: $uv-badge-text-align;
 		font-size: $uv-badge-text-font-size;

package/components/uv-button/uv-button.vue

@@ -209,7 +209,7 @@
 		return p.type === 'info' ? '#000000' : '#ffffff'
 	})
 
-	// uv-ui 主题色（与 styles/color.scss 一致），用于 plain/light 态文字颜色
+	// uv-ui 主题色（与 styles/theme.scss 一致），用于 plain/light 态文字颜色
 	const typeTextColors: Record<string, string> = {
 		info: '#909399',
 		primary: '#3c9cff',
@@ -353,7 +353,7 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/color.scss';
+	@import '../../styles/theme.scss';
 
 	.uv-button-wrapper {
 		position: relative;

package/components/uv-checkbox/uv-checkbox.vue

@@ -326,9 +326,6 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-	@import '../../styles/color.scss';
-
 	$uv-checkbox-label-wrap-padding-right: 6px !default;
 	$uv-checkbox-icon-wrap-font-size: 6px !default;
 	$uv-checkbox-icon-wrap-border-width: 1px !default;

package/components/uv-checkbox-group/uv-checkbox-group.vue

@@ -143,9 +143,6 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-	@import '../../styles/color.scss';
-
 	.uv-checkbox-group {
 		flex: 1;
 	}

package/components/uv-dialog/uv-dialog.vue

@@ -111,7 +111,7 @@
 	/**
 	 * Dialog 业务对话框
 	 * @description 基于 uv-popup 的业务对话框：标题/内容/底部取消确认/关闭/确认回调，支持 ref.open() 返回 Promise；
-	 * 标题与按钮内置文案支持 i18n（内置 zh-Hans / en，可通过 createI18n messages 覆盖 uv.dialog.*）
+	 * 标题与按钮内置文案支持 i18n（默认中文；其他语言需显式引入语言包并在 createI18n 中合并，可覆盖 uv.dialog.*）
 	 * @tutorial https://www.uvui.cn/components/popup.html
 	 * @property {Boolean} modelValue 是否显示（v-model）
 	 * @property {String} mode 弹出方式，默认 center
@@ -440,8 +440,6 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/color.scss';
-
 	.uv-dialog {
 		/* #ifndef APP-NVUE */
 		box-sizing: border-box;

package/components/uv-form/uv-form.vue

@@ -247,8 +247,6 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-
 	.uv-form {
 		display: flex;
 		flex-direction: column;

package/components/uv-form-item/uv-form-item.vue

@@ -230,8 +230,7 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-	@import '../../styles/color.scss';
+	@import '../../styles/theme.scss';
 
 	.uv-form-item {
 		display: flex;

package/components/uv-icon/uv-icon.vue

@@ -118,11 +118,11 @@ const iconStyle = computed(() => {
   };
   if (p.color && !colorType.includes(p.color)) {
     style.color = p.color;
-  }
-  if (p.customPrefix !== 'uvicon') {
-    style.fontFamily = p.customPrefix;
-  } else {
-    style.fontFamily = 'uvicon-iconfont';
+  }
+  if (p.customPrefix !== 'uvicon') {
+    style.fontFamily = p.customPrefix;
+  } else {
+    style.fontFamily = 'uvicon-iconfont';
   }
   return style;
 });
@@ -141,7 +141,7 @@ const clickHandler = (e: any) => {
 </script>
 
 <style lang="scss">
-@import '../../styles/color.scss';
+@import '../../styles/theme.scss';
 
 /* #ifndef APP-NVUE */
 @font-face {

package/components/uv-input/uv-input.vue

@@ -377,8 +377,7 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-	@import '../../styles/color.scss';
+	@import '../../styles/theme.scss';
 
 	.uv-input {
 		/* #ifndef APP-NVUE */

package/components/uv-line-progress/uv-line-progress.vue

@@ -108,8 +108,6 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-
 	.uv-line-progress {
 		/* #ifndef APP-NVUE */
 		display: flex;

package/components/uv-loading-icon/uv-loading-icon.vue

@@ -160,8 +160,7 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-	@import '../../styles/color.scss';
+	@import '../../styles/theme.scss';
 
 	.uv-loading-icon {
 		display: flex;

package/components/uv-overlay/uv-overlay.vue

@@ -104,8 +104,6 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-
 	$uv-overlay-top: 0 !default;
 	$uv-overlay-left: 0 !default;
 	$uv-overlay-background-color: rgba(0, 0, 0, 0.7) !default;

package/components/uv-popup/uv-popup.vue

@@ -325,8 +325,6 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-
 	.uv-popup {
 		position: fixed;
 		/* #ifndef APP-NVUE */

package/components/uv-safe-bottom/uv-safe-bottom.vue

@@ -96,8 +96,6 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-
 	.uv-safe-bottom {
 		/* #ifndef APP-NVUE */
 		width: 100%;

package/components/uv-status-bar/uv-status-bar.vue

@@ -102,8 +102,6 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-
 	.uv-status-bar {
 		/* #ifndef APP-NVUE */
 		width: 100%;

package/components/uv-tabs/uv-tabs.vue

@@ -359,8 +359,7 @@
 </script>
 
 <style lang="scss">
-	@import '../../styles/components.scss';
-	@import '../../styles/color.scss';
+	@import '../../styles/theme.scss';
 
 	.uv-tabs {
 		display: flex;

package/hooks/useI18n.ts

@@ -46,7 +46,7 @@ function createLocaleComputed(): WritableComputedRef<string> {
 }
 
 /**
- * 降级实现：不依赖 vue-i18n 运行时，直接读 `uni.$i18n` 语言包 + 组件内置语言包。
+ * 降级实现：不依赖 vue-i18n 运行时，直接读 `uni.$i18n` 语言包 + 默认中文语言包。
  *
  * 小程序端 vue-i18n 为 runtime-only 构建（无消息编译器），App 端也不依赖 vue-i18n 注入；
  * H5 未创建 / 未安装 i18n 实例时同样走这里，保证 `useI18n()` 不抛错。

package/index.ts

@@ -1,5 +1,8 @@
 import type { App } from 'vue';
 import { $uv } from './utils';
+// #ifdef WEB || H5
+import { applyScrollbar } from './utils/scrollbar';
+// #endif
 
 export * from './utils';
 export * from './hooks';
@@ -14,10 +17,14 @@ uni.$uv = $uv;
  *
  * - 仅挂到 `app.config.globalProperties.$uv`，模板中可直接使用 `$uv`；
  * - `uni.$uv` 已在入口模块顶层赋值（脚本中使用）；
- * - 不注册全局 mixin，也不提供 uv-ui 的 `mpShare` 等安装选项。
- */
+ * - H5 下按 `config.scrollbar` 注入全局滚动条样式（默认隐藏）；
+ */
+
 function install(app: App): void {
-  app.config.globalProperties.$uv = $uv;
+  app.config.globalProperties.$uv = $uv;
+  // #ifdef WEB || H5
+  applyScrollbar($uv.config.scrollbar);
+  // #endif
 }
 
 export default { install };

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

@@ -1,10 +1,11 @@
 /**
- * uview-x 组件内置语言包：英文（en）。
+ * uview-x 可选组件语言包：英文（en-US）。
  *
- * 键空间固定为 `uv.*`，用户可通过 `createI18n({ messages })` 传同名 key 覆盖；
- * `uv.form.*` 与 async-validator 默认 messages 完全对齐，`%s` 占位符由校验器替换。
+ * 不参与内部聚合、不会被 `createI18n` 自动合并；需要英文时由使用方显式引入并合并：
+ * `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',
@@ -75,4 +76,4 @@ const en = {
   },
 };
 
-export default en;
+export default enUS;

package/locales/es-ES.ts

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