@leafer/interface 1.0.0-alpha.1

package/src/data/IData.ts

@@ -0,0 +1,27 @@
+export type __Number = number // number | string    will convert to number
+export type __Boolean = boolean // boolean | string  will convert to boolean
+export type __String = string //  string  | other   will convert to string
+export type __Object = IObject // will convert to object
+export type __Value = __Number | __Boolean | __String | __Object  // 
+
+
+export interface IObject {
+    [name: string]: any
+}
+
+export interface IBooleanMap {
+    [name: string]: boolean
+}
+
+export interface INumberMap {
+    [name: string]: number
+}
+
+export interface IStringMap {
+    [name: string]: string
+}
+
+export interface IDataTypeHandle {
+    (target: any): void
+}
+

package/src/data/ILeafData.ts

@@ -0,0 +1,17 @@
+import { ILeaf, ILeafComputedData } from '../display/ILeaf'
+import { IObject } from './IData'
+
+export interface IDataProcessor extends IObject {
+    __leaf: ILeaf
+    __input: IObject
+    __middle: IObject
+    __setInput(name: string, value: unknown): void
+    __getInput(name: string): unknown
+    __setMiddle(name: string, value: unknown): void
+    __getMiddle(name: string): unknown
+    destroy(): void
+}
+
+export interface ILeafData extends IDataProcessor, ILeafComputedData {
+
+}

package/src/data/IList.ts

@@ -0,0 +1,45 @@
+import { ILeaf } from '../display/ILeaf'
+import { INumberMap } from './IData'
+
+export interface ILeafMap {
+    [name: string]: ILeaf
+}
+
+export interface ILeafArrayMap {
+    [name: string]: ILeaf[]
+}
+
+export type ILeafListItemCallback = (item: ILeaf, index?: number) => void
+
+export interface ILeafList {
+    list: ILeaf[]
+    keys: INumberMap
+    readonly length: number
+    has(leaf: ILeaf): boolean
+    indexAt(index: number): ILeaf
+    indexOf(leaf: ILeaf): number
+    unshift(leaf: ILeaf): void
+    pushList(list: ILeaf[]): void
+    push(leaf: ILeaf): void
+    sort(reverse?: boolean): void
+    remove(leaf: ILeaf): void
+    forEach(itemCallback: ILeafListItemCallback): void
+    clone(): ILeafList
+    reset(): void
+    destroy(): void
+}
+
+export interface ILeafLevelList {
+    levelMap: ILeafArrayMap
+    keys: INumberMap
+    levels: number[]
+    readonly length: number
+    has(leaf: ILeaf): boolean
+    without(leaf: ILeaf): boolean
+    sort(reverse?: boolean): void
+    pushList(list: ILeaf[]): void
+    push(leaf: ILeaf): void
+    forEach(itemCallback: ILeafListItemCallback): void
+    reset(): void
+    destroy(): void
+}

package/src/display/IBranch.ts

@@ -0,0 +1,9 @@
+import { ILeaf } from './ILeaf'
+
+export interface IBranch extends ILeaf {
+    children: ILeaf[]
+
+    __updateSortChildren(): void
+    add(child: ILeaf, index?: number): void
+    remove(child?: ILeaf): void
+}

package/src/display/ILeaf.ts

@@ -0,0 +1,191 @@
+import { ILeafer } from '../app/ILeafer'
+import { IEventer } from '../event/IEventer'
+
+import { ILeaferCanvas, IHitCanvas } from '../canvas/ILeaferCanvas'
+import { IRenderOptions } from '../renderer/IRenderer'
+
+import { IObject, __Number, __Boolean, __Value, __String } from '../data/IData'
+import { IMatrixWithBoundsData, IMatrix, IBoundsData, IRadiusPointData } from '../math/IMath'
+import { IFunction } from '../function/IFunction'
+
+import { ILeafDataProxy } from './module/ILeafDataProxy'
+import { ILeafMatrix } from './module/ILeafMatrix'
+import { ILeafBounds } from './module/ILeafBounds'
+import { ILeafLayout } from '../layout/ILeafLayout'
+import { ILeafHit } from './module/ILeafHit'
+import { ILeafRender } from './module/ILeafRender'
+import { ILeafData } from '../data/ILeafData'
+
+
+export interface ICachedLeaf {
+    canvas: ILeaferCanvas,
+    matrix?: IMatrix,
+    bounds: IBoundsData
+}
+
+export interface ILeafAttrData {
+    // layer data
+    id: __String
+    name: __String
+    className: __String
+
+    opacity: __Number
+    visible: __Boolean
+    zIndex: __Number
+
+    // layout data
+    x: __Number
+    y: __Number
+    width: __Number
+    height: __Number
+    scaleX: __Number
+    scaleY: __Number
+    rotation: __Number
+    skewX: __Number
+    skewY: __Number
+
+    draggable: __Boolean
+}
+
+export interface ILeafInputData {
+    // layer data
+    id?: __String
+    name?: __String
+    className?: __String
+
+    opacity?: __Number
+    visible?: __Boolean
+    zIndex?: __Number
+
+    // layout data
+    x?: __Number
+    y?: __Number
+    width?: __Number
+    height?: __Number
+    scaleX?: __Number
+    scaleY?: __Number
+    rotation?: __Number
+    skewX?: __Number
+    skewY?: __Number
+
+    draggable?: __Boolean
+}
+export interface ILeafComputedData {
+    // layer data
+    id?: string
+    name?: string
+    className?: string
+
+    opacity?: number
+    visible?: boolean
+    zIndex?: number
+
+    // layout data
+    x?: number
+    y?: number
+    width?: number
+    height?: number
+    scaleX?: number
+    scaleY?: number
+    rotation?: number
+    skewX?: number
+    skewY?: number
+
+    draggable?: boolean
+}
+
+export interface ILeaf extends ILeafRender, ILeafHit, ILeafBounds, ILeafMatrix, ILeafDataProxy, ILeafInputData, IEventer {
+    readonly tag: string
+    readonly __DataProcessor: IObject // IDataProcessor
+    readonly __LayoutProcessor: IObject // ILeafLayout
+
+    leafer?: ILeafer
+    root?: ILeaf
+    parent?: ILeaf
+
+    __interactionOff?: boolean
+    __childrenInteractionOff?: boolean
+
+    __isRoot?: boolean
+    __isBranch?: boolean
+    __isBranchLeaf?: boolean
+
+    __: ILeafData
+    __layout: ILeafLayout
+
+    __relative: IMatrixWithBoundsData
+    __world: IMatrixWithBoundsData
+
+    __worldOpacity: number
+    __renderTime: number // μs 1000微秒 = 1毫秒
+    __complex: boolean // 外观是否复杂， 将调用__drawComplex()
+
+    __level: number // 图层级别 root(1) -> hight
+    __tempNumber?: number // 用于临时运算储存状态
+
+    __hitCanvas?: IHitCanvas
+
+    __parentWait?: IFunction[]
+
+    __addParentWait(item: IFunction): void
+    __runParentWait(): void
+
+    __setAsLeafer(): void
+    __setAsRoot(): void
+
+    __bindRoot(root: ILeaf): void
+
+    // ILeafData ->
+    __set(attrName: string, newValue: __Value): void
+    __get(attrName: string): __Value
+    __updateAttr(attrName: string): void
+
+    // ILeafMatrix ->
+    __updateWorldMatrix(): void
+    __updateRelativeMatrix(): void
+
+    // ILeafBounds ->
+    __updateWorldBounds(): void
+
+    __updateRelativeBoxBounds(): void
+    __updateRelativeEventBounds(): void
+    __updateRelativeRenderBounds(): void
+
+    __updateBoxBounds(): void
+    __updateEventBounds(): void
+    __updateRenderBounds(): void
+
+    __updateEventBoundsSpreadWidth(): number
+    __updateRenderBoundsSpreadWidth(): number
+
+    __onUpdateSize(): void
+
+    // ILeafHit ->
+    __hitWorld(point: IRadiusPointData): boolean
+    __hit(local: IRadiusPointData): boolean
+    __updateHitCanvas(): void
+
+    // ILeafRender ->
+    __render(canvas: ILeaferCanvas, options: IRenderOptions): void
+    __drawFast(canvas: ILeaferCanvas, options: IRenderOptions): void
+    __draw(canvas: ILeaferCanvas, options: IRenderOptions): void
+
+    __updateWorldOpacity(): void
+    __updateChange(): void
+
+    // path
+    __drawPath(canvas: ILeaferCanvas): void
+    __drawRenderPath(canvas: ILeaferCanvas): void
+    __updatePath(): void
+    __updateRenderPath(): void
+
+    // branch
+    children?: ILeaf[]
+    __childBranchNumber?: number // 存在子分支的个数
+
+    __updateSortChildren(): void
+    add(child: ILeaf, index?: number): void
+    remove(child?: ILeaf): void
+}
+
+

package/src/display/IView.ts

@@ -0,0 +1,9 @@
+import { IBranch } from './IBranch'
+import { ILeaf } from './ILeaf'
+import { ITransformEventData } from '../event/IEvent'
+
+export interface IZoomView extends IBranch {
+    zoomLayer?: ILeaf
+    moveLayer?: ILeaf
+    transformData?: ITransformEventData
+}

package/src/display/module/ILeafBounds.ts

@@ -0,0 +1,21 @@
+import { ILeaf } from '../ILeaf'
+
+export type ILeafBoundsModule = ILeafBounds & ThisType<ILeaf>
+
+export interface ILeafBounds {
+    __updateWorldBounds?(): void
+
+    __updateRelativeBoxBounds?(): void
+    __updateRelativeEventBounds?(): void
+    __updateRelativeRenderBounds?(): void
+
+    __updateBoxBounds?(): void
+    __updateEventBounds?(): void
+    __updateRenderBounds?(): void
+
+    __updateEventBoundsSpreadWidth?(): number
+    __updateRenderBoundsSpreadWidth?(): number
+
+    __onUpdateSize?(): void
+}
+

package/src/display/module/ILeafDataProxy.ts

@@ -0,0 +1,11 @@
+import { ILeaf } from '../ILeaf'
+import { __Value } from '../../data/IData'
+
+export type ILeafDataProxyModule = ILeafDataProxy & ThisType<ILeaf>
+
+export interface ILeafDataProxy {
+    __set?(attrName: string, newValue: __Value): void
+    __get?(attrName: string): __Value
+    __updateAttr?(attrName: string): void
+}
+

package/src/display/module/ILeafEventer.ts

@@ -0,0 +1,18 @@
+import { ILeaf } from '../ILeaf'
+import { IEventListener, IEventListenerId, IEventListenerOptions } from '../../event/IEventer'
+import { } from '@leafer/interface'
+import { IEvent } from '../../event/IEvent'
+import { IObject } from '../../data/IData'
+
+export type ILeafEventerModule = ILeafEventer & ThisType<ILeaf>
+
+export interface ILeafEventer {
+    on?(type: string | string[], listener: IEventListener, options?: IEventListenerOptions | boolean): void
+    off?(type: string | string[], listener: IEventListener, options?: IEventListenerOptions | boolean): void
+    on__?(type: string | string[], listener: IEventListener, bind?: IObject, options?: IEventListenerOptions | boolean): IEventListenerId
+    off__?(id: IEventListenerId | IEventListenerId[]): void
+    once?(type: string | string[], listener: IEventListener, capture?: boolean): void
+    emit?(type: string, event?: IEvent | IObject, capture?: boolean): void
+    emitEvent?(event?: IEvent, capture?: boolean): void
+    hasEvent?(type: string, capture?: boolean): boolean
+}

package/src/display/module/ILeafHit.ts

@@ -0,0 +1,10 @@
+import { IRadiusPointData } from '../../math/IMath'
+import { ILeaf } from '../ILeaf'
+
+export type ILeafHitModule = ILeafHit & ThisType<ILeaf>
+
+export interface ILeafHit {
+    __hitWorld?(point: IRadiusPointData): boolean
+    __hit?(local: IRadiusPointData): boolean
+    __updateHitCanvas?(): void
+}

package/src/display/module/ILeafMatrix.ts

@@ -0,0 +1,8 @@
+import { ILeaf } from '../ILeaf'
+
+export type ILeafMatrixModule = ILeafMatrix & ThisType<ILeaf>
+
+export interface ILeafMatrix {
+    __updateWorldMatrix?(): void
+    __updateRelativeMatrix?(): void
+}

package/src/display/module/ILeafRender.ts

@@ -0,0 +1,17 @@
+import { ILeaferCanvas } from '../../canvas/ILeaferCanvas'
+import { IRenderOptions } from '../../renderer/IRenderer'
+import { ILeaf } from '../ILeaf'
+
+export type ILeafRenderModule = ILeafRender & ThisType<ILeaf>
+
+export interface ILeafRender {
+    __render?(canvas: ILeaferCanvas, options: IRenderOptions): void
+    __drawFast?(canvas: ILeaferCanvas, options: IRenderOptions): void
+    __draw?(canvas: ILeaferCanvas, options: IRenderOptions): void
+
+    __drawBefore?(canvas: ILeaferCanvas, options: IRenderOptions): void
+    __drawAfter?(canvas: ILeaferCanvas, options: IRenderOptions): void
+
+    __updateWorldOpacity?(): void
+    __updateChange?(): void
+}

package/src/event/IEvent.ts

@@ -0,0 +1,89 @@
+import { IEventer } from './IEventer'
+import { IWatchEventData } from '../watcher/IWatcher'
+import { ILayoutBlockData } from '../layouter/ILayouter'
+import { ILeaf } from '../display/ILeaf'
+import { IScreenSizeData } from '../math/IMath'
+
+export interface IEvent {
+    type: string
+    target: IEventTarget
+    current: IEventTarget
+
+    bubbles?: boolean
+    phase?: number
+
+    isStopDefault: boolean
+    isStop: boolean
+    isStopNow: boolean
+    stopDefault(): void
+    stopNow(): void
+    stop(): void
+}
+
+export interface IEventTarget extends IEventer {
+
+}
+
+export interface IRenderEvent {
+
+}
+
+export interface IChildEvent extends IEvent {
+    parent?: ILeaf
+    child?: ILeaf
+}
+
+export interface IResizeEvent extends IEvent {
+    readonly width: number
+    readonly height: number
+    readonly pixelRatio: number
+
+    readonly bigger: boolean
+    readonly smaller: boolean
+    readonly samePixelRatio: boolean
+    readonly old: IScreenSizeData
+}
+
+export interface IResizeEventListener {
+    (event: IResizeEvent): void
+}
+
+export interface IUpdateEvent extends IEvent {
+
+}
+
+export interface IAttrEvent extends IEvent {
+    readonly attrName: string
+    readonly oldValue: unknown
+    readonly newValue: unknown
+}
+
+export interface ILayoutEvent extends IEvent {
+    readonly data: ILayoutBlockData[]
+}
+
+export interface IWatchEvent extends IEvent {
+    readonly data: IWatchEventData
+}
+
+export interface ITransformEventData {
+    x: number
+    y: number
+    scaleX: number
+    scaleY: number
+    rotation: number
+
+    readonly zooming: boolean
+    readonly moving: boolean
+    readonly rotating: boolean
+    readonly changing: boolean
+}
+
+export interface ITransformEvent extends IEvent, ITransformEventData {
+    readonly x: number
+    readonly y: number
+    readonly scaleX: number
+    readonly scaleY: number
+    readonly rotation: number
+}
+export type TransformMode = 'move' | 'zoom' | 'rotate'

package/src/event/IEventer.ts

@@ -0,0 +1,43 @@
+import { IEvent, IFunction, IObject } from '@leafer/interface'
+import { LeafEventer } from '../display/module/ILeafEventer'
+
+export type IEventListener = IFunction
+
+export interface IEventListenerOptions {
+    capture?: boolean
+    once?: boolean
+}
+
+export interface IEventListenerItem extends IEventListenerOptions {
+    listener: IEventListener
+}
+
+export interface IEventListenerMap {
+    [name: string]: IEventListenerItem[]
+}
+
+export interface IEventListenerId {
+    type: string | string[]
+    listener: IEventListener
+    options?: IEventListenerOptions | boolean
+}
+
+export type InnerId = number
+
+export interface IEventer extends LeafEventer {
+
+    readonly innerId: InnerId
+    __captureMap?: IEventListenerMap
+    __bubbleMap?: IEventListenerMap
+
+    on(type: string | string[], listener: IEventListener, options?: IEventListenerOptions | boolean): void
+    off(type: string | string[], listener: IEventListener, options?: IEventListenerOptions | boolean): void
+    on__(type: string | string[], listener: IEventListener, bind?: IObject, options?: IEventListenerOptions | boolean): IEventListenerId
+    off__(id: IEventListenerId | IEventListenerId[]): void
+    once(type: string | string[], listener: IEventListener): void
+    emit(type: string, event?: IEvent | IObject, capture?: boolean): void
+    emitEvent(event?: IEvent, capture?: boolean): void
+    hasEvent(type: string, capture?: boolean): boolean
+
+    destroy(): void
+}

package/src/event/IUIEvent.ts

@@ -0,0 +1,69 @@
+import { ILeafList } from '../data/IList'
+import { IEvent } from './IEvent'
+
+export interface IUIEvent extends IEvent {
+    x: number
+    y: number
+
+    altKey: boolean
+    ctrlKey: boolean
+    shiftKey: boolean
+    metaKey: boolean
+    readonly spaceKey: boolean
+
+    readonly left: boolean
+    readonly right: boolean
+    readonly middle: boolean
+    buttons: number
+
+    path: ILeafList
+    throughPath?: ILeafList // 穿透path，不受层级影响，从上到下只要碰撞到区域就算，一般点击的时候
+
+    stopDefault(): void
+    stopNow(): void
+    stop(): void
+}
+
+
+export interface IPointerEvent extends IUIEvent {
+    width: number
+    height: number
+    pointerType: PointerType
+    pressure: number
+    tangentialPressure?: number
+    tiltX?: number
+    tiltY?: number
+    twist?: number
+}
+export type PointerType = 'mouse' | 'pen' | 'touch'
+
+export interface IDragEvent extends IPointerEvent {
+    moveX: number
+    moveY: number
+    totalX: number
+    totalY: number
+}
+
+export interface IDropEvent extends IPointerEvent {
+    list: ILeafList
+}
+
+export interface IRotateEvent extends IUIEvent {
+    rotation: number
+}
+
+export interface IZoomEvent extends IUIEvent {
+    scale: number
+}
+
+export interface IMoveEvent extends IDragEvent {
+
+}
+
+export interface ISwipeEvent extends IDragEvent {
+
+}
+
+export interface IKeyEvent extends IUIEvent {
+
+}

package/src/function/IFunction.ts

@@ -0,0 +1,13 @@
+import { IPointData } from '../math/IMath'
+
+export interface IFunction {
+    (...arg: any): any
+}
+
+export interface INumberFunction {
+    (...arg: any): number
+}
+
+export interface IPointDataFunction {
+    (...arg: any): IPointData
+}

package/src/image/IImageManager.ts

@@ -0,0 +1,3 @@
+export interface IImageManager {
+    destory(): void
+}

package/src/image/ILeaferImage.ts

@@ -0,0 +1,8 @@
+export interface ILeaferImageConfig {
+    url: string
+    thumb?: string
+}
+
+export interface ILeaferImage {
+
+}

package/src/index.ts

@@ -0,0 +1,48 @@
+export { ISupperLeafer } from './app/ISupperLeafer'
+export { ILeafer, ILeaferConfig, ICreator, IUICreator } from './app/ILeafer'
+export { ILeaf, ILeafAttrData, ILeafComputedData, ILeafInputData, ICachedLeaf } from './display/ILeaf'
+export { IBranch } from './display/IBranch'
+export { IZoomView } from './display/IView'
+
+
+export { ILeafData, IDataProcessor } from './data/ILeafData'
+export { ILeafLayout, ILayoutLocationType, ILayoutBoundsType } from './layout/ILeafLayout'
+
+export { ILeafDataProxy, ILeafDataProxyModule } from './display/module/ILeafDataProxy'
+export { ILeafMatrix, ILeafMatrixModule } from './display/module/ILeafMatrix'
+export { ILeafBounds, ILeafBoundsModule } from './display/module/ILeafBounds'
+export { ILeafHit, ILeafHitModule } from './display/module/ILeafHit'
+export { ILeafRender, ILeafRenderModule } from './display/module/ILeafRender'
+export { ILeafEventer, ILeafEventerModule } from './display/module/ILeafEventer'
+
+export { IRenderer, IRendererConfig, IRenderOptions } from './renderer/IRenderer'
+export { IWatcher, IWatchEventData, IWatcherConfig } from './watcher/IWatcher'
+export { ILayouter, ILayoutChangedData, ILayoutBlockData, ILayouterConfig, IPartLayoutConfig } from './layouter/ILayouter'
+export { ISelector, ISelectPathResult, ISelectPathOptions } from './selector/ISelector'
+
+export { ICanvasManager } from './canvas/ICanvasManager'
+export { IHitCanvasManager } from './canvas/IHitCanvasManager'
+export { IImageManager } from './image/IImageManager'
+
+
+export { IPlatform } from './platform/IPlatform'
+export { IPlugin } from './plugin/IPlugin'
+
+
+export { ILeaferCanvas, IHitCanvas, ICanvasAttr, ICanvasStrokeOptions, ILeaferCanvasContext, ILeaferCanvasConfig, IHitCanvasConfig } from './canvas/ILeaferCanvas'
+export { ICanvasDrawPath } from './canvas/ICanvasPathDrawer'
+export { CanvasFillRule, CanvasRenderingContext2D, TextMetrics, Path2D } 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 { ILeaferImage, ILeaferImageConfig } from './image/ILeaferImage'
+
+export { InnerId, IEventer, IEventListener, IEventListenerOptions, IEventListenerMap, IEventListenerItem, IEventListenerId } from './event/IEventer'
+export { IEventTarget, IEvent, IAttrEvent, ILayoutEvent, IRenderEvent, IChildEvent, IResizeEvent, IResizeEventListener, IUpdateEvent, IWatchEvent, ITransformEvent, ITransformEventData, TransformMode } from './event/IEvent'
+export { IUIEvent, IPointerEvent, PointerType, IDragEvent, IDropEvent, ISwipeEvent, IMoveEvent, IZoomEvent, IRotateEvent, IKeyEvent } from './event/IUIEvent'
+export { IInteraction, IInteractionConfig, IWheelConfig, IPointerConfig } from './interaction/IInteraction'
+
+
+export { __Number, __Boolean, __String, __Object, __Value, IObject, INumberMap, IStringMap, IBooleanMap, IDataTypeHandle } from './data/IData'
+export { ILeafList, ILeafArrayMap, ILeafMap, ILeafLevelList, ILeafListItemCallback } from './data/IList'
+export { IPoint, IPointData, IRadiusPointData, ISize, ISizeData, IScreenSizeData, IBounds, IBoundsData, IBoundsDataHandle, IOffsetBoundsData, ITwoPointBounds, ITwoPointBoundsData, IAutoBounds, IAutoBoundsData, IMatrix, IMatrixData, IMatrixWithBoundsData } from './math/IMath'
+export { IFunction } from './function/IFunction'