stellar-ui-plus 1.25.0 → 1.25.2

package/components/ste-upload/ste-upload.easycom.json

@@ -169,7 +169,6 @@
         {
             "name": "[event]beforeRead",
             "description": "文件读取前触发",
-            "type": "(fileList:Array<UploadFileType>,suspend:()=>void,next()=>void,stop:()=>void)=>void",
             "params": [
                 {
                     "name": "fileList",
@@ -192,7 +191,6 @@
         {
             "name": "[event]read",
             "description": "文件读完成触发",
-            "type": "(fileList:Array<UploadFileType>)=>void",
             "params": [
                 {
                     "name": "fileList",
@@ -203,7 +201,6 @@
         {
             "name": "[event]oversize",
             "description": "文件大小超出限制触发",
-            "type": "(file,fileList:Array<UploadFileType>)=>void",
             "params": [
                 {
                     "name": "file",
@@ -218,7 +215,6 @@
         {
             "name": "[event]beforeDelete",
             "description": "文件删除前触发",
-            "type": "(index:number,suspend:()=>void,next()=>void,stop:()=>void)=>void",
             "params": [
                 {
                     "name": "index",
@@ -241,7 +237,6 @@
         {
             "name": "[event]delete",
             "description": "文件删除后触发",
-            "type": "(index:number,fileList:Array<UploadFileType>)=>void",
             "params": [
                 {
                     "name": "index",
@@ -256,28 +251,60 @@
         {
             "name": "[event]open-preview",
             "description": "打开预览时触发",
-            "type": "()=>void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "()=>void"
+                }
+            ]
         },
         {
             "name": "[event]preview-change",
             "description": "预览图片变化触发",
-            "type": "(index:number | null)=>void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "(index:number | null)=>void"
+                }
+            ]
         },
         {
             "name": "[event]close-preview",
             "description": "关闭预览时触发",
-            "type": "()=>void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "()=>void"
+                }
+            ]
         },
         {
             "name": "[event]click-item",
             "description": "点击文件触发",
-            "type": "(index:number)=>void",
             "params": [
                 {
                     "name": "index",
                     "description": "文件下标"
                 }
             ]
+        },
+        {
+            "name": "[slot]default",
+            "description": "上传按钮"
+        },
+        {
+            "name": "[slot]preview-cover",
+            "description": "每一份文件的预览图层样式",
+            "params": [
+                {
+                    "name": "file",
+                    "description": "当前文件"
+                }
+            ]
+        },
+        {
+            "name": "[slot]media-preview",
+            "description": "图片放大预览（媒体预览组件带默认插槽）"
         }
     ]
 }

package/components/ste-user-info/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `avatar` | 头像 | `String` | `` | - | - |
@@ -17,10 +19,18 @@
 | `loginBtnBg` | 登录按钮背景色 | `String` | `主题色` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `userClick` | 用户区域点击 | - | - |
+| `userClick` | 用户区域点击 | `data`：() => void | - |
 | `dataClick` | 数据点击 | `index`：当前点击的数据排序 | - |
-| `codeClick` | 功能码区域点击 | - | - |
-| `loginBtnClick` | 登录按钮点击 | - | - |
+| `codeClick` | 功能码区域点击 | `data`：() => void | - |
+| `loginBtnClick` | 登录按钮点击 | `data`：() => void | - |
+
+
+### Slots
+| 插槽名 | 说明  | 参数 | 支持版本 |
+| ----- | ----- | --- | -------- |
+| `desc` | 用户描述 | - | - |
+
+

package/components/ste-user-info/README.md

@@ -6,7 +6,7 @@
 
 ## 代码演示
 
-### 基本使用
+## 基本使用
 
 - 通过 `avatar`设置头像，默认为``
 - 通过 `nickname`设置昵称，默认为``
@@ -128,7 +128,7 @@
 </style>
 ```
 
-### 用户信息隐藏
+## 用户信息隐藏
 
 - 通过 `showUserInfo`设置是否展示用户相关，默认为`true`
 
@@ -188,7 +188,7 @@
 </style>
 ```
 
-### 核销码隐藏
+## 核销码隐藏
 
 - 通过 `showCode`设置核销码隐藏，默认为`true`
 
@@ -276,7 +276,7 @@
 </style>
 ```
 
-### 用户信息和核销码隐藏
+## 用户信息和核销码隐藏
 
 ```html
 <script lang="ts" setup>
@@ -334,7 +334,7 @@
 </style>
 ```
 
-### 未登录状态
+## 未登录状态
 
 - 通过 `loginStatus`设置登录状态，`0`：未登录，`1`：登录，默认为`1`
 - 通过 `loginSrc`设置未登录头像，默认为``
@@ -399,15 +399,7 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### Slots
-
-| 插槽名 | 说明     | 插槽参数 | 支持版本 |
-| ------ | -------- | -------- | -------- |
-| `desc` | 用户描述 | -        | -        |
-
 ---$
 {{qinpengfei}}

package/components/ste-user-info/ste-user-info.easycom.json

@@ -101,12 +101,16 @@
         {
             "name": "[event]userClick",
             "description": "用户区域点击",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]dataClick",
             "description": "数据点击",
-            "type": "(index : string | number) => void",
             "params": [
                 {
                     "name": "index",
@@ -117,12 +121,26 @@
         {
             "name": "[event]codeClick",
             "description": "功能码区域点击",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
         },
         {
             "name": "[event]loginBtnClick",
             "description": "登录按钮点击",
-            "type": "() => void"
+            "params": [
+                {
+                    "name": "data",
+                    "description": "() => void"
+                }
+            ]
+        },
+        {
+            "name": "[slot]desc",
+            "description": "用户描述"
         }
     ]
 }

package/components/ste-video/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `title` | 视频的标题，全屏时在顶部展示 | `string` | `` | - | - |

package/components/ste-video/README.md

@@ -4,9 +4,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础使用
+## 基础使用
 
 默认视频宽度会根据父容器的宽度撑满
 
@@ -16,7 +16,7 @@
 </template>
 ```
 
-#### 可选择清晰度
+## 可选择清晰度
 
 配置`resolution`后会在全屏时显示清晰度选择选项，数据结构如下
 
@@ -35,15 +35,11 @@
 
 ---$
 
-### API
-
-#### 组件属性(Props)
-
 <!-- props -->
 
 其他属性可参考原生[video](https://zh.uniapp.dcloud.io/component/video.html)
 
-#### 组件事件(Events)
+## 组件事件(Events)
 
 事件可参考原生[video](https://zh.uniapp.dcloud.io/component/video.html)
 

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.0",
+    "version": "1.25.2",
     "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,