@shijiu/jsview-vue 2.2.201 → 2.2.373

package/bin/types/JsViewVueWidget/JsvMindMap/JsvMindMap.vue.d.ts

@@ -1,3 +1,86 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvMindMap/JsvMindMap.vue}
+ */
+
+/** 
+* @file
+*
+* [界面概述]
+*   思维导图控件
+*  
+* [控件介绍]
+*   JsvMindMap:
+*     props:
+*       name:             {string}      焦点name
+*       provideData:      {function}    提供数据的函数
+*       width:            {number}      组件宽
+*       height:           {number}      组件高
+*       formatNode:       {function}    接受数据, 返回标准格式节点信息的函数
+*                                         {
+*                                           left: number, left(必需)
+*                                           top: number, top(必需)
+*                                           width: number, width(必需)
+*                                           height: number, height(必需)
+*                                           id: string, 节点的唯一id(必需)
+*                                           childrenList: Array<any>, 子数据列表
+*                                           moveType: "star" | "layer" | "inherit", 节点布局类型(可选)
+*                                           lineStyle: object 此节点线的style
+*                                             { 
+*                                               lineWidth: number, 线宽
+*                                               backgroundColor: string, 线的颜色(与backgroundImage互斥)
+*                                               backgroundImage: string, 线的图片(与backgroundColor互斥)
+*                                               borderRadius: string | number, 线的圆角设置
+*                                             }
+*                                            enableTap: boolean, 是否支持点击
+*                                         }
+*       left:             {number}      组件left
+*       top:              {number}      组件top
+*       slideAnim:        {object}      滚动动画设置, { duration: number, easing?: string }, duration为毫秒
+*       onEdge:           {function}    到达边缘回调
+*       focusRectPadding: {number}      焦点区域内边距
+*       renderRectMargin: {number}      描画区域外边距
+*     methods:
+*       getCurFocusNode
+*         @description 获取当前焦点的数据
+*         @return {object} 当前焦点节点的数据
+*       getCurFocusId
+*         @description 获取当前焦点的id
+*         @return {string} 当前节点的id
+*       getCurVisibleRect
+*         @description 获取当前的可视区域
+*         @return {object} 可视区域{x: number, y: number, width: number, height: number}
+*       slideTo
+*         @description 滚动到指定位置
+*         @params {int} x x坐标
+*         @params {int} y y坐标
+*         @params {object} animInfo 动画设置, 为null时不做动画. {duration: number, easing: string, onEnd: function}
+*       setFocusTo
+*         @description 设置焦点
+*         @params {string} id 目标节点的id
+*         @params {boolean} needSlide  是否需要滚动
+*         @params {object} animInfo 滚动动画设置
+*       moveInItem
+*         @description 把指定节点移入焦点区域
+*         @params {string} id 目标节点的id
+*         @params {object} animInfo 动画信息
+*       moveFocus
+*         @description 往指定方向移动焦点
+*         @params {string} direction 移动方向 "left" | "top" | "right" | "bottom"
+*       getEntireTreeBoundingSize
+*         @description 获取整个树的包围框宽高
+*         @return {object} 宽高 {width: number, height: number}
+*       refreshData
+*         @description 刷新数据
+*      setSensor {(callback: ({left: number, top: number}) => void, sensitivity: number) => void} 
+*          设置运动后触发的回调, sensitivity为回调敏感度, 每移动多少像素进行回调，适当放大(推荐10以上)可以极大减小对js回调过多引起的性能降低 
+*                                         
+* [额外说明]
+* 1. 焦点移动逻辑
+*   每个节点首先有个父方向, 若父节点是star模式, 则父方向由父节点相对位置决定, 若父节点是layer模式, 则父方向为父节点子方向的反向
+*   layer模式的节点, 有一个子方向, 其子方向是所有子所在的一侧方向(只有上下左右四侧), 若无子, 则父方向的反向为子方向. 确定了父方向和子方向后, 剩余两个方向则寻找该方向最近的兄弟节点, 若无则寻找最近分支上最近的同级或者叶节点
+*   star模式的节点, 除了父方向, 剩余三个方向均寻找相应方向的最近子节点, 若未找到则按layer寻找兄弟节点相同的逻辑寻找同级节点
+*/
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;
@@ -29,6 +112,7 @@ declare const _default: {
                 height: number;
             };
             refreshData: () => void;
+            setSensor: (callback: any, sensitivity?: number) => void;
             $props: {
                 readonly height?: number | undefined;
                 readonly width?: number | undefined;
@@ -36,6 +120,7 @@ declare const _default: {
                 readonly top?: number | undefined;
                 readonly name?: string | undefined;
                 readonly provideData?: Function | undefined;
+                readonly touchFlag?: number | undefined;
                 readonly formatNode?: Function | undefined;
                 readonly focusRectPadding?: number | undefined;
                 readonly renderRectMargin?: number | undefined;
@@ -75,6 +160,7 @@ declare const _default: {
             height: number;
         };
         refreshData: () => void;
+        setSensor: (callback: any, sensitivity?: number) => void;
         $props: {
             readonly height?: number | undefined;
             readonly width?: number | undefined;
@@ -82,6 +168,7 @@ declare const _default: {
             readonly top?: number | undefined;
             readonly name?: string | undefined;
             readonly provideData?: Function | undefined;
+            readonly touchFlag?: number | undefined;
             readonly formatNode?: Function | undefined;
             readonly focusRectPadding?: number | undefined;
             readonly renderRectMargin?: number | undefined;
@@ -105,6 +192,7 @@ declare const _default: {
         height: number;
     };
     refreshData: () => void;
+    setSensor: (callback: any, sensitivity?: number) => void;
     $props: {
         readonly height?: number | undefined;
         readonly width?: number | undefined;
@@ -112,6 +200,7 @@ declare const _default: {
         readonly top?: number | undefined;
         readonly name?: string | undefined;
         readonly provideData?: Function | undefined;
+        readonly touchFlag?: number | undefined;
         readonly formatNode?: Function | undefined;
         readonly focusRectPadding?: number | undefined;
         readonly renderRectMargin?: number | undefined;
@@ -136,6 +225,7 @@ declare const _default: {
                     height: number;
                 };
                 refreshData: () => void;
+                setSensor: (callback: any, sensitivity?: number) => void;
             };
             onAction: any;
         }) => any;

package/bin/types/JsViewVueWidget/JsvMindMap/index.d.ts

@@ -1 +1,5 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvMindMap/index.js}
+ */
+
 export { default as JsvMindMap } from "./JsvMindMap.vue";

package/bin/types/JsViewVueWidget/JsvMindMap/rtree.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvMindMap/rtree.js}
+ */
+
 export default RBush;
 declare function RBush(maxEntries: any): void;
 declare class RBush {

package/bin/types/JsViewVueWidget/JsvNativeSharedDiv.vue.d.ts

@@ -1,3 +1,21 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvNativeSharedDiv.vue}
+ */
+
+/**
+* @file
+*
+* 【控件介绍】
+* JsvNativeSharedDiv：创建一个Native端可以跟进显示位置的div，用于Native端外挂插件的开发
+*     @param {Object} style  布局样式(必须)，必须包含的信息为{left, top, width, height}
+*     @param {function} getId 回调函数，用于接收ID信息，ID信息用于Native端对该view进行跟踪的标识
+*     @param {String} setId  给定命名ID，避免同进程不同context重名要和Context相关，
+*                            例如`${window.JsView?.getJsContextId()}_${you_name}`
+*     @param {number} corner 圆角的尺寸，默认为0
+*     @param {number} oversize  为了去除黑边的调整选项，让native video的尺寸信息比扣洞大多少, 默认为0
+*     @param {boolean} frontLayer 视图是在JsView界面前方，不是需要扣洞的后方，默认为false
+*/
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;
@@ -20,6 +38,8 @@ declare const _default: {
             $props: {
                 readonly style?: Record<string, any> | undefined;
                 readonly corner?: number | undefined;
+                readonly oversize?: number | undefined;
+                readonly frontLayer?: boolean | undefined;
                 readonly getId?: Function | undefined;
                 readonly setId?: string | undefined;
             };
@@ -47,6 +67,8 @@ declare const _default: {
         $props: {
             readonly style?: Record<string, any> | undefined;
             readonly corner?: number | undefined;
+            readonly oversize?: number | undefined;
+            readonly frontLayer?: boolean | undefined;
             readonly getId?: Function | undefined;
             readonly setId?: string | undefined;
         };
@@ -58,6 +80,8 @@ declare const _default: {
     $props: {
         readonly style?: Record<string, any> | undefined;
         readonly corner?: number | undefined;
+        readonly oversize?: number | undefined;
+        readonly frontLayer?: boolean | undefined;
         readonly getId?: Function | undefined;
         readonly setId?: string | undefined;
     };

package/bin/types/JsViewVueWidget/JsvNinePatch.vue.d.ts

@@ -1,3 +1,32 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvNinePatch.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvNinePatch：Vue高阶组件，.9图展示控件，该控件的原图要求为正方形，延展后可为长方形
+ *              centerWidth和borderOutset传值比较抽象，若 imageDspWidth 和图片素材的原图尺寸一直，
+ *              则可以参考 samples/NinePatchTester 的样例图示
+ *      props说明:
+ *          style       {Object}    同div的Style，通过width/height来控制.9图片延展后的显示尺寸，另外通过top/left控制坐标
+ *          imageUrl    {String}    (必填)显示图片的加载地址
+ *          imageWidth  {int}       (必填)原图信息: 原图的宽度(由于正方形,宽高相同)
+ *          contentWidth {int}      (废弃)此值为了兼容，会赋值给centerWidth
+ *          centerWidth  {int}      (必填)原图信息: .9图的中心区域宽度(repeat区域)
+ *          imageDspWidth  {int}    原图缩放后的显示宽度，计算方法: 
+ *                                四角为90度圆弧时: imageDspWidth = 显示图形的圆弧半径 / 原图中圆弧的半径 * 原图宽度
+ *                                                原图中圆弧半径 = (原图宽度 - borderOutset * 2) / 2
+ *                                四角为其他形状时，原图.9图的四角区域，缩放到要和显示图形重合后的宽度。
+ *          borderOutset {int}      (必填)原图信息: 图片边缘到中心内容区域边缘的距离, 快速计算: (原图宽度 - 原图中放内容宽度) / 2
+ *          animTime    {int}       (必填)缩放动画的时长(单位秒)
+ *          waitForInit {boolean}  (选填)尺寸为0时是否进行描画(例如: 首次显示不展示动画的场合，设置为true),默认值为true
+ *          onTransitionEnd { Function } (选填)transition动画结束的回调
+ *          onAnimationEnd { Function } (选填)animation动画结束的回调
+ *          imageBlendType {String}  (选填) alpha合并模式，默认为普通合成，可设置"alphaOverride", 用于Video挖洞操作
+*/
+
 declare const _default: import("vue").DefineComponent<{}, {
     $props: {
         readonly left?: number | undefined;
@@ -14,6 +43,7 @@ declare const _default: import("vue").DefineComponent<{}, {
         readonly imageBlendType?: string | undefined;
         readonly onDivRef?: Function | undefined;
         readonly animation?: string | undefined;
+        readonly onAnimationEnd?: Function | undefined;
         readonly onTransitionEnd?: Function | undefined;
     };
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;

package/bin/types/JsViewVueWidget/JsvPieChart.vue.d.ts

@@ -1,3 +1,20 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvPieChart.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvPieChart：Vue高阶组件，饼图。
+ *      props说明:
+ *          centerPosition  {Object}   圆心坐标，属性:{x,y}
+ *          radius          {Number}   半径
+ *          animationTime   {Number}   动画变化时间，单位 /秒
+ *          data            {Array}    数组对象，包含百分比和颜色。例如:[{color:'#FFFFFF',percent:20}]
+ * 说明：传入的数组要为响应式，且保证所有项的percent都是大于0并且相加等于100
+*/
+
 declare const _default: import("vue").DefineComponent<{}, {
     $props: {
         readonly data?: unknown[] | undefined;

package/bin/types/JsViewVueWidget/JsvPosterDiv.vue.d.ts

@@ -1,3 +1,20 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvPosterDiv.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvPosterDiv：Vue高阶组件，海报描画
+ *  props说明:
+ *      style    {Object}   包含
+ *                          left/top/width/height
+ *                          border-radius
+ *                          backgroundImage/backgroundColor 
+ *                          的style设置
+*/
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/JsvPosterImage.vue.d.ts

@@ -1,3 +1,21 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvPosterImage.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvPosterImage：Vue高阶组件，海报描画，可设置color space 和 texture size
+ *  props说明:
+ *      style    {Object}   包含left/top/width/height/border-radius的style设置
+ *      colorSpace {String} 颜色空间，调整其他颜色空间可以节省内存，默认RGBA_8888
+ *      imageCompress {boolean} 是否压缩图片, 默认打开
+ *      src {string}        图片的加载地址
+ *      fadeIn: {boolean}   图片加载完成是否有淡入效果，默认为打开
+ *      isPosterImage:      标识是否用于海报位，对于海报位的内容，可以有下载线程控制等策略来优化整体体验
+*/
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/JsvPreload/BrowserPreload.vue.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvPreload/BrowserPreload.vue}
+ */
+
 declare const _default: import("vue").DefineComponent<{}, {
     $props: {
         readonly preloadList?: unknown[] | undefined;

package/bin/types/JsViewVueWidget/JsvPreload/JsvPreload.vue.d.ts

@@ -1,3 +1,45 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvPreload/JsvPreload.vue}
+ */
+
+/**
+* @file
+*
+* 【模块 export 内容】
+* JsvPreload：Vue高阶组件，图片预加载的控件
+*      preloadList {ObjectArray}: 预加载的信息列表，单个内容通过buildPreloadInfo构建
+*                                 列表中的图片会被进行下载，解码并将解码结果存储在内存中，内存占用的周期同JsvPreload组件声明周期
+*      downloadList {ObjectArray}: 预下载的信息列表，单个内容通过buildDownloadInfo构建
+*                                  列表的内容可以是图片，音频等任何网络资源，下载后缓存在本地，归入本地缓存管理(LRU清理策略)
+*      onPreloading {Function(float percent)}: 预加载中回调，返回预加载进度
+*      onPreloadDone {Function(sizeArray)}: 预加载完成回调，sizeArray(格式Object[])，每个的格式为{width, height}
+*      onDownloadDone {Function(pathesArray, extra)}: 预下载完成回调,pathesArray(格式为String[])为下载好回调的地址, 
+*                                         其中pathesArray为存储位置的路径列表, extra为额外信息(目前只有下载图片时的尺寸)
+*
+* 注意事项:
+*      指定加载时的尺寸(0为不指定)，与img标签中的 jsv_img_scaledown_tex 属性一起使用
+*      指定加载色空间，与div标签中的 jsv_img_color_space 一起使用。
+*      因为，同样url情况下，jsv_img_scaledown_tex 和 jsv_img_color_space 启用后，不同的尺寸不同颜色空间
+*      对应着各自不同的图片内存缓存
+*
+* 静态函数:
+*  buildPreloadInfo: 静态函数，创建预加载信息项，用于制作JsvPreload的preloadList属性列表信息
+*        参数:
+*        url {string}:  (必填)图片url
+*        width {int}:  图片内存存储区域宽度，默认为0(同图片源文件宽度)
+*        height {int}:  图片内存存储区域宽度，默认为0(同图片源文件宽度)
+*        color_type {string}:  图片存储颜色空间，去掉alpha通道可节省内存，例如"RGB_565"等，与img标签jsv_img_color_space配合，默认值"RGBA_8888"
+*        net_setting {object}:  (未实现)网络加载参数，cookie, refer等，默认值 null
+*
+*  buildDownloadInfo: 函数，创建预下载信息项，用于制作JsvPreload的downloadList属性列表信息
+*        参数:
+*        url {string}:  (必填)图片url
+*        width {int}:  图片内存存储区域宽度，默认为0(同图片源文件宽度)
+*        height {int}:  图片内存存储区域宽度，默认为0(同图片源文件宽度)
+*        color_type {string}:  图片存储颜色空间，去掉alpha通道可节省内存，例如"RGB_565"等，与img标签jsv_img_color_space配合，默认值"RGBA_8888"
+*        net_setting {object}:  (未实现)网络加载参数，cookie, refer等，默认值 null
+*/
+
 declare const _default: import("vue").DefineComponent<{}, {
     $props: {
         readonly preloadList?: Record<string, any> | undefined;

package/bin/types/JsViewVueWidget/JsvPreload/index.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvPreload/index.js}
+ */
+
 export default _JsvPreload;
 declare let _JsvPreload: any;
 export let buildPreloadInfo: (url: any, width: number | undefined, height: number | undefined, color_type: string | undefined, net_setting: null | undefined, is_poster_img: any) => {

package/bin/types/JsViewVueWidget/JsvProgressBar.vue.d.ts

@@ -1,3 +1,22 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvProgressBar.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvProgressBar：Vue高阶组件，进度条组件。
+ *      props说明:
+ *          width            {Number}    (必填) 进度条总宽度
+ *          height           {Number}    (必填) 进度条总宽度（也是圆的直径）
+ *          bgcBefore        {String}    (必填) 进度条前景颜色
+ *          bgcBehind        {String}    (必填) 进度条背景颜色
+ *          aniTime          {Number}    (可选) 进度条变化的动画时间，单位：秒。
+ *          progress         {Number}    (可选) 进度条的百分比进度。有效值：0-100
+ *          isCanvas         {Boolean}   (可选) 进度条的展示样式：①点九 ②clipView 默认为true，即点九样式。
+*/
+
 declare const _default: import("vue").DefineComponent<{}, {
     $props: {
         readonly progress?: number | undefined;

package/bin/types/JsViewVueWidget/JsvQrcode/BrowserQrcode.vue.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvQrcode/BrowserQrcode.vue}
+ */
+
 declare const _default: import("vue").DefineComponent<{}, {
     $props: {
         readonly fgColor?: string | undefined;

package/bin/types/JsViewVueWidget/JsvQrcode/JsvQrcode.vue.d.ts

@@ -1,3 +1,28 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvQrcode/JsvQrcode.vue}
+ */
+
+/**
+* @file
+*
+* 【模块 export 内容】
+* QRCode：Vue高阶组件，描绘二维码，
+*      props说明:
+*            value {string} (必须)     二维码代表的字符串
+*            size {int} (必须)      二维码展示尺寸，二维码为正方形，所以改值代表宽和高，默认值：128
+*            fgColor {string}          二维码前景色，默认值"#000000"，黑色
+*            bgColor {string}          二维码背景色，默认值"#ffffff"，白色
+*            level {string}            二维码的容错能力，可选值{'L':低, 'M':中, 'H':高, 'Q':最精细}，默认值'L'
+*            instant {string}      是否立即加载(auto, sync, async), auto = async
+*                                      是否当前帧限制(默认为非当前帧显示，不影响按键响应，但是会闪)
+*            imageSettings {Object}    设置中心logo图片，默认值为null，设置格式为：
+*                       {
+*                              src {string}        logo的url地址
+*                              height {int}     logo的宽度
+*                              height {int}     logo的高度
+*                       }
+*/
+
 declare const _default: import("vue").DefineComponent<{
     value: StringConstructor;
     size: NumberConstructor;

package/bin/types/JsViewVueWidget/JsvQrcode/index.d.ts

@@ -1,2 +1,6 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvQrcode/index.js}
+ */
+
 export default _JsvQrcode;
 declare let _JsvQrcode: any;

package/bin/types/JsViewVueWidget/JsvRadarChart.vue.d.ts

@@ -1,3 +1,27 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvRadarChart.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvRadarChart：Vue高阶组件，多维属性图展示控件，又称雷达图，该控件的原图要求为正方形，按对角线划分，一边为透明，一边为带边框的正三角形，
+ *                    带上等分线。
+ *      props说明:
+ *          style            {Object}    (必填) 同div的Style，通过top/left控制圆心坐标
+ *          backgroundUrl    {String}    (必填) 背景图片的加载地址
+ *          foregroundUrl    {String}    (必填) 展示图片的加载地址
+ *          data             {Array}     (必填) 响应式数组对象，有title和value两个属性 例: const data=ref([{title:'智力',value:80}])
+ *                                       注：value为0-100的整数
+ *          fontSize         {Number}    (必填) 要展示的字体大小
+ *          fontColor        {String}    字体颜色，默认黑色。
+ *          radius           {Number}    (必填) 半径宽度 
+ *          extendOffset     {Number}    (必填) 延展半径宽度(width)，用于展示title
+ *      补充说明:
+ *          该控件以左上角为顶点旋转渲染，所以图片中带边框的正三角形的三个顶点应该为：左上，右上，左下；请调整图的朝向。
+*/
+
 declare const _default: import("vue").DefineComponent<{}, {
     $props: {
         readonly data?: unknown[] | undefined;

package/bin/types/JsViewVueWidget/JsvRipple/Constant.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvRipple/Constant.js}
+ */
+
 export namespace JsvRippleShape {
     const CIRCLE: any;
     const RECTANGLE: any;

package/bin/types/JsViewVueWidget/JsvRipple/JsvRipple.vue.d.ts

@@ -1,3 +1,48 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvRipple/JsvRipple.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvRipple: 波纹组件
+ *      组件说明:
+ *        只在盒子端支持, 浏览器端无效果
+ *        出于性能考虑, 最多同时有5个波纹
+ *        波的函数为 f(x, t) = amplitude * exp(-timeDecay * t) * (1.0 / (1.0 + distanceDecay * x * x))  
+                                * sin(PI_2 * frequency * (x / speed - t))
+ *      props说明:
+ *          width   {int}   宽
+ *          height  {int}   高
+ *          left    {int}   left位置
+ *          top     {int}   top位置
+ *          enable  {boolean} 是否启用特效
+ *      method说明:
+ *          addSource {(x, y, amplitude, shapeParams, mediumParams) => number}
+ *            返回值: token
+ *            参数: 
+ *              x {int}: 波纹中心x坐标
+ *              y {int}: 波纹中心y坐标
+ *              amplitude {int}: 波幅
+ *              shapeParams {{type: number, width?: number, height?: number, radius?: number}}:
+ *                type: 波纹类型, 目前只有两种
+ *                  JsvRippleShape.CIRCLE 圆形波
+ *                  JsvRippleShape.RECTANGLE 圆角矩形波
+ *                width: JsvRippleShape.RECTANGLE 时设置, 矩形的宽
+ *                height: JsvRippleShape.RECTANGLE 时设置, 矩形的高
+ *                radius: JsvRippleShape.RECTANGLE 时设置, 圆角半径
+ *              mediumParams {{timeDecay: number, distanceDecay: nubmer, speed: number, frequency: number, waveNum: number}}:
+ *                timeDecay: 时间衰减因子, 在公式中的影响为 exp(-timeDecay * t), 一般认为amplitude * exp(-timeDecay * t) < 1 时波消失, 所以要控制波的时长可以计算 ln(amplitude) / timeDecay
+ *                distanceDecay: 距离衰减因子, 公式中的影响为 (1.0 / (1.0 + distanceDecay * x * x))
+ *                speed: 波速 px/s
+ *                frequency: 频率 次/s
+ *                waveNum: 波的个数
+ *          removeSource {(token) => void}
+ *            参数:
+ *              token: 波源的token
+*/
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/JsvRipple/index.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvRipple/index.js}
+ */
+
 import JsvRipple from "./JsvRipple.vue";
 import { JsvRippleShape } from "./Constant";
 export { JsvRipple as default, JsvRippleShape };

package/bin/types/JsViewVueWidget/JsvScaleTextBox.vue.d.ts

@@ -1,3 +1,21 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvScaleTextBox.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【控件介绍】
+ * JsvScaleTextBox：
+ *          创建一个div，可以控制其内部的文字图层的清晰度，
+ *          当文字被放大(例如焦点所在位置放大效果)时发现文字显示模糊的场景，
+ *          将这些文字都放入到本控件中，设置scale属性等于文字的缩放大小，即可解决显示清晰问题。
+ *
+ *      prop说明:
+ *          definitionScale   内部文字被放大的倍数，写法为"1.0x", "1.6x"
+ *          其他    同div的其他props，例如style, class等
+*/
+
 declare const _default: import("vue").DefineComponent<{
     definitionScale: {
         type: StringConstructor;

package/bin/types/JsViewVueWidget/JsvScrollBox/JsvScrollBox.vue.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvScrollBox/JsvScrollBox.vue?vue&type=script&setup=true&lang.ts}
+ */
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/JsvScrollBox/JsvScrollFollow.vue.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvScrollBox/JsvScrollFollow.vue?vue&type=script&setup=true&lang.ts}
+ */
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/JsvScrollBox/ScrollInnerSymbol.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvScrollBox/ScrollInnerSymbol.ts}
+ */
+
 declare const ScrollInnerStyle: {
     UpdatePercentNexusCode: number;
 };

package/bin/types/JsViewVueWidget/JsvScrollBox/ScrollSymbol.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvScrollBox/ScrollSymbol.ts}
+ */
+
 declare const ScrollBoxStyle: {
     DrawerMode: symbol;
     PinMode: symbol;

package/bin/types/JsViewVueWidget/JsvScrollBox/index.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvScrollBox/index.ts}
+ */
+
 export { default as JsvScrollBox } from "./JsvScrollBox.vue";
 export { default as JsvScrollFollow } from "./JsvScrollFollow.vue";
 export * from "./ScrollSymbol";

package/bin/types/JsViewVueWidget/JsvSector.vue.d.ts

@@ -1,3 +1,21 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvSector.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvSector：Vue高阶组件，扇形图。
+ *      props说明:
+ *          centerPosition  {Object}   圆心坐标，属性:{x,y}
+ *          radius          {Number}   半径
+ *          animationTime   {Number}   动画变化时间，单位 /秒
+ *          config          {Object}   配置信息对象，包含初始角度，扫过的角度以及颜色。属性:{startAngle,sweepAngle,color}
+ *          extraTime       {Number}   可选配置（饼图用）扇形运动额外时间
+ * 
+*/
+
 declare const _default: import("vue").DefineComponent<{}, {
     $props: {
         readonly animationTime?: number | undefined;