@shijiu/jsview-vue 2.3.151-test.0 → 3.0.0

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

@@ -1,78 +1,61 @@
-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<{}>>, {
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+type __VLS_WithSlots<T, S> = T & (new () => {
+    $slots: S;
+});
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    childWidth: {
+        type: NumberConstructor;
+        default: number;
+    };
+    childHeight: {
+        type: NumberConstructor;
+        default: number;
+    };
+    askSize: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    onSized: {
+        type: FunctionConstructor;
+        default: null;
+    };
+    background: {
+        type: StringConstructor;
+        default: null;
+    };
+}>, {
     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, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    childWidth: {
+        type: NumberConstructor;
+        default: number;
     };
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, {}, {}, string> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & (new () => {
-    $slots: {
-        default: (_: {}) => any;
+    childHeight: {
+        type: NumberConstructor;
+        default: number;
     };
-});
-export default _default;
+    askSize: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    onSized: {
+        type: FunctionConstructor;
+        default: null;
+    };
+    background: {
+        type: StringConstructor;
+        default: null;
+    };
+}>> & Readonly<{}>, {
+    background: string;
+    askSize: boolean;
+    onSized: Function;
+    childWidth: number;
+    childHeight: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+type __VLS_Slots = {
+    default?: ((props: {}) => any) | undefined;
+};

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

@@ -1,75 +1,45 @@
-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<{}>>, {
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+type __VLS_WithSlots<T, S> = T & (new () => {
+    $slots: S;
+});
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    style: ObjectConstructor;
+    askSize: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    onSized: {
+        type: FunctionConstructor;
+        default: null;
+    };
+    background: {
+        type: StringConstructor;
+        default: null;
+    };
+}>, {
     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, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    style: ObjectConstructor;
+    askSize: {
+        type: BooleanConstructor;
+        default: boolean;
     };
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, {}, {}, string> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & (new () => {
-    $slots: {
-        default: (_: {}) => any;
+    onSized: {
+        type: FunctionConstructor;
+        default: null;
     };
-});
-export default _default;
+    background: {
+        type: StringConstructor;
+        default: null;
+    };
+}>> & Readonly<{}>, {
+    background: string;
+    askSize: boolean;
+    onSized: Function;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+type __VLS_Slots = {
+    default?: ((props: {}) => any) | undefined;
+};

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

@@ -1,16 +1,85 @@
-declare const _default: import("vue").DefineComponent<{}, {
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    style: {
+        type: ObjectConstructor;
+        required: true;
+    };
+    duration: {
+        type: NumberConstructor;
+        default: number;
+    };
+    autoplay: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    reverseAnimate: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    shaderStr: {
+        type: StringConstructor;
+        required: true;
+    };
+    uniforms: {
+        type: ArrayConstructor;
+    };
+    textures: {
+        type: ArrayConstructor;
+    };
+    onEnd: {
+        type: FunctionConstructor;
+    };
+    onStart: {
+        type: FunctionConstructor;
+    };
+    loadComfirmed: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>, {
     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 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;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    style: {
+        type: ObjectConstructor;
+        required: true;
+    };
+    duration: {
+        type: NumberConstructor;
+        default: number;
+    };
+    autoplay: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    reverseAnimate: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    shaderStr: {
+        type: StringConstructor;
+        required: true;
+    };
+    uniforms: {
+        type: ArrayConstructor;
+    };
+    textures: {
+        type: ArrayConstructor;
+    };
+    onEnd: {
+        type: FunctionConstructor;
+    };
+    onStart: {
+        type: FunctionConstructor;
+    };
+    loadComfirmed: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>> & Readonly<{}>, {
+    autoplay: boolean;
+    duration: number;
+    reverseAnimate: boolean;
+    loadComfirmed: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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
+     * @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
+     *
+     * @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
+     * @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;