@shijiu/jsview-vue 2.3.0 → 2.3.728-alpha.0

package/dist/types/utils/JsViewVueWidget/JsvFlexCell/JsvFullScrAdjust.vue.d.ts

@@ -0,0 +1,100 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFlexCell/JsvFullScrAdjust.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ *  JsvFullscreenAdjust: 将给定的宽高区域(一般为主屏幕),放到屏幕中心,保持横纵比
+ *      props说明:
+ *          childWidth: number 主屏幕的宽
+ *          childHeight: number 主屏幕的高
+ *          onSized: Function(width:number, height:number) 
+                  可以通过回调知道尺寸变化后的时机，回调参数(width, height)为flex后的尺寸
+ *          background: {string} (选填)背景图案 可选值: 绝对路径url|url(相对路径url)|#FFFFFF|rbga(255,0,0,1.0)
+ *
+ *      expose说明:
+ *          getWidth():  onSize生效时，获取元素的宽度
+ *          getHeight():  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 childWidth?: number | undefined;
+                readonly childHeight?: number | 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 childWidth?: number | undefined;
+            readonly childHeight?: number | 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 childWidth?: number | undefined;
+        readonly childHeight?: number | 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/dist/types/utils/JsViewVueWidget/JsvFlexCell/JsvScreenFlex.vue.d.ts

@@ -0,0 +1,108 @@
+/** 
+ + @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(width:number, height:number) 
+                比askSize更进一步，可以通过回调知道尺寸变化后的时机，回调参数(width, height)为flex后的尺寸*          background: {string} (选填)背景图案 可选值: 绝对路径url|url(相对路径url)|#FFFFFF|rbga(255,0,0,1.0)
+            background: {string} (选填)背景图片url或者背景颜色 可选值: #FFFFFF|rbga(255,0,0,1.0)
+                                背景图会被按照objectFit:cover的形式显示
+ *
+ *      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/dist/types/utils/JsViewVueWidget/JsvFlexCell/index.d.ts

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

package/dist/types/utils/JsViewVueWidget/JsvFragShaderView/JsvFragShaderView.vue.d.ts

@@ -0,0 +1,63 @@
+/** 
+ + @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 {boolean}    reverseAnimate 是否反向动画
+*           @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, reverse?: boolean) => number;
+    stopAnim: () => void;
+    $props: {
+        readonly style?: Record<string, any> | undefined;
+        readonly duration?: number | undefined;
+        readonly autoplay?: boolean | undefined;
+        readonly reverseAnimate?: boolean | undefined;
+        readonly shaderStr?: string | undefined;
+        readonly loadComfirmed?: boolean | 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/dist/types/utils/JsViewVueWidget/JsvFragShaderView/index.d.ts

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

package/dist/types/utils/JsViewVueWidget/JsvFreeMoveActor/ActionRefObject.d.ts

@@ -0,0 +1,4 @@
+export default class ActionRefObject {
+    token: number;
+    used: boolean;
+}

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

@@ -0,0 +1,228 @@
+/** 
+ + @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";
+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;
+    private _StatePackBuilder;
+    private _Callbacks;
+    private _SelfNexusRecv;
+    private _OwnerControl;
+    constructor(owner: ActorControl, callbackManager: CallbackManager, selfNexusRecv: NexusNode);
+    /**
+     * Condition
+     * 获取创建 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 的处理队列
+     * 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, 单个Anim中唯一, Anim之间可重名, 用于指定名字进行active/deactive动作的场景
+     * @param {boolean} shoudRenderBreak 可选参数，默认false, 关联的回调是否会发起RenderBreak
+     * @return {ConditionPackBuilder} Condition指令的工厂对象
+     */
+    condition(configOrGroup?: ConditionConfig | number, multiTimes?: boolean, specName?: string | null, shoudRenderBreak?: boolean): ConditionPackBuilder;
+    /**
+     * Action
+     * 获取创建 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} Action指令的工厂对象
+     */
+    action(configOrSpeedKeeps?: ActionConfig | number, xyAccKeeps?: number, nexusRecv?: NexusNode): ActionPackBuilder;
+    /**
+     * State
+     * 获取创建 State指令 的工厂对象
+     *
+     * 用法示例:
+     *   actorControl.run((cmds)=>[ // cmds: 即为 BuilderFactory 的实例
+     *     cmds.state(...).状态指令(...),  // 状态指令: 例如 clearConditions()
+     *     ...  // 其他command
+     *   ]);
+     *
+     * 在下一帧运行前的设置值，例如清理condition, 或者在下一帧运动的前调整启动运动的位置
+     * 可用方法见 @file://./SetState.ts 的 StatePackBuilder 类
+     * @return {StatePackBuilder} State指令的工厂对象
+     */
+    state(): StatePackBuilder;
+}
+declare class ActorControl {
+    private _BindView;
+    private _BindAnim;
+    private _Callbacks;
+    private _SelfNexusRecv;
+    private _SizeMode;
+    private _CondCycleStartList;
+    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 创建并执行编排好的指令队列
+     *
+     * 用法为
+     * 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
+     *                         命令指令队列创建回调
+     *                         此回调返回值为一个数组，数组内容内容来自 Condition(), State(), Action()
+     *                         这些工厂类创建的Command pack
+     */
+    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;
+}
+export default ActorControl;

package/dist/types/utils/JsViewVueWidget/JsvFreeMoveActor/ActorState.d.ts

@@ -0,0 +1,6 @@
+export default class ActorState {
+    xPos: number;
+    yPos: number;
+    xSpd: number;
+    ySpd: number;
+}

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

@@ -0,0 +1,16 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/CallbackManager.ts}
+ */
+
+import type { CommandType } from "./CmdTypes";
+declare class CallbackManager {
+    private _CallbackMap;
+    private _IdGen;
+    constructor();
+    private addCallback;
+    clearCallback(): void;
+    expiredIds(ids: Array<string>): void;
+    invokeCallback(id: string, actorState: Object, customDataStr: string | null | undefined, nexusCustomDataStr: string | null | undefined): void;
+    buildCallbackCmd(func: Function): CommandType;
+}
+export default CallbackManager;

package/dist/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/dist/types/utils/JsViewVueWidget/JsvFreeMoveActor/ForgeTypeDefine.d.ts

@@ -0,0 +1,20 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvFreeMoveActor/ForgeTypeDefine.ts}
+ */
+
+declare const ActEventDefine: {
+    ActFinish: any;
+    SpeedRevertX: any;
+    SpeedRevertY: any;
+    ActReject: any;
+};
+declare const GroupType_ActionAssoc: number;
+declare const ConditionSetBuilder: any;
+declare const StateCmdBuilder: any;
+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, FireGlobalNexus, FinishRenderBreak };