@shijiu/jsview-vue 2.2.128 → 2.2.373

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

@@ -0,0 +1,19 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFragShaderView/BrowserJsvFragShaderView.vue}
+ */
+
+declare const _default: import("vue").DefineComponent<{}, {
+    startAnim: () => void;
+    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;
+    };
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
+export default _default;

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

@@ -0,0 +1,60 @@
+/** 
+ + @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: (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;
+    };
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
+export default _default;

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

@@ -0,0 +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,33 +1,31 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/ActorControl.ts}
+ */
+
 import ConditionPackBuilder from "./SetCondition";
 import ActionPackBuilder from "./SetAction";
 import StatePackBuilder from "./SetState";
+import CallbackManager from "./CallbackManager";
 import { NexusNode } from "./NexusNode";
-declare class ActorControl {
-    private _BindView;
-    private _BindAnim;
-    private _Callbacks;
-    private _SelfNexusRecv;
-    private _SizeMode;
+interface CmdListCreator {
+    (builders: BuilderFactory): Array<Object>;
+}
+declare class BuilderFactory {
     private _SharedQuickConditionPackBuilder;
     private _SharedQuickActionPackBuilder;
     private _StatePackBuilder;
-    constructor();
-    asSizeMode(): void;
-    bindForgeView(bindView: any, instantActive: boolean): void;
-    /**
-     * run 执行编排好的intent集合
-     *
-     * @param {Array} cmdPackList 内容来自 Condition(), State(), Action() 这些工厂类创建的Command pack
-     */
-    run(cmdPackList: Array<Object>): void;
-    _WrappedRun(cmdPackList: Array<Object>): void;
+    private _Callbacks;
+    private _SelfNexusRecv;
+    private _OwnerControl;
+    constructor(owner: ActorControl, callbackManager: CallbackManager, selfNexusRecv: NexusNode);
     /**
      * Condition
      * 获取创建 ConditionPack 的工厂对象
      * ConditionPack对应支持 .then(cmdPackList), 可传入同 Run 的处理队列
      * 可用方法见 ./SetCondition.js
      * @param {int} group 可选参数，默认为0, 有效值为0~3, 对应默认组, 1组, 2组, 3组, 便于remove时，按组进行清理
-     * @param {boolean} multiTimes 可选参数，默认为false, 是否要多次执行, 若为单次，则执行后condition作废
+     * @param {boolean} multiTimes 可选参数，默认为false, 是否要多次执行,
+     *                      若为单次, 当group未设定时自动作废，当group设定时，不作废但改为deactive状态
      * @param {string} specName 可选参数，默认null, 命名condition, 用于指定名字进行active/deactive动作的场景
      * @param {boolean} shoudRenderBreak 可选参数，默认false, 关联的回调是否会发起RenderBreak
      * @return {ConditionPackBuilder} ConditionPack 的工厂对象
@@ -57,8 +55,40 @@ declare class ActorControl {
      * @return {StatePackBuilder} StatePack 的工厂对象
      */
     state(): StatePackBuilder;
+}
+declare class ActorControl {
+    private _BindView;
+    private _BindAnim;
+    private _Callbacks;
+    private _SelfNexusRecv;
+    private _SizeMode;
+    private _CondCycleStartList;
+    private _CondCycleEndList;
+    private _Builders;
+    constructor();
+    asSizeMode(): void;
+    bindForgeView(bindView: any, instantActive: boolean): void;
+    /**
+     * run 执行编排好的intent集合
+     *
+     * @param {CmdListCreator} commandsCreator
+     *                         命令指令队列创建回调
+     *                         此回调返回值为一个数组，数组内容内容来自 Condition(), State(), Action()
+     *                         这些工厂类创建的Command pack
+     */
+    run(commandsCreator: CmdListCreator | undefined): void;
+    _WrappedRun(cmdPackList: Array<Object>): void;
     getBindedAnim(): any;
     getBindedView(): any;
+    /**
+     * addCondCycleListener
+     * 追加 cond cycle listener，可以根据start和end来进行callback时序排序
+     *
+     * @param {Function} startCycleCallback   开始执行一帧的js回调(condition的callback)
+     * @param {Function} endCycleCallback  执行一帧的js回调完毕
+     */
+    addCondCycleListener(startCycleCallback: Function, endCycleCallback: Function): void;
+    removeCondCycleListener(startCycleCallback: Function, endCycleCallback: Function): void;
     _OnEchoEvent(retJson: string): void;
     _EnsureAnim(): void;
 }

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 {
@@ -54,16 +58,16 @@ declare class ActorPackBuilder {
      * 只能放在 movementSync 的then中，用于将Sync同步信息按比例转化成
      * (注意): 如果触发链条上有自己发出的信息，则将不再产生动作，规避循环触发
      *
-     * @param {int} left  运动识别区域的left, 可以为负
-     * @param {int} top  运动识别区域的top, 可以为负
-     * @param {int} right  运动识别区域的right, 可以为负，必须大于left
-     * @param {int} bottom  运动识别区域的bottom, 可以为负，必须大于bottom
+     * @param {int} horizontalStart  横向运动识别区域的0%对应位置, 可以为负
+     * @param {int} horizontalEnd  横向运动识别区域的100%对应位置, 可以为负，可以小于start
+     * @param {int} verticalStart  纵向运动识别区域的0%对应位置, 可以为负
+     * @param {int} verticalEnd  纵向运动识别区域的100%对应位置, 可以为负，可以小于end
      * @param {int} xyEnable  x,y是否都触发, 0b01对应x, 0b10对应y, 可以或运算在一起
      * @param {int} syncType 换算公式:
      *                        1: 正比公式:selfPercent = givenPercent
      *                        2: 反比公式:selfPercent = (1 - givenPercent)
      */
-    ackMovementSync(left: number, top: number, right: number, bottom: number, xyEnable: number, syncType: number): any;
+    ackMovementSync(horizontalStart: number, horizontalEnd: number, verticalStart: number, verticalEnd: number, xyEnable: number, syncType: number): any;
     _BuildAccelOnPole(builderThis: ActorPackBuilder, cmdList: Array<Object>, nexusRecv: NexusNode | null, onRevertX: Function | null, onRevertY: Function | null): void;
     _BasicPreProcess(procName: string): boolean;
     private _TeleportToInner;

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;
@@ -7,7 +11,8 @@ declare class ConditionPackBuilder {
     private _CommonInfo;
     private _CommonInfoValid;
     private _ContorlSlefNexus;
-    constructor(callbackManager: CallbackManager, selfNexus: NexusNode);
+    private _BuildersFactory;
+    constructor(callbackManager: CallbackManager, selfNexus: NexusNode, buildersFactory: any);
     isInUsing(): boolean;
     updateCommandInfo(group: number, multiTimes: boolean, specName: string | null, shoudRenderBreak: boolean): void;
     /**
@@ -47,7 +52,7 @@ declare class ConditionPackBuilder {
      * @param {NexusNode} nexusRecv 由 FreeMoveFunc.newNexus() 创建, 作为通讯句柄，类似电话号，被fireNexusEvent调用
      * @param {number} detailEventType 监听的事件类型, 类比与分机号，和fireNexusEvent发出的id约定, 自定义内容要求1000以上
      */
-    onNexusEvent(nexusRecv: NexusNode, detailEventType: number): Object | null;
+    onNexusEvent(nexusRecv: NexusNode, detailEventType: number): any;
     /**
      * OnHitBlock
      * 监听Actor关联的LayoutView与blocker碰撞的状态
@@ -59,6 +64,7 @@ declare class ConditionPackBuilder {
     /**
      * onNextTick
      * 用于对一些Condition激活进行延迟，例如teleportTo处理后延迟激活 OnHitBlock 动作，规避teleportTo处理直接触发OnHitBlocker
+     * 特别场景: onNextTick(0) 可用于充当前帧命令执行完毕的回调，相当于为命令执行完毕做一个callback
      *
      */
     onNextTick(tickGap?: number): any;

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 {
@@ -43,20 +47,20 @@ declare class StatePackBuilder {
      *
      * 发出进度同步信号(可以一个FreeMove绑定多个信号发生器，但目前场景估计只需要一个发生器即可)
      * 计算当前freeMove的postion和运动识别区域的比值
-     * xPercent = (xPos - left) / (right - left)
-     * yPercent = (yPos - top) / (bottom - top)
+     * xPercent = (xPos - horizontalStart) / (horizontalEnd - horizontalStart)
+     * yPercent = (yPos - verticalStart) / (verticalEnd - verticalStart)
      * x和y可以为负数，也可能>100%
      *
      * 当多次调用时，nexusRef相同时，则为更新运动识别区域，nexusRef不同时则为新建信号发起器
      *
      * @param {NexusNode} nexusRef  绑定的nexus句柄，接受者用这个句柄来进行监听
-     * @param {int} left  运动识别区域的left, 可以为负
-     * @param {int} top  运动识别区域的top, 可以为负
-     * @param {int} right  运动识别区域的right, 可以为负，必须大于left
-     * @param {int} bottom  运动识别区域的bottom, 可以为负，必须大于bottom
+     * @param {int} horizontalStart  横向运动识别区域的0%对应位置, 可以为负
+     * @param {int} horizontalEnd  横向运动识别区域的100%对应位置, 可以为负，可以小于start
+     * @param {int} verticalStart  纵向运动识别区域的0%对应位置, 可以为负
+     * @param {int} verticalEnd  纵向运动识别区域的100%对应位置, 可以为负，可以小于end
      * @param {int} xyEnable  x,y是否都触发, 0b01对应x, 0b10对应y, 可以或运算在一起
      */
-    startMovementSync(nexusRef: NexusNode, left: number, top: number, right: number, bottom: number, xyEnable: number): any;
+    startMovementSync(nexusRef: NexusNode, horizontalStart: number, horizontalEnd: number, verticalStart: number, verticalEnd: number, xyEnable: number): any;
     stopMovementSync(): any;
 }
 export default StatePackBuilder;

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

@@ -0,0 +1,22 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/SyncLinkManager.ts}
+ */
+
+import { NexusNode } from "./NexusNode";
+declare class SyncLinkSource {
+    nexusNode: NexusNode;
+    linkName: String;
+    constructor(name: string, node: NexusNode);
+}
+declare class SyncLinkManager {
+    private pendingPromiseList;
+    private syncSourceMap;
+    constructor();
+    SourceOnMounted(syncSource: SyncLinkSource | null): void;
+    SourceOnUnmounted(linkName: String): void;
+    WaitSourceMounted(name: String): Promise<void>;
+    UnListen(waitPromise: Promise<void>): void;
+    GetSourceNexusNode(linkName: String): NexusNode | null;
+}
+declare function GetSyncLinkManager(): SyncLinkManager;
+export { GetSyncLinkManager, SyncLinkSource };

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 {
@@ -7,6 +11,8 @@ export namespace FreeMoveDef {
 export namespace FreeMoveFunc {
     export { newNexus };
     export { ActControlDebug };
+    export { GetSyncLinkManager };
+    export { SyncLinkSource };
 }
 import { newNexus } from "./NexusNode";
 export { JsvFreeMoveActor, JsvFreeMoveActor as JsvFreeMoveDiv, JsvEnvBlocker };

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;