ice-render 0.0.45 → 1.0.1

package/dist/types/graphic/link/ICELinkSlot.d.ts

@@ -1,4 +1,3 @@
-import ICEEvent from '../../event/ICEEvent';
 import ICECircle from '../shape/ICECircle';
 /**
  * @class ICELinkSlot
@@ -29,39 +28,16 @@ declare class ICELinkSlot extends ICECircle {
      * @param props
      */
     constructor(props?: any);
-    protected initEvents(): void;
     /**
      * @overwrite
      * @method keyboardEvtHandler 键盘事件处理
-     * !ICELinkSlot 不响应键盘事件。
+     * !ICELinkSlot 不响应键盘事件，覆盖成空实现。
      * @see {ICEComponent.keyboardEvtHandler}
      * @param evt
      * @returns
      */
     protected keyboardEvtHandler(evt: any): void;
-    protected beforeRenderHandler(evt: ICEEvent): void;
-    protected beforeRemoveHandler(evt: ICEEvent): void;
-    /**
-     * 只要鼠标弹起，连接插槽总是变成不可见状态。
-     */
-    protected globalMouseUpHandler(): void;
-    /**
-     * 监听 EventBus 上连接钩子鼠标按下事件
-     * @param evt
-     */
-    protected hookMouseDownHandler(evt: ICEEvent): void;
-    /**
-     * 监听 EventBus 上连接钩子鼠标移动事件，判断钩子是否与插槽发生了碰撞。
-     * FIXME:这里需要更好的碰撞检测算法，与所有插槽进行比对的方式效率太低。
-     * @param evt
-     */
-    protected hookMouseMoveHandler(evt: ICEEvent): void;
-    /**
-     * 处理 EventBus 上连接钩子鼠标弹起事件
-     * @param evt
-     */
-    protected hookMouseUpHandler(evt: ICEEvent): void;
-    private isIntersectWithHook;
+    destory(): void;
     protected updatePosition(): void;
     set hostComponent(component: any);
     get hostComponent(): any;

package/dist/types/graphic/link/ICELinkSlotManager.d.ts

@@ -1,3 +1,4 @@
+import ICEEvent from '../../event/ICEEvent';
 import ICE from '../../ICE';
 /**
  * @class ICELinkSlotManager
@@ -16,6 +17,8 @@ export default class ICELinkSlotManager {
     start(): this;
     stop(): this;
     private hookMouseMoveHandler;
+    private hookMouseUpHandler;
+    protected globalMouseUpHandler(evt?: ICEEvent): void;
     /**
      * 创建连接插槽，插槽默认分布在组件最小边界盒子的4条边几何中点位置。
      * 有顺序，按照 TRBL 上右下左 创建，插槽的 ID 会被序列化。

package/dist/types/graphic/link/ICEPolyLine.d.ts

@@ -1,6 +1,5 @@
 import ICEEvent from '../../event/ICEEvent';
 import ICEBoundingBox from '../../geometry/ICEBoundingBox';
-import ICEComponent from '../ICEComponent';
 import ICEDotPath from '../ICEDotPath';
 /**
  *
@@ -23,28 +22,19 @@ declare class ICEPolyLine extends ICEDotPath {
      * 仅供内部使用，业务代码不可依赖此属性
      */
     isLine: boolean;
-    /**
-     * 数据结构：
-     * {
-     *  start:{componnet:ICEComponent,position:'T'},
-     *  end:{component:ICEComponent,position:'B'}
-     * }
-     * !注意：此结构与 state 上的 links 结构不同，state.links 只存 id，position 信息，而且会被序列化，此结构不会被序列化。
-     */
-    protected links: any;
     /**
      * @cfg
      * {
-     *   lineType: 'solid',         //可能的取值：solid, dashed
-     *   arrow: 'none',             //可能的取值：none, start, end ,both
-     *   arrowLength: 15,           //箭头长度
-     *   arrowAngel: 30,            //箭头角度
-     *   lineWidth:2,               //线条宽度
-     *   closePath:false,           //连线默认不闭合路径
-     *   points:[],                 //线条上所有点的坐标
-     *   links:{                    //如果传递了连接关系参数，则在渲染器完成一轮渲染之后，会自动与指定的组件建立连接关系。
-     *     start:{id,position},
-     *     end:{id,position}
+     *   lineType: 'solid',                 //可能的取值：solid, dashed
+     *   arrow: 'none',                     //可能的取值：none, start, end ,both
+     *   arrowLength: 15,                   //箭头长度
+     *   arrowAngel: 30,                    //箭头角度
+     *   lineWidth:2,                       //线条宽度
+     *   closePath:false,                   //连线默认不闭合路径
+     *   points:[],                         //线条上所有点的坐标
+     *   links:{                            //如果传递了连接关系参数，ICEPolyLine 会自动与指定的组件建立连接关系。
+     *     start:{id:null,position:null},
+     *     end:{id:null,position:null}
      *   }
      * }
      *
@@ -65,9 +55,22 @@ declare class ICEPolyLine extends ICEDotPath {
      */
     protected initEvents(): void;
     protected afterAddHandler(evt?: ICEEvent): void;
-    protected makeConnection(): void;
-    setLink(terminal: string, component: ICEComponent, position: string): void;
-    removeLink(terminal: string, component: ICEComponent, position: string): void;
+    /**
+     * @method syncConnections 同步连接关系
+     *
+     * - 根据 this.state.links 的数据结构，建立或者删除连接关系。
+     * - 此方法会在 setState() 中被调用，所以此方法内部不能调用 setState()，否则会死循环。如果需要修改 state ，直接赋值。
+     *
+     */
+    protected syncConnections(): void;
+    protected createLink(id: string, position: string): void;
+    /**
+     * @method removeLink 删除连接关系
+     * @param terminal 可以为 start 或者 end ，如果只提供了 terminal 参数，则删除此端点上的所有连接关系。
+     * @param id 连接终点的组件 id
+     * @param position 连接终点的组件的位置，可以为 TRBL
+     */
+    protected removeLink(terminal: string, id?: string, position?: string): void;
     /**
      * @method getLinkFromId
      * 获取起点组件 id ，如果没有建立连接，则返回 null
@@ -124,14 +127,15 @@ declare class ICEPolyLine extends ICEDotPath {
      */
     rmDot(index: number): boolean;
     /**
+     * @overwrite
      * @method calcComponentParams
-     *
-     * - 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * - 由于点状路径可能是不规则的形状，所以宽高需要手动计算，特殊形状的子类需要覆盖此方法提供自己的实现。
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
      * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
-     *
-     * @overwrite
-     * @returns {ComponentParams}
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
+     * @returns
      */
     protected calcComponentParams(): {
         width: any;

package/dist/types/graphic/shape/ICEIsogon.d.ts

@@ -28,9 +28,12 @@ declare class ICEIsogon extends ICEDotPath {
     /**
      * @overwrite
      * @method calcComponentParams
-     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * 由于点状路径可能是不规则的形状，所以宽高需要手动计算，特殊形状的子类需要覆盖此方法提供自己的实现。
-     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
      * @returns
      */
     protected calcComponentParams(): {

package/dist/types/graphic/shape/ICERose.d.ts

@@ -15,9 +15,12 @@ declare class ICERose extends ICEDotPath {
     /**
      * @overwrite
      * @method calcComponentParams
-     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * 由于点状路径可能是不规则的形状，所以宽高需要手动计算，特殊形状的子类需要覆盖此方法提供自己的实现。
-     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
      * @returns
      */
     protected calcComponentParams(): {

package/dist/types/graphic/shape/ICEStar.d.ts

@@ -22,9 +22,12 @@ declare class ICEStar extends ICEDotPath {
     /**
      * @overwrite
      * @method calcComponentParams
-     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * 由于点状路径可能是不规则的形状，所以宽高需要手动计算，特殊形状的子类需要覆盖此方法提供自己的实现。
-     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
      * @returns
      */
     protected calcComponentParams(): {

package/dist/types/graphic/text/ICEText.d.ts

@@ -28,9 +28,13 @@ declare class ICEText extends ICEComponent {
     protected static arrangeParam(props: any): any;
     /**
      * @overwrite
-     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * 此方法不能依赖原点位置和 transform 矩阵。
-     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * @method calcComponentParams
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
      * @returns
      */
     protected calcComponentParams(): {

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "大漠穷秋",
   "name": "ice-render",
-  "version": "0.0.45",
+  "version": "1.0.1",
   "description": "A canvas engine for interactive graphics.",
   "repository": "https://gitee.com/ice-render/ice-render",
   "module": "dist/index.js",