@hlw-uni/mp-vue 2.1.50 → 2.1.52

package/dist/composables/theme/appearance.d.ts

@@ -1,8 +1,9 @@
 /**
  * 外观模式 — 浅色 / 深色 / 跟随系统
  *
- * 提供一套语义化 CSS 变量（--bg-page, --surface-card, --text-primary ...），
- * 页面通过 hlw-page 的 `:page-style` 注入到 `page` 元素，让内部组件和样式统一消费。
+ * 提供一套语义化 CSS 变量（--bg-page, --surface-card, --text-primary ...）。
+ * 默认不通过 useThemePageStyle 注入，业务项目应在全局 CSS 中声明这些变量，
+ * 避免运行时 page-meta 覆盖业务侧样式。
  *
  * 使用指南：
  * - 业务样式里用 `var(--text-primary)` 代替硬编码 `#0f172a`

package/dist/composables/theme/index.d.ts

@@ -5,21 +5,20 @@ import { ComputedRef } from 'vue';
  */
 export declare const THEME_CHANGE_EVENT = "hlw:theme-change";
 /**
- * 只注入会随主题变化的变量（字号档位、主题色、外观模式）。
+ * 只注入运行时配置变量（字号档位、主题色）。
  *
- * 语义排版 token（--text-title-size 等）是静态值、不随主题变化，
- * 放在项目的全局 CSS（static/css/style.scss）里作为 page{} 默认值即可，
- * 让业务侧可以自由 override，不被运行时注入覆盖。
+ * 页面背景、卡片色、文字色、边框色等业务视觉变量统一由项目全局 CSS
+ * （static/css/style.scss）控制，避免 page-meta 运行时样式覆盖业务侧配置。
  */
 export declare function buildThemeStyle(): string;
 /**
  * 获取主题样式字符串，用于注入 <page-meta :page-style>。
  *
- * 实现走 pinia store 响应式：store.scale / primaryColor / appearance 任一变化
+ * 实现走 pinia store 响应式：store.scale / primaryColor 任一变化
  * → computed 重算 → page-meta 自动 setData。
  *
  * 注：早期版本用 uni.$emit + onMounted+uni.$on 事件总线驱动，在 vue3 + 小程序部分
- * 基础库下 emit 后 ref 不响应（导致字号 / 主题色 / 外观切换不生效）。已改成响应式驱动。
+ * 基础库下 emit 后 ref 不响应（导致字号 / 主题色切换不生效）。已改成响应式驱动。
  */
 export declare function useThemePageStyle(): {
     themePageStyle: ComputedRef<string>;

package/dist/index.js

@@ -1489,8 +1489,7 @@ var __publicField = (obj, key, value) => {
   function buildThemeStyle() {
     return varsToStyle({
       ...getCurrentFontVars(),
-      ...getCurrentThemeVars(),
-      ...getCurrentAppearanceVars()
+      ...getCurrentThemeVars()
     });
   }
   function useThemePageStyle() {
@@ -1498,7 +1497,6 @@ var __publicField = (obj, key, value) => {
     const themePageStyle = vue.computed(() => {
       void store.scale;
       void store.primaryColor;
-      void store.appearance;
       return buildThemeStyle();
     });
     return { themePageStyle };

package/dist/index.mjs

@@ -1488,8 +1488,7 @@ const THEME_CHANGE_EVENT = "hlw:theme-change";
 function buildThemeStyle() {
   return varsToStyle({
     ...getCurrentFontVars(),
-    ...getCurrentThemeVars(),
-    ...getCurrentAppearanceVars()
+    ...getCurrentThemeVars()
   });
 }
 function useThemePageStyle() {
@@ -1497,7 +1496,6 @@ function useThemePageStyle() {
   const themePageStyle = computed(() => {
     void store.scale;
     void store.primaryColor;
-    void store.appearance;
     return buildThemeStyle();
   });
   return { themePageStyle };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hlw-uni/mp-vue",
-    "version": "2.1.50",
+    "version": "2.1.52",
     "description": "hlw-uni 小程序运行时 — Vue 组件 + composables + theme + http + 工具集（合并自原 mp-core）",
     "main": "dist/index.js",
     "module": "dist/index.mjs",

package/src/composables/theme/appearance.ts

@@ -1,8 +1,9 @@
 /**
  * 外观模式 — 浅色 / 深色 / 跟随系统
  *
- * 提供一套语义化 CSS 变量（--bg-page, --surface-card, --text-primary ...），
- * 页面通过 hlw-page 的 `:page-style` 注入到 `page` 元素，让内部组件和样式统一消费。
+ * 提供一套语义化 CSS 变量（--bg-page, --surface-card, --text-primary ...）。
+ * 默认不通过 useThemePageStyle 注入，业务项目应在全局 CSS 中声明这些变量，
+ * 避免运行时 page-meta 覆盖业务侧样式。
  *
  * 使用指南：
  * - 业务样式里用 `var(--text-primary)` 代替硬编码 `#0f172a`

package/src/composables/theme/index.ts

@@ -5,7 +5,6 @@ import { useThemeStore } from "../../stores/theme";
 const { varsToStyle } = useColor();
 import { getCurrentFontVars } from "./font";
 import { getCurrentThemeVars } from "./palette";
-import { getCurrentAppearanceVars } from "./appearance";
 
 /**
  * @deprecated 历史事件名；现已改用 pinia store 响应式驱动，emit 不再有效。
@@ -14,38 +13,35 @@ import { getCurrentAppearanceVars } from "./appearance";
 export const THEME_CHANGE_EVENT = "hlw:theme-change";
 
 /**
- * 只注入会随主题变化的变量（字号档位、主题色、外观模式）。
+ * 只注入运行时配置变量（字号档位、主题色）。
  *
- * 语义排版 token（--text-title-size 等）是静态值、不随主题变化，
- * 放在项目的全局 CSS（static/css/style.scss）里作为 page{} 默认值即可，
- * 让业务侧可以自由 override，不被运行时注入覆盖。
+ * 页面背景、卡片色、文字色、边框色等业务视觉变量统一由项目全局 CSS
+ * （static/css/style.scss）控制，避免 page-meta 运行时样式覆盖业务侧配置。
  */
 export function buildThemeStyle(): string {
     return varsToStyle({
         ...getCurrentFontVars(),
         ...getCurrentThemeVars(),
-        ...getCurrentAppearanceVars(),
     });
 }
 
 /**
  * 获取主题样式字符串，用于注入 <page-meta :page-style>。
  *
- * 实现走 pinia store 响应式：store.scale / primaryColor / appearance 任一变化
+ * 实现走 pinia store 响应式：store.scale / primaryColor 任一变化
  * → computed 重算 → page-meta 自动 setData。
  *
  * 注：早期版本用 uni.$emit + onMounted+uni.$on 事件总线驱动，在 vue3 + 小程序部分
- * 基础库下 emit 后 ref 不响应（导致字号 / 主题色 / 外观切换不生效）。已改成响应式驱动。
+ * 基础库下 emit 后 ref 不响应（导致字号 / 主题色切换不生效）。已改成响应式驱动。
  */
 export function useThemePageStyle() {
     const store = useThemeStore();
     const themePageStyle = computed(() => {
-        // 显式 track 三个响应字段，触发 computed 重算
-        // setScale / setTheme / setAppearance 内部已先 set storage 再改 ref，
+        // 显式 track 两个响应字段，触发 computed 重算
+        // setScale / setTheme 内部已先 set storage 再改 ref，
         // 所以 buildThemeStyle 从 storage 读到的一定是最新值
         void store.scale;
         void store.primaryColor;
-        void store.appearance;
         return buildThemeStyle();
     });
     return { themePageStyle };