@zfqh/uniapp 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -3,7 +3,7 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [0.1.2](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.1.1...@zfqh/uniapp@0.1.2) (2026-06-01)
+## [0.1.4](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.1.2...@zfqh/uniapp@0.1.4) (2026-06-02)
 
 **Note:** Version bump only for package @zfqh/uniapp
 
@@ -11,14 +11,23 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 
 
-## 0.1.1 (2026-05-31)
-
-**Note:** Version bump only for package @zfqh/uniapp
-
-
-
-
-
-## [0.1.0](http://10.10.200.92:8090/gmcb/front-end/compare/@zfqh/uniapp@0.1.0) (2026-05-31)
-
+
+## [0.1.2](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.1.1...@zfqh/uniapp@0.1.2) (2026-06-01)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
+## 0.1.1 (2026-05-31)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
+## [0.1.0](http://10.10.200.92:8090/gmcb/front-end/compare/@zfqh/uniapp@0.1.0) (2026-05-31)
+
 **Note:** Version bump only for package @zfqh/uniapp

package/docs/api/apis/index.md

@@ -28,7 +28,7 @@ import { getTencentToken, getDictData } from '@zfqh/uniapp/lib/apis/core';
 - `GET` 会把 data 作为 query params。
 - `POST`、`PUT`、`DELETE` 会把 data 作为请求体或方法参数传给底层请求实例。
 - URL 中的 `:id`、`/:id` 会由 `formatURL` 使用 data 同名字段替换，并从 data 中删除该字段。
-- 响应拦截器要求后端成功码为 `code == 0`；失败时会按配置弹 toast，并在 401 时触发 `uni.$store.dispatch('logout')`。
+- 响应拦截器要求后端成功码为 `code == 0`；失败时会按配置弹 toast，并在 401 时触发 `store.dispatch('logout')`。
 
 ## 接口清单
 

package/docs/api/apis/request.md

@@ -26,9 +26,9 @@ const request = uni.$uv.http;
 
 | Header | 来源 | 默认值 |
 | --- | --- | --- |
-| `Authorization` | `uni.$store.state.login.info.token` | 无 |
-| `Tenant-Id` | `uni.$store.state.login.info.tenantId` | `1` |
-| `X-Language` | `uni.$store.state.system.info.appLanguage` 映射到 `LANGUAGE` | 无 |
+| `Authorization` | `store.state.login.info.token` | 无 |
+| `Tenant-Id` | `store.state.login.info.tenantId` | `1` |
+| `X-Language` | `store.state.system.info.appLanguage` 映射到 `LANGUAGE` | 无 |
 | `Channel` | `query.channel` 或 `config.app.channel` | `config.app.channel` |
 
 业务请求的 `baseURL` 来自 `config.api.baseUrl`。
@@ -274,7 +274,7 @@ GET('/app-api/demo/check', {}, {
 | 阶段 | 行为 |
 | --- | --- |
 | request | 当 `log.request` 为 true 时打印请求 URL 和配置。 |
-| request | 如果存在 `uni.$store.state.login.info.token`，注入 `Authorization: Bearer <token>`。 |
+| request | 如果存在 `store.state.login.info.token`，注入 `Authorization: Bearer <token>`。 |
 | response | 当 `log.response` 为 true 时打印响应数据。 |
 | response | 当 `data.code != 0` 时将其作为错误响应处理。 |
 | error | 补齐非标准错误的 `response`、`status`、`data.msg`。 |
@@ -283,11 +283,11 @@ GET('/app-api/demo/check', {}, {
 `401` 处理依赖：
 
 ```ts
-uni.$store.state.login.info.token
-uni.$store.dispatch('logout')
+store.state.login.info.token
+store.dispatch('logout')
 ```
 
-请求拦截器属于普通 TS 模块，不在 Vue 组件 setup 上下文中，因此这里使用 `uni.$store`。如果是在组件或 hooks 中读取同一份登录态，请使用：
+请求拦截器属于普通 TS 模块，不在 Vue 组件 setup 上下文中，因此直接引入 store 实例。如果是在组件或 hooks 中读取同一份登录态，请使用：
 
 ```ts
 import { useStore } from 'vuex';
@@ -322,8 +322,8 @@ const request = uni.$uv.http;
 
 | Header | 来源 |
 | --- | --- |
-| `Tenant-Id` | `uni.$store.state.login.info.tenantId`，默认 `1`。 |
-| `X-Language` | `uni.$store.state.system.info.appLanguage` 映射到 `LANGUAGE`。 |
+| `Tenant-Id` | `store.state.login.info.tenantId`，默认 `1`。 |
+| `X-Language` | `store.state.system.info.appLanguage` 映射到 `LANGUAGE`。 |
 | `Channel` | `query.channel`，没有 query 渠道时回退到 `config.app.channel`。 |
 
 业务请求的 `baseURL` 来自：

package/docs/api/configs/index.md

@@ -283,7 +283,6 @@ defineConfig({
 
 ```ts
 import { getTencentToken } from '@zfqh/uniapp/lib/apis';
-import store from '@/store';
 
 defineConfig({
   upload: {
@@ -296,7 +295,7 @@ defineConfig({
         create_time: data.createTime,
         expire_time: data.expirationTime,
         bucket: data.bucket,
-        region: store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
+        region: uni.$store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
       };
     },
   },

package/docs/api/hooks/index.md

@@ -10,7 +10,7 @@ import { useStore } from 'vuex';
 const store = useStore();
 ```
 
-`uni.$store` 主要用于请求、导航、权限、webview 消息等普通模块。
+普通 TS 模块中使用 `uni.$store`。
 
 | Hook | 说明 |
 | --- | --- |
@@ -44,7 +44,7 @@ import { useOverlay, usePopup, useVersion, useI18n } from '@zfqh/uniapp';
 
 ## Store 用法
 
-Hooks 运行在组件 setup 上下文中，需要读取 Vuex 时请使用 `useStore()`，不要直接读取 `uni.$store`：
+Hooks 运行在组件 setup 上下文中，需要读取 Vuex 时请使用 `useStore()`：
 
 ```ts
 import { computed } from 'vue';
@@ -57,7 +57,7 @@ export function useUserName() {
 }
 ```
 
-`uni.$store` 主要给请求、导航、权限、webview 消息等非组件上下文的普通模块使用。完整约定见 [Store 使用位置](./../../guide/project-frame#store-使用位置)。
+普通 TS 模块中使用 `uni.$store`。完整约定见 [Store 使用位置](./../../guide/project-frame#store-使用位置)。
 
 ## useOverlay
 
@@ -172,7 +172,7 @@ const { t, locale } = useI18n();
 
 | 平台 | 行为 |
 | --- | --- |
-| APP-NVUE | 使用内部 `inject('t')` 和 `showLocale`。 |
+| APP-NVUE | 使用内部 `inject('t')` 和 `getLocaleMessage`。 |
 | 其他平台 | 透传 `vue-i18n` 的 `useI18n`。 |
 
 ```vue

package/docs/api/index.md

@@ -21,14 +21,19 @@ app.use(uniapp);
 安装逻辑：
 
 - 小程序端混入 `deep`。
-- 将 `app.config.globalProperties.$store` 挂到 `uni.$store`。
 
-`uni.$store` 用于请求、导航、权限、webview 消息等非组件上下文的普通模块。组件的 Composition API 和 hooks 中请使用 Vuex 官方入口：
+Store 使用入口请按上下文区分：
 
 ```ts
+// Composition API / <script setup>
 import { useStore } from 'vuex';
-
 const store = useStore();
+
+// Options API 组件
+this.$store
+
+// 普通 TS 模块
+uni.$store
 ```
 
 ## Hooks

package/docs/api/mixins/app.md

@@ -16,13 +16,12 @@ App.vue 全局生命周期 mixin。发布路径：`@zfqh/uniapp/lib/mixins/app`
 
 ```ts
 import app from '@zfqh/uniapp/lib/mixins/app';
-import store from '@/store';
 
 export default {
   mixins: [app],
   onLaunch() {
     if (store.getters.isLogin) {
-      store.dispatch('getInfo');
+      this.$store.dispatch('getInfo');
     }
   },
 };

package/docs/api/modules/app.md

@@ -20,8 +20,6 @@ const store = createStore({
     app,
   },
 });
-
-uni.$store = store;
 ```
 
 ```ts

package/docs/api/modules/index.md

@@ -2,7 +2,7 @@
 
 模块发布路径为 `@zfqh/uniapp/lib/modules`。根入口没有直接导出这些模块；如果业务项目要复用，请深度引入 `@zfqh/uniapp/lib/modules/<name>` 或从 `@zfqh/uniapp/lib/modules` 取具名导出。
 
-这些模块默认假设项目使用 Vuex 4，并且插件安装后会把 Vuex store 暴露到 `uni.$store`，请求、导航、webview 消息等普通模块会读取它。组件和 hooks 中读取 Vuex 时仍应使用 `useStore()` 或 `this.$store`。
+这些模块默认假设项目使用 Vuex 4。请求、导航、webview 消息等普通模块会从 store 中读取状态。组件和 hooks 中读取 Vuex 时仍应使用 `useStore()` 或 `this.$store`。
 
 ## 基本使用
 

package/docs/api/utils/cos.md

@@ -205,7 +205,6 @@ defineConfig({
 
 ```ts
 import { getTencentToken } from '@zfqh/uniapp/lib/apis';
-import store from '@/store';
 
 defineConfig({
   upload: {
@@ -218,7 +217,7 @@ defineConfig({
         create_time: data.createTime,
         expire_time: data.expirationTime,
         bucket: data.bucket,
-        region: store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
+        region: uni.$store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
       };
     },
   },

package/docs/api/utils/index.md

@@ -12,7 +12,7 @@
 | [cos](./cos) | 腾讯云 COS 上传与图片压缩 URL。 |
 | [debounce](./debounce) | 防抖类和默认实例。 |
 | [file](./file) | URL、dataURL、base64、File、本地路径互转。 |
-| [locale](./locale) | 当前语言、回退语言和 nvue 文案读取。 |
+| [locale](./locale) | 当前语言、回退语言、vue-i18n 实例创建和 nvue 文案读取。 |
 | [message](./message) | webview 与宿主环境通信的消息类型常量。 |
 | [navigate](./navigate) | 页面跳转、登录拦截、tabBar、webview、自定义协议。 |
 | [pages](./pages) | 根据页面配置生成页面集合。 |

package/docs/api/utils/locale.md

@@ -4,7 +4,7 @@
 `@zfqh/uniapp/lib/utils/locale`
 :::
 
-提供当前语言、回退语言和 nvue 可用的简易文案读取方法。
+提供当前语言、回退语言、vue-i18n 实例创建和 nvue 可用的简易文案读取方法。
 
 ## 平台兼容性
 
@@ -15,11 +15,47 @@
 ## 基本使用
 
 ```ts
-import { defaultLocale, fallbackLocale, showLocale } from '@zfqh/uniapp';
+import { defaultLocale, fallbackLocale, createI18n, getLocaleMessage } from '@zfqh/uniapp';
 ```
 
 具体方法、参数语义和返回值以发布包类型为准；下方表格按 `@zfqh/uniapp/lib/utils/locale` 的导出整理。
 
+## 创建 vue-i18n 实例
+
+在 `locale/index.js` 中调用 `createI18n` 创建实例并导出：
+
+```js
+import { createI18n, defaultLocale, fallbackLocale } from '@zfqh/uniapp';
+import messages from './messages';
+
+export const i18n = createI18n({
+  locale: defaultLocale,
+  fallbackLocale,
+  messages,
+});
+```
+
+`messages.js` 按语言键组织翻译文件：
+
+```js
+import zhHans from './zh-Hans.json';
+import en from './en.json';
+
+export default {
+  'zh-Hans': zhHans,
+  en,
+};
+```
+
+实例创建后可在 App 启动时注册：
+
+```js
+import { i18n } from './locale';
+
+const app = createApp(App);
+app.use(i18n);
+```
+
 ## API
 
 发布路径：`@zfqh/uniapp/lib/utils/locale`
@@ -28,5 +64,5 @@ import { defaultLocale, fallbackLocale, showLocale } from '@zfqh/uniapp';
 | --- | --- | --- |
 | `defaultLocale` | `export const defaultLocale = uni.getLocale();` | 默认语言。 |
 | `fallbackLocale` | `export const fallbackLocale = 'zh-Hans';` | 回退语言。 |
-| `showLocale` | `export function showLocale(key, values) {` | nvue 场景下的简易 i18n 文案获取函数。 |
-
+| `createI18n` | `export function createI18n(opts: I18nOptions)` | 创建 vue-i18n 实例，返回实例。 |
+| `getLocaleMessage` | `export function getLocaleMessage(key: string): string` | 通过 key 获取当前语言文案，nvue 场景下的简易 i18n 文案读取。未匹配时返回 key 本身。 |

package/docs/api/utils/navigate.md

@@ -18,7 +18,7 @@
 import { navigate } from '@zfqh/uniapp';
 ```
 
-导航工具脱离组件 setup 上下文，内部会通过 `uni.$store.getters.isLogin` 判断登录态。组件或 hooks 中判断登录态时请使用 `useStore()`。
+导航工具脱离组件 setup 上下文，内部会通过 `store.getters.isLogin` 判断登录态。组件或 hooks 中判断登录态时请使用 `useStore()`。
 
 ## 常用跳转
 
@@ -192,10 +192,10 @@ navigate.navigateTo({
 登录判断依赖：
 
 ```ts
-uni.$store.getters.isLogin
+store.getters.isLogin
 ```
 
-`navigate` 是普通工具模块，脱离组件 setup 上下文，所以读取 `uni.$store`。如果是在组件或 hooks 中判断登录态，请使用：
+`navigate` 是普通工具模块，脱离组件 setup 上下文，所以直接引入 store 实例。如果是在组件或 hooks 中判断登录态，请使用：
 
 ```ts
 import { computed } from 'vue';

package/docs/api/utils/pages.md

@@ -124,7 +124,7 @@ defineConfig({
 
 `needLogin` 字段控制页面是否需要登录才能访问，默认为 `false`。
 
-当 `needLogin: true` 时，`navigate` 会检查 `uni.$store.getters.isLogin`，如果未登录则自动跳转到 `getPage('login')` 返回的登录页路径。
+当 `needLogin: true` 时，`navigate` 会检查 `store.getters.isLogin`，如果未登录则自动跳转到 `getPage('login')` 返回的登录页路径。
 
 ```json
 {

package/docs/api/utils/request.md

@@ -18,7 +18,7 @@
 import { formatURL, createInterceptors, createRequest } from '@zfqh/uniapp';
 ```
 
-请求工具脱离组件 setup 上下文，拦截器内部会通过 `uni.$store` 读取 token 并处理 `401`。组件或 hooks 中读取 store 时请使用 `useStore()`。
+请求工具脱离组件 setup 上下文，拦截器内部会从 store 中读取 token 并处理 `401`。组件或 hooks 中读取 store 时请使用 `useStore()`。
 
 具体方法、参数语义和返回值以发布包类型为准；下方表格按 `@zfqh/uniapp/lib/utils/request` 的导出整理。
 

package/docs/components/index.md

@@ -41,7 +41,7 @@ import { useStore } from 'vuex';
 const store = useStore();
 ```
 
-Options API 组件可使用 `this.$store`。`uni.$store` 主要给请求、导航、权限、webview 消息等普通 TS 模块使用，不建议作为组件 setup 或 hooks 的首选入口。
+Options API 组件可使用 `this.$store`。普通 TS 模块中使用 `uni.$store`。
 
 ## 组件分类
 

package/docs/components/styles/base-styles.md

@@ -1,239 +1,239 @@
-# 工具样式类
-
-`@zfqh/uniapp` 内置一组静态 SCSS 工具类，仅覆盖 **平台差异类** 和 **使用 `$uv-*` SCSS 变量的语义色类**。间距、尺寸、字号、圆角、透明度、阴影等通用原子类需要配合 `@gmcb/vite` 提供的 unocss 插件在构建时动态生成，两者命名风格与 UnoCSS / Tailwind CSS 一致。
-
-## 前置依赖
-
-使用完整原子类能力前，需要在项目的 `vite.config.js` 中注册 unocss 插件，并传入 `blockList` 避免与内置静态类冲突：
-
-```js
-import { defineConfig } from '@gmcb/vite';
-import { unocss } from '@gmcb/vite/lib/plugins';
-import { blockList } from '@gmcb/vite/lib/unocss';
-
-export default defineConfig({
-  plugins: [
-    uni(),
-    unocss({
-      blockList,
-    }),
-  ],
-});
-```
-
-`blockList` 已预置全部内置静态类名，unocss 插件不会为这些类名生成重复 CSS。
-
-## 引入方式
-
-在项目全局样式中导入一次即可。放在 `App.vue` 的 `<style>` 块：
-
-```scss
-@import '@zfqh/uniapp/lib/styles/index.scss';
-```
-
-此入口同时导入 `@gmcb/uv-ui/index.scss`，无需再单独导入 uv-ui 基础样式。
-
-## 内置原子类
-
-### Flex 布局
-
-| 类名 | 效果 |
-| --- | --- |
-| `.flex` | flex 行布局 |
-| `.flex-inline` | inline-flex 行布局 |
-| `.flex-row` / `.flex-row-reverse` | 行方向 |
-| `.flex-col` / `.flex-col-reverse` | 列方向 |
-| `.flex-wrap` / `.flex-nowrap` / `.flex-wrap-reverse` | 换行控制 |
-| `.flex-0` ~ `.flex-8` | `flex: 0` ~ `flex: 8` |
-| `.flex-none` | `flex: 0` |
-| `.items-start` / `.items-end` / `.items-center` / `.items-stretch` / `.items-baseline` | align-items |
-| `.justify-start` / `.justify-end` / `.justify-center` / `.justify-between` / `.justify-around` | justify-content |
-
-::: info 平台差异
-- H5 平台下这些类包裹在 `page` 选择器内。
-- `.flex` / `.flex-inline` 的 `display: flex` / `display: inline-flex` 仅在非 APP-NVUE 平台生效，nvue 端省略 display 属性（Weex 默认 flex 布局）。
-:::
-
-### 背景色
-
-`.bg-{color}` 系列，颜色值读取 `$uv-*` SCSS 变量，跟随主题配置：
-
-| 色组 | 可用类名 |
-| --- | --- |
-| primary | `.bg-primary`、`.bg-primary-dark`、`.bg-primary-light`、`.bg-primary-disabled` |
-| warning | `.bg-warning`、`.bg-warning-dark`、`.bg-warning-light`、`.bg-warning-disabled` |
-| success | `.bg-success`、`.bg-success-dark`、`.bg-success-light`、`.bg-success-disabled` |
-| error | `.bg-error`、`.bg-error-dark`、`.bg-error-light`、`.bg-error-disabled` |
-| info | `.bg-info`、`.bg-info-dark`、`.bg-info-light`、`.bg-info-disabled` |
-
-基础背景：
-
-| 类名 | SCSS 变量 | 说明 |
-| --- | --- | --- |
-| `.bg` | `$uv-bg-color` | 页面背景色 |
-| `.bg-light` | `$uv-bg-light-color` | 浅色背景 |
-| `.bg-disabled` | `$uv-disabled-color` | 禁用态背景 |
-| `.bg-border` | `$uv-border-color` | 边框色背景 |
-
-### 文字颜色
-
-`.text-{color}` 系列，颜色值读取 `$uv-*` SCSS 变量：
-
-| 色组 | 可用类名 |
-| --- | --- |
-| primary | `.text-primary`、`.text-primary-dark`、`.text-primary-light`、`.text-primary-disabled` |
-| warning | `.text-warning`、`.text-warning-dark`、`.text-warning-light`、`.text-warning-disabled` |
-| success | `.text-success`、`.text-success-dark`、`.text-success-light`、`.text-success-disabled` |
-| error | `.text-error`、`.text-error-dark`、`.text-error-light`、`.text-error-disabled` |
-| info | `.text-info`、`.text-info-dark`、`.text-info-light`、`.text-info-disabled` |
-
-UI 语义色：
-
-| 类名 | SCSS 变量 | 说明 |
-| --- | --- | --- |
-| `.text-main` | `$uv-main-color` | 主要文字 |
-| `.text-content` | `$uv-content-color` | 正文文字 |
-| `.text-tips` | `$uv-tips-color` | 辅助提示 |
-| `.text-light` | `$uv-light-color` | 占位/水印 |
-| `.text-border` | `$uv-border-color` | 边框色文字 |
-| `.text-disabled` | `$uv-disabled-color` | 禁用态文字 |
-
-### 边框
-
-| 类名 | 效果 |
-| --- | --- |
-| `.border` | 1px solid 边框色（`$uv-border-color`） |
-| `.border-half` | 0.5px solid 边框色 |
-| `.border-t` / `.border-r` / `.border-b` / `.border-l` | 单边 1px solid 边框色 |
-| `.border-x` / `.border-y` | 双轴 1px solid 边框色 |
-
-语义色边框：
-
-| 类名 | SCSS 变量 |
-| --- | --- |
-| `.border-primary` | `$uv-primary` |
-| `.border-warning` | `$uv-warning` |
-| `.border-success` | `$uv-success` |
-| `.border-error` | `$uv-error` |
-| `.border-info` | `$uv-info` |
-
-### 定位
-
-| 类名 | 效果 |
-| --- | --- |
-| `.relative` | position: relative |
-| `.absolute` | position: absolute |
-| `.fixed` | position: fixed |
-| `.sticky` | position: sticky |
-
-::: info 平台差异
-H5 平台下这些类包裹在 `page` 选择器内，其他平台直接使用。
-:::
-
-### 文本截断
-
-**非 nvue 平台**（`text-vue.scss`）：
-
-| 类名 | 效果 |
-| --- | --- |
-| `.truncate` | 单行截断（overflow ellipsis + nowrap） |
-| `.line-clamp-1` ~ `.line-clamp-5` | 多行截断（`-webkit-line-clamp`） |
-
-**nvue 平台**（`text-nvue.scss`）：
-
-| 类名 | 效果 |
-| --- | --- |
-| `.truncate` | 单行截断（Weex `lines: 1`） |
-| `.line-clamp-1` ~ `.line-clamp-5` | 多行截断（Weex `lines: n`） |
-
-### 全局重置
-
-`reset-vue.scss` 在非 nvue 平台自动生效，不属于原子类，作用：
-
-- 设置 `:root` 下的 `--window-bottom`、`--window-top`（非 H5）、`--window-height`、`--window-width` CSS 自定义属性。
-- `page` 元素宽高 100%、`font-family: Microsoft YaHei`、颜色取 `$uv-main-color`、flex 列布局。
-- `view`、`text`、`image` 设置 `box-sizing: border-box`。
-- 修复 `.uni-scroll-view-refresher` 背景透明。
-- 调整 `.ql-editor.ql-blank:before` 占位文字样式。
-- 调整 `.uv-toast` 默认样式。
-
-除上述内置类外，其余原子类（间距、尺寸、字号、字重、行高、对齐、基础背景色、边框宽度/样式、圆角、overflow、top/right/bottom/left/inset/z-index、透明度、阴影、transform-origin、transition 等）均由 `@gmcb/vite` 的 unocss 插件在构建时根据模板扫描动态生成，命名风格与 UnoCSS / Tailwind CSS 一致，支持 `px` 和 `rpx` 两种单位。
-
-`blockList` 已预置全部内置静态类名，unocss 插件不会为这些类名生成重复 CSS。
-
-## 常用组合示例
-
-卡片布局：
-
-```html
-<view class="flex flex-col p-16px bg-white rounded-8px shadow-sm">
-  <text class="text-32px font-semibold text-main">标题</text>
-  <text class="text-24px text-tips mt-8px">描述内容</text>
-</view>
-```
-
-居加载中状态：
-
-```html
-<view class="flex justify-center items-center h-200px">
-  <text class="text-28px text-tips">加载中...</text>
-</view>
-```
-
-列表项（头像 + 文字）：
-
-```html
-<view class="flex items-center px-16px py-12px">
-  <image class="w-80rpx h-80rpx rounded-full" :src="avatar" />
-  <view class="flex-1 ml-12px">
-    <text class="text-28px text-main truncate">用户名</text>
-    <text class="text-24px text-tips">副标题</text>
-  </view>
-</view>
-```
-
-吸顶导航栏：
-
-```html
-<view class="sticky top-0 bg-light px-16px py-12px">
-  <text class="text-32px font-bold text-main">页面标题</text>
-</view>
-```
-
-表单区域：
-
-```html
-<view class="flex flex-col px-16px py-12px bg-white mt-8px">
-  <view class="flex justify-between items-center py-12px border-b">
-    <text class="text-28px text-main">标签</text>
-    <text class="text-28px text-content">值</text>
-  </view>
-</view>
-```
-
-两列等分布局：
-
-```html
-<view class="flex flex-wrap">
-  <view class="w-full flex" v-for="group in groups" :key="group.id">
-    <view class="flex-1 p-8px" v-for="item in group.items" :key="item.id">
-      <view class="bg-white rounded-8px p-16px">{{ item.name }}</view>
-    </view>
-  </view>
-</view>
-```
-
-底部固定操作栏：
-
-```html
-<view class="fixed bottom-0 left-0 right-0 bg-white px-16px py-12px z-5">
-  <view class="flex">
-    <view class="flex-1 mr-8px bg-error rounded-8px py-12px text-center">
-      <text class="text-white text-28px font-medium">取消</text>
-    </view>
-    <view class="flex-1 bg-primary rounded-8px py-12px text-center">
-      <text class="text-white text-28px font-medium">确认</text>
-    </view>
-  </view>
-</view>
-```
+# 工具样式类
+
+`@zfqh/uniapp` 内置一组静态 SCSS 工具类，仅覆盖 **平台差异类** 和 **使用 `$uv-*` SCSS 变量的语义色类**。间距、尺寸、字号、圆角、透明度、阴影等通用原子类需要配合 `@gmcb/vite` 提供的 unocss 插件在构建时动态生成，两者命名风格与 UnoCSS / Tailwind CSS 一致。
+
+## 前置依赖
+
+使用完整原子类能力前，需要在项目的 `vite.config.js` 中注册 unocss 插件，并传入 `blockList` 避免与内置静态类冲突：
+
+```js
+import { defineConfig } from '@gmcb/vite';
+import { unocss } from '@gmcb/vite/lib/plugins';
+import { blockList } from '@gmcb/vite/lib/unocss';
+
+export default defineConfig({
+  plugins: [
+    uni(),
+    unocss({
+      blockList,
+    }),
+  ],
+});
+```
+
+`blockList` 已预置全部内置静态类名，unocss 插件不会为这些类名生成重复 CSS。
+
+## 引入方式
+
+在项目全局样式中导入一次即可。放在 `App.vue` 的 `<style>` 块：
+
+```scss
+@import '@zfqh/uniapp/lib/styles/index.scss';
+```
+
+此入口同时导入 `@gmcb/uv-ui/index.scss`，无需再单独导入 uv-ui 基础样式。
+
+## 内置原子类
+
+### Flex 布局
+
+| 类名 | 效果 |
+| --- | --- |
+| `.flex` | flex 行布局 |
+| `.flex-inline` | inline-flex 行布局 |
+| `.flex-row` / `.flex-row-reverse` | 行方向 |
+| `.flex-col` / `.flex-col-reverse` | 列方向 |
+| `.flex-wrap` / `.flex-nowrap` / `.flex-wrap-reverse` | 换行控制 |
+| `.flex-0` ~ `.flex-8` | `flex: 0` ~ `flex: 8` |
+| `.flex-none` | `flex: 0` |
+| `.items-start` / `.items-end` / `.items-center` / `.items-stretch` / `.items-baseline` | align-items |
+| `.justify-start` / `.justify-end` / `.justify-center` / `.justify-between` / `.justify-around` | justify-content |
+
+::: info 平台差异
+- H5 平台下这些类包裹在 `page` 选择器内。
+- `.flex` / `.flex-inline` 的 `display: flex` / `display: inline-flex` 仅在非 APP-NVUE 平台生效，nvue 端省略 display 属性（Weex 默认 flex 布局）。
+:::
+
+### 背景色
+
+`.bg-{color}` 系列，颜色值读取 `$uv-*` SCSS 变量，跟随主题配置：
+
+| 色组 | 可用类名 |
+| --- | --- |
+| primary | `.bg-primary`、`.bg-primary-dark`、`.bg-primary-light`、`.bg-primary-disabled` |
+| warning | `.bg-warning`、`.bg-warning-dark`、`.bg-warning-light`、`.bg-warning-disabled` |
+| success | `.bg-success`、`.bg-success-dark`、`.bg-success-light`、`.bg-success-disabled` |
+| error | `.bg-error`、`.bg-error-dark`、`.bg-error-light`、`.bg-error-disabled` |
+| info | `.bg-info`、`.bg-info-dark`、`.bg-info-light`、`.bg-info-disabled` |
+
+基础背景：
+
+| 类名 | SCSS 变量 | 说明 |
+| --- | --- | --- |
+| `.bg` | `$uv-bg-color` | 页面背景色 |
+| `.bg-light` | `$uv-bg-light-color` | 浅色背景 |
+| `.bg-disabled` | `$uv-disabled-color` | 禁用态背景 |
+| `.bg-border` | `$uv-border-color` | 边框色背景 |
+
+### 文字颜色
+
+`.text-{color}` 系列，颜色值读取 `$uv-*` SCSS 变量：
+
+| 色组 | 可用类名 |
+| --- | --- |
+| primary | `.text-primary`、`.text-primary-dark`、`.text-primary-light`、`.text-primary-disabled` |
+| warning | `.text-warning`、`.text-warning-dark`、`.text-warning-light`、`.text-warning-disabled` |
+| success | `.text-success`、`.text-success-dark`、`.text-success-light`、`.text-success-disabled` |
+| error | `.text-error`、`.text-error-dark`、`.text-error-light`、`.text-error-disabled` |
+| info | `.text-info`、`.text-info-dark`、`.text-info-light`、`.text-info-disabled` |
+
+UI 语义色：
+
+| 类名 | SCSS 变量 | 说明 |
+| --- | --- | --- |
+| `.text-main` | `$uv-main-color` | 主要文字 |
+| `.text-content` | `$uv-content-color` | 正文文字 |
+| `.text-tips` | `$uv-tips-color` | 辅助提示 |
+| `.text-light` | `$uv-light-color` | 占位/水印 |
+| `.text-border` | `$uv-border-color` | 边框色文字 |
+| `.text-disabled` | `$uv-disabled-color` | 禁用态文字 |
+
+### 边框
+
+| 类名 | 效果 |
+| --- | --- |
+| `.border` | 1px solid 边框色（`$uv-border-color`） |
+| `.border-half` | 0.5px solid 边框色 |
+| `.border-t` / `.border-r` / `.border-b` / `.border-l` | 单边 1px solid 边框色 |
+| `.border-x` / `.border-y` | 双轴 1px solid 边框色 |
+
+语义色边框：
+
+| 类名 | SCSS 变量 |
+| --- | --- |
+| `.border-primary` | `$uv-primary` |
+| `.border-warning` | `$uv-warning` |
+| `.border-success` | `$uv-success` |
+| `.border-error` | `$uv-error` |
+| `.border-info` | `$uv-info` |
+
+### 定位
+
+| 类名 | 效果 |
+| --- | --- |
+| `.relative` | position: relative |
+| `.absolute` | position: absolute |
+| `.fixed` | position: fixed |
+| `.sticky` | position: sticky |
+
+::: info 平台差异
+H5 平台下这些类包裹在 `page` 选择器内，其他平台直接使用。
+:::
+
+### 文本截断
+
+**非 nvue 平台**（`text-vue.scss`）：
+
+| 类名 | 效果 |
+| --- | --- |
+| `.truncate` | 单行截断（overflow ellipsis + nowrap） |
+| `.line-clamp-1` ~ `.line-clamp-5` | 多行截断（`-webkit-line-clamp`） |
+
+**nvue 平台**（`text-nvue.scss`）：
+
+| 类名 | 效果 |
+| --- | --- |
+| `.truncate` | 单行截断（Weex `lines: 1`） |
+| `.line-clamp-1` ~ `.line-clamp-5` | 多行截断（Weex `lines: n`） |
+
+### 全局重置
+
+`reset-vue.scss` 在非 nvue 平台自动生效，不属于原子类，作用：
+
+- 设置 `:root` 下的 `--window-bottom`、`--window-top`（非 H5）、`--window-height`、`--window-width` CSS 自定义属性。
+- `page` 元素宽高 100%、`font-family: Microsoft YaHei`、颜色取 `$uv-main-color`、flex 列布局。
+- `view`、`text`、`image` 设置 `box-sizing: border-box`。
+- 修复 `.uni-scroll-view-refresher` 背景透明。
+- 调整 `.ql-editor.ql-blank:before` 占位文字样式。
+- 调整 `.uv-toast` 默认样式。
+
+除上述内置类外，其余原子类（间距、尺寸、字号、字重、行高、对齐、基础背景色、边框宽度/样式、圆角、overflow、top/right/bottom/left/inset/z-index、透明度、阴影、transform-origin、transition 等）均由 `@gmcb/vite` 的 unocss 插件在构建时根据模板扫描动态生成，命名风格与 UnoCSS / Tailwind CSS 一致，支持 `px` 和 `rpx` 两种单位。
+
+`blockList` 已预置全部内置静态类名，unocss 插件不会为这些类名生成重复 CSS。
+
+## 常用组合示例
+
+卡片布局：
+
+```html
+<view class="flex flex-col p-16px bg-white rounded-8px shadow-sm">
+  <text class="text-32px font-semibold text-main">标题</text>
+  <text class="text-24px text-tips mt-8px">描述内容</text>
+</view>
+```
+
+居加载中状态：
+
+```html
+<view class="flex justify-center items-center h-200px">
+  <text class="text-28px text-tips">加载中...</text>
+</view>
+```
+
+列表项（头像 + 文字）：
+
+```html
+<view class="flex items-center px-16px py-12px">
+  <image class="w-80rpx h-80rpx rounded-full" :src="avatar" />
+  <view class="flex-1 ml-12px">
+    <text class="text-28px text-main truncate">用户名</text>
+    <text class="text-24px text-tips">副标题</text>
+  </view>
+</view>
+```
+
+吸顶导航栏：
+
+```html
+<view class="sticky top-0 bg-light px-16px py-12px">
+  <text class="text-32px font-bold text-main">页面标题</text>
+</view>
+```
+
+表单区域：
+
+```html
+<view class="flex flex-col px-16px py-12px bg-white mt-8px">
+  <view class="flex justify-between items-center py-12px border-b">
+    <text class="text-28px text-main">标签</text>
+    <text class="text-28px text-content">值</text>
+  </view>
+</view>
+```
+
+两列等分布局：
+
+```html
+<view class="flex flex-wrap">
+  <view class="w-full flex" v-for="group in groups" :key="group.id">
+    <view class="flex-1 p-8px" v-for="item in group.items" :key="item.id">
+      <view class="bg-white rounded-8px p-16px">{{ item.name }}</view>
+    </view>
+  </view>
+</view>
+```
+
+底部固定操作栏：
+
+```html
+<view class="fixed bottom-0 left-0 right-0 bg-white px-16px py-12px z-5">
+  <view class="flex">
+    <view class="flex-1 mr-8px bg-error rounded-8px py-12px text-center">
+      <text class="text-white text-28px font-medium">取消</text>
+    </view>
+    <view class="flex-1 bg-primary rounded-8px py-12px text-center">
+      <text class="text-white text-28px font-medium">确认</text>
+    </view>
+  </view>
+</view>
+```

package/docs/components/usage.md

@@ -58,7 +58,7 @@ const isLogin = computed(() => store.getters.isLogin);
 </script>
 ```
 
-如果组件仍使用 Options API，可使用 `this.$store`。`uni.$store` 只推荐在脱离组件上下文的普通 TS 模块中使用，例如请求拦截器、导航工具、权限工具和 webview 消息处理。
+如果组件仍使用 Options API，可使用 `this.$store`。脱离组件上下文的普通 TS 模块中使用 `uni.$store`。
 
 ## 页面骨架示例
 

package/docs/faq/index.md

@@ -5,16 +5,15 @@
 检查：
 
 1. 是否先注册 store，再注册 `@zfqh/uniapp`。
-2. 是否设置了 `app.config.globalProperties.$store = store`。
-3. token 是否位于 `uni.$store.state.login.info.token`。
+2. token 是否位于 `store.state.login.info.token`。
 
-这里检查 `uni.$store` 是因为请求拦截器属于普通 TS 模块。组件或 hooks 内读取同一份状态时应使用 `useStore()`。
+请求拦截器属于普通 TS 模块，内部会从 store 中读取状态。组件或 hooks 内读取同一份状态时应使用 `useStore()`。
 
 ## 401 后没有退出登录
 
 检查：
 
-1. `uni.$store.state.login.info.token` 是否存在。
+1. `store.state.login.info.token` 是否存在。
 2. store 是否实现 `dispatch('logout')`。
 3. 请求配置是否设置了 `custom.reLogin: false` 或 `custom.needLogin: false`。
 
@@ -31,12 +30,12 @@
 
 检查：
 
-1. `uni.$store.getters.isLogin` 是否正确。
+1. `store.getters.isLogin` 是否正确。
 2. `page.needLoginPages` 是否包含目标页。
 3. `getPage('login')` 是否能返回登录页路径。
 4. 当前跳转是否显式传入 `needLogin: false`。
 
-`navigate` 内部读取 `uni.$store.getters.isLogin`。如果页面组件里自己判断登录态，请使用 `import { useStore } from 'vuex'`。
+`navigate` 内部读取 `store.getters.isLogin`。如果页面组件里自己判断登录态，请使用 `import { useStore } from 'vuex'`。
 
 ## tabBar 页面 navigateTo 失败
 

package/docs/guide/getting-started.md

@@ -34,14 +34,14 @@ export function createApp() {
 }
 ```
 
-`@zfqh/uniapp` 插件安装时会把 `app.config.globalProperties.$store` 赋值给 `uni.$store`。请求、导航、权限、登录等能力会读取 `uni.$store`，所以请先挂载 store，再注册本插件。
+请求、导航、权限、登录等能力会读取 store 状态，所以请先挂载 store，再注册本插件。
 
 Store 使用入口请按上下文区分：
 
 - 组件的 Composition API 或 `<script setup>` 中使用 `import { useStore } from 'vuex'`。
 - 自定义 hooks / composables 中也使用 `useStore()`。
 - Options API 组件中可使用 `this.$store`。
-- 请求、导航、权限、webview 消息等普通 TS 模块中使用 `uni.$store`。
+- 普通 TS 模块中使用 `uni.$store`。
 
 详见 [Store 使用位置](./project-frame.md#store-使用位置)。
 
@@ -124,7 +124,6 @@ import { defineConfig } from '@zfqh/uniapp';
 import { app } from '@zfqh/uniapp/lib/configs/app';
 import { brand } from '@zfqh/uniapp/lib/configs/brand';
 import { getTencentToken } from '@zfqh/uniapp/lib/apis';
-import store from '@/store';
 
 defineConfig({
   app: app.merchant,
@@ -149,7 +148,7 @@ defineConfig({
         create_time: data.createTime,
         expire_time: data.expirationTime,
         bucket: data.bucket,
-        region: store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
+        region: uni.$store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
       };
     },
   },

package/docs/guide/project-frame.md

@@ -110,7 +110,6 @@ import { defineConfig } from '@zfqh/uniapp';
 import { app } from '@zfqh/uniapp/lib/configs/app';
 import { brand } from '@zfqh/uniapp/lib/configs/brand';
 import { getTencentToken } from '@zfqh/uniapp/lib/apis';
-import store from '@/store';
 
 defineConfig({
   app: app.merchant,
@@ -135,7 +134,7 @@ defineConfig({
         create_time: data.createTime,
         expire_time: data.expirationTime,
         bucket: data.bucket,
-        region: store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
+        region: uni.$store.state.storeConfig.isGlobalAccelerate ? 'accelerate' : data.region,
       };
     },
   },
@@ -197,13 +196,13 @@ export default defineConfig({
 
 | 路径 | 用途 |
 | --- | --- |
-| `uni.$store.state.login.info.token` | 请求拦截器注入 `Authorization`。 |
-| `uni.$store.state.login.info.tenantId` | 业务请求注入 `Tenant-Id`。 |
-| `uni.$store.state.system.info.appLanguage` | 业务请求注入 `X-Language`。 |
-| `uni.$store.state.system.info.appVersion` | 非 App 环境下读取版本名。 |
-| `uni.$store.state.system.info.appVersionCode` | 非 App 环境下读取版本号。 |
-| `uni.$store.getters.isLogin` | 导航登录拦截判断。 |
-| `uni.$store.dispatch('logout')` | `401` 时触发退出登录。 |
+| `store.state.login.info.token` | 请求拦截器注入 `Authorization`。 |
+| `store.state.login.info.tenantId` | 业务请求注入 `Tenant-Id`。 |
+| `store.state.system.info.appLanguage` | 业务请求注入 `X-Language`。 |
+| `store.state.system.info.appVersion` | 非 App 环境下读取版本名。 |
+| `store.state.system.info.appVersionCode` | 非 App 环境下读取版本号。 |
+| `store.getters.isLogin` | 导航登录拦截判断。 |
+| `store.dispatch('logout')` | `401` 时触发退出登录。 |
 
 推荐在注册插件前完成：
 
@@ -219,9 +218,9 @@ app.use(uniapp);
 | 场景 | 推荐用法 | 说明 |
 | --- | --- | --- |
 | Vue 组件的 Composition API / `<script setup>` | `import { useStore } from 'vuex'` 后调用 `const store = useStore()` | 组件实例处于 Vue 上下文内，应使用 Vuex 官方组合式 API，便于类型推导、测试和组件复用。 |
-| 自定义 hooks / composables | `import { useStore } from 'vuex'` 后在 hook 内调用 `useStore()` | hooks 同样运行在组件 setup 上下文里，不要直接读取全局 `uni.$store`。 |
+| 自定义 hooks / composables | `import { useStore } from 'vuex'` 后在 hook 内调用 `useStore()` | hooks 同样运行在组件 setup 上下文里。 |
 | Options API 组件 | `this.$store` | 组件实例已注入 `$store` 时可使用实例属性；现有 `g-*` 组件源码也采用这种方式读取部分系统状态。 |
-| 请求、导航、toast、权限、webview 消息等普通 TS 模块 | `uni.$store` | 这些模块不在 Vue setup 上下文中，无法调用 `useStore()`，因此通过插件挂载到 `uni.$store` 的全局 store 读取登录态和全局状态。 |
+| 请求、导航、toast、权限、webview 消息等普通 TS 模块 | `uni.$store` | 这些模块不在 Vue setup 上下文中，无法调用 `useStore()`，因此直接引入 store 实例读取登录态和全局状态。 |
 
 组件或 hooks 中推荐写法：
 
@@ -241,16 +240,6 @@ export function useLoginInfo() {
 }
 ```
 
-普通模块中推荐写法：
-
-```ts
-export function getToken() {
-  return uni.$store?.state?.login?.info?.token;
-}
-```
-
-`uni.$store` 是为了让脱离组件树的工具函数能够访问 store，不建议在组件 setup 或 hooks 中把它作为首选入口。
-
 ## 样式接入
 
 `@zfqh/uniapp` 内置的静态样式仅覆盖平台差异类和使用 `$uv-*` SCSS 变量的语义色类，间距、尺寸、字号、圆角、透明度、阴影等通用原子类由 `@gmcb/vite` 的 unocss 插件在构建时动态生成。

package/docs/index.md

@@ -74,7 +74,7 @@ export function createApp() {
 
 ## 使用约定
 
-- 项目需要提供符合约定的 Vuex store：请求读取 `uni.$store.state.login.info.token`，导航读取 `uni.$store.getters.isLogin`，`401` 会触发 `uni.$store.dispatch('logout')`。
-- Store 入口按上下文区分：组件和 hooks 的 Composition API 中使用 `import { useStore } from 'vuex'`，Options API 组件中使用 `this.$store`，请求、导航、权限、webview 消息等普通模块中使用 `uni.$store`。
+- 项目需要提供符合约定的 Vuex store：请求读取 `store.state.login.info.token`，导航读取 `store.getters.isLogin`，`401` 会触发 `store.dispatch('logout')`。
+- Store 入口按上下文区分：组件的 Composition API 中使用 `import { useStore } from 'vuex'`，Options API 组件中使用 `this.$store`，普通 TS 模块中使用 `uni.$store`。
 - 多环境配置推荐使用 `@env/.env.<env>.ts`，并通过 `defineEnvConfig` 输出配置。
 - 根入口未导出的 `apis`、`modules`、`mixins` 请按 [深度引用](./api/index.md#深度引用) 从构建产物路径引入。

package/lib/hooks/useI18n.js

@@ -1,16 +1,10 @@
-// #ifdef APP-NVUE
-import { ref, inject } from 'vue';
-import { showLocale, defaultLocale } from '../utils/locale';
-// #endif
 // #ifndef APP-NVUE
 import { useI18n as vueUseI18n } from 'vue-i18n';
 // #endif
 let _useI18n;
 // #ifdef APP-NVUE
 _useI18n = function () {
-    const locale = ref(defaultLocale);
-    const t = inject('t', showLocale);
-    return { t, locale };
+    return uni.$i18n.global;
 };
 // #endif
 // #ifndef APP-NVUE

package/lib/index.d.ts

@@ -5,6 +5,7 @@ import cos from './utils/cos';
 import './utils/uni';
 export * from './hooks';
 export * from './utils';
+export * from './utils/locale';
 export * from './utils/file';
 export * from './utils/storage';
 export * from './utils/pages';

package/lib/index.js

@@ -6,6 +6,7 @@ import cos from './utils/cos';
 import './utils/uni';
 export * from './hooks';
 export * from './utils';
+export * from './utils/locale';
 export * from './utils/file';
 export * from './utils/storage';
 export * from './utils/pages';
@@ -25,8 +26,6 @@ const install = (app) => {
     // #ifdef MP
     app.mixin(deep);
     // #endif
-    const { $store } = app.config.globalProperties;
-    uni.$store = $store;
 };
 export default {
     install,

package/lib/styles/bg.scss

@@ -63,7 +63,7 @@
 }
 .bg {
   background-color: $uv-bg-color;
-}
+}
 .bg-light {
   background-color: $uv-bg-light-color;
 }

package/lib/styles/flex.scss

@@ -1,15 +1,15 @@
-/* #ifdef H5 */
-page {
+/* #ifdef H5 */
+page {
 /* #endif */
-  .flex {
+  .flex {
     /* #ifndef APP-NVUE */
-    display: flex;
+    display: flex;
     /* #endif */
     flex-direction: row;
   }
-  .flex-inline {
+  .flex-inline {
     /* #ifndef APP-NVUE */
-    display: inline-flex;
+    display: inline-flex;
     /* #endif */
     flex-direction: row;
   }
@@ -72,7 +72,7 @@ page {
   .justify-around {
     justify-content: space-around;
   }
-/* #ifdef H5 */
-}
+/* #ifdef H5 */
+}
 /* #endif */
 

package/lib/styles/index.scss

@@ -1,13 +1,13 @@
 @import '@gmcb/uv-ui/index.scss';
 @import './border.scss';
 @import './bg.scss';
-@import './text.scss';
+@import './text.scss';
 @import './layout.scss';
 @import './flex.scss';
 /* #ifndef APP-NVUE */
-@import './reset-vue.scss';
+@import './reset-vue.scss';
 @import './text-vue.scss';
 /* #endif */
 /* #ifdef APP-NVUE */
-@import './text-nvue.scss';
+@import './text-nvue.scss';
 /* #endif */

package/lib/styles/layout.scss

@@ -1,18 +1,18 @@
-/* #ifdef H5 */
-page {
+/* #ifdef H5 */
+page {
 /* #endif */
-  .relative {
-    position: relative;
-  }
-  .absolute {
-    position: absolute;
-  }
-  .fixed {
-    position: fixed;
-  }
-  .sticky {
-    position: sticky;
-  }
+  .relative {
+    position: relative;
+  }
+  .absolute {
+    position: absolute;
+  }
+  .fixed {
+    position: fixed;
+  }
+  .sticky {
+    position: sticky;
+  }
 /* #ifdef H5 */
 }
 /* #endif */

package/lib/styles/reset-vue.scss

@@ -11,8 +11,8 @@ page {
   width: 100%;
   height: 100%;
   font-family: Microsoft YaHei;
-  color: $uv-main-color;
-  display: flex;
+  color: $uv-main-color;
+  display: flex;
   flex-direction: column;
 }
 

package/lib/styles/text-nvue.scss

@@ -9,4 +9,4 @@
     text-overflow: ellipsis;
     lines: $n;
   }
-}
+}

package/lib/styles/text.scss

@@ -75,6 +75,6 @@
 }
 .text-disabled {
   color: $uv-disabled-color;
-}
+}
 
 

package/lib/utils/locale.d.ts

@@ -1,6 +1,5 @@
+import { I18nOptions } from 'vue-i18n';
 export declare const defaultLocale: string;
 export declare const fallbackLocale = "zh-Hans";
-/**
- * nvue 下 inject 未提供 t 时的回退；第二参数为命名占位 {n} 等
- */
-export declare function showLocale(key: any, values: any): any;
+export declare function createI18n(opts: I18nOptions): import("vue-i18n").I18n<import("vue-i18n").LocaleMessages<import("vue-i18n").VueMessageType>, import("vue-i18n").IntlDateTimeFormats, import("vue-i18n").IntlNumberFormats, boolean>;
+export declare function getLocaleMessage(key: string): string;

package/lib/utils/locale.js

@@ -1,19 +1,10 @@
+import { createI18n as _createI18n } from 'vue-i18n';
 export const defaultLocale = uni.getLocale();
 export const fallbackLocale = 'zh-Hans';
-function applyNamedPlaceholders(str, values) {
-    if (!values || typeof str !== 'string') {
-        return str;
-    }
-    let out = str;
-    for (const k of Object.keys(values)) {
-        out = out.split(`{${k}}`).join(String(values[k]));
-    }
-    return out;
+export function createI18n(opts) {
+    const i18n = _createI18n(opts);
+    return (uni.$i18n = i18n);
 }
-/**
- * nvue 下 inject 未提供 t 时的回退；第二参数为命名占位 {n} 等
- */
-export function showLocale(key, values) {
-    const raw = uni.$messages[uni.getLocale()]?.[key] || uni.$messages[fallbackLocale]?.[key] || key;
-    return applyNamedPlaceholders(raw, values);
+export function getLocaleMessage(key) {
+    return uni.$i18n?.global?.t(key) || key;
 }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@zfqh/uniapp",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "uniapp公共模块",
   "author": "yinjiazeng@163.com",
   "license": "MIT",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
-  "homepage": "https://git.keeprisk.cn/zfqh/front-end/tree/master/packages/uniapp-zfqh",
+  "homepage": "https://git.keeprisk.cn/zfqh/front-end/tree/master/packages/zfqh-uniapp",
   "publishConfig": {
     "access": "public"
   },
@@ -45,5 +45,5 @@
     "@types/qs": "^6.9.16",
     "@types/url-parse": "^1.4.11"
   },
-  "gitHead": "4eadd74fdfef951065e002cb9f65a30a7de03021"
+  "gitHead": "466e3167167162d5976a7d39111f1d2309707542"
 }

package/types/index.d.ts

@@ -1,12 +1,14 @@
 /// <reference path="./virtual.d.ts" />
 
 import type { Uni as UniTypes } from '@dcloudio/types';
+import type { Store } from 'vuex';
+import type { I18n } from 'vue-i18n';
 import color from '../lib/configs/color';
 
 declare global {
   interface Uni extends UniTypes {
-    $store: any;
-    $messages: any;
+    $store: Store;
+    $i18n: I18n;
     $uv: any;
     webView: any;
     showAppFromBackground: boolean;