@leafer/interface 1.0.5 → 1.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leafer/interface",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "@leafer/interface",
   "author": "Chao (Leafer) Wan",
   "license": "MIT",

package/src/app/ILeafer.ts

@@ -120,7 +120,7 @@ export interface ICreator {
     watcher?(target: ILeaf, options?: IWatcherConfig): IWatcher
     layouter?(target: ILeaf, options?: ILayouterConfig): ILayouter
     renderer?(target: ILeaf, canvas: ILeaferCanvas, options?: IRendererConfig): IRenderer
-    selector?(target: ILeaf, options?: ISelectorConfig): ISelector
+    selector?(target?: ILeaf, options?: ISelectorConfig): ISelector
 
     interaction?(target: ILeaf, canvas: IInteractionCanvas, selector: ISelector, options?: IInteractionConfig): IInteraction
 

package/src/display/ILeaf.ts

@@ -16,7 +16,7 @@ import { ILeafHit } from './module/ILeafHit'
 import { ILeafRender } from './module/ILeafRender'
 import { ILeafData } from '../data/ILeafData'
 import { IFindMethod } from '../selector/ISelector'
-import { IPathCommandData } from '../path/IPathCommand'
+import { IPathCommandObject, IPathCommandData } from '../path/IPathCommand'
 import { IWindingRule, IPath2D } from '../canvas/ICanvas'
 import { IJSONOptions } from '../file/IExport'
 import { IMotionPathData } from '../path/IPathData'
@@ -246,7 +246,7 @@ export interface ILeafAttrData {
     lazy?: IBoolean
     pixelRatio?: INumber
 
-    path?: IPathCommandData | IPathString
+    path?: IPathCommandData | IPathCommandObject[] | IPathString
     windingRule?: IWindingRule
     closed?: IBoolean
 
@@ -665,7 +665,7 @@ export interface ILeaf extends ILeafRender, ILeafHit, ILeafBounds, ILeafMatrix,
     children?: ILeaf[]
 
     __updateSortChildren(): void
-    add(child: ILeaf | ILeafInputData, index?: number): void
+    add(child: ILeaf | ILeaf[] | ILeafInputData | ILeafInputData[], index?: number): void
     remove(child?: ILeaf | number | string | IFindMethod, destroy?: boolean): void
     dropTo(parent: ILeaf, index?: number, resize?: boolean): void
 }

package/src/index.ts

@@ -38,7 +38,7 @@ export { ISkiaCanvas, ISkiaCanvasExportConfig, ICanvasType, ISkiaNAPICanvas } fr
 export { IPathDrawer, IPathCreator } from './path/IPathDrawer'
 export { IMotionPathData } from './path/IPathData'
 export { IWindingRule, ICanvasContext2D, ICanvasContext2DSettings, ITextMetrics, IPath2D, ICanvasPattern } from './canvas/ICanvas'
-export { CanvasPathCommand, IPathCommandData, MCommandData, HCommandData, VCommandData, LCommandData, CCommandData, SCommandData, QCommandData, TCommandData, ZCommandData, ACommandData, RectCommandData, RoundRectCommandData, EllipseCommandData, ArcCommandData, ArcToCommandData } from './path/IPathCommand'
+export { CanvasPathCommand, IPathCommandData, MCommandData, HCommandData, VCommandData, LCommandData, CCommandData, SCommandData, QCommandData, TCommandData, ZCommandData, ACommandData, RectCommandData, RoundRectCommandData, EllipseCommandData, ArcCommandData, ArcToCommandData, MoveToCommandObject, LineToCommandObject, BezierCurveToCommandObject, QuadraticCurveToCommandObject, IPathCommandObject } from './path/IPathCommand'
 
 export { ILeaferImage, ILeaferImageConfig, ILeaferImageOnLoaded, ILeaferImageOnError, ILeaferImageCacheCanvas, ILeaferImagePatternPaint } from './image/ILeaferImage'
 export { IExportFileType, IExportImageType } from './file/IFileType'

package/src/path/IPathCommand.ts

@@ -48,3 +48,40 @@ export type ArcToCommandData = [Command, x1, y1, x2, y2, radius]
 export type CanvasPathCommand = 1 | 2 | 5 | 7 | 11 // M | L | C | Q | Z   canvas可以绘制的命令
 
 export type IPathCommandData = number[] // ...(MCommandData | LCommandData | CCommandData | QCommandData | ZCommandData)
+
+
+// 路径命令对象
+export interface MoveToCommandObject {
+    name: 'M'
+    x: number
+    y: number
+}
+export interface LineToCommandObject {
+    name: 'L'
+    x: number
+    y: number
+}
+
+export interface BezierCurveToCommandObject {
+    name: 'C'
+    x1: number
+    y1: number
+    x2: number
+    y2: number
+    x: number
+    y: number
+}
+
+export interface QuadraticCurveToCommandObject {
+    name: 'Q'
+    x1: number
+    y1: number
+    x: number
+    y: number
+}
+
+export interface ClosePathCommandObject {
+    name: 'Z'
+}
+
+export type IPathCommandObject = MoveToCommandObject | LineToCommandObject | BezierCurveToCommandObject | QuadraticCurveToCommandObject | ClosePathCommandObject // M | L | C | Q | Z   canvas可以绘制的命令

package/src/path/IPathDrawer.ts

@@ -4,8 +4,8 @@ export interface IPathDrawer {
 
     moveTo(x: number, y: number): void
     lineTo(x: number, y: number): void
-    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number): void
-    quadraticCurveTo(cpx: number, cpy: number, x: number, y: number): void
+    bezierCurveTo(x1: number, y1: number, x2: number, y2: number, x: number, y: number): void
+    quadraticCurveTo(x1: number, y1: number, x: number, y: number): void
     closePath(): void
 
     arc(x: number, y: number, radius: number, startAngle: number, endAngle: number, anticlockwise?: boolean): void
@@ -24,8 +24,8 @@ export interface IPathCreator extends IPathDrawer {
 
     moveTo(x: number, y: number): IPathCreator
     lineTo(x: number, y: number): IPathCreator
-    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number): IPathCreator
-    quadraticCurveTo(cpx: number, cpy: number, x: number, y: number): IPathCreator
+    bezierCurveTo(x1: number, y1: number, x2: number, y2: number, x: number, y: number): IPathCreator
+    quadraticCurveTo(x1: number, y1: number, x: number, y: number): IPathCreator
     closePath(): IPathCreator
 
     arc(x: number, y: number, radius: number, startAngle?: number, endAngle?: number, anticlockwise?: boolean): IPathCreator

package/src/platform/IPlatform.ts

@@ -5,24 +5,32 @@ import { IExportFileType, IExportImageType } from '../file/IFileType'
 import { IBoundsData, ISizeData } from '../math/IMath'
 import { IObject } from '../data/IData'
 import { ICanvasType } from '../canvas/ISkiaCanvas'
+import { ISelector } from '../selector/ISelector'
 
 export interface IPlatform {
     name?: 'web' | 'node' | 'miniapp'
     os?: 'Mac' | 'Windows' | 'Linux'
     toURL(text: string, fileType?: 'text' | 'svg'): string
+
     requestRender?(render: IFunction): void
     canvas?: ILeaferCanvas
     renderCanvas?: ILeaferCanvas
     canvasType?: ICanvasType
+
     isWorker?: boolean
     isMobile?: boolean
+
     readonly devicePixelRatio?: number
+
     intWheelDeltaY?: boolean // firefox / Windows need
     conicGradientSupport?: boolean
     conicGradientRotate90?: boolean // firefox need rotate
     fullImageShadow?: boolean // safari need
     syncDomFont?: boolean // firefox need
+
+    selector?: ISelector // 公共查找选择器
     layout?(target: ILeaf): void
+
     origin?: {
         createCanvas(width: number, height: number, format?: 'svg' | 'pdf'): any
         canvasToDataURL(canvas: any, type?: IExportImageType, quality?: number): string | Promise<string>
@@ -32,14 +40,18 @@ export interface IPlatform {
         loadImage(url: string): Promise<any>
         noRepeat?: string  // fix: 微信小程序 createPattern 直接使用 no-repeat 有bug，导致无法显示
     },
+
     roundRectPatch?: boolean //  fix: skia-canvas roundRect
     ellipseToCurve?: boolean, // fix: skia 绘制圆环和椭圆弧
+
     event?: {
         stopDefault(origin: IObject): void
         stopNow(origin: IObject): void
         stop(origin: IObject): void
     },
+
     miniapp?: IMiniapp
+
     image: {
         hitCanvasSize: number // 图片生成碰撞画布的最大尺寸(单边)
         maxCacheSize: number // 最大等级缓存，一般取当前屏幕大小，默认2k: 2560 * 1600

package/src/selector/ISelector.ts

@@ -47,7 +47,7 @@ export interface ISelectorProxy {
 }
 
 export interface ISelector {
-    target: ILeaf
+    target?: ILeaf
 
     proxy?: ISelectorProxy
 

package/types/index.d.ts

@@ -770,13 +770,43 @@ type ArcCommandData = [Command, x, y, radius, startAngle, endAngle, anticlockwis
 type ArcToCommandData = [Command, x1, y1, x2, y2, radius];
 type CanvasPathCommand = 1 | 2 | 5 | 7 | 11;
 type IPathCommandData = number[];
+interface MoveToCommandObject {
+    name: 'M';
+    x: number;
+    y: number;
+}
+interface LineToCommandObject {
+    name: 'L';
+    x: number;
+    y: number;
+}
+interface BezierCurveToCommandObject {
+    name: 'C';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x: number;
+    y: number;
+}
+interface QuadraticCurveToCommandObject {
+    name: 'Q';
+    x1: number;
+    y1: number;
+    x: number;
+    y: number;
+}
+interface ClosePathCommandObject {
+    name: 'Z';
+}
+type IPathCommandObject = MoveToCommandObject | LineToCommandObject | BezierCurveToCommandObject | QuadraticCurveToCommandObject | ClosePathCommandObject;
 
 interface IPathDrawer {
     beginPath?(): void;
     moveTo(x: number, y: number): void;
     lineTo(x: number, y: number): void;
-    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number): void;
-    quadraticCurveTo(cpx: number, cpy: number, x: number, y: number): void;
+    bezierCurveTo(x1: number, y1: number, x2: number, y2: number, x: number, y: number): void;
+    quadraticCurveTo(x1: number, y1: number, x: number, y: number): void;
     closePath(): void;
     arc(x: number, y: number, radius: number, startAngle: number, endAngle: number, anticlockwise?: boolean): void;
     arcTo(x1: number, y1: number, x2: number, y2: number, radius: number): void;
@@ -790,8 +820,8 @@ interface IPathCreator extends IPathDrawer {
     beginPath(): IPathCreator;
     moveTo(x: number, y: number): IPathCreator;
     lineTo(x: number, y: number): IPathCreator;
-    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number): IPathCreator;
-    quadraticCurveTo(cpx: number, cpy: number, x: number, y: number): IPathCreator;
+    bezierCurveTo(x1: number, y1: number, x2: number, y2: number, x: number, y: number): IPathCreator;
+    quadraticCurveTo(x1: number, y1: number, x: number, y: number): IPathCreator;
     closePath(): IPathCreator;
     arc(x: number, y: number, radius: number, startAngle?: number, endAngle?: number, anticlockwise?: boolean): IPathCreator;
     arcTo(x1: number, y1: number, x2: number, y2: number, radius: number): IPathCreator;
@@ -1229,7 +1259,7 @@ interface ISelectorProxy {
     dragHoverExclude: ILeaf[];
 }
 interface ISelector {
-    target: ILeaf;
+    target?: ILeaf;
     proxy?: ISelectorProxy;
     config: ISelectorConfig;
     getByPoint(hitPoint: IPointData, hitRadius: number, options?: IPickOptions): IPickResult;
@@ -1337,7 +1367,7 @@ interface ILeafAttrData {
     around?: IAlign | IUnitPointData;
     lazy?: IBoolean;
     pixelRatio?: INumber;
-    path?: IPathCommandData | IPathString;
+    path?: IPathCommandData | IPathCommandObject[] | IPathString;
     windingRule?: IWindingRule;
     closed?: IBoolean;
     flow?: IFlowType;
@@ -1631,7 +1661,7 @@ interface ILeaf extends ILeafRender, ILeafHit, ILeafBounds, ILeafMatrix, ILeafDa
     __emitLifeEvent(type: string): void;
     children?: ILeaf[];
     __updateSortChildren(): void;
-    add(child: ILeaf | ILeafInputData, index?: number): void;
+    add(child: ILeaf | ILeaf[] | ILeafInputData | ILeafInputData[], index?: number): void;
     remove(child?: ILeaf | number | string | IFindMethod, destroy?: boolean): void;
     dropTo(parent: ILeaf, index?: number, resize?: boolean): void;
 }
@@ -1956,7 +1986,7 @@ interface ICreator {
     watcher?(target: ILeaf, options?: IWatcherConfig): IWatcher;
     layouter?(target: ILeaf, options?: ILayouterConfig): ILayouter;
     renderer?(target: ILeaf, canvas: ILeaferCanvas, options?: IRendererConfig): IRenderer;
-    selector?(target: ILeaf, options?: ISelectorConfig): ISelector;
+    selector?(target?: ILeaf, options?: ISelectorConfig): ISelector;
     interaction?(target: ILeaf, canvas: IInteractionCanvas, selector: ISelector, options?: IInteractionConfig): IInteraction;
     editor?(options?: IObject): ILeaf;
 }
@@ -2078,6 +2108,7 @@ interface IPlatform {
     conicGradientRotate90?: boolean;
     fullImageShadow?: boolean;
     syncDomFont?: boolean;
+    selector?: ISelector;
     layout?(target: ILeaf): void;
     origin?: {
         createCanvas(width: number, height: number, format?: 'svg' | 'pdf'): any;
@@ -2139,4 +2170,4 @@ interface ICursorRotateMap {
     [name: string]: ICursorRotate;
 }
 
-export type { ACommandData, ArcCommandData, ArcToCommandData, CCommandData, CanvasPathCommand, EllipseCommandData, HCommandData, IAlign, IAnimateEvent, IAnswer, IAppBase, IAround, IAttrDecorator, IAutoBounds, IAutoBoundsData, IAutoBoxData, IAutoSize, IAxis, IAxisAlign, IAxisReverse, IBaseLineAlign, IBlendMode, IBlob, IBlobFunction, IBoolean, IBooleanMap, IBounds, IBoundsData, IBoundsDataFn, IBoundsType, IBranch, IBranchRender, IBranchRenderModule, ICachedLeaf, ICanvasAttr, ICanvasCacheOptions, ICanvasContext2D, ICanvasContext2DSettings, ICanvasManager, ICanvasPattern, ICanvasStrokeOptions, ICanvasType, IChildEvent, IClientPointData, IConstraint, IConstraintType, IControl, ICreator, ICursorRotate, ICursorRotateMap, ICursorType, ICursorTypeMap, IDataProcessor, IDataTypeHandle, IDirection, IDirection4, IDragEvent, IDropEvent, IEditSize, IEraserType, IEvent, IEventListener, IEventListenerId, IEventListenerItem, IEventListenerMap, IEventListenerOptions, IEventMap, IEventOption, IEventTarget, IEventer, IExportFileType, IExportImageType, IExportOnCanvasFunction, IExportOptions, IExportResult, IExportResultFunction, IFindCondition, IFindMethod, IFlowAlign, IFlowAxisAlign, IFlowBoxType, IFlowType, IFlowWrap, IFourNumber, IFromToData, IFunction, IFunctionMap, IGap, IHitCanvas, IHitCanvasConfig, IHitCanvasManager, IHitType, IImageCursor, IImageEvent, IImageManager, IInteraction, IInteractionCanvas, IInteractionConfig, IJSONOptions, IKeepTouchData, IKeyEvent, ILayoutAttr, ILayoutBlockData, ILayoutBoundsData, ILayoutChangedData, ILayoutData, ILayoutEvent, ILayouter, ILayouterConfig, ILeaf, ILeafArrayMap, ILeafAttrData, ILeafAttrDescriptor, ILeafAttrDescriptorFn, ILeafBounds, ILeafBoundsModule, ILeafComputedData, ILeafData, ILeafDataOptions, ILeafDataProxy, ILeafDataProxyModule, ILeafEventer, ILeafEventerModule, ILeafHit, ILeafHitModule, ILeafInputData, ILeafLayout, ILeafLevelList, ILeafList, ILeafListItemCallback, ILeafMap, ILeafMatrix, ILeafMatrixModule, ILeafRender, ILeafRenderModule, ILeaferAttrData, ILeaferBase, ILeaferCanvas, ILeaferCanvasConfig, ILeaferCanvasView, ILeaferConfig, ILeaferEvent, ILeaferImage, ILeaferImageCacheCanvas, ILeaferImageConfig, ILeaferImageOnError, ILeaferImageOnLoaded, ILeaferImagePatternPaint, ILeaferType, ILeaferTypeCreator, ILeaferTypeFunction, ILeaferTypeList, ILocationType, IMaskType, IMatrix, IMatrixData, IMatrixWithBoundsData, IMatrixWithBoundsScaleData, IMatrixWithLayoutData, IMatrixWithOptionScaleData, IMatrixWithScaleData, IMiniapp, IMiniappSelect, IMiniappSizeView, IMotionPathData, IMoveEvent, IMultiTouchConfig, IMultiTouchData, INumber, INumberFunction, INumberMap, IObject, IObjectFunction, IOffsetBoundsData, IPartLayoutConfig, IPath2D, IPathCommandData, IPathCreator, IPathDrawer, IPathString, IPercentData, IPickBottom, IPickOptions, IPickResult, IPlatform, IPlugin, IPoint, IPointData, IPointDataFunction, IPointDataMap, IPointGap, IPointerConfig, IPointerEvent, IPropertyEvent, IRadiusPointData, IRangeSize, IRenderEvent, IRenderOptions, IRenderer, IRendererConfig, IResizeEvent, IResizeEventListener, IRotateEvent, IRotationPointData, IScaleData, IScaleRotationData, IScreenSizeData, IScrollPointData, ISelector, ISelectorConfig, ISelectorProxy, ISide, ISize, ISizeData, ISkewData, ISkiaCanvas, ISkiaCanvasExportConfig, ISkiaNAPICanvas, IStateStyleType, IString, IStringFunction, IStringMap, ISwipeEvent, ITaskItem, ITaskOptions, ITaskProcessor, ITaskProcessorConfig, ITextMetrics, ITimer, ITouchConfig, ITwoPointBoundsData, IUICreator, IUIEvent, IUnitData, IUnitPointData, IUpdateEvent, IValue, IWatchEvent, IWatchEventData, IWatcher, IWatcherConfig, IWheelConfig, IWindingRule, IZoomEvent, IZoomType, IZoomView, InnerId, LCommandData, MCommandData, PointerType, QCommandData, RectCommandData, RoundRectCommandData, SCommandData, TCommandData, VCommandData, ZCommandData };
+export type { ACommandData, ArcCommandData, ArcToCommandData, BezierCurveToCommandObject, CCommandData, CanvasPathCommand, EllipseCommandData, HCommandData, IAlign, IAnimateEvent, IAnswer, IAppBase, IAround, IAttrDecorator, IAutoBounds, IAutoBoundsData, IAutoBoxData, IAutoSize, IAxis, IAxisAlign, IAxisReverse, IBaseLineAlign, IBlendMode, IBlob, IBlobFunction, IBoolean, IBooleanMap, IBounds, IBoundsData, IBoundsDataFn, IBoundsType, IBranch, IBranchRender, IBranchRenderModule, ICachedLeaf, ICanvasAttr, ICanvasCacheOptions, ICanvasContext2D, ICanvasContext2DSettings, ICanvasManager, ICanvasPattern, ICanvasStrokeOptions, ICanvasType, IChildEvent, IClientPointData, IConstraint, IConstraintType, IControl, ICreator, ICursorRotate, ICursorRotateMap, ICursorType, ICursorTypeMap, IDataProcessor, IDataTypeHandle, IDirection, IDirection4, IDragEvent, IDropEvent, IEditSize, IEraserType, IEvent, IEventListener, IEventListenerId, IEventListenerItem, IEventListenerMap, IEventListenerOptions, IEventMap, IEventOption, IEventTarget, IEventer, IExportFileType, IExportImageType, IExportOnCanvasFunction, IExportOptions, IExportResult, IExportResultFunction, IFindCondition, IFindMethod, IFlowAlign, IFlowAxisAlign, IFlowBoxType, IFlowType, IFlowWrap, IFourNumber, IFromToData, IFunction, IFunctionMap, IGap, IHitCanvas, IHitCanvasConfig, IHitCanvasManager, IHitType, IImageCursor, IImageEvent, IImageManager, IInteraction, IInteractionCanvas, IInteractionConfig, IJSONOptions, IKeepTouchData, IKeyEvent, ILayoutAttr, ILayoutBlockData, ILayoutBoundsData, ILayoutChangedData, ILayoutData, ILayoutEvent, ILayouter, ILayouterConfig, ILeaf, ILeafArrayMap, ILeafAttrData, ILeafAttrDescriptor, ILeafAttrDescriptorFn, ILeafBounds, ILeafBoundsModule, ILeafComputedData, ILeafData, ILeafDataOptions, ILeafDataProxy, ILeafDataProxyModule, ILeafEventer, ILeafEventerModule, ILeafHit, ILeafHitModule, ILeafInputData, ILeafLayout, ILeafLevelList, ILeafList, ILeafListItemCallback, ILeafMap, ILeafMatrix, ILeafMatrixModule, ILeafRender, ILeafRenderModule, ILeaferAttrData, ILeaferBase, ILeaferCanvas, ILeaferCanvasConfig, ILeaferCanvasView, ILeaferConfig, ILeaferEvent, ILeaferImage, ILeaferImageCacheCanvas, ILeaferImageConfig, ILeaferImageOnError, ILeaferImageOnLoaded, ILeaferImagePatternPaint, ILeaferType, ILeaferTypeCreator, ILeaferTypeFunction, ILeaferTypeList, ILocationType, IMaskType, IMatrix, IMatrixData, IMatrixWithBoundsData, IMatrixWithBoundsScaleData, IMatrixWithLayoutData, IMatrixWithOptionScaleData, IMatrixWithScaleData, IMiniapp, IMiniappSelect, IMiniappSizeView, IMotionPathData, IMoveEvent, IMultiTouchConfig, IMultiTouchData, INumber, INumberFunction, INumberMap, IObject, IObjectFunction, IOffsetBoundsData, IPartLayoutConfig, IPath2D, IPathCommandData, IPathCommandObject, IPathCreator, IPathDrawer, IPathString, IPercentData, IPickBottom, IPickOptions, IPickResult, IPlatform, IPlugin, IPoint, IPointData, IPointDataFunction, IPointDataMap, IPointGap, IPointerConfig, IPointerEvent, IPropertyEvent, IRadiusPointData, IRangeSize, IRenderEvent, IRenderOptions, IRenderer, IRendererConfig, IResizeEvent, IResizeEventListener, IRotateEvent, IRotationPointData, IScaleData, IScaleRotationData, IScreenSizeData, IScrollPointData, ISelector, ISelectorConfig, ISelectorProxy, ISide, ISize, ISizeData, ISkewData, ISkiaCanvas, ISkiaCanvasExportConfig, ISkiaNAPICanvas, IStateStyleType, IString, IStringFunction, IStringMap, ISwipeEvent, ITaskItem, ITaskOptions, ITaskProcessor, ITaskProcessorConfig, ITextMetrics, ITimer, ITouchConfig, ITwoPointBoundsData, IUICreator, IUIEvent, IUnitData, IUnitPointData, IUpdateEvent, IValue, IWatchEvent, IWatchEventData, IWatcher, IWatcherConfig, IWheelConfig, IWindingRule, IZoomEvent, IZoomType, IZoomView, InnerId, LCommandData, LineToCommandObject, MCommandData, MoveToCommandObject, PointerType, QCommandData, QuadraticCurveToCommandObject, RectCommandData, RoundRectCommandData, SCommandData, TCommandData, VCommandData, ZCommandData };