@zfqh/uview-x 0.0.4 → 0.0.6

package/utils/locale.ts

@@ -2,10 +2,13 @@ import { ref } from 'vue';
 import type { Ref } from 'vue';
 import { createI18n as _createI18n } from 'vue-i18n';
 import type { I18n, I18nOptions } from 'vue-i18n';
-import { getBuiltinMessage, mergeComponentMessages } from '../locales';
+import { getBuiltinMessage, mergeDefaultMessages } from '../locales';
 
 /**
- * 国际化能力（组件内置语言包 + 4 个公共 API）。
+ * 国际化能力（默认中文 + 可选语言包 + 4 个公共 API）。
+ *
+ * 默认语言只有简体中文（`zh-CN`），`createI18n` 只注入并深合并内置中文；
+ * 英文等其他语言为独立语言包（`locales/en-US.ts`），由使用方显式引入后合并进 `messages`。
  *
  * 公共 API（由 `utils/index.ts` 导出到包入口）：
  * `createI18n`、`getLocale`、`getLocaleMessage`、`setLocale`。
@@ -32,45 +35,17 @@ interface RefLike<T> {
   value: T;
 }
 
-/**
- * `uni` 全局对象的最小运行时视图（含 i18n 实例挂载点）。
- *
- * 对外 `$i18n` 声明在 `types/index.d.ts`；这里再留一份最小结构，保证其他包深引用
- * `@zfqh/uview-x/utils/locale`（不会加载本包 types 入口）时仍能编译。
- * 纯 Node / 单测环境可能没有 `uni` 全局，所有访问都要容错。
- */
-interface UniWithI18n {
-  $i18n?: I18n;
-  getStorageSync?: (key: string) => unknown;
-  setStorageSync?: (key: string, value: unknown) => void;
-  getLocale?: () => string;
-  setLocale?: (locale: string) => void;
-  getAppBaseInfo?: () => { appLanguage?: string; language?: string };
-}
-
-/** 读取 uni 全局对象；不存在时返回 undefined */
-function getUni(): UniWithI18n | undefined {
-  return typeof uni === 'undefined' ? undefined : (uni as unknown as UniWithI18n);
-}
-
-/** 读取挂到 `uni.$i18n` 上的 i18n 实例 */
-function getUniI18n(): I18n | undefined {
-  const uniApi = getUni();
-  return uniApi ? uniApi.$i18n : undefined;
-}
-
 /** 语言持久化 key：App 端切换语言可能触发重启，必须先落盘 */
 const STORAGE_KEY = 'UNI_LOCALE';
 
 /** 回退语言（内部使用，不对外导出） */
-const fallbackLocale = 'zh-Hans';
+const fallbackLocale = 'zh-CN';
 
 /** 读取上次选择的语言；storage 不可用或无有效值时返回空字符串 */
 function readStorageLocale(): string {
-  const uniApi = getUni();
-  if (uniApi && typeof uniApi.getStorageSync === 'function') {
+  if (typeof uni !== 'undefined' && typeof uni.getStorageSync === 'function') {
     try {
-      const stored: unknown = uniApi.getStorageSync(STORAGE_KEY);
+      const stored: unknown = uni.getStorageSync(STORAGE_KEY);
       if (typeof stored === 'string' && stored) {
         return stored;
       }
@@ -99,26 +74,19 @@ function readStorageLocale(): string {
  *
  * 顺序：
  * 1. 本地存储 `UNI_LOCALE`（用户上次通过 `setLocale` 选择的语言）；
- * 2. `uni.getLocale()`（H5 / 小程序 / 经典 App）；
- * 3. `uni.getAppBaseInfo().appLanguage`（uni-app x App）；
- * 4. `uni.getAppBaseInfo().language`（经典端已废弃字段，兜底）；
- * 5. `zh-Hans`。
+ * 2. `uni.getAppBaseInfo().language`；
+ * 3. `uni.getAppBaseInfo().osLanguage`；
+ * 4. `uni.getAppBaseInfo().hostLanguage`；
+ * 5. `zh-CN`。
  */
 export function getLocale(): string {
   const stored = readStorageLocale();
   if (stored) {
     return stored;
   }
-  const uniApi = getUni();
-  if (uniApi && typeof uniApi.getLocale === 'function') {
-    const systemLocale = uniApi.getLocale();
-    if (systemLocale) {
-      return systemLocale;
-    }
-  }
-  if (uniApi && typeof uniApi.getAppBaseInfo === 'function') {
-    const info = uniApi.getAppBaseInfo();
-    const systemLocale = info.appLanguage || info.language;
+  if (typeof uni !== 'undefined' && typeof uni.getAppBaseInfo === 'function') {
+    const info = uni.getAppBaseInfo() as { language?: string; osLanguage?: string; hostLanguage?: string };
+    const systemLocale = info.language || info.osLanguage || info.hostLanguage;
     if (systemLocale) {
       return systemLocale;
     }
@@ -154,7 +122,10 @@ function isI18nGlobalLike(value: unknown): value is I18nGlobalLike {
 
 /** 当前 `uni.$i18n.global` 的运行时视图；实例不存在时返回 undefined */
 export function getI18nGlobal(): I18nGlobalLike | undefined {
-  const global = getUniI18n()?.global;
+  if (typeof uni === 'undefined') {
+    return undefined;
+  }
+  const global = uni.$i18n?.global;
   return isI18nGlobalLike(global) ? global : undefined;
 }
 
@@ -186,8 +157,9 @@ function getMessage(messages: I18nMessages, locale: string, key: string): string
 /**
  * 翻译（App / 小程序 / 无 i18n 实例时的统一实现）。
  *
- * locale 优先级：storage `UNI_LOCALE` → `uni.$i18n.global.locale` → 内部 `localeState` → `zh-Hans`；
- * 消息优先级：全局语言包（当前语言 → 回退语言）→ 组件内置语言包（当前语言 → 回退语言）→ key。
+ * locale 优先级：storage `UNI_LOCALE` → `uni.$i18n.global.locale` → 内部 `localeState` → `zh-CN`；
+ * 消息优先级：全局语言包（当前语言 → 中文回退）→ 内置中文默认语言包 → key。
+ * 其他语言（如英文）由使用方在 `createI18n` 中显式合并，未合并时回退中文。
  * storage 优先用于 nvue 等页面上下文模块副本不同、实例未共享的场景（setLocale 已先落盘）。
  */
 export function appTranslate(key: string, values?: Record<string, string | number>): string {
@@ -206,14 +178,18 @@ export function appTranslate(key: string, values?: Record<string, string | numbe
 /**
  * 创建 i18n 实例并挂到 `uni.$i18n`。
  *
- * - 自动把组件内置语言包合并进 `opts.messages`（用户同名 key 优先）；
+ * - 只注入内置默认中文：`mergeDefaultMessages(opts.messages)` 仅深合并 `zh-CN`，
+ *   用户同名 key 优先；其他 locale（如显式引入的 `en-US`）原样透传，不做内置补全；
+ * - 未显式传 `fallbackLocale` 时默认 `zh-CN`，未合并的语言回退中文；
  * - App 端不依赖 vue-i18n 注入，直接把 `global.t` 替换为包内 `appTranslate`；
  * - 用 `opts.locale` 初始化内部 `localeState`，无实例时也能保持语言一致。
  */
 export function createI18n(opts: I18nOptions): I18n {
-  const mergedMessages: I18nMessages = mergeComponentMessages(opts.messages as I18nMessages | undefined);
+  const mergedMessages: I18nMessages = mergeDefaultMessages(opts.messages as I18nMessages | undefined);
   const mergedOptions: I18nOptions = {
     ...opts,
+    // 默认回退中文；显式传入的值（含 false）优先
+    fallbackLocale: opts.fallbackLocale ?? fallbackLocale,
     // #ifdef WEB || H5
     // vue-i18n 9.1.9 的 globalInjection 默认 false；H5 开启后 app.use(i18n) 会注入
     // `app.config.globalProperties.$i18n`，useI18n 才能检测到实例并走 vue-i18n 分支
@@ -226,9 +202,8 @@ export function createI18n(opts: I18nOptions): I18n {
   // #ifdef APP
   i18n.global.t = appTranslate as unknown as typeof i18n.global.t;
   // #endif
-  const uniApi = getUni();
-  if (uniApi) {
-    uniApi.$i18n = i18n;
+  if (typeof uni !== 'undefined') {
+    uni.$i18n = i18n;
   }
   if (typeof opts.locale === 'string' && opts.locale) {
     localeState.value = opts.locale;
@@ -269,17 +244,16 @@ export function setLocale(locale: string): void {
       // 实例不可写时忽略，继续持久化
     }
   }
-  const uniApi = getUni();
-  if (uniApi && typeof uniApi.setStorageSync === 'function') {
+  if (typeof uni !== 'undefined' && typeof uni.setStorageSync === 'function') {
     try {
-      uniApi.setStorageSync(STORAGE_KEY, locale);
+      uni.setStorageSync(STORAGE_KEY, locale);
     } catch (e) {
       // storage 不可用时忽略
     }
   }
-  if (uniApi && typeof uniApi.setLocale === 'function') {
+  if (typeof uni !== 'undefined' && typeof uni.setLocale === 'function') {
     try {
-      uniApi.setLocale(locale);
+      uni.setLocale(locale);
     } catch (e) {
       // App 端 setLocale 可能触发重启 / 平台不支持，忽略
     }
@@ -288,7 +262,7 @@ export function setLocale(locale: string): void {
 
 /**
  * 按当前语言取词（公共 API）。
- * 统一走 `appTranslate`（优先读 `uni.$i18n` 语言包，其次组件内置语言包），
+ * 统一走 `appTranslate`（优先读 `uni.$i18n` 语言包，其次默认中文语言包），
  * 避免小程序端 vue-i18n runtime-only 构建缺少消息编译器导致翻译空白 / 占位符不插值。
  */
 export function getLocaleMessage(key: string, values?: Record<string, string | number>): string {

package/utils/scrollbar.ts

@@ -0,0 +1,181 @@
+/**
+ * H5 全局滚动条样式（仅 H5 运行时注入）。
+ *
+ * - `false`（默认）：隐藏滚动条（保持原 reset 的默认效果）；
+ * - `true`：使用默认滚动条样式；
+ * - 对象：在默认样式基础上覆盖 `::-webkit-scrollbar` 及其 thumb / track。
+ *
+ * 注入入口见 `index.ts` 的 `install`（H5 条件编译）。
+ */
+
+/** 单组滚动条 CSS 样式：camelCase / kebab-case 均可；number 默认按 px 处理（无单位属性除外） */
+export type UviewXScrollbarStyle = Record<string, string | number>;
+
+/** 滚动条自定义样式：默认合并 / 扩展 ::-webkit-scrollbar 及其 thumb / track */
+export interface UviewXScrollbarOptions {
+  /** ::-webkit-scrollbar-thumb 样式，覆盖默认 thumb 样式 */
+  thumb?: UviewXScrollbarStyle;
+  /** ::-webkit-scrollbar-track 样式，覆盖默认 track 样式 */
+  track?: UviewXScrollbarStyle;
+  /** 其余键作为 ::-webkit-scrollbar 样式，覆盖默认宽高 */
+  [property: string]: string | number | UviewXScrollbarStyle | undefined;
+}
+
+export type UviewXScrollbar = boolean | UviewXScrollbarOptions;
+
+/** 注入到 `<style>` 的元素 id；重复设置时替换同一节点 */
+const SCROLLBAR_STYLE_ID = 'uv-scrollbar-style';
+
+/** `false`：隐藏滚动条 */
+const HIDDEN_SCROLLBAR_STYLE: UviewXScrollbarStyle = {
+  display: 'none',
+  width: '0 !important',
+  height: '0 !important',
+  WebkitAppearance: 'none',
+  background: 'transparent',
+};
+
+/** `true` / 对象的默认基础样式 */
+const DEFAULT_SCROLLBAR_STYLE: UviewXScrollbarStyle = {
+  width: 6,
+  height: 6,
+};
+
+const DEFAULT_SCROLLBAR_THUMB_STYLE: UviewXScrollbarStyle = {
+  background: '#c0c4cc',
+  borderRadius: 3,
+};
+
+const DEFAULT_SCROLLBAR_TRACK_STYLE: UviewXScrollbarStyle = {
+  background: 'transparent',
+};
+
+/** 数值不补 px 的 CSS 属性（已转换为 kebab-case） */
+const UNITLESS_PROPERTIES = new Set([
+  'opacity',
+  'z-index',
+  'font-weight',
+  'line-height',
+  'flex',
+  'flex-grow',
+  'flex-shrink',
+  'order',
+  'zoom',
+  'animation-iteration-count',
+  'column-count',
+  'tab-size',
+]);
+
+/** camelCase → kebab-case；已是 kebab-case 的属性保持不变 */
+function toKebabCase(property: string): string {
+  return property.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);
+}
+
+function formatStyleValue(property: string, value: string | number): string {
+  if (typeof value === 'number' && !UNITLESS_PROPERTIES.has(toKebabCase(property))) {
+    return `${value}px`;
+  }
+  return String(value);
+}
+
+/** 把样式对象转换为 CSS 声明串 */
+function styleToDeclarations(style: UviewXScrollbarStyle): string {
+  const declarations: string[] = [];
+  for (const property of Object.keys(style)) {
+    const value = style[property];
+    if (typeof value !== 'string' && typeof value !== 'number') {
+      continue;
+    }
+    declarations.push(`${toKebabCase(property)}: ${formatStyleValue(property, value)};`);
+  }
+  return declarations.join(' ');
+}
+
+function toRule(selector: string, style: UviewXScrollbarStyle): string {
+  const declarations = styleToDeclarations(style);
+  return declarations ? `${selector} { ${declarations} }` : '';
+}
+
+function isScrollbarStyle(value: unknown): value is UviewXScrollbarStyle {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function mergeScrollbarStyle(base: UviewXScrollbarStyle, override?: UviewXScrollbarStyle): UviewXScrollbarStyle {
+  return override ? { ...base, ...override } : { ...base };
+}
+
+/**
+ * 生成滚动条 CSS。
+ *
+ * - `false` / `undefined`：隐藏滚动条；
+ * - `true`：默认滚动条样式；
+ * - 对象：默认样式 + 用户覆盖；空对象等价 `true`。
+ */
+export function buildScrollbarCss(scrollbar: UviewXScrollbar): string {
+  if (!scrollbar) {
+    return toRule('::-webkit-scrollbar', HIDDEN_SCROLLBAR_STYLE);
+  }
+  if (scrollbar === true) {
+    return [
+      toRule('::-webkit-scrollbar', DEFAULT_SCROLLBAR_STYLE),
+      toRule('::-webkit-scrollbar-thumb', DEFAULT_SCROLLBAR_THUMB_STYLE),
+      toRule('::-webkit-scrollbar-track', DEFAULT_SCROLLBAR_TRACK_STYLE),
+    ]
+      .filter(Boolean)
+      .join('\n');
+  }
+
+  // 自定义样式：`thumb` / `track` 之外的键作为基础样式
+  const baseOverride: UviewXScrollbarStyle = {};
+  let thumbOverride: UviewXScrollbarStyle | undefined;
+  let trackOverride: UviewXScrollbarStyle | undefined;
+  for (const property of Object.keys(scrollbar)) {
+    const value = scrollbar[property];
+    if (property === 'thumb' || property === 'track') {
+      if (isScrollbarStyle(value)) {
+        if (property === 'thumb') {
+          thumbOverride = value;
+        } else {
+          trackOverride = value;
+        }
+      }
+      continue;
+    }
+    if (typeof value === 'string' || typeof value === 'number') {
+      baseOverride[property] = value;
+    }
+  }
+
+  return [
+    toRule('::-webkit-scrollbar', mergeScrollbarStyle(DEFAULT_SCROLLBAR_STYLE, baseOverride)),
+    toRule('::-webkit-scrollbar-thumb', mergeScrollbarStyle(DEFAULT_SCROLLBAR_THUMB_STYLE, thumbOverride)),
+    toRule('::-webkit-scrollbar-track', mergeScrollbarStyle(DEFAULT_SCROLLBAR_TRACK_STYLE, trackOverride)),
+  ]
+    .filter(Boolean)
+    .join('\n');
+}
+
+/**
+ * 应用 H5 滚动条样式：替换 `#uv-scrollbar-style` 节点；其它平台不会注入任何代码。
+ *
+ * `document` 不存在（SSR / Node 单测）时静默返回。
+ */
+export function applyScrollbar(scrollbar: UviewXScrollbar): void {
+  // #ifdef WEB || H5
+  if (typeof document === 'undefined' || !document.head) {
+    return;
+  }
+  const existing = document.getElementById(SCROLLBAR_STYLE_ID);
+  if (existing && existing.parentNode) {
+    existing.parentNode.removeChild(existing);
+  }
+  const css = buildScrollbarCss(scrollbar);
+  if (!css) {
+    return;
+  }
+  const styleElement = document.createElement('style');
+  styleElement.id = SCROLLBAR_STYLE_ID;
+  styleElement.textContent = css;
+  document.head.appendChild(styleElement);
+  // #endif
+}

package/styles/color.scss

@@ -1,33 +0,0 @@
-$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/components.scss

@@ -1,19 +0,0 @@
-// 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/vue.scss

@@ -1,39 +0,0 @@
-// 全局辅助样式（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

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