@shijiu/jsview-vue 2.2.201 → 2.2.373

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

@@ -1,3 +1,24 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvConnectLine/JsvConnectLine.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvConnectLine：Vue高阶组件，由JsvLine组件变化而来，用于连接两个区域的线条。
+ *      props说明(注意:全部属性非响应式, 需要变更时用 key 来触发重绘):
+ *          startPos         {Object}   (必填) 起始位置，属性:x,y
+ *          endPos           {Object}   (必填) 结束位置, 属性:x,y
+ *          lineWidth        {Number}   (必填) 线条的粗细程度
+ *          backgroundColor  {String}   背景颜色，默认值:白色#FFFFFF
+ *          radius           {Number}   圆角半径，若半径超过起点终点距离的一半，则没有曲线为直线。
+ *          isVertical       {Boolean}  (必填) true为y轴拐点,false为x轴拐点
+ *          percent          {Number}   (必填) 承接isVertical，百分比拐点。
+ *          RoundSet         {Object}   圆角配置对象，可选开始拐点和结束拐点，false代表不配置，true代表配置。属性值：start，end
+ * 
+*/
+
 declare const _default: import("vue").DefineComponent<{}, {
     $props: {
         readonly isVertical?: boolean | undefined;

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

@@ -1,2 +1,6 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvConnectLine/index.js}
+ */
+
 export default JsvConnectLine;
 import JsvConnectLine from "./JsvConnectLine.vue";

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

@@ -0,0 +1,109 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvDragBox/JsvDragBox.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvDragBox：在一定限制区域内拖动的容器
+ *  props说明:
+ *      boxRect   {Object}  (必填) 限制区域 { left?: number, top?: number, width: number, height: number }
+ *      dragRect  {Object}  (必填) 拖拽区域 { left?: number, top?: number, width: number, height: number }
+ *  expose函数说明:
+ *      定义: type CBK = ({left: number, top: number}) => void;
+ *      setSensor {(callback: CBK, sensitivity: number) => void} 
+ *          设置运动后触发的回调, sensitivity为回调敏感度, 每移动多少像素进行回调，适当放大(推荐10以上)可以极大减小对js回调过多引起的性能降低 
+ *      setTouchCallback { (onDragStart: CBK, onDragRelease: CBK) => void }
+ *          设置触控开始和结束回调
+ *      moveTo { (left: number, top: number) => void },
+ *          将拖拽块移动到指定位置
+ *      getPosition { () => {left: number, top: number} }
+ *          获取当前拖拽块的位置
+ *
+*/
+
+declare const _default: {
+    new (...args: any[]): {
+        $: import("vue").ComponentInternalInstance;
+        $data: {};
+        $props: Partial<{}> & Omit<Readonly<import("vue").ExtractPropTypes<{}>> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>;
+        $attrs: {
+            [x: string]: unknown;
+        };
+        $refs: {
+            [x: string]: unknown;
+        };
+        $slots: Readonly<{
+            [name: string]: import("vue").Slot | undefined;
+        }>;
+        $root: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null;
+        $parent: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null;
+        $emit: (event: string, ...args: any[]) => void;
+        $el: any;
+        $options: import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{}>>, {
+            setSensor: (callback: any, sensitivity: any) => void;
+            setTouchCallback: (onDragStart: any, onDragEnd: any) => void;
+            moveTo: (left: any, top: any) => void;
+            getPosition: () => {
+                left: number;
+                top: number;
+            };
+            $props: {
+                readonly boxRect?: Record<string, any> | undefined;
+                readonly dragRect?: Record<string, any> | undefined;
+            };
+        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, {}, {}, string> & {
+            beforeCreate?: ((() => void) | (() => void)[]) | undefined;
+            created?: ((() => void) | (() => void)[]) | undefined;
+            beforeMount?: ((() => void) | (() => void)[]) | undefined;
+            mounted?: ((() => void) | (() => void)[]) | undefined;
+            beforeUpdate?: ((() => void) | (() => void)[]) | undefined;
+            updated?: ((() => void) | (() => void)[]) | undefined;
+            activated?: ((() => void) | (() => void)[]) | undefined;
+            deactivated?: ((() => void) | (() => void)[]) | undefined;
+            beforeDestroy?: ((() => void) | (() => void)[]) | undefined;
+            beforeUnmount?: ((() => void) | (() => void)[]) | undefined;
+            destroyed?: ((() => void) | (() => void)[]) | undefined;
+            unmounted?: ((() => void) | (() => void)[]) | undefined;
+            renderTracked?: (((e: import("vue").DebuggerEvent) => void) | ((e: import("vue").DebuggerEvent) => void)[]) | undefined;
+            renderTriggered?: (((e: import("vue").DebuggerEvent) => void) | ((e: import("vue").DebuggerEvent) => void)[]) | undefined;
+            errorCaptured?: (((err: unknown, instance: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null, info: string) => boolean | void) | ((err: unknown, instance: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null, info: string) => boolean | void)[]) | undefined;
+        };
+        $forceUpdate: () => void;
+        $nextTick: typeof import("vue").nextTick;
+        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (args_0: R, args_1: R) => any : (...args: any) => any, options?: import("vue").WatchOptions<boolean> | undefined): import("vue").WatchStopHandle;
+    } & Readonly<import("vue").ExtractPropTypes<{}>> & import("vue").ShallowUnwrapRef<{
+        setSensor: (callback: any, sensitivity: any) => void;
+        setTouchCallback: (onDragStart: any, onDragEnd: any) => void;
+        moveTo: (left: any, top: any) => void;
+        getPosition: () => {
+            left: number;
+            top: number;
+        };
+        $props: {
+            readonly boxRect?: Record<string, any> | undefined;
+            readonly dragRect?: Record<string, any> | undefined;
+        };
+    }> & {} & import("vue").ComponentCustomProperties & {};
+    __isFragment?: undefined;
+    __isTeleport?: undefined;
+    __isSuspense?: undefined;
+} & import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{}>>, {
+    setSensor: (callback: any, sensitivity: any) => void;
+    setTouchCallback: (onDragStart: any, onDragEnd: any) => void;
+    moveTo: (left: any, top: any) => void;
+    getPosition: () => {
+        left: number;
+        top: number;
+    };
+    $props: {
+        readonly boxRect?: Record<string, any> | undefined;
+        readonly dragRect?: Record<string, any> | undefined;
+    };
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, {}, {}, string> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & (new () => {
+    $slots: {
+        default: (_: {}) => any;
+    };
+});
+export default _default;

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

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

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

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

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

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvEnableRenderBreak.vue}
+ */
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

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

@@ -1,3 +1,22 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvFilterView.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvFilterView：黑白滤镜组件
+ *      props说明:
+ *          width   {int}   宽
+ *          height  {int}   高
+ *          left    {int}   left位置
+ *          top     {int}   top位置
+ *          filterType  {String}  滤镜设置:
+ *                                null: 无滤镜
+ *                                "gray-down": 黑白滤镜(公祭日滤镜)
+*/
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/JsvFlexCell/JsvFlexDiv.vue.d.ts

@@ -1,3 +1,37 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFlexCell/JsvFlexDiv.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ *  JsvFlexDiv: 包装成一个支持flex属性的div
+ *      props说明:
+ *          class: 等同于div的class设置(目前未实装，后续支持...)
+ *          style: 等同于div的style，关于flex的属性支持如下：
+ *              作为container:
+ *                  flexDirection: row|row-reverse|column|column-reverse  默认row, 决定主轴为行还是列，正向还是反向
+ *                  flexWrap: nowrap|wrap  默认nowrap, 主轴方向是否换行
+ *                  justifyContent: flex-start|flex-end|center  默认flex-start
+ *                                  主轴对齐方式(与direction相关决定start为左还是右)
+ *                  alignItems: flex-start|flex-end|center|stretch  默认center
+ *                                  副轴方向单行内的对齐方式，例如主轴为行时，项目在每行中竖直方向的对齐
+ *                  alignContent: flex-start|flex-end|center  默认flex-start
+ *                                副轴方向多行内容总体的对齐方式，例如主轴为行时，项目在每行中竖直方向的对齐
+ *                                若未设置，当遇到多行场景，行为为flex-start + 剩余空间每行平均瓜分(特别适合单行填充整个副轴空间的需求) 
+ *              作为item(二级container):
+ *                  alignSelf: auto|flex-start|flex-end|center|stretch  默认auto, 覆盖container的alignItems设置
+ *              特别注意: 这些属性会引起位置对齐问题, 所以会自动去掉: "overflow:hidden"
+ *          askSize: boolean  设置会跟进flex的尺寸变化，设置后可通过getWidth/getHeight拿到尺寸，但会降低性能
+ *          onSized: Function 比askSize更进一步，可以通过回调知道尺寸变化后的时机，回调参数(width, height)为flex后的尺寸
+ *
+ *      expose说明:
+ *          getWidth():  当askSize或者onSize生效时，获取元素的宽度
+ *          getHeight():  当askSize或者onSize生效时，获取元素的高度
+ *                   
+*/
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/JsvFlexCell/JsvScreenFlex.vue.d.ts

@@ -0,0 +1,106 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFlexCell/JsvScreenFlex.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ *  JsvScreenFlex: 包装成一个支持flex属性的div, 背景图片等同于objectFit:cover的模式
+ *      props说明:
+ *          style: 不能设置top/left/height/width, 这些信息自动来自屏幕的宽高
+ *                 主要用于设置flex的属性，目前支持属性如下：
+ *                 flexDirection: row|row-reverse|column|column-reverse  默认row, 决定主轴为行还是列，正向还是反向
+ *                 flexWrap: nowrap|wrap  默认nowrap, 主轴方向是否换行
+ *                 justifyContent: flex-start|flex-end|center  默认flex-start
+ *                                 主轴对齐方式(与direction相关决定start为左还是右)
+ *                 alignItems: flex-start|flex-end|center|stretch  默认center
+ *                                 副轴方向单行内的对齐方式，例如主轴为行时，项目在每行中竖直方向的对齐
+ *                 alignContent: flex-start|flex-end|center  默认flex-start
+ *                                 副轴方向多行内容总体的对齐方式，例如主轴为行时，项目在每行中竖直方向的对齐
+ *              特别注意: 这些属性会引起位置对齐问题, 所以会自动去掉: "overflow:hidden"
+ *          askSize: boolean  设置会跟进flex的尺寸变化，设置后可通过getWidth/getHeight拿到尺寸，但会降低性能
+ *          onSized: Function 比askSize更进一步，可以通过回调知道尺寸变化后的时机，回调参数(width, height)为flex后的尺寸
+ *          background: {string} (选填)背景图案 可选值: 绝对路径url|url(相对路径url)|#FFFFFF|rbga(255,0,0,1.0)
+ *
+ *      expose说明:
+ *          getWidth():  当askSize或者onSize生效时，获取元素的宽度
+ *          getHeight():  当askSize或者onSize生效时，获取元素的高度
+ *                   
+*/
+
+declare const _default: {
+    new (...args: any[]): {
+        $: import("vue").ComponentInternalInstance;
+        $data: {};
+        $props: Partial<{}> & Omit<Readonly<import("vue").ExtractPropTypes<{}>> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>;
+        $attrs: {
+            [x: string]: unknown;
+        };
+        $refs: {
+            [x: string]: unknown;
+        };
+        $slots: Readonly<{
+            [name: string]: import("vue").Slot | undefined;
+        }>;
+        $root: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null;
+        $parent: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null;
+        $emit: (event: string, ...args: any[]) => void;
+        $el: any;
+        $options: import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{}>>, {
+            getWidth: () => any;
+            getHeight: () => any;
+            $props: {
+                readonly background?: string | undefined;
+                readonly askSize?: boolean | undefined;
+                readonly onSized?: Function | undefined;
+                readonly style?: Record<string, any> | undefined;
+            };
+        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, {}, {}, string> & {
+            beforeCreate?: ((() => void) | (() => void)[]) | undefined;
+            created?: ((() => void) | (() => void)[]) | undefined;
+            beforeMount?: ((() => void) | (() => void)[]) | undefined;
+            mounted?: ((() => void) | (() => void)[]) | undefined;
+            beforeUpdate?: ((() => void) | (() => void)[]) | undefined;
+            updated?: ((() => void) | (() => void)[]) | undefined;
+            activated?: ((() => void) | (() => void)[]) | undefined;
+            deactivated?: ((() => void) | (() => void)[]) | undefined;
+            beforeDestroy?: ((() => void) | (() => void)[]) | undefined;
+            beforeUnmount?: ((() => void) | (() => void)[]) | undefined;
+            destroyed?: ((() => void) | (() => void)[]) | undefined;
+            unmounted?: ((() => void) | (() => void)[]) | undefined;
+            renderTracked?: (((e: import("vue").DebuggerEvent) => void) | ((e: import("vue").DebuggerEvent) => void)[]) | undefined;
+            renderTriggered?: (((e: import("vue").DebuggerEvent) => void) | ((e: import("vue").DebuggerEvent) => void)[]) | undefined;
+            errorCaptured?: (((err: unknown, instance: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null, info: string) => boolean | void) | ((err: unknown, instance: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null, info: string) => boolean | void)[]) | undefined;
+        };
+        $forceUpdate: () => void;
+        $nextTick: typeof import("vue").nextTick;
+        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (args_0: R, args_1: R) => any : (...args: any) => any, options?: import("vue").WatchOptions<boolean> | undefined): import("vue").WatchStopHandle;
+    } & Readonly<import("vue").ExtractPropTypes<{}>> & import("vue").ShallowUnwrapRef<{
+        getWidth: () => any;
+        getHeight: () => any;
+        $props: {
+            readonly background?: string | undefined;
+            readonly askSize?: boolean | undefined;
+            readonly onSized?: Function | undefined;
+            readonly style?: Record<string, any> | undefined;
+        };
+    }> & {} & import("vue").ComponentCustomProperties & {};
+    __isFragment?: undefined;
+    __isTeleport?: undefined;
+    __isSuspense?: undefined;
+} & import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{}>>, {
+    getWidth: () => any;
+    getHeight: () => any;
+    $props: {
+        readonly background?: string | undefined;
+        readonly askSize?: boolean | undefined;
+        readonly onSized?: Function | undefined;
+        readonly style?: Record<string, any> | undefined;
+    };
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, {}, {}, string> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & (new () => {
+    $slots: {
+        default: (_: {}) => any;
+    };
+});
+export default _default;

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

@@ -1,2 +1,6 @@
-export { JsvFlexDiv };
-import JsvFlexDiv from "./JsvFlexDiv.vue";
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFlexCell/index.js}
+ */
+
+export { default as JsvFlexDiv } from "./JsvFlexDiv.vue";
+export { default as JsvScreenFlex } from "./JsvScreenFlex.vue";

package/bin/types/JsViewVueWidget/JsvFragShaderView/BrowserJsvFragShaderView.vue.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFragShaderView/BrowserJsvFragShaderView.vue}
+ */
+
 declare const _default: import("vue").DefineComponent<{}, {
     startAnim: () => void;
     stopAnim: () => void;
@@ -6,6 +10,8 @@ declare const _default: import("vue").DefineComponent<{}, {
         readonly duration?: number | undefined;
         readonly autoplay?: boolean | undefined;
         readonly shaderStr?: string | undefined;
+        readonly onEnd?: Function | undefined;
+        readonly onStart?: Function | undefined;
         readonly uniforms?: unknown[] | undefined;
         readonly textures?: unknown[] | undefined;
     };

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

@@ -1,11 +1,58 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFragShaderView/JsvFragShaderView.vue}
+ */
+
+/**
+* @file
+*
+* [模块 export 内容]
+*   JsvFragShaderView：自定义Fragment shader的组件
+*       props说明:
+*           @prop {Object} style  (必填)left, top, width, height
+*           @prop {String}     shaderStr      (必填)shader的函数体
+*           @prop {int}        duration       动画时长
+*           @prop {boolean}    autoplay       自动播放
+*           @prop {Array}      uniforms       uniform参数, [{ name: string, value: number }]
+*           @prop {Array}      textures       texture参数, [{ name: string, resource: string }]
+*           @prop {() => void} onStart        动画开始回调
+*           @prop {(int,boolean) => void} onEnd
+*                                动画结束回调,
+*                                返回值1号 int: 回到参数为动画的序列号，和startAnim的返回值匹配
+*                                返回值2号 boolean: true: 动画正常结束，false:动画因为cancel而结束
+*       methods:
+*           @method startAnim
+*               @description 开始动画
+*               @param {int} duration: 动画时长, 默认为props.duration
+*               @param {()=>void} onTimeout: 如果到达duration的时长，动画因为资源问题还没开始动画的时会回调此函数
+*               @return {int} 所开动画的序列号，用于和onEnd收到的值匹配
+*           @method stopAnim
+*               @description 停止动画
+*       shader函数体说明:
+*         参考网站: https://www.shadertoy.com
+*         主函数:
+*           void mainImage( out vec4 fragColor, in vec2 fragCoord )
+*             @params {vec4} fragColor: 输出的片元颜色
+*             @params {vec2} fragCoord: 片元坐标, 左下角为原点, 往右为x正, 往上为y正
+*         可用的uniform:
+*           iResolution:  {vec3}  view的大小, vec3(width, height, 0)
+*           iTime:        {float} 动画时间
+*           iDuration:    {float} 动画总时间
+*       注意事项:
+*         * 盒子端使用OpenGL ES 2.0版本, 而网站 https://www.shadertoy.com 上使用WebGL, glsl支持的函数和操作符有区别.
+*         * 由于坐标系的差异, texture()采样函数需要替换为jsvTexture2D()
+*         * 盒子端的精度有限, 可能会出现精度导致的计算错误
+*/
+
 declare const _default: import("vue").DefineComponent<{}, {
-    startAnim: (d: any) => void;
+    startAnim: (alt_duration: any, on_timeout_func: any) => number;
     stopAnim: () => void;
     $props: {
         readonly style?: Record<string, any> | undefined;
         readonly duration?: number | undefined;
         readonly autoplay?: boolean | undefined;
         readonly shaderStr?: string | undefined;
+        readonly onEnd?: Function | undefined;
+        readonly onStart?: Function | undefined;
         readonly uniforms?: unknown[] | undefined;
         readonly textures?: unknown[] | undefined;
     };

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

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

package/bin/types/JsViewVueWidget/JsvFreeMoveActor/ActorControl.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/ActorControl.ts}
+ */
+
 import ConditionPackBuilder from "./SetCondition";
 import ActionPackBuilder from "./SetAction";
 import StatePackBuilder from "./SetState";

package/bin/types/JsViewVueWidget/JsvFreeMoveActor/CallbackManager.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/CallbackManager.ts}
+ */
+
 declare class CallbackManager {
     private _CallbackMap;
     private _IdGen;

package/bin/types/JsViewVueWidget/JsvFreeMoveActor/ForgeTypeDefine.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/ForgeTypeDefine.ts}
+ */
+
 declare const ActEventDefine: {
     ActFinish: any;
     SpeedRevertX: any;

package/bin/types/JsViewVueWidget/JsvFreeMoveActor/FreeMoveActor.vue.d.ts

@@ -1,3 +1,28 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/FreeMoveActor.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvFreeMoveActor/JsvFreeMoveDiv：
+ *          帧动画控制组件，通过control
+ *              .action()  单一运动指令，新指令发生时会冲掉旧指令  
+ *              .condition()  条件设置，有时间维度，X/Y维度
+ *              .state()  状态调整指令
+ *
+ *      props说明:
+ *          class: String, 等同于div的class设置(目前未实装，后续支持...)
+ *          style: Object, 等同于div的style设置
+ *                 特别注意: 在sizeMode模式下，非hidden，控制的是background/image的展示区域，
+ *                 overflow:hidden时，控制的是剪切区域，展示区域保持最初的width/height
+ *          sizeMode: Boolean, 从控制div左上角坐标的模式改为改为通过div矩形宽高
+ *                    (指令控制右下角坐标，实现对[0,0]->[右下角x,y]的矩形的宽高调整，另外，不支持负坐标)
+ *      expose说明:
+ *          control: Object 控制器句柄，具体参考 ActorControl
+*/
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/JsvFreeMoveActor/JsvEnvBlocker.vue.d.ts

@@ -1,3 +1,25 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/JsvEnvBlocker.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvEnvBlocker: 触发FreeMoveAnimation的 blockerCondition 的全屏碰撞体
+ *                与FreeMoveAnimation的 setCondition.onHitBlock 配合使用
+ *      props说明:
+ *          top, left, width, height(Number): 关联的div的定位信息
+ *          topGID(Number): 上边缘响应监听的组id(用于blockerCondition的组参数), 0或者undefined代表不激活这条边的测试
+ *          bottomGID(Number): 下边缘响应监听的组id
+ *          leftGID(Number): 左边缘响应监听的组id
+ *          rightGID(Number): 右边缘响应监听的组id
+ *
+ *          特别说明 GID 是全局共享的，例如多个EnvBlocker都有GID=2设置的边时，某个FreeMove实例设置setCondition.onHitBlock(2), 
+ *          意味着此FreeMoveAnimation碰撞任何一个EnvBlocker的GID=2的边都会触发回调
+ * 
+*/
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/JsvFreeMoveActor/NexusNode.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/NexusNode.ts}
+ */
+
 declare class NexusNode {
     token: number;
     constructor();

package/bin/types/JsViewVueWidget/JsvFreeMoveActor/SetAction.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/SetAction.ts}
+ */
+
 import CallbackManager from "./CallbackManager";
 import { NexusNode } from "./NexusNode";
 declare class ActorPackBuilder {

package/bin/types/JsViewVueWidget/JsvFreeMoveActor/SetCondition.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/SetCondition.ts}
+ */
+
 import CallbackManager from "./CallbackManager";
 import { NexusNode } from "./NexusNode";
 type UNumber = undefined | number;

package/bin/types/JsViewVueWidget/JsvFreeMoveActor/SetState.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/SetState.ts}
+ */
+
 import { NexusNode } from "./NexusNode";
 import ActorControl from "./ActorControl";
 declare class StatePackBuilder {

package/bin/types/JsViewVueWidget/JsvFreeMoveActor/SyncLinkManager.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/SyncLinkManager.ts}
+ */
+
 import { NexusNode } from "./NexusNode";
 declare class SyncLinkSource {
     nexusNode: NexusNode;

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

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/index.js}
+ */
+
 import JsvFreeMoveActor from "./FreeMoveActor.vue";
 import JsvEnvBlocker from "./JsvEnvBlocker.vue";
 export namespace FreeMoveDef {

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

@@ -1,3 +1,76 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvGrid.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【界面概述】
+ *  表格式布局控件, 页面滚动时无动画. 一般用于对页面刷新速度有要求的场景
+ *
+ * 【控件介绍】
+ * JsvGrid:
+ *    props:
+ *      left {int} 控件的left
+ *      top {int} 控件的top
+ *      name {String} (必选)控件的焦点Id
+ *      provideData {function} (必选)提供数据的接口, 数据中每个item均会包装成reactive对象,出于优化性能考虑, 请简化item中的属性
+ *      row {int} (必选)布局的行数
+ *      column {int} (必选)布局的列数
+ *      itemSize {Object} 格子的大小 {width: 0, height: 0}
+ *      updateType {UpdateType} 滚动的类型, 目前有两种PageType(整页), LineType(逐行)
+ *      initFocusId {int} 初始的焦点
+ *      gapInfo {Object} 格子间隔设置 {row: 行间距, colum: 列间距}
+ *      verticalUpdate {boolean} 是否纵向滚动
+ *      columnFirst {boolean} 单页是否列优先排布 
+ *      loopUpdate {boolean} 焦点移动到边界时循环滚动
+ *      onEdge {function} 焦点移动到边缘时的回调
+ *              @params {object} edgeInfo {
+                                            "direction": {EdgeDirection}边缘方向, 
+                                            "rect": 到达边缘时的区域{x: 0, y: 0, width: 0,height: 0}
+                                          }
+ *      focusMoveType {int} 焦点移动的模式, 可通过 | 运算进行组合
+                            NO_ADJUST: 无特殊处理
+                            COLUMN_LOOP: 到达列首/尾后跳转到上/下一列, 只在水平滚动时生效
+                            ROW_LOOP: 到达行首/尾后跳转到上/下一行, 只在竖直滚动时生效
+                            COLUMN_FIND_NEAR: 一列中没有下一个元素时是否跳转到相邻列
+                            ROW_FIND_NEAR: 一行中没有下一个元素时是否跳转到相邻行
+ *    methods:
+        getFocusBlockRef
+          @description 获取focusBlock的引用
+          @return {boolean} focusBlock的引用
+        setFocusId
+          @description 设置焦点id
+          @params {int} id 焦点id
+        refreshData
+          @description 刷新数据
+ * 【技巧说明】
+ * Q: 插槽props如何使用？
+ * A: userData: 通过provideData返回的数据会包装成reactive对象后给插槽内的item
+ *    widgetData: 控件内部的关于item的属性 
+                  {
+                    dataIndex: {int} 当前格子数据的index,
+                    gridIndex: {int} 当前格子的index,
+                    selected: {boolean} 格子是否选中
+                    getCurrentFocusId: {function} 获取widget的当前焦点的dataIndex
+                    gridCoord: {{row: 0, column: 0}} 获取当前格子的行列坐标
+                  }
+ *    onAction: 单元格内控件需要通过onAction.register方法注册 item 的回调，回调函数有
+                onFocus， onBlur， onClick
+ * 
+ * Q: 单元格的普通状态，焦点状态，失焦状态如何渲染？
+ * A: 在单元的空间中通过往onAction注册的onFocus，onBlur控制显示
+ *
+ * Q: 控件中的导航处理(上下左右，OK键)需要什么响应的开发？
+ * A: 上下左右键已经由控件接管，不需要开发者而外处理，上下左右键会触发翻页时间
+ * 
+ * Q: 焦点怎么移出控件？
+ * A: 当焦点移动到控件边缘时，会调用onEdge回调。在回调中通过参数传递的值来决定焦点转移的行为
+ * 
+ * Q: item内是可获焦的元素时该如何处理?
+ * A: 焦点处理: item内的元素需要在注册的onFocus中管理焦点. 子组件通过onKeyDown处理按键, 未处理的方向键会冒泡给JsvGrid, 从而触发格子间焦点的变换
+*/
+
 declare const _default: import("vue").DefineComponent<{
     left: {
         type: NumberConstructor;