@shijiu/jsview-vue 2.3.151-test.0 → 2.3.728-alpha.0

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

@@ -6,6 +6,17 @@ import { NexusNode } from "./NexusNode";
 interface CmdListCreator {
     (builders: BuilderFactory): Array<Object>;
 }
+interface ConditionConfig {
+    group?: number;
+    multiTimes?: boolean;
+    specName?: string | null;
+    shoudRenderBreak?: boolean;
+}
+interface ActionConfig {
+    xySpeedKeeps?: number;
+    xyAccKeeps?: number;
+    nexusRecv?: NexusNode | null;
+}
 declare class BuilderFactory {
     private _SharedQuickConditionPackBuilder;
     private _SharedQuickActionPackBuilder;
@@ -16,39 +27,108 @@ declare class BuilderFactory {
     constructor(owner: ActorControl, callbackManager: CallbackManager, selfNexusRecv: NexusNode);
     /**
      * Condition
-     * 获取创建 ConditionPack 的工厂对象
+     * 获取创建 Condition指令 的工厂对象
+     * 用法示例:
+     *   actorControl.run((cmds)=>[ // cmds: 即为 BuilderFactory 的实例
+     *     cmds.condition(...).条件指令(...).then([  // 条件指令: 例如 wallPosition()
+     *       cmds.condition(...).其他条件指令(...),  // 其他condition创建
+     *       (actorState)=>{
+     *         // 条件满足时预设的指令集
+     *         console.log(
+     *           "condition triggered",
+     *           actorState.xPos, actorState.yPos,
+     *           actorState.xSpd, actorState.ySpd,
+     *           actorState.xAcc, actorState.yAcc);
+     *       },
+     *       ...  // 其他command
+     *     ]),
+     *     ...  // 其他command
+     *   ]);
+     *
      * ConditionPack对应支持 .then(cmdPackList), 可传入同 Run 的处理队列
-     * 可用方法见 ./SetCondition.js
-     * @param {int} group 可选参数，默认为0, 有效值为0~3, 对应默认组, 1组, 2组, 3组, 便于remove时，按组进行清理
+     * cmdPackList中是新的由 action(), state(), condition(), (actorState)=>{} 组成的指令集
+     * 其中(actorState)=>{} 是 condition().xxxx.then() 中独有的指令类型, 用于对接此condition触发后, 进行js端的回调
+     * actorState {
+     *   xPos: number, // 当前drawX的值
+     *   yPos: number, // 当前drawY的值
+     *   xSpd: number, // 当前SpeedX的值
+     *   ySpd: number, // 当前SpeedY的值
+     *   xAcc: number, // 当前AccelerationX的值
+     *   yAcc: number, // 当前AccelerationY的值
+     * }
+     *
+     * 创建condition时, 会记录当时的 baseOffset 坐标, 其设定值在进行比较时会转换成baseX和baseY坐标, 然后进行比较
+     * 所以不同担心div的style.top, style.left改变后, condition设置的条件中的坐标会发生偏移导致需要重新设置
+     * 比如: wallPosition(), boxPosition() 这种要常驻的condition
+     *
+     * boxPosition 用法示例(边界框与背景div尺寸一致):
+     *   // div1 背景: (0, 0) -> (400, 400)
+     *   cmds.condition({ multiTimes: true })
+     *     .boxPosition(0, 0, 400, 400)
+     *     .then([cmds.action().stopMoving(true)]);
+     *
+     *   // div2 背景: (0, 0) -> (200, 200)
+     *   cmds.condition({ multiTimes: true })
+     *     .boxPosition(0, 0, 200, 200)
+     *     .then([cmds.action().stopMoving(true)]);
+     *
+     * condition创建时, 可以用group和specName进行归类, 以便于后续按需清理, 例如:
+     * wallPosition()在一启动的时候有, 后续就没有了, 而还有其他condition存在, 不能使用state().clearConditions()全清理
+     *
+     * action指令内部也可能自己创建一些associated condition, 这些condition会被action执行完成后自动回收, 不需要通过state指令主动清理
+     *
+     * 可用方法见 @file://./SetCondition.ts 的 ConditionPackBuilder 类
+     * @param {int | ConditionConfig} configOrGroup 可选参数，默认为0, 有效值为0~3, 对应默认组, 1组, 2组, 3组, 便于remove时，按组进行清理, 单个Anim中唯一, Anim之间可重名
+     *                                     也可以传入一个Object, 包含 group, multiTimes, specName, shoudRenderBreak 四个属性
      * @param {boolean} multiTimes 可选参数，默认为false, 是否要多次执行,
      *                      若为单次, 当group未设定时自动作废，当group设定时，不作废但改为deactive状态
-     * @param {string} specName 可选参数，默认null, 命名condition, 用于指定名字进行active/deactive动作的场景
+     * @param {string} specName 可选参数，默认null, 命名condition, 单个Anim中唯一, Anim之间可重名, 用于指定名字进行active/deactive动作的场景
      * @param {boolean} shoudRenderBreak 可选参数，默认false, 关联的回调是否会发起RenderBreak
-     * @return {ConditionPackBuilder} ConditionPack 的工厂对象
+     * @return {ConditionPackBuilder} Condition指令的工厂对象
      */
-    condition(group?: number, multiTimes?: boolean, specName?: string | null, shoudRenderBreak?: boolean): ConditionPackBuilder;
+    condition(configOrGroup?: ConditionConfig | number, multiTimes?: boolean, specName?: string | null, shoudRenderBreak?: boolean): ConditionPackBuilder;
     /**
      * Action
-     * 获取创建 ActionPack 的工厂对象
-     * 注意: ActionPack 是指会改变 speed 或 accelerate 并自动生成子condition的指令，
-     * 每个新的Action会覆盖掉前一次的Action设置，包括其关联的condition，
-     * 以及上一个action中的回调，以及上一个action中规划中的ActionEvent
-     * 可用方法见 ./SetAction.js
+     * 获取创建 Action指令 的工厂对象
      *
-     * @param {int} xySpeedKeeps xy轴上的速度是否保持(与新Action不冲突的才会被保留)，
+     * 用法示例:
+     *   actorControl.run((cmds)=>[ // cmds: 即为 BuilderFactory 的实例
+     *     cmds.action(...).动作指令(...),  // 动作指令: 例如 teleportOffset()
+     *     ...  // 其他command
+     *   ]);
+     *
+     * Action主要是改变speed和accelerate的值，在Action指令中还包含一些综合指令, 例如:
+     *    brakeToPosition: 通过内部创建一些associated condition来实现减速并停止到目标位置
+     *    setSpdAndAccel: 同时设置速度和加速度，并提供拐点回调(用于抛物线处理)
+     *
+     * Action有个重要个规则: 一个FreeMoveActor中, 一个时间只会激活一条Action指令,
+     * 当下一条Action指令激活时, 会默认自动重置因为上一条Action而改变的SpeedX/Y(重置为0), AccelerationX/Y(重置为0), 以及其associated condition
+     * 但也可以进行主动保持, 通过 xySpeedKeeps 和 xyAccKeeps 参数控制
+     *
+     * 可用方法见 @file://./SetAction.ts 的 ActionPackBuilder 类
+     *
+     * @param {int | ActionConfig} configOrSpeedKeeps xy轴上的速度是否保持(与新Action不冲突的才会被保留)，
      *                           x轴保持为1, y轴保持为2，可"与或"让两个轴都保持
+     *                           也可以传入一个Object, 包含 xySpeedKeeps, xyAccKeeps, nexusRecv 三个属性
      * @param {int} xyAccKeeps xy轴上的加速度是否保持(与新Action不冲突的才会被保留)，
      *                         x轴保持为1, y轴保持为2，可"与或"让两个轴都保持
      * @param {NexusNode} nexusRecv 此动作发出的 nexusEvent 的接受者
-     * @return {ActionPackBuilder} ActionPack 的工厂对象
+     * @return {ActionPackBuilder} Action指令的工厂对象
      */
-    action(xySpeedKeeps?: number, xyAccKeeps?: number, nexusRecv?: NexusNode | null): ActionPackBuilder;
+    action(configOrSpeedKeeps?: ActionConfig | number, xyAccKeeps?: number, nexusRecv?: NexusNode): ActionPackBuilder;
     /**
      * State
-     * 获取创建 StatePack 的工厂对象
+     * 获取创建 State指令 的工厂对象
+     *
+     * 用法示例:
+     *   actorControl.run((cmds)=>[ // cmds: 即为 BuilderFactory 的实例
+     *     cmds.state(...).状态指令(...),  // 状态指令: 例如 clearConditions()
+     *     ...  // 其他command
+     *   ]);
+     *
      * 在下一帧运行前的设置值，例如清理condition, 或者在下一帧运动的前调整启动运动的位置
-     * 可用方法见 ./SetState.js
-     * @return {StatePackBuilder} StatePack 的工厂对象
+     * 可用方法见 @file://./SetState.ts 的 StatePackBuilder 类
+     * @return {StatePackBuilder} State指令的工厂对象
      */
     state(): StatePackBuilder;
 }
@@ -62,10 +142,43 @@ declare class ActorControl {
     private _CondCycleEndList;
     private _Builders;
     constructor();
+    /**
+     * 内部API
+     *
+     * asSizeMode
+     */
     asSizeMode(): void;
+    /**
+     * 内部API
+     *
+     * bindForgeView
+     * 为普通的div创建ActorControl控制
+     *
+     * @param {any} bindView forgeView实例
+     * @param {boolean} instantActive 是否立即激活动画
+     */
     bindForgeView(bindView: any, instantActive: boolean): void;
     /**
-     * run 执行编排好的intent集合
+     * run 创建并执行编排好的指令队列
+     *
+     * 用法为
+     * actorControl.run((cmds)=>[ // 指令队列
+     *   cmds.state(...).状态指令(...),
+     *   cmds.action(...).动作指令(...),
+     *   cmds.condition(...).条件指令(...).then([
+     *     // 条件满足时预设的指令集队列
+     *     cmds.condition(...).其他条件指令(...),
+     *     (actorState)=>{
+     *       console.log(
+     *         "condition triggered",
+     *         actorState.xPos, actorState.yPos,
+     *         actorState.xSpd, actorState.ySpd,
+     *         actorState.xAcc, actorState.yAcc);
+     *     },
+     *     ...
+     *   ]),
+     *   ...
+     * ]);
      *
      * @param {CmdListCreator} commandsCreator
      *                         命令指令队列创建回调
@@ -74,16 +187,36 @@ declare class ActorControl {
      */
     run(commandsCreator: CmdListCreator | undefined): void;
     _WrappedRun(cmdPackList: Array<Object>): void;
+    /**
+     * 内部API
+     *
+     * getBindedAnim
+     */
     getBindedAnim(): any;
+    /**
+     * 内部API
+     *
+     * getBindedView
+     */
     getBindedView(): any;
     /**
      * addCondCycleListener
      * 追加 cond cycle listener，可以根据start和end来进行callback时序排序
      *
+     * 应对场景为, 在condition的 (ActorState)=>{} 回调中,
+     * 当一帧中condition的多个回调发生时(可能复数的condition被触发,也可能是一个condition有多个回调), 协调这些回调的处理逻辑的场景
+     *
      * @param {Function} startCycleCallback   开始执行一帧的js回调(condition的callback)
      * @param {Function} endCycleCallback  执行一帧的js回调完毕
      */
     addCondCycleListener(startCycleCallback: Function, endCycleCallback: Function): void;
+    /**
+     * removeCondCycleListener
+     * 移除由 addCondCycleListener 加入的回调
+     *
+     * @param {Function} startCycleCallback   开始执行一帧的js回调(condition的callback)
+     * @param {Function} endCycleCallback  执行一帧的js回调完毕
+     */
     removeCondCycleListener(startCycleCallback: Function, endCycleCallback: Function): void;
     _OnEchoEvent(retJson: string): void;
     _EnsureAnim(): void;

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

@@ -1,3 +1,4 @@
+import type { CommandType } from "./CmdTypes";
 declare class CallbackManager {
     private _CallbackMap;
     private _IdGen;
@@ -6,6 +7,6 @@ declare class CallbackManager {
     clearCallback(): void;
     expiredIds(ids: Array<string>): void;
     invokeCallback(id: string, actorState: Object, customDataStr: string | null | undefined, nexusCustomDataStr: string | null | undefined): void;
-    buildCallbackCmd(func: Function): Object;
+    buildCallbackCmd(func: Function): CommandType;
 }
 export default CallbackManager;

package/bin/types/utils/JsViewVueWidget/JsvFreeMoveActor/CmdTypes.d.ts

@@ -0,0 +1,16 @@
+export interface CommandType {
+    typ: number;
+    set?: {};
+}
+export interface ConditionPackType {
+    subt: number;
+    react?: number;
+    cmds?: Array<CommandType>;
+    cmdPacks?: Array<CommandPackType>;
+}
+export interface CommandPackType {
+    t: number;
+    cmd?: CommandType;
+    cmds?: Array<CommandType> | null;
+    then?: Function;
+}

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

@@ -11,5 +11,6 @@ declare const ActionCmdBuilder: any;
 declare const CmdPackBuilder: any;
 declare const FreeMoveAnimClass: any;
 declare const RunFreeMoveCmdPacks: Function;
+declare const FireGlobalNexus: Function;
 declare const FinishRenderBreak: Function;
-export { GroupType_ActionAssoc, ActEventDefine, ConditionSetBuilder, ActionCmdBuilder, StateCmdBuilder, CmdPackBuilder, FreeMoveAnimClass, RunFreeMoveCmdPacks, FinishRenderBreak };
+export { GroupType_ActionAssoc, ActEventDefine, ConditionSetBuilder, ActionCmdBuilder, StateCmdBuilder, CmdPackBuilder, FreeMoveAnimClass, RunFreeMoveCmdPacks, FireGlobalNexus, FinishRenderBreak };

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

@@ -3,4 +3,6 @@ declare class NexusNode {
     constructor();
 }
 declare function newNexus(): NexusNode;
-export { NexusNode, newNexus };
+declare function fireGlobalNexus(NexusNode: NexusNode): void;
+declare const GLOBAL_CUSTOM_NEXUS_DETAIL_TYPE = 1001;
+export { NexusNode, GLOBAL_CUSTOM_NEXUS_DETAIL_TYPE, newNexus, fireGlobalNexus };

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

@@ -1,13 +1,18 @@
 import CallbackManager from "./CallbackManager";
 import { NexusNode } from "./NexusNode";
-declare class ActorPackBuilder {
+import type { CommandPackType } from "./CmdTypes";
+/**
+ * action().XXXXX 可用的API说明
+ * 标注"内部API"的API, 应用开发时一定!!不要使用, 因为后续版本可能调整导致失效
+ */
+declare class ActionPackBuilder {
     _CallbackManager: CallbackManager;
     private _ActionTokenGen;
     private _SpeedKeeps;
     private _AccKeeps;
     private _NexusRecv;
     private _CommonInfoValid;
-    private _ContorlSlefNexus;
+    private _ContorlSelfNexus;
     constructor(callbackManager: CallbackManager, selfNexus: NexusNode);
     isInUsing(): boolean;
     updateCommonInfo(xySpdEnables: number, xyAccEnables: number, nexusRecv: NexusNode | null): void;
@@ -39,33 +44,71 @@ declare class ActorPackBuilder {
      *                       undefined时，若edgeX设置, 则把edge作为运动目标，以另一轴速度反推此速度, 否则不改变该轴速度
      * @param {double} ySpeed 运行速度，使用时会自动取绝对值，单位(pixel/帧)
      *                       undefined时，若targetY设置, 则把edge作为运动目标，以另一轴速度反推此速度, 否则不改变该轴速度
-     * @param {function} endCallback 参数(x, y) 运动到目标位置后的回调函数, x或者y达到后即回调，以先到为准，回报当前Actor的相对于原始位置的x,y
+     * @param {function | Array} endCallback
+     *                        function: js消息通知(异步), 参数(x, y) 运动到目标位置后的回调函数, x或者y达到后即回调，以先到为准，
+     *                               回报当前Actor的相对于原始位置的x,y
+     *                        Array: 命令集
      * @return CommandPack(放入run或者then的CmdPackList队列)
      */
-    moveTo(edgeX: number | undefined, edgeY: number | undefined, xSpeed: number | undefined, ySpeed: number | undefined, endCallback?: Function | null): any;
-    altSpeed(xSpeed: number | undefined, ySpeed: number | undefined, spreadFrame: number | undefined, finishCallback?: Function | null): any;
-    brakeToPosition(targetX: number | undefined, targetY: number | undefined, finishCallback?: Function | null, rejectedCallback?: Function | null): any;
+    moveTo(edgeX: number | undefined, edgeY: number | undefined, xSpeed: number | undefined, ySpeed: number | undefined, endCallback?: Function | Array<CommandPackType | Function> | null): any;
+    altSpeed(xSpeed: number | undefined, ySpeed: number | undefined, spreadFrame: number | undefined, finishCallback?: Function | Array<CommandPackType | Function> | null): any;
+    brakeToPosition(targetX: number | undefined, targetY: number | undefined, finishCallback?: Function | Array<CommandPackType | Function> | null, rejectedCallback?: Function | Array<CommandPackType | Function> | null): any;
     setSpeed(spdX: number | undefined, spdY: number | undefined): any;
-    setAccel(accelX: number | undefined, accelY: number | undefined, onRevertX?: Function | null, onRevertY?: Function | null): any;
-    setSpdAndAccel(spdX: number | undefined, spdY: number | undefined, accelX: number | undefined, accelY: number | undefined, onRevertX?: Function | null, onRevertY?: Function | null): any;
+    scaleSpeed(scaleX: number | undefined, scaleY: number | undefined): any;
+    setAccel(accelX: number | undefined, accelY: number | undefined, onRevertX?: Function | Array<CommandPackType | Function> | null, onRevertY?: Function | Array<CommandPackType | Function> | null): any;
+    /**
+     * setSpdAndAccel
+     * 同时设置速度和加速度，并提供拐点回调(用于抛物线处理)
+     *
+     * 参数说明:
+     *      spdX      (double) x 速度有效值，可正可负, 每帧的posX移动量, 可以传入undefined来决定此值不设置
+     *      spdY      (double) y 速度有效值，可正可负, 每帧的posY移动量, 可以传入undefined来决定此值不设置
+     *      accelX    (double) 加速度有效值，可正可负，每帧spdX的调整量，可以传入undefined来决定此值不设置
+     *      accelY    (double) 加速度有效值，可正可负，每帧spdY的调整量，可以传入undefined来决定此值不设置
+     *      onRevertX (Function | Array) x速度开始反向运动时的处理(例如抛物到达顶点)
+     *                              Function: js消息通知(异步), 不要把新的run需求放这里, 会导致时机控制不准
+     *                              Array: 命令集(会按 then 链路进行翻译处理)
+     *      onRevertY (Function | Array) y速度开始反向运动时的处理(例如抛物到达顶点)
+     *                              Function: js消息通知(异步), 不要把新的run需求放这里, 会导致时机控制不准
+     *                              Array: 命令集(会按 then 链路进行翻译处理)
+     */
+    setSpdAndAccel(spdX: number | undefined, spdY: number | undefined, accelX: number | undefined, accelY: number | undefined, onRevertX?: Function | Array<CommandPackType | Function> | null, onRevertY?: Function | Array<CommandPackType | Function> | null): any;
+    /**
+     * stopMoving
+     * 停止运动
+     *      isExact (boolean) 设置为true时,
+     *          如果在positionCondition中会按照condition的位置进行精准停止
+     *          从而解决在condition.then中停止时,停止的位置因为上帧的drawX/Y + speedX/Y并不是完全和condition不吻合,而希望吻合的问题
+     */
     stopMoving(isExact?: boolean): any;
+    /**
+     * alignSpeed
+     * 在condition().then()中使用, 只在speed相关的condition中才会响应
+     * 用condition的速度设定值,来校准speed值, 相当于用condition的speed值来进行 action().setSpeed()
+     * 以解决加速对速度进行改变后，速度值已经超过了condition中设定的阈值时, 想纠正回来的场景
+     *
+     * 标准的停止加速度但保持速度的方法为: action(FreeMoveDef.KeepFlags.XY, 0).alignSpeed()
+     * 即通过action()构建的第二个参数把加速度清除
+     */
+    alignSpeed(): any;
     /**
      * ackMovementSync
-     * 只能放在 movementSync 的then中，用于将Sync同步信息按比例转化成
+     * 只能放在 movementSync 的then中，用于将Sync同步信息按比例转化成自身的freeMoveDiv的位置值
      * (注意): 如果触发链条上有自己发出的信息，则将不再产生动作，规避循环触发
      *
      * @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} xyEnable  x,y是否都触发, 使用FreeMoveDef.KeepFlags设置x,y,或者xy
      * @param {int} syncType 换算公式:
      *                        1: 正比公式:selfPercent = givenPercent
      *                        2: 反比公式:selfPercent = (1 - givenPercent)
      */
     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;
+    _BuildAccelOnPole(builderThis: ActionPackBuilder, cmdList: Array<Object>, nexusRecv: NexusNode | null, onRevertX: Function | Array<CommandPackType | Function> | null, onRevertY: Function | Array<CommandPackType | Function> | null): void;
+    private _BuildCallbackCmdPackList;
     _BasicPreProcess(procName: string): boolean;
     private _TeleportToInner;
 }
-export default ActorPackBuilder;
+export default ActionPackBuilder;

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

@@ -1,12 +1,18 @@
 import CallbackManager from "./CallbackManager";
 import { NexusNode } from "./NexusNode";
+import type { CommandPackType, ConditionPackType } from "./CmdTypes";
 type UNumber = undefined | number;
+export declare const TranslateCondThenCmdPackList: (callbackManager: CallbackManager, cmdPackList: Array<CommandPackType | Function>) => void;
 type WallDirection = "left" | "right" | "top" | "bottom";
+/**
+ * condition().XXXXX 可用的API说明
+ * 标注"内部API"的API, 应用开发时一定!!不要使用, 因为后续版本可能调整导致失效
+ */
 declare class ConditionPackBuilder {
     _Callbacks: CallbackManager;
     private _CommonInfo;
     private _CommonInfoValid;
-    private _ContorlSlefNexus;
+    private _ContorlSelfNexus;
     private _BuildersFactory;
     constructor(callbackManager: CallbackManager, selfNexus: NexusNode, buildersFactory: any);
     isInUsing(): boolean;
@@ -14,74 +20,205 @@ declare class ConditionPackBuilder {
     /**
      * reachPosition
      * 获取 ReachPosition 的condition
-     * x或y已经处于，或者被越过时触发
+     * x或y已经处于，或者被越过时触发,
+     * 此接口主要用于途径中途点的监听, 若要定义运动边界, 用positionWall/positionBox更合适
      *
      * @param {double} xPosition 位置有效值，可以传入undefined来决定此值不设置
      * @param {double} yPosition 位置有效值，可以传入undefined来决定此值不设置
      */
-    reachPosition(xPosition: number | undefined, yPosition: number | undefined): Object | null;
+    reachPosition(xPosition: number | undefined, yPosition: number | undefined): CommandPackType | null;
     /**
-     * reachPosition
-     * 获取 ReachPosition 的condition
+     * onSpeedAcross
+     * 创建速度跨越阈值检测条件
+     * 当速度跨越给定阈值后触发
+     *
+     * 经典场景是检测抛物运动的拐点(定点),
+     * 例如 condition().onSpeedAcross("y", 0).then([(ActorState)=>{}])
+     *
+     * @param {string} xOrY "x"为x轴，"y"为y轴
+     * @param {number} speedVale 速度阈值
+     */
+    onSpeedAcross(xOrY: string, speedVale: number): CommandPackType | null;
+    /**
+     * speedBoundary
+     * 创建速度阈值检测条件(单个阈值)
+     * 当速度超过给定阈值后触发
+     *
+     * @param {string} boundName 边界名称，可以是 "x-min" | "x-max" | "y-min" | "y-max"
+     * @param {Object} speedSet 速度设置，可以是 {speed: number, limit: number}
+     */
+    speedBoundary(boundName: string, speedVale: number): CommandPackType | null;
+    /**
+     * speedAllBoundary
+     * 创建速度所有阈值检测条件(x,y的max/min阈值，Max=上限，Min=下限)
+     * 当速度超过给定阈值后触发
+     *
+     * @param {number} xMinLimit x轴下限阈值
+     * @param {number} xMaxLimit x轴上限阈值
+     * @param {number} yMinLimit y轴下限阈值
+     * @param {number} yMaxLimit y轴上限阈值
+     */
+    speedAllBoundary(xMinLimit: number | undefined, xMaxLimit: number | undefined, yMinLimit: number | undefined, yMaxLimit: number | undefined): CommandPackType | null;
+    /**
+     * positionWall/wallPosition
+     * 创建碰墙(单面)检测条件
      * x或y已经处于，或者被越过时触发
      *
-     * @param {double} xPosition 位置有效值，可以传入undefined来决定此值不设置
-     * @param {double} yPosition 位置有效值，可以传入undefined来决定此值不设置
+     * 和reachPosition的最大区别是,
+     * reach是有跨过行为才激活,
+     * 而wall是初始位置已经超过wall时就会立刻激活
+     *
+     * @param {string} direction 方向，可以是 "left" | "right" | "top" | "bottom", 标明初始wall位置相对运动物体的方位
+     * @param {double} position 位置有效值，direction为left/right时作用于x，direction为top/bottom时作用于y
      */
-    wallPosition(direction: WallDirection, xPosition: UNumber, yPosition: UNumber): object | null;
-    boxPosition(left: UNumber, top: UNumber, right: UNumber, bottom: UNumber): any;
-    offsetPosition(left: UNumber, top: UNumber, right: UNumber, bottom: UNumber): object | null;
-    startMove(xEnable: boolean, yEnable: boolean): any;
+    positionWall(direction: WallDirection, position: UNumber): CommandPackType | null;
+    wallPosition(direction: WallDirection, position: UNumber): CommandPackType | null;
     /**
-     * AcrossPosition
-     * 获取 AcrossPosition 的condition
-     * x或y被越过时触发
+     * positionBox/boxPosition
+     * 创建碰墙(4面)检测条件
+     * 相当于用4面wallPosition组合起来的box(本物体一般处于box内, 一旦移到box外就激活)
      *
-     * @param {double} xPosition 位置有效值，可以传入undefined来决定此值不设置
-     * @param {double} yPosition 位置有效值，可以传入undefined来决定此值不设置
+     * @param {double} left 左边界位置有效值，可以传入undefined来表面此面无wallPosition
+     * @param {double} top 上边界位置有效值，可以传入undefined来表面此面无wallPosition
+     * @param {double} right 右边界位置有效值，可以传入undefined来表面此面无wallPosition
+     * @param {double} bottom 下边界位置有效值，可以传入undefined来表面此面无wallPosition
+     */
+    positionBox(left: UNumber, top: UNumber, right: UNumber, bottom: UNumber): CommandPackType | null;
+    boxPosition(left: UNumber, top: UNumber, right: UNumber, bottom: UNumber): CommandPackType | null;
+    /**
+     * offsetPosition
+     * 当div运动了给定的偏移量后触发
+     *
+     * @param {double} left 向左移动多少触发，为正整数
+     * @param {double} top 向上移动多少触发，为正整数
+     * @param {double} right 向右移动多少触发，为正整数
+     * @param {double} bottom 向下移动多少触发，为正整数
+     */
+    offsetPosition(left: UNumber, top: UNumber, right: UNumber, bottom: UNumber): CommandPackType | null;
+    /**
+     * startMove
+     * 当FreeMove块开始移动时触发, 用于探测方块从静止到移动的过程
+     *
+     * @param {boolean} xEnable x轴是否启用
+     * @param {boolean} yEnable y轴是否启用
+     */
+    startMove(xEnable: boolean, yEnable: boolean): CommandPackType | null;
+    /**
+     *
+     * onCustomNexus
+     * 响应由 state.fireCustomNexus 发起的event
+     * 是用户事件处理中激发预制命令集的手段
+     *
+     * @param {NexusNode} nexusRecv 由 FreeMoveFunc.newNexus() 创建, 为通讯匹配的句柄, 类似电话号
      */
-    acrossPosition(xPosition: number | undefined, yPosition: number | undefined): Object | null;
+    onCustomNexus(nexusRecv: NexusNode): CommandPackType | null;
     /**
+     * 内部API
+     *
      * OnNexusEvent
-     * 响应 actRef 关联的 action 所发出的内部状态信息
+     * 响应由 state.fireNexusEvent 发起的event
+     * 是用户事件处理中激发预制命令集的手段
      *
      * @param {NexusNode} nexusRecv 由 FreeMoveFunc.newNexus() 创建, 作为通讯句柄，类似电话号，被fireNexusEvent调用
      * @param {number} detailEventType 监听的事件类型, 类比与分机号，和fireNexusEvent发出的id约定, 自定义内容要求1000以上
      */
-    onNexusEvent(nexusRecv: NexusNode, detailEventType: number): any;
+    onNexusEvent(nexusRecv: NexusNode, detailEventType: number): CommandPackType | null;
     /**
+     * 内部API
+     *
      * OnHitBlock
      * 监听Actor关联的LayoutView与blocker碰撞的状态
      * 碰撞发生后，可以 State.revertWithHitBlock 将LayoutView返回到紧贴到碰撞点的状态
      *
      * @param {number} blkGID 想监听的blocker集群的组ID, 例如所有的跳板横向碰撞面，或者所有的跳板边缘的纵向碰撞面, 0为无效值
      */
-    onHitBlock(blkGID: number): any;
+    onHitBlock(blkGID: number): CommandPackType | null;
     /**
      * onNextTick
      * 用于对一些Condition激活进行延迟，例如teleportTo处理后延迟激活 OnHitBlock 动作，规避teleportTo处理直接触发OnHitBlocker
      * 特别场景: onNextTick(0) 可用于充当前帧命令执行完毕的回调，相当于为命令执行完毕做一个callback
      *
      */
-    onNextTick(tickGap?: number): any;
+    onNextTick(tickGap?: number): CommandPackType | null;
     /** 指定的swapcount前才能执行 */
-    onSwapCount(): any;
-    onDragStart(): any;
-    onDragEnd(): any;
-    onTouchDown(): any;
-    onTouchRelease(): any;
-    onFlingStart(): any;
-    onFlingProgress(): any;
-    onFlingEnd(): any;
-    onFlingCancel(): any;
-    onFlingDrop(): any;
     /**
+     * 内部API
+     *
+     * onSwapCount
+     */
+    onSwapCount(): CommandPackType | null;
+    /**
+     * 内部API
+     *
+     * onDragStart
+     * 当拖拽开始时触发
+     */
+    onDragStart(): CommandPackType | null;
+    /**
+     * 内部API
+     */
+    onDragEnd(): CommandPackType | null;
+    /**
+     * 内部API
+     */
+    onTouchDown(): CommandPackType | null;
+    /**
+     * 内部API
+     */
+    onTouchRelease(): CommandPackType | null;
+    /**
+     * 内部API
+     *
+     * onFlingStart
+     * 当 fling 开始时触发
+     */
+    onFlingStart(): CommandPackType | null;
+    /**
+     * 内部API
+     *
+     * onFlingProgress
+     * 当 fling 过程中触发
+     */
+    onFlingProgress(): CommandPackType | null;
+    /**
+     * 内部API
+     *
+     * onFlingEnd
+     * 当 fling 结束时触发
+     */
+    onFlingEnd(): CommandPackType | null;
+    /**
+     * 内部API
+     *
+     * onFlingCancel
+     * 当 fling 取消时触发
+     */
+    onFlingCancel(): CommandPackType | null;
+    /**
+     * 内部API
+     *
+     * onFlingDrop
+     * 当 fling 拖拽结束时触发
+     */
+    onFlingDrop(): CommandPackType | null;
+    /**
+     * 内部API
+     *
+     * onMouseWheelScrollProgress
+     * 当鼠标滚轮滚动时触发
+     */
+    onMouseWheelScrollProgress(): CommandPackType | null;
+    /**
+     * 内部API
+     *
      * touchCount
      * 当touchDown时，Count会++，用于解决多次touchDown引发的时序问题
      * 当native的count计数等于给定的参数设定的count时，触发condition
      */
-    touchCount(count: number): any;
+    touchCount(count: number): CommandPackType | null;
     /**
+     * 内部API
+     *
      * onMovement
      * 当FreeMove块移动时，移动了给定的距离值后触发条件, 给定的距离值由sensitivity定义
      *
@@ -89,9 +226,15 @@ declare class ConditionPackBuilder {
      * @param {float} ySensitivity y轴的敏感度设置，表示移动了多少像素时就触发条件, undefined时等于xSensitivity
      * @param {int} xyEnables x,y两轴哪个生效, 0b1 为x, 0b10 为y, 默认为都enable
      */
-    onMovement(xSensitivity: number, ySensitivity?: number | undefined, xyEnables?: number | undefined): any;
-    movementSync(nexusRef: NexusNode): any;
+    onMovement(xSensitivity: number, ySensitivity?: number | undefined, xyEnables?: number | undefined): CommandPackType | null;
+    /**
+     * 内部API
+     *
+     * movementSync
+     * @param {NexusNode} nexusRef 用于同步运动的nexus节点
+     */
+    movementSync(nexusRef: NexusNode): CommandPackType | null;
     _CheckCommonInfo(): boolean;
-    _BuildPack(conditionSet: Object): any;
+    _BuildPack(conditionSet: ConditionPackType): CommandPackType;
 }
 export default ConditionPackBuilder;