stellar-ui-plus 1.25.1 → 1.25.3

package/components/ste-watermark/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `width` | 水印的宽度， content 的默认值是它自己的宽度 | `number` | `120` | - | `v1.18.3` |

package/components/ste-watermark/README.md

@@ -4,9 +4,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础用法
+## 基础用法
 
 默认水印会覆盖整个页面，若想局部使用可配置`fullPage`属性
 
@@ -16,7 +16,7 @@
 </template>
 ```
 
-#### 多行水印
+## 多行水印
 
 使用 "content" 设置一个字符串数组来指定多行文本水印内容
 
@@ -28,7 +28,7 @@
 </template>
 ```
 
-#### 图片水印
+## 图片水印
 
 通过 'image' 指定图像地址。 为了确保图像清晰展示而不是被拉伸，请设置宽度和高度，建议使用至少两倍的宽度和高度的图片来保证显示效果。
 
@@ -42,11 +42,9 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### Font Props
+## Font Props
 
 | 属性名       | 说明     | 类型     | 默认值            | 可选值                            | 支持版本  |
 | ------------ | -------- | -------- | ----------------- | --------------------------------- | --------- |

package/config/font-size.ts

@@ -54,6 +54,9 @@ class FontSize {
         return FontSize.config.max;
     }
     constructor() {
+        // 初始化 changes 数组，防止构造函数提前 return 导致问题
+        this._changes = [];
+
         if (process.env.NODE_ENV == 'test') {
             return;
         }

package/config/index.ts

@@ -2,6 +2,11 @@ import useFontSize from './font-size';
 
 const { config, fontSizeStyle } = useFontSize();
 
+// 防御性检查：确保 config 存在
+if (!config) {
+    throw new Error('FontSize config initialization failed');
+}
+
 class Options {
     get minSize() {
         return config.min;

package/index.ts

@@ -36,6 +36,8 @@ import steDateUser from "./components/ste-date-user/ste-date-user.vue"
 export const SteDateUser = steDateUser
 import steDrag from "./components/ste-drag/ste-drag.vue"
 export const SteDrag = steDrag
+import steDragSort from "./components/ste-drag-sort/ste-drag-sort.vue"
+export const SteDragSort = steDragSort
 import steDropdownMenu from "./components/ste-dropdown-menu/ste-dropdown-menu.vue"
 export const SteDropdownMenu = steDropdownMenu
 import steDropdownMenuItem from "./components/ste-dropdown-menu-item/ste-dropdown-menu-item.vue"
@@ -70,6 +72,8 @@ import steLogin from "./components/ste-login/ste-login.vue"
 export const SteLogin = steLogin
 import steLoginInfo from "./components/ste-login-info/ste-login-info.vue"
 export const SteLoginInfo = steLoginInfo
+import steMarquee from "./components/ste-marquee/ste-marquee.vue"
+export const SteMarquee = steMarquee
 import steMediaPreview from "./components/ste-media-preview/ste-media-preview.vue"
 export const SteMediaPreview = steMediaPreview
 import steMessageBox from "./components/ste-message-box/ste-message-box.vue"

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "stellar-ui-plus",
-    "version": "1.25.1",
+    "version": "1.25.3",
     "description": "",
     "author": "",
     "license": "MIT",

package/types/components.d.ts

@@ -17,6 +17,7 @@ import steCustomKeyboard from "../components/ste-custom-keyboard/ste-custom-keyb
 import steDatePicker from "../components/ste-date-picker/ste-date-picker.vue"
 import steDateUser from "../components/ste-date-user/ste-date-user.vue"
 import steDrag from "../components/ste-drag/ste-drag.vue"
+import steDragSort from "../components/ste-drag-sort/ste-drag-sort.vue"
 import steDropdownMenu from "../components/ste-dropdown-menu/ste-dropdown-menu.vue"
 import steDropdownMenuItem from "../components/ste-dropdown-menu-item/ste-dropdown-menu-item.vue"
 import steFilterTool from "../components/ste-filter-tool/ste-filter-tool.vue"
@@ -34,6 +35,7 @@ import steLineChart from "../components/ste-line-chart/ste-line-chart.vue"
 import steLoading from "../components/ste-loading/ste-loading.vue"
 import steLogin from "../components/ste-login/ste-login.vue"
 import steLoginInfo from "../components/ste-login-info/ste-login-info.vue"
+import steMarquee from "../components/ste-marquee/ste-marquee.vue"
 import steMediaPreview from "../components/ste-media-preview/ste-media-preview.vue"
 import steMessageBox from "../components/ste-message-box/ste-message-box.vue"
 import steNavbar from "../components/ste-navbar/ste-navbar.vue"
@@ -111,6 +113,7 @@ import steWatermark from "../components/ste-watermark/ste-watermark.vue"
 		SteDatePicker: typeof steDatePicker;
 		SteDateUser: typeof steDateUser;
 		SteDrag: typeof steDrag;
+		SteDragSort: typeof steDragSort;
 		SteDropdownMenu: typeof steDropdownMenu;
 		SteDropdownMenuItem: typeof steDropdownMenuItem;
 		SteFilterTool: typeof steFilterTool;
@@ -128,6 +131,7 @@ import steWatermark from "../components/ste-watermark/ste-watermark.vue"
 		SteLoading: typeof steLoading;
 		SteLogin: typeof steLogin;
 		SteLoginInfo: typeof steLoginInfo;
+		SteMarquee: typeof steMarquee;
 		SteMediaPreview: typeof steMediaPreview;
 		SteMessageBox: typeof steMessageBox;
 		SteNavbar: typeof steNavbar;

package/types/refComponents.d.ts

@@ -17,6 +17,7 @@ import steCustomKeyboard from "../components/ste-custom-keyboard/ste-custom-keyb
 import steDatePicker from "../components/ste-date-picker/ste-date-picker.vue"
 import steDateUser from "../components/ste-date-user/ste-date-user.vue"
 import steDrag from "../components/ste-drag/ste-drag.vue"
+import steDragSort from "../components/ste-drag-sort/ste-drag-sort.vue"
 import steDropdownMenu from "../components/ste-dropdown-menu/ste-dropdown-menu.vue"
 import steDropdownMenuItem from "../components/ste-dropdown-menu-item/ste-dropdown-menu-item.vue"
 import steFilterTool from "../components/ste-filter-tool/ste-filter-tool.vue"
@@ -34,6 +35,7 @@ import steLineChart from "../components/ste-line-chart/ste-line-chart.vue"
 import steLoading from "../components/ste-loading/ste-loading.vue"
 import steLogin from "../components/ste-login/ste-login.vue"
 import steLoginInfo from "../components/ste-login-info/ste-login-info.vue"
+import steMarquee from "../components/ste-marquee/ste-marquee.vue"
 import steMediaPreview from "../components/ste-media-preview/ste-media-preview.vue"
 import steMessageBox from "../components/ste-message-box/ste-message-box.vue"
 import steNavbar from "../components/ste-navbar/ste-navbar.vue"
@@ -106,6 +108,7 @@ export type RefCustomKeyboard = InstanceType<typeof steCustomKeyboard>
 export type RefDatePicker = InstanceType<typeof steDatePicker>
 export type RefDateUser = InstanceType<typeof steDateUser>
 export type RefDrag = InstanceType<typeof steDrag>
+export type RefDragSort = InstanceType<typeof steDragSort>
 export type RefDropdownMenu = InstanceType<typeof steDropdownMenu>
 export type RefDropdownMenuItem = InstanceType<typeof steDropdownMenuItem>
 export type RefFilterTool = InstanceType<typeof steFilterTool>
@@ -123,6 +126,7 @@ export type RefLineChart = InstanceType<typeof steLineChart>
 export type RefLoading = InstanceType<typeof steLoading>
 export type RefLogin = InstanceType<typeof steLogin>
 export type RefLoginInfo = InstanceType<typeof steLoginInfo>
+export type RefMarquee = InstanceType<typeof steMarquee>
 export type RefMediaPreview = InstanceType<typeof steMediaPreview>
 export type RefMessageBox = InstanceType<typeof steMessageBox>
 export type RefNavbar = InstanceType<typeof steNavbar>

package/utils/System.ts

@@ -1,3 +1,27 @@
+// 模块级缓存，所有实例共享，App 生命周期内只调用一次系统 API
+// 定义 WindowInfo 类型，包含 getWindowInfo 和 getSystemInfoSync 返回的共同字段
+interface WindowInfo {
+    pixelRatio: number;
+    safeArea: {
+        bottom: number;
+        height: number;
+        left: number;
+        right: number;
+        top: number;
+        width: number;
+    };
+    safeAreaInsets?: { bottom: number };
+    screenHeight: number;
+    screenTop?: number;
+    screenWidth: number;
+    statusBarHeight: number;
+    windowHeight: number;
+    windowWidth: number;
+    [key: string]: any;
+}
+
+let _cachedWindowInfo: WindowInfo | null = null;
+
 export default class System {
     /**
      * 获取设备设置
@@ -39,12 +63,14 @@ export default class System {
     }
 
     /**
-     * 获取窗口信息
+     * 获取窗口信息（结果已缓存，同一 App 生命周期内只调用一次系统 API）
      */
     static getWindowInfo() {
+        if (_cachedWindowInfo) return _cachedWindowInfo;
+
         // 测试环境判断
         if (process.env.NODE_ENV == 'test' || process.env.UNI_APP_NAME == 'stellar-debug') {
-            let windowInfo = {
+            let windowInfo: WindowInfo = {
                 pixelRatio: 3,
                 safeArea: {
                     bottom: 778,
@@ -65,21 +91,30 @@ export default class System {
             windowInfo.safeAreaInsets = {
                 bottom: windowInfo.screenHeight - windowInfo.safeArea.bottom,
             };
-            return windowInfo;
+            _cachedWindowInfo = windowInfo;
+            return _cachedWindowInfo;
         }
-        if (process.env.NODE_ENV != 'test') {
-            // #ifdef MP-WEIXIN
-            let windowInfo = wx.getWindowInfo();
-            windowInfo.safeAreaInsets = {
-                bottom: (windowInfo?.screenHeight ?? 812) - (windowInfo?.safeArea?.bottom ?? 778),
-            };
-            return windowInfo;
-            // #endif
 
-            // #ifndef MP-WEIXIN
-            return uni.getSystemInfoSync();
-            // #endif
-        }
+        // #ifdef MP-WEIXIN
+        let windowInfo: WindowInfo = wx.getWindowInfo();
+        windowInfo.safeAreaInsets = {
+            bottom: (windowInfo?.screenHeight ?? 812) - (windowInfo?.safeArea?.bottom ?? 778),
+        };
+        _cachedWindowInfo = windowInfo;
+        return _cachedWindowInfo;
+        // #endif
+
+        // #ifndef MP-WEIXIN
+        _cachedWindowInfo = uni.getSystemInfoSync() as WindowInfo;
+        return _cachedWindowInfo;
+        // #endif
+    }
+
+    /**
+     * 清除窗口信息缓存（屏幕旋转或窗口尺寸变化时调用）
+     */
+    static clearWindowInfoCache() {
+        _cachedWindowInfo = null;
     }
 
     /**

package/utils/mixin.ts

@@ -86,7 +86,7 @@ export function sortChildren(parent: SelfComponentInternalInstance, internalChil
 }
 
 // 如果指定组件名称，则只查找此组件并且查到后结束。也就是不关心此组件下的内容，在大部分场景下节省查找消耗。
-export function useProvide<ProvideValue>(key: InjectionKey<ProvideValue>, childName?: string) {
+export function useProvide<ProvideValue>(key: InjectionKey<ParentProvide<ProvideValue>>, childName?: string) {
   const internalChildren: SelfComponentInternalInstance[] = shallowReactive([])
   const publicChildren = shallowReactive<any[]>([])
   const parent = getCurrentInstance()!
@@ -107,12 +107,13 @@ export function useProvide<ProvideValue>(key: InjectionKey<ProvideValue>, childN
   }
 
   return (value?: ProvideValue) => {
-    provide(key, {
+    // 使用 markRaw 包装整个 provide 对象，避免 provide/inject 链形成循环引用
+    provide(key, markRaw({
       add,
       remove,
       internalChildren,
       ...value,
-    } as any)
+    }) as ParentProvide<ProvideValue>)
 
     return {
       internalChildren,