@zfqh/uview-x 0.0.0-stage → 0.0.2

package/locales/index.ts

@@ -0,0 +1,169 @@
+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'),
+    },
+  };
+}

package/locales/zh-Hans.ts

@@ -0,0 +1,78 @@
+/**
+ * uview-x 组件内置语言包：简体中文（zh-Hans）。
+ *
+ * 键空间固定为 `uv.*`，用户可通过 `createI18n({ messages })` 传同名 key 覆盖；
+ * `uv.form.*` 与 `components/uv-form/valid.ts` 的 async-validator 默认 messages 对齐，`%s` 占位符由校验器替换。
+ */
+const zhHans = {
+  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 zhHans;

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@zfqh/uview-x",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.2",
+  "description": "uview-x：面向 uni-app x 蒸汽模式（Vapor）、经典 uni-app Vue3 与 nvue 的 UV UI 组件库，组件保持 uv-ui API。",
+  "main": "index.ts",
+  "types": "types/index.d.ts",
+  "type": "module",
+  "dependencies": {
+    "vue-i18n": "9.1.9"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "uv-ui",
+    "uvui",
+    "uni-app 框架",
+    "uv_UI",
+    "uv UI",
+    "uni-app x",
+    "uni-app-x",
+    "uni-app vue3",
+    "nvue",
+    "app-plus",
+    "vapor",
+    "蒸汽模式"
+  ],
+  "author": "yinjiazeng@163.com",
+  "license": "MIT",
+  "files": [
+    "components",
+    "hooks",
+    "libs",
+    "locales",
+    "styles",
+    "types",
+    "utils",
+    "index.ts",
+    "theme.scss",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "gitHead": "abcec16d4c73e83cec02770a553cd89091e35cf3"
+}

package/styles/color.scss

@@ -0,0 +1,33 @@
+$uv-main-color: #333333 !default;
+$uv-content-color: #7a7a7a !default;
+$uv-tips-color: #9a9a9a !default;
+$uv-light-color: #c0c4cc !default;
+$uv-border-color: #eeeeee !default;
+$uv-bg-color: #f5f5f5 !default;
+$uv-bg-light-color: #fffbf4 !default;
+$uv-disabled-color: #c8c9cc !default;
+
+$uv-primary: #00b4c3 !default;
+$uv-primary-dark: #157572 !default;
+$uv-primary-disabled: #b4e3d9 !default;
+$uv-primary-light: #dff3f9 !default;
+
+$uv-warning: #ff9a05 !default;
+$uv-warning-dark: #ed6c04 !default;
+$uv-warning-disabled: #f9d39b !default;
+$uv-warning-light: #fdf6ec !default;
+
+$uv-success: #5ac725 !default;
+$uv-success-dark: #53c21d !default;
+$uv-success-disabled: #a9e08f !default;
+$uv-success-light: #f5fff0 !default;
+
+$uv-error: #ff4d4f !default;
+$uv-error-dark: #e45656 !default;
+$uv-error-disabled: #f7b2b2 !default;
+$uv-error-light: #fef0f0 !default;
+
+$uv-info: #909399 !default;
+$uv-info-dark: #767a82 !default;
+$uv-info-disabled: #c4c6c9 !default;
+$uv-info-light: #f4f4f5 !default;

package/styles/common.scss

@@ -0,0 +1,134 @@
+// 全局工具类（x-safe）。
+//
+// App 蒸汽模式只支持 class / 分组 / 复合 class / page 选择器，
+// 因此这里不使用元素选择器、伪类、伪元素；Web/小程序专属规则放在条件块中。
+
+// 超出行数，自动显示行尾省略号，最多 5 行
+// App 蒸汽模式用 text 的 max-lines；nvue 用 weex 的 lines；Web/小程序用 CSS 截断。
+/* #ifdef APP-NVUE */
+@for $i from 1 through 5 {
+	.uv-line-#{$i} {
+		lines: $i;
+		text-overflow: ellipsis;
+		overflow: hidden;
+		flex: 1;
+	}
+}
+/* #endif */
+
+/* #ifdef WEB || H5 || MP */
+@for $i from 1 through 5 {
+	.uv-line-#{$i} {
+		@if $i == 1 {
+			overflow: hidden;
+			white-space: nowrap;
+			text-overflow: ellipsis;
+		} @else {
+			display: -webkit-box !important;
+			overflow: hidden;
+			text-overflow: ellipsis;
+			word-break: break-all;
+			-webkit-line-clamp: $i;
+			-webkit-box-orient: vertical !important;
+		}
+	}
+}
+/* #endif */
+
+$uv-bordercolor: #dadbde !default;
+@if variable-exists(uv-border-color) {
+	$uv-bordercolor: $uv-border-color;
+}
+
+// 边框工具类：
+// - nvue 不支持 !important，基础声明供 App-NVUE 使用；
+// - Web/H5/MP 与 App 蒸汽模式保留 !important 覆盖组件内联边框（与上游行为一致）。
+.uv-border {
+	border-style: solid;
+	border-width: 0.5px;
+	border-color: $uv-bordercolor;
+	/* #ifndef APP-NVUE */
+	border-width: 0.5px !important;
+	border-color: $uv-bordercolor !important;
+	/* #endif */
+}
+
+.uv-border-top {
+	border-top-style: solid;
+	border-top-width: 0.5px;
+	border-color: $uv-bordercolor;
+	/* #ifndef APP-NVUE */
+	border-top-width: 0.5px !important;
+	border-color: $uv-bordercolor !important;
+	/* #endif */
+}
+
+.uv-border-left {
+	border-left-style: solid;
+	border-left-width: 0.5px;
+	border-color: $uv-bordercolor;
+	/* #ifndef APP-NVUE */
+	border-left-width: 0.5px !important;
+	border-color: $uv-bordercolor !important;
+	/* #endif */
+}
+
+.uv-border-right {
+	border-right-style: solid;
+	border-right-width: 0.5px;
+	border-color: $uv-bordercolor;
+	/* #ifndef APP-NVUE */
+	border-right-width: 0.5px !important;
+	border-color: $uv-bordercolor !important;
+	/* #endif */
+}
+
+.uv-border-bottom {
+	border-bottom-style: solid;
+	border-bottom-width: 0.5px;
+	border-color: $uv-bordercolor;
+	/* #ifndef APP-NVUE */
+	border-bottom-width: 0.5px !important;
+	border-color: $uv-bordercolor !important;
+	/* #endif */
+}
+
+.uv-border-top-bottom {
+	border-top-style: solid;
+	border-bottom-style: solid;
+	border-top-width: 0.5px;
+	border-bottom-width: 0.5px;
+	border-color: $uv-bordercolor;
+	/* #ifndef APP-NVUE */
+	border-top-width: 0.5px !important;
+	border-bottom-width: 0.5px !important;
+	border-color: $uv-bordercolor !important;
+	/* #endif */
+}
+
+// 去除 button 默认样式，让其表现跟普通 view/text 一致
+// 注意：App 蒸汽模式不支持 font-size/line-height/color: inherit，这里给显式兜底值，
+// 组件内部会通过内联样式/局部 class 覆盖。
+.uv-reset-button {
+	padding: 0;
+	background-color: transparent;
+	/* #ifndef APP-NVUE */
+	border-width: 0;
+	font-size: 16px;
+	line-height: 20px;
+	color: #303133;
+	/* #endif */
+	/* #ifdef APP-NVUE */
+	border-width: 0;
+	/* #endif */
+}
+
+/* #ifdef WEB || H5 || MP */
+.uv-reset-button::after {
+	border: none;
+}
+/* #endif */
+
+.uv-hover-class {
+	opacity: 0.7;
+}

package/styles/components.scss

@@ -0,0 +1,19 @@
+// uview-x 组件样式基础 mixin。
+//
+// 注意：这里只允许输出“编译期可消解”的 SCSS 或扁平 class 规则。
+// uni-app x App 蒸汽模式不支持元素选择器、后代选择器、伪类/伪元素，
+// 因此原 uv-ui 中的 view/scroll-view 全局重置必须放在 index.scss 的
+// WEB / MP 条件块中，不能出现在每个组件的 style 里。
+@mixin flex($direction: row) {
+	/* #ifndef APP-NVUE */
+	display: flex;
+	/* #endif */
+	flex-direction: $direction;
+}
+
+// 细边框（用于需要显式声明边框的场景，调用方自行控制 class）
+@mixin border-1px($color: #dadbde) {
+	border-width: 0.5px;
+	border-color: $color;
+	border-style: solid;
+}

package/styles/index.scss

@@ -0,0 +1,7 @@
+// 引入公共基础类
+@import "./common.scss";
+
+// 非nvue的样式
+/* #ifndef APP-NVUE */
+@import "./vue.scss";
+/* #endif */

package/styles/theme.scss

@@ -0,0 +1,44 @@
+// 此文件为uvUI的主题变量，这些变量目前只能通过uni.scss引入才有效，另外由于
+// uni.scss中引入的样式会同时混入到全局样式文件和单独每一个页面的样式中，造成微信程序包太大，
+// 故uni.scss只建议放scss变量名相关样式，其他的样式可以通过main.js或者App.vue引入
+
+$uv-main-color: #303133;
+$uv-content-color: #606266;
+$uv-tips-color: #909193;
+$uv-light-color: #c0c4cc;
+$uv-border-color: #dadbde;
+$uv-bg-color: #f3f4f6;
+$uv-bg-light-color: #fffbf4;
+$uv-disabled-color: #c8c9cc;
+
+$uv-primary: #3c9cff;
+$uv-primary-dark: #398ade;
+$uv-primary-disabled: #9acafc;
+$uv-primary-light: #ecf5ff;
+
+$uv-warning: #f9ae3d;
+$uv-warning-dark: #f1a532;
+$uv-warning-disabled: #f9d39b;
+$uv-warning-light: #fdf6ec;
+
+$uv-success: #5ac725;
+$uv-success-dark: #53c21d;
+$uv-success-disabled: #a9e08f;
+$uv-success-light: #f5fff0;
+
+$uv-error: #f56c6c;
+$uv-error-dark: #e45656;
+$uv-error-disabled: #f7b2b2;
+$uv-error-light: #fef0f0;
+
+$uv-info: #909399;
+$uv-info-dark: #767a82;
+$uv-info-disabled: #c4c6c9;
+$uv-info-light: #f4f4f5;
+
+@mixin flex($direction: row) {
+	/* #ifndef APP-NVUE */
+	display: flex;
+	/* #endif */
+	flex-direction: $direction;
+}

package/styles/var.module.scss

@@ -0,0 +1,32 @@
+@import './color.scss';
+
+:export {
+  primary: $uv-primary;
+  primaryDark: $uv-primary-dark;
+  primaryDisabled: $uv-primary-disabled;
+  primaryLight: $uv-primary-light;
+  success: $uv-success;
+  successDark: $uv-success-dark;
+  successDisabled: $uv-success-disabled;
+  successLight: $uv-success-light;
+  warning: $uv-warning;
+  warningDark: $uv-warning-dark;
+  warningDisabled: $uv-warning-disabled;
+  warningLight: $uv-warning-light;
+  error: $uv-error;
+  errorDark: $uv-error-dark;
+  errorDisabled: $uv-error-disabled;
+  errorLight: $uv-error-light;
+  info: $uv-info;
+  infoDark: $uv-info-dark;
+  infoDisabled: $uv-info-disabled;
+  infoLight: $uv-info-light;
+  bgColor: $uv-bg-color;
+  bgLightColor: $uv-bg-light-color;
+  mainColor: $uv-main-color;
+  contentColor: $uv-content-color;
+  tipsColor: $uv-tips-color;
+  lightColor: $uv-light-color;
+  disabledColor: $uv-disabled-color;
+  borderColor: $uv-border-color;
+}

package/styles/vue.scss

@@ -0,0 +1,39 @@
+// 全局辅助样式（x-safe）。
+//
+// App 蒸汽模式不支持元素选择器、伪元素、后代选择器；
+// Web/小程序不需要这些限制，相关规则保留在条件编译块中。
+
+// 四个方向的安全区
+@each $d in top, right, bottom, left {
+	.uv-safe-area-inset-#{$d} {
+		padding-#{$d}: 0;
+		/* #ifdef APP */
+		padding-#{$d}: var(--uni-safe-area-inset-#{$d}, 0px);
+		/* #endif */
+		/* #ifdef WEB || H5 || MP */
+		padding-#{$d}: constant(safe-area-inset-#{$d});
+		padding-#{$d}: env(safe-area-inset-#{$d});
+		/* #endif */
+	}
+}
+
+/* #ifdef WEB || H5 */
+// 提升 H5 端 uni.toast() 的层级，避免被弹层遮盖
+uni-toast {
+	z-index: 10090;
+}
+uni-toast .uni-toast {
+	z-index: 10090;
+}
+
+// 隐藏 scroll-view 滚动条
+::-webkit-scrollbar {
+	display: none;
+	width: 0 !important;
+	height: 0 !important;
+	-webkit-appearance: none;
+	background: transparent;
+}
+/* #endif */
+
+

package/theme.scss

@@ -0,0 +1,2 @@
+// 主题变量入口（兼容旧路径）：源文件位于 styles/theme.scss
+@import "./styles/theme.scss";

package/types/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @zfqh/uview-x 全局注入类型声明。
+ *
+ * 入口 `index.ts` 会把 `$uv` 挂到 `uni.$uv` 与 `app.config.globalProperties.$uv`；
+ * `utils/locale.ts` 的 `createI18n` 会把 i18n 实例挂到 `uni.$i18n`。
+ * 本文件为 uni 全局对象与 Vue 组件实例补充类型，并声明入口默认插件类型与 i18n 公共 API。
+ */
+import type { App } from 'vue';
+import type { I18n, I18nOptions } from 'vue-i18n';
+
+type UviewX$uv = (typeof import('../utils'))['$uv'];
+
+declare global {
+  namespace UniNamespace {
+    interface GetAppBaseInfoResult {
+      /** uni-app x App 返回的语言，如 en / zh-Hans / zh-Hant / fr / es（经典端用 language 兜底） */
+      appLanguage?: string;
+    }
+  }
+
+  interface Uni {
+    $uv: UviewX$uv;
+    /** `createI18n` 创建的全局 i18n 实例 */
+    $i18n?: I18n;
+  }
+}
+
+declare module '*.ttf' {
+  const src: string;
+  export default src;
+}
+
+declare module '*.otf' {
+  const src: string;
+  export default src;
+}
+
+declare module 'vue' {
+  interface ComponentCustomProperties {
+    $uv: UviewX$uv;
+  }
+}
+
+/**
+ * 入口模块声明：包内 `types` 指向本文件时，消费者仍可从入口
+ * `import { config, createI18n, useI18n, setLocale, ... } from '@zfqh/uview-x'` 获得类型提示。
+ *
+ * 这里声明 `config` 与 4 个 i18n 公共函数 + `useI18n`；包内其余 helper、内部状态与 default/fallback 语言均不对外导出。
+ */
+declare module '@zfqh/uview-x' {
+  /** 运行时配置；颜色通过 `config.color` 访问（键为 camelCase，如 `primary`） */
+  export const config: (typeof import('../utils'))['config'];
+  /** 创建 i18n 实例并挂到 `uni.$i18n`（自动合并 `locales/` 内置组件语言包，用户同名 key 覆盖） */
+  export function createI18n(opts: I18nOptions): I18n;
+  /** 获取当前语言（storage `UNI_LOCALE` → `uni.getLocale` → `getAppBaseInfo` → `zh-Hans`） */
+  export function getLocale(): string;
+  /** 按当前语言取词（优先全局语言包，其次组件内置语言包；支持 `a.b.c` 路径与 `{name}` 占位符） */
+  export function getLocaleMessage(key: string, values?: Record<string, string | number>): string;
+  /** 设置当前语言：更新内部 localeState 与 `uni.$i18n.global.locale`，写 storage `UNI_LOCALE`，最后调用 `uni.setLocale` */
+  export function setLocale(locale: string): void;
+  /** i18n hook：未创建 i18n 实例时降级读组件内置语言包，不会抛错 */
+  export const useI18n: typeof import('vue-i18n').useI18n;
+}
+
+declare const plugin: { install: (app: App) => void };
+export default plugin;