fabric 6.2.0 → 6.3.0

package/dist-extensions/src/shapes/Ellipse.d.ts

@@ -0,0 +1,88 @@
+import type { Abortable, TClassProperties, TOptions } from '../typedefs';
+import { FabricObject } from './Object/FabricObject';
+import type { FabricObjectProps, SerializedObjectProps } from './Object/types';
+import type { ObjectEvents } from '../EventTypeDefs';
+import type { CSSRules } from '../parser/typedefs';
+export declare const ellipseDefaultValues: Partial<TClassProperties<Ellipse>>;
+interface UniqueEllipseProps {
+    rx: number;
+    ry: number;
+}
+export interface SerializedEllipseProps extends SerializedObjectProps, UniqueEllipseProps {
+}
+export interface EllipseProps extends FabricObjectProps, UniqueEllipseProps {
+}
+export declare class Ellipse<Props extends TOptions<EllipseProps> = Partial<EllipseProps>, SProps extends SerializedEllipseProps = SerializedEllipseProps, EventSpec extends ObjectEvents = ObjectEvents> extends FabricObject<Props, SProps, EventSpec> implements EllipseProps {
+    /**
+     * Horizontal radius
+     * @type Number
+     * @default
+     */
+    rx: number;
+    /**
+     * Vertical radius
+     * @type Number
+     * @default
+     */
+    ry: number;
+    static type: string;
+    static cacheProperties: string[];
+    static ownDefaults: Partial<TClassProperties<Ellipse<Partial<EllipseProps>, SerializedEllipseProps, ObjectEvents>>>;
+    static getDefaults(): Record<string, any>;
+    /**
+     * Constructor
+     * @param {Object} [options] Options object
+     */
+    constructor(options?: Props);
+    /**
+     * @private
+     * @param {String} key
+     * @param {*} value
+     * @return {Ellipse} thisArg
+     */
+    _set(key: string, value: any): this;
+    /**
+     * Returns horizontal radius of an object (according to how an object is scaled)
+     * @return {Number}
+     */
+    getRx(): number;
+    /**
+     * Returns Vertical radius of an object (according to how an object is scaled)
+     * @return {Number}
+     */
+    getRy(): number;
+    /**
+     * Returns object representation of an instance
+     * @param {Array} [propertiesToInclude] Any properties that you might want to additionally include in the output
+     * @return {Object} object representation of an instance
+     */
+    toObject<T extends Omit<Props & TClassProperties<this>, keyof SProps>, K extends keyof T = never>(propertiesToInclude?: K[]): Pick<T, K> & SProps;
+    /**
+     * Returns svg representation of an instance
+     * @return {Array} an array of strings with the specific svg representation
+     * of the instance
+     */
+    _toSVG(): string[];
+    /**
+     * @private
+     * @param {CanvasRenderingContext2D} ctx context to render on
+     */
+    _render(ctx: CanvasRenderingContext2D): void;
+    /**
+     * List of attribute names to account for when parsing SVG element (used by {@link Ellipse.fromElement})
+     * @static
+     * @memberOf Ellipse
+     * @see http://www.w3.org/TR/SVG/shapes.html#EllipseElement
+     */
+    static ATTRIBUTE_NAMES: string[];
+    /**
+     * Returns {@link Ellipse} instance from an SVG element
+     * @static
+     * @memberOf Ellipse
+     * @param {HTMLElement} element Element to parse
+     * @return {Ellipse}
+     */
+    static fromElement(element: HTMLElement, options: Abortable, cssRules?: CSSRules): Promise<Ellipse<Record<string, any>, SerializedEllipseProps, ObjectEvents>>;
+}
+export {};
+//# sourceMappingURL=Ellipse.d.ts.map

package/dist-extensions/src/shapes/Ellipse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ellipse.d.ts","sourceRoot":"","sources":["../../../src/shapes/Ellipse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAmB,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,oBAAoB,EAAE,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAGnE,CAAC;AAEF,UAAU,kBAAkB;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,sBACf,SAAQ,qBAAqB,EAC3B,kBAAkB;CAAG;AAEzB,MAAM,WAAW,YAAa,SAAQ,iBAAiB,EAAE,kBAAkB;CAAG;AAI9E,qBAAa,OAAO,CAChB,KAAK,SAAS,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,EAC5D,MAAM,SAAS,sBAAsB,GAAG,sBAAsB,EAC9D,SAAS,SAAS,YAAY,GAAG,YAAY,CAE/C,SAAQ,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAC7C,YAAW,YAAY;IAEvB;;;;OAIG;IACK,EAAE,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACK,EAAE,EAAE,MAAM,CAAC;IAEnB,MAAM,CAAC,IAAI,SAAa;IAExB,MAAM,CAAC,eAAe,WAA0C;IAEhE,MAAM,CAAC,WAAW,kGAAwB;IAE1C,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAOzC;;;OAGG;gBACS,OAAO,CAAC,EAAE,KAAK;IAM3B;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAgB5B;;;OAGG;IACH,KAAK;IAIL;;;OAGG;IACH,KAAK;IAIL;;;;OAIG;IACH,QAAQ,CACN,CAAC,SAAS,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC,EAC5D,CAAC,SAAS,MAAM,CAAC,GAAG,KAAK,EACzB,mBAAmB,GAAE,CAAC,EAAO,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM;IAIrD;;;;OAIG;IACH,MAAM,IAAI,MAAM,EAAE;IAQlB;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,wBAAwB;IAWrC;;;;;OAKG;IACH,MAAM,CAAC,eAAe,WAAkD;IAExE;;;;;;OAMG;WACU,WAAW,CACtB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,SAAS,EAClB,QAAQ,CAAC,EAAE,QAAQ;CActB"}

package/dist-extensions/src/shapes/Group.d.ts

@@ -0,0 +1,303 @@
+import type { CollectionEvents, ObjectEvents } from '../EventTypeDefs';
+import type { TClassProperties, TSVGReviver, TOptions, Abortable } from '../typedefs';
+import { FabricObject } from './Object/FabricObject';
+import type { FabricObjectProps, SerializedObjectProps } from './Object/types';
+import type { ImperativeLayoutOptions, LayoutBeforeEvent, LayoutAfterEvent } from '../LayoutManager/types';
+import { LayoutManager } from '../LayoutManager/LayoutManager';
+import type { SerializedLayoutManager } from '../LayoutManager/LayoutManager';
+export interface GroupEvents extends ObjectEvents, CollectionEvents {
+    'layout:before': LayoutBeforeEvent;
+    'layout:after': LayoutAfterEvent;
+}
+export interface GroupOwnProps {
+    subTargetCheck: boolean;
+    interactive: boolean;
+}
+export interface SerializedGroupProps extends SerializedObjectProps, GroupOwnProps {
+    objects: SerializedObjectProps[];
+    layoutManager: SerializedLayoutManager;
+}
+export interface GroupProps extends FabricObjectProps, GroupOwnProps {
+    layoutManager: LayoutManager;
+}
+export declare const groupDefaultValues: Partial<TClassProperties<Group>>;
+declare const Group_base: {
+    new (...args: any[]): {
+        _objects: FabricObject[];
+        _onObjectAdded(object: FabricObject): void;
+        _onObjectRemoved(object: FabricObject): void;
+        _onStackOrderChanged(object: FabricObject): void;
+        add(...objects: FabricObject[]): number;
+        insertAt(index: number, ...objects: FabricObject[]): number;
+        remove(...objects: FabricObject[]): FabricObject<Partial<FabricObjectProps>, SerializedObjectProps, ObjectEvents>[];
+        forEachObject(callback: (object: FabricObject, index: number, array: FabricObject[]) => any): void;
+        getObjects(...types: string[]): FabricObject<Partial<FabricObjectProps>, SerializedObjectProps, ObjectEvents>[];
+        item(index: number): FabricObject<Partial<FabricObjectProps>, SerializedObjectProps, ObjectEvents>;
+        isEmpty(): boolean;
+        size(): number;
+        contains(object: FabricObject, deep?: boolean): boolean;
+        complexity(): number;
+        sendObjectToBack(object: FabricObject): boolean;
+        bringObjectToFront(object: FabricObject): boolean;
+        sendObjectBackwards(object: FabricObject, intersecting?: boolean): boolean;
+        bringObjectForward(object: FabricObject, intersecting?: boolean): boolean;
+        moveObjectTo(object: FabricObject, index: number): boolean;
+        findNewLowerIndex(object: FabricObject, idx: number, intersecting?: boolean): number;
+        findNewUpperIndex(object: FabricObject, idx: number, intersecting?: boolean): number;
+        collectObjects({ left, top, width, height }: import("../typedefs").TBBox, { includeIntersecting }?: {
+            includeIntersecting?: boolean;
+        }): import("./Object/InteractiveObject").InteractiveFabricObject<Partial<FabricObjectProps>, SerializedObjectProps, ObjectEvents>[];
+    };
+} & {
+    new (options?: GroupProps | undefined): FabricObject<GroupProps, SerializedGroupProps, GroupEvents>;
+    ownDefaults: Partial<TClassProperties<import("./Object/InteractiveObject").InteractiveFabricObject<Partial<FabricObjectProps>, SerializedObjectProps, ObjectEvents>>>;
+    getDefaults(): Record<string, any>;
+    createControls(): {
+        controls: Record<string, import("../..").Control>;
+    };
+    stateProperties: string[];
+    cacheProperties: string[];
+    type: string;
+    _fromObject<S extends import("./Object/Object").FabricObject>({ type, ...serializedObjectOptions }: Record<string, unknown>, { extraParam, ...options }?: Abortable & {
+        extraParam?: string;
+    }): Promise<S>;
+    fromObject<T extends TOptions<SerializedObjectProps>>(object: T, options?: Abortable): Promise<import("./Object/Object").FabricObject<Partial<import("./Object/types/ObjectProps").ObjectProps>, SerializedObjectProps, ObjectEvents>>;
+    colorProperties: string[];
+};
+/**
+ * @fires object:added
+ * @fires object:removed
+ * @fires layout:before
+ * @fires layout:after
+ */
+export declare class Group extends Group_base implements GroupProps {
+    /**
+     * Used to optimize performance
+     * set to `false` if you don't need contained objects to be targets of events
+     * @default
+     * @type boolean
+     */
+    subTargetCheck: boolean;
+    /**
+     * Used to allow targeting of object inside groups.
+     * set to true if you want to select an object inside a group.\
+     * **REQUIRES** `subTargetCheck` set to true
+     * This will be not removed but slowly replaced with a method setInteractive
+     * that will take care of enabling subTargetCheck and necessary object events.
+     * There is too much attached to group interactivity to just be evaluated by a
+     * boolean in the code
+     * @default
+     * @deprecated
+     * @type boolean
+     */
+    interactive: boolean;
+    layoutManager: LayoutManager;
+    /**
+     * Used internally to optimize performance
+     * Once an object is selected, instance is rendered without the selected object.
+     * This way instance is cached only once for the entire interaction with the selected object.
+     * @private
+     */
+    protected _activeObjects: FabricObject[];
+    static type: string;
+    static ownDefaults: Record<string, any>;
+    private __objectSelectionTracker;
+    private __objectSelectionDisposer;
+    static getDefaults(): Record<string, any>;
+    /**
+     * Constructor
+     *
+     * @param {FabricObject[]} [objects] instance objects
+     * @param {Object} [options] Options object
+     */
+    constructor(objects?: FabricObject[], options?: Partial<GroupProps>);
+    /**
+     * Shared code between group and active selection
+     * Meant to be used by the constructor.
+     */
+    protected groupInit(objects: FabricObject[], options: {
+        layoutManager?: LayoutManager;
+        top?: number;
+        left?: number;
+    }): void;
+    /**
+     * Checks if object can enter group and logs relevant warnings
+     * @private
+     * @param {FabricObject} object
+     * @returns
+     */
+    canEnterGroup(object: FabricObject): boolean;
+    /**
+     * Override this method to enhance performance (for groups with a lot of objects).
+     * If Overriding, be sure not pass illegal objects to group - it will break your app.
+     * @private
+     */
+    protected _filterObjectsBeforeEnteringGroup(objects: FabricObject[]): FabricObject<Partial<FabricObjectProps>, SerializedObjectProps, ObjectEvents>[];
+    /**
+     * Add objects
+     * @param {...FabricObject[]} objects
+     */
+    add(...objects: FabricObject[]): number;
+    /**
+     * Inserts an object into collection at specified index
+     * @param {FabricObject[]} objects Object to insert
+     * @param {Number} index Index to insert object at
+     */
+    insertAt(index: number, ...objects: FabricObject[]): number;
+    /**
+     * Remove objects
+     * @param {...FabricObject[]} objects
+     * @returns {FabricObject[]} removed objects
+     */
+    remove(...objects: FabricObject[]): FabricObject<Partial<FabricObjectProps>, SerializedObjectProps, ObjectEvents>[];
+    _onObjectAdded(object: FabricObject): void;
+    /**
+     * @private
+     * @param {FabricObject} object
+     * @param {boolean} [removeParentTransform] true if object should exit group without applying group's transform to it
+     */
+    _onObjectRemoved(object: FabricObject, removeParentTransform?: boolean): void;
+    /**
+     * @private
+     * @param {'added'|'removed'} type
+     * @param {FabricObject[]} targets
+     */
+    _onAfterObjectsChange(type: 'added' | 'removed', targets: FabricObject[]): void;
+    _onStackOrderChanged(): void;
+    /**
+     * @private
+     * @param {string} key
+     * @param {*} value
+     */
+    _set(key: string, value: any): this;
+    /**
+     * @private
+     */
+    _shouldSetNestedCoords(): boolean;
+    /**
+     * Remove all objects
+     * @returns {FabricObject[]} removed objects
+     */
+    removeAll(): FabricObject<Partial<FabricObjectProps>, SerializedObjectProps, ObjectEvents>[];
+    /**
+     * keeps track of the selected objects
+     * @private
+     */
+    __objectSelectionMonitor<T extends boolean>(selected: T, { target: object, }: ObjectEvents[T extends true ? 'selected' : 'deselected']): void;
+    /**
+     * @private
+     * @param {boolean} watch
+     * @param {FabricObject} object
+     */
+    _watchObject(watch: boolean, object: FabricObject): void;
+    /**
+     * @private
+     * @param {FabricObject} object
+     * @param {boolean} [removeParentTransform] true if object is in canvas coordinate plane
+     */
+    enterGroup(object: FabricObject, removeParentTransform?: boolean): void;
+    /**
+     * @private
+     * @param {FabricObject} object
+     * @param {boolean} [removeParentTransform] true if object is in canvas coordinate plane
+     */
+    _enterGroup(object: FabricObject, removeParentTransform?: boolean): void;
+    /**
+     * @private
+     * @param {FabricObject} object
+     * @param {boolean} [removeParentTransform] true if object should exit group without applying group's transform to it
+     */
+    exitGroup(object: FabricObject, removeParentTransform?: boolean): void;
+    /**
+     * Executes the inner fabric logic of exiting a group.
+     * - Stop watching the object
+     * - Remove the object from the optimization map this._activeObjects
+     * - unset the group property of the object
+     * @protected
+     * @param {FabricObject} object
+     * @param {boolean} [removeParentTransform] true if object should exit group without applying group's transform to it
+     */
+    _exitGroup(object: FabricObject, removeParentTransform?: boolean): void;
+    /**
+     * Decide if the object should cache or not. Create its own cache level
+     * needsItsOwnCache should be used when the object drawing method requires
+     * a cache step. None of the fabric classes requires it.
+     * Generally you do not cache objects in groups because the group is already cached.
+     * @return {Boolean}
+     */
+    shouldCache(): boolean;
+    /**
+     * Check if this object or a child object will cast a shadow
+     * @return {Boolean}
+     */
+    willDrawShadow(): boolean;
+    /**
+     * Check if instance or its group are caching, recursively up
+     * @return {Boolean}
+     */
+    isOnACache(): boolean;
+    /**
+     * Execute the drawing operation for an object on a specified context
+     * @param {CanvasRenderingContext2D} ctx Context to render on
+     */
+    drawObject(ctx: CanvasRenderingContext2D): void;
+    /**
+     * @override
+     * @return {Boolean}
+     */
+    setCoords(): void;
+    triggerLayout(options?: ImperativeLayoutOptions): void;
+    /**
+     * Renders instance on a given context
+     * @param {CanvasRenderingContext2D} ctx context to render instance on
+     */
+    render(ctx: CanvasRenderingContext2D): void;
+    /**
+     *
+     * @private
+     * @param {'toObject'|'toDatalessObject'} [method]
+     * @param {string[]} [propertiesToInclude] Any properties that you might want to additionally include in the output
+     * @returns {FabricObject[]} serialized objects
+     */
+    __serializeObjects(method: 'toObject' | 'toDatalessObject', propertiesToInclude?: string[]): any[];
+    /**
+     * Returns object representation of an instance
+     * @param {string[]} [propertiesToInclude] Any properties that you might want to additionally include in the output
+     * @return {Object} object representation of an instance
+     */
+    toObject<T extends Omit<GroupProps & TClassProperties<this>, keyof SerializedGroupProps>, K extends keyof T = never>(propertiesToInclude?: K[]): Pick<T, K> & SerializedGroupProps;
+    toString(): string;
+    dispose(): void;
+    /**
+     * @private
+     */
+    _createSVGBgRect(reviver?: TSVGReviver): string;
+    /**
+     * Returns svg representation of an instance
+     * @param {TSVGReviver} [reviver] Method for further parsing of svg representation.
+     * @return {String} svg representation of an instance
+     */
+    _toSVG(reviver?: TSVGReviver): string[];
+    /**
+     * Returns styles-string for svg-export, specific version for group
+     * @return {String}
+     */
+    getSvgStyles(): string;
+    /**
+     * Returns svg clipPath representation of an instance
+     * @param {Function} [reviver] Method for further parsing of svg representation.
+     * @return {String} svg representation of an instance
+     */
+    toClipPathSVG(reviver?: TSVGReviver): string;
+    /**
+     * @todo support loading from svg
+     * @private
+     * @static
+     * @memberOf Group
+     * @param {Object} object Object to create a group from
+     * @returns {Promise<Group>}
+     */
+    static fromObject<T extends TOptions<SerializedGroupProps>>({ type, objects, layoutManager, ...options }: T, abortable?: Abortable): Promise<Group>;
+}
+export {};
+//# sourceMappingURL=Group.d.ts.map

package/dist-extensions/src/shapes/Group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../../src/shapes/Group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,SAAS,EACV,MAAM,aAAa,CAAC;AAUrB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE/E,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAO/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAc9E,MAAM,WAAW,WAAY,SAAQ,YAAY,EAAE,gBAAgB;IACjE,eAAe,EAAE,iBAAiB,CAAC;IACnC,cAAc,EAAE,gBAAgB,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBACf,SAAQ,qBAAqB,EAC3B,aAAa;IACf,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,aAAa,EAAE,uBAAuB,CAAC;CACxC;AAED,MAAM,WAAW,UAAW,SAAQ,iBAAiB,EAAE,aAAa;IAClE,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAI/D,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsoBiy6B,CAAC;;;;;AApoBpy6B;;;;;GAKG;AACH,qBAAa,KACX,SAAQ,UAGR,YAAW,UAAU;IAErB;;;;;OAKG;IACK,cAAc,EAAE,OAAO,CAAC;IAEhC;;;;;;;;;;;OAWG;IACK,WAAW,EAAE,OAAO,CAAC;IAErB,aAAa,EAAE,aAAa,CAAC;IAErC;;;;;OAKG;IACH,SAAS,CAAC,cAAc,EAAE,YAAY,EAAE,CAAM;IAE9C,MAAM,CAAC,IAAI,SAAW;IAEtB,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAsB;IAC7D,OAAO,CAAC,wBAAwB,CAAyC;IACzE,OAAO,CAAC,yBAAyB,CAA2C;IAE5E,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAOzC;;;;;OAKG;gBACS,OAAO,GAAE,YAAY,EAAO,EAAE,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM;IAO3E;;;OAGG;IACH,SAAS,CAAC,SAAS,CACjB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE;QACP,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IA+BH;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY;IAmBlC;;;;OAIG;IACH,SAAS,CAAC,iCAAiC,CAAC,OAAO,EAAE,YAAY,EAAE;IAOnE;;;OAGG;IACH,GAAG,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE;IAO9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE;IAOlD;;;;OAIG;IACH,MAAM,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE;IAMjC,cAAc,CAAC,MAAM,EAAE,YAAY;IAMnC;;;;OAIG;IACH,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,qBAAqB,CAAC,EAAE,OAAO;IAMtE;;;;OAIG;IACH,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE;IAQxE,oBAAoB;IAIpB;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAW5B;;OAEG;IACH,sBAAsB;IAItB;;;OAGG;IACH,SAAS;IAKT;;;OAGG;IACH,wBAAwB,CAAC,CAAC,SAAS,OAAO,EACxC,QAAQ,EAAE,CAAC,EACX,EACE,MAAM,EAAE,MAAM,GACf,EAAE,YAAY,CAAC,CAAC,SAAS,IAAI,GAAG,UAAU,GAAG,YAAY,CAAC;IAe7D;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY;IAYjD;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,qBAAqB,CAAC,EAAE,OAAO;IAMhE;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,qBAAqB,CAAC,EAAE,OAAO;IA4BjE;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,qBAAqB,CAAC,EAAE,OAAO;IAM/D;;;;;;;;OAQG;IACH,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,qBAAqB,CAAC,EAAE,OAAO;IAoBhE;;;;;;OAMG;IACH,WAAW;IAaX;;;OAGG;IACH,cAAc;IAYd;;;OAGG;IACH,UAAU,IAAI,OAAO;IAIrB;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,wBAAwB;IAmBxC;;;OAGG;IACH,SAAS;IAMT,aAAa,CAAC,OAAO,GAAE,uBAA4B;IAQnD;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,wBAAwB;IAMpC;;;;;;OAMG;IACH,kBAAkB,CAChB,MAAM,EAAE,UAAU,GAAG,kBAAkB,EACvC,mBAAmB,CAAC,EAAE,MAAM,EAAE;IAiBhC;;;;OAIG;IACH,QAAQ,CACN,CAAC,SAAS,IAAI,CACZ,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,EACnC,MAAM,oBAAoB,CAC3B,EACD,CAAC,SAAS,MAAM,CAAC,GAAG,KAAK,EACzB,mBAAmB,GAAE,CAAC,EAAO,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,oBAAoB;IAmBnE,QAAQ;IAIR,OAAO;IAaP;;OAEG;IACH,gBAAgB,CAAC,OAAO,CAAC,EAAE,WAAW;IAWtC;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW;IAW5B;;;OAGG;IACH,YAAY,IAAI,MAAM;IAStB;;;;OAIG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM;IAY5C;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,QAAQ,CAAC,oBAAoB,CAAC,EACxD,EAAE,IAAI,EAAE,OAAY,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,EACpD,SAAS,CAAC,EAAE,SAAS;CA+BxB"}

package/dist-extensions/src/shapes/IText/DraggableTextDelegate.d.ts

@@ -0,0 +1,78 @@
+import type { DragEventData, DropEventData, TPointerEvent } from '../../EventTypeDefs';
+import type { IText } from './IText';
+/**
+ * #### Dragging IText/Textbox Lifecycle
+ * - {@link start} is called from `mousedown` {@link IText#_mouseDownHandler} and determines if dragging should start by testing {@link isPointerOverSelection}
+ * - if true `mousedown` {@link IText#_mouseDownHandler} is blocked to keep selection
+ * - if the pointer moves, canvas fires numerous mousemove {@link Canvas#_onMouseMove} that we make sure **aren't** prevented ({@link IText#shouldStartDragging}) in order for the window to start a drag session
+ * - once/if the session starts canvas calls {@link onDragStart} on the active object to determine if dragging should occur
+ * - canvas fires relevant drag events that are handled by the handlers defined in this scope
+ * - {@link end} is called from `mouseup` {@link IText#mouseUpHandler}, blocking IText default click behavior
+ * - in case the drag session didn't occur, {@link end} handles a click, since logic to do so was blocked during `mousedown`
+ */
+export declare class DraggableTextDelegate {
+    readonly target: IText;
+    private __mouseDownInPlace;
+    private __dragStartFired;
+    private __isDraggingOver;
+    private __dragStartSelection?;
+    private __dragImageDisposer?;
+    private _dispose?;
+    constructor(target: IText);
+    isPointerOverSelection(e: TPointerEvent): boolean;
+    /**
+     * @public override this method to disable dragging and default to mousedown logic
+     */
+    start(e: TPointerEvent): boolean;
+    /**
+     * @public override this method to disable dragging without discarding selection
+     */
+    isActive(): boolean;
+    /**
+     * Ends interaction and sets cursor in case of a click
+     * @returns true if was active
+     */
+    end(e: TPointerEvent): boolean;
+    getDragStartSelection(): {
+        selectionStart: number;
+        selectionEnd: number;
+    } | undefined;
+    /**
+     * Override to customize the drag image
+     * https://developer.mozilla.org/en-US/docs/Web/API/DataTransfer/setDragImage
+     */
+    setDragImage(e: DragEvent, { selectionStart, selectionEnd, }: {
+        selectionStart: number;
+        selectionEnd: number;
+    }): void;
+    /**
+     * @returns {boolean} determines whether {@link target} should/shouldn't become a drag source
+     */
+    onDragStart(e: DragEvent): boolean;
+    /**
+     * use {@link targetCanDrop} to respect overriding
+     * @returns {boolean} determines whether {@link target} should/shouldn't become a drop target
+     */
+    canDrop(e: DragEvent): boolean;
+    /**
+     * in order to respect overriding {@link IText#canDrop} we call that instead of calling {@link canDrop} directly
+     */
+    protected targetCanDrop(e: DragEvent): boolean;
+    dragEnterHandler({ e }: DragEventData): void;
+    dragOverHandler(ev: DragEventData): void;
+    dragLeaveHandler(): void;
+    /**
+     * Override the `text/plain | application/fabric` types of {@link DragEvent#dataTransfer}
+     * in order to change the drop value or to customize styling respectively, by listening to the `drop:before` event
+     * https://developer.mozilla.org/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Drag_operations#performing_a_drop
+     */
+    dropHandler(ev: DropEventData): void;
+    /**
+     * fired only on the drag source after drop (if occurred)
+     * handle changes to the drag source in case of a drop on another object or a cancellation
+     * https://developer.mozilla.org/en-US/docs/Web/API/HTML_Drag_and_Drop_API/Drag_operations#finishing_a_drag
+     */
+    dragEndHandler({ e }: DragEventData): void;
+    dispose(): void;
+}
+//# sourceMappingURL=DraggableTextDelegate.d.ts.map

package/dist-extensions/src/shapes/IText/DraggableTextDelegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DraggableTextDelegate.d.ts","sourceRoot":"","sources":["../../../../src/shapes/IText/DraggableTextDelegate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAOrC;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IAChC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,oBAAoB,CAAC,CAG3B;IACF,OAAO,CAAC,mBAAmB,CAAC,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,CAAa;gBAElB,MAAM,EAAE,KAAK;IAezB,sBAAsB,CAAC,CAAC,EAAE,aAAa;IAWvC;;OAEG;IACH,KAAK,CAAC,CAAC,EAAE,aAAa;IAItB;;OAEG;IACH,QAAQ;IAIR;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,aAAa;IAepB,qBAAqB;wBAjEH,MAAM;sBACR,MAAM;;IAoEtB;;;OAGG;IACH,YAAY,CACV,CAAC,EAAE,SAAS,EACZ,EACE,cAAc,EACd,YAAY,GACb,EAAE;QACD,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB;IAwDH;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO;IAgClC;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO;IAqB9B;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,CAAC,EAAE,SAAS;IAIpC,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,aAAa;IAOrC,eAAe,CAAC,EAAE,EAAE,aAAa;IAkBjC,gBAAgB;IAMhB;;;;OAIG;IACH,WAAW,CAAC,EAAE,EAAE,aAAa;IAoE7B;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,aAAa;IAyCnC,OAAO;CAGR"}