fabric 5.3.0 → 6.0.0-beta3

package/dist/src/canvas/TextEditingManager.d.ts

@@ -0,0 +1,17 @@
+import { TPointerEvent } from '../EventTypeDefs';
+import type { ITextBehavior } from '../shapes/IText/ITextBehavior';
+/**
+ * In charge of synchronizing all interactive text instances of a canvas
+ */
+export declare class TextEditingManager {
+    private targets;
+    private target?;
+    exitTextEditing(): void;
+    add(target: ITextBehavior): void;
+    remove(target: ITextBehavior): void;
+    register(target: ITextBehavior): void;
+    unregister(target: ITextBehavior): void;
+    onMouseMove(e: TPointerEvent): void;
+    dispose(): void;
+}
+//# sourceMappingURL=TextEditingManager.d.ts.map

package/dist/src/canvas/canvas_gestures.mixin.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=canvas_gestures.mixin.d.ts.map

package/dist/src/color/Color.d.ts

@@ -0,0 +1,174 @@
+/**
+ * RGB format
+ */
+export type TRGBColorSource = [red: number, green: number, blue: number];
+/**
+ * RGBA format
+ */
+export type TRGBAColorSource = [
+    red: number,
+    green: number,
+    blue: number,
+    alpha: number
+];
+export type TColorArg = string | TRGBColorSource | TRGBAColorSource | Color;
+/**
+ * @class Color common color operations
+ * @tutorial {@link http://fabricjs.com/fabric-intro-part-2/#colors colors}
+ */
+export declare class Color {
+    private _source;
+    /**
+     *
+     * @param {string} [color] optional in hex or rgb(a) or hsl format or from known color list
+     */
+    constructor(color?: TColorArg);
+    /**
+     * @private
+     * @param {string} [color] Color value to parse
+     * @returns {TRGBAColorSource}
+     */
+    protected _tryParsingColor(color: string): TRGBAColorSource;
+    /**
+     * Adapted from {@link https://gist.github.com/mjackson/5311256 https://gist.github.com/mjackson}
+     * @private
+     * @param {Number} r Red color value
+     * @param {Number} g Green color value
+     * @param {Number} b Blue color value
+     * @return {TRGBColorSource} Hsl color
+     */
+    _rgbToHsl(r: number, g: number, b: number): TRGBColorSource;
+    /**
+     * Returns source of this color (where source is an array representation; ex: [200, 200, 100, 1])
+     * @return {TRGBAColorSource}
+     */
+    getSource(): TRGBAColorSource;
+    /**
+     * Sets source of this color (where source is an array representation; ex: [200, 200, 100, 1])
+     * @param {TRGBAColorSource} source
+     */
+    setSource(source: TRGBAColorSource): void;
+    /**
+     * Returns color representation in RGB format
+     * @return {String} ex: rgb(0-255,0-255,0-255)
+     */
+    toRgb(): string;
+    /**
+     * Returns color representation in RGBA format
+     * @return {String} ex: rgba(0-255,0-255,0-255,0-1)
+     */
+    toRgba(): string;
+    /**
+     * Returns color representation in HSL format
+     * @return {String} ex: hsl(0-360,0%-100%,0%-100%)
+     */
+    toHsl(): string;
+    /**
+     * Returns color representation in HSLA format
+     * @return {String} ex: hsla(0-360,0%-100%,0%-100%,0-1)
+     */
+    toHsla(): string;
+    /**
+     * Returns color representation in HEX format
+     * @return {String} ex: FF5555
+     */
+    toHex(): string;
+    /**
+     * Returns color representation in HEXA format
+     * @return {String} ex: FF5555CC
+     */
+    toHexa(): string;
+    /**
+     * Gets value of alpha channel for this color
+     * @return {Number} 0-1
+     */
+    getAlpha(): number;
+    /**
+     * Sets value of alpha channel for this color
+     * @param {Number} alpha Alpha value 0-1
+     * @return {Color} thisArg
+     */
+    setAlpha(alpha: number): this;
+    /**
+     * Transforms color to its grayscale representation
+     * @return {Color} thisArg
+     */
+    toGrayscale(): this;
+    /**
+     * Transforms color to its black and white representation
+     * @param {Number} threshold
+     * @return {Color} thisArg
+     */
+    toBlackWhite(threshold: number): this;
+    /**
+     * Overlays color with another color
+     * @param {String|Color} otherColor
+     * @return {Color} thisArg
+     */
+    overlayWith(otherColor: string | Color): this;
+    /**
+     * Returns new color object, when given a color in RGB format
+     * @memberOf Color
+     * @param {String} color Color value ex: rgb(0-255,0-255,0-255)
+     * @return {Color}
+     */
+    static fromRgb(color: string): Color;
+    /**
+     * Returns new color object, when given a color in RGBA format
+     * @static
+     * @function
+     * @memberOf Color
+     * @param {String} color
+     * @return {Color}
+     */
+    static fromRgba(color: string): Color;
+    /**
+     * Returns array representation (ex: [100, 100, 200, 1]) of a color that's in RGB or RGBA format
+     * @memberOf Color
+     * @param {String} color Color value ex: rgb(0-255,0-255,0-255), rgb(0%-100%,0%-100%,0%-100%)
+     * @return {TRGBAColorSource | undefined} source
+     */
+    static sourceFromRgb(color: string): TRGBAColorSource | undefined;
+    /**
+     * Returns new color object, when given a color in HSL format
+     * @param {String} color Color value ex: hsl(0-260,0%-100%,0%-100%)
+     * @memberOf Color
+     * @return {Color}
+     */
+    static fromHsl(color: string): Color;
+    /**
+     * Returns new color object, when given a color in HSLA format
+     * @static
+     * @function
+     * @memberOf Color
+     * @param {String} color
+     * @return {Color}
+     */
+    static fromHsla(color: string): Color;
+    /**
+     * Returns array representation (ex: [100, 100, 200, 1]) of a color that's in HSL or HSLA format.
+     * Adapted from <a href="https://rawgithub.com/mjijackson/mjijackson.github.com/master/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript.html">https://github.com/mjijackson</a>
+     * @memberOf Color
+     * @param {String} color Color value ex: hsl(0-360,0%-100%,0%-100%) or hsla(0-360,0%-100%,0%-100%, 0-1)
+     * @return {TRGBAColorSource | undefined} source
+     * @see http://http://www.w3.org/TR/css3-color/#hsl-color
+     */
+    static sourceFromHsl(color: string): TRGBAColorSource | undefined;
+    /**
+     * Returns new color object, when given a color in HEX format
+     * @static
+     * @memberOf Color
+     * @param {String} color Color value ex: FF5555
+     * @return {Color}
+     */
+    static fromHex(color: string): Color;
+    /**
+     * Returns array representation (ex: [100, 100, 200, 1]) of a color that's in HEX format
+     * @static
+     * @memberOf Color
+     * @param {String} color ex: FF5555 or FF5544CC (RGBa)
+     * @return {TRGBAColorSource | undefined} source
+     */
+    static sourceFromHex(color: string): TRGBAColorSource | undefined;
+}
+//# sourceMappingURL=Color.d.ts.map

package/dist/src/color/color_map.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Map of the 148 color names with HEX code
+ * @see: https://www.w3.org/TR/css3-color/#svg-color
+ */
+export declare const ColorNameMap: {
+    aliceblue: string;
+    antiquewhite: string;
+    aqua: string;
+    aquamarine: string;
+    azure: string;
+    beige: string;
+    bisque: string;
+    black: string;
+    blanchedalmond: string;
+    blue: string;
+    blueviolet: string;
+    brown: string;
+    burlywood: string;
+    cadetblue: string;
+    chartreuse: string;
+    chocolate: string;
+    coral: string;
+    cornflowerblue: string;
+    cornsilk: string;
+    crimson: string;
+    cyan: string;
+    darkblue: string;
+    darkcyan: string;
+    darkgoldenrod: string;
+    darkgray: string;
+    darkgrey: string;
+    darkgreen: string;
+    darkkhaki: string;
+    darkmagenta: string;
+    darkolivegreen: string;
+    darkorange: string;
+    darkorchid: string;
+    darkred: string;
+    darksalmon: string;
+    darkseagreen: string;
+    darkslateblue: string;
+    darkslategray: string;
+    darkslategrey: string;
+    darkturquoise: string;
+    darkviolet: string;
+    deeppink: string;
+    deepskyblue: string;
+    dimgray: string;
+    dimgrey: string;
+    dodgerblue: string;
+    firebrick: string;
+    floralwhite: string;
+    forestgreen: string;
+    fuchsia: string;
+    gainsboro: string;
+    ghostwhite: string;
+    gold: string;
+    goldenrod: string;
+    gray: string;
+    grey: string;
+    green: string;
+    greenyellow: string;
+    honeydew: string;
+    hotpink: string;
+    indianred: string;
+    indigo: string;
+    ivory: string;
+    khaki: string;
+    lavender: string;
+    lavenderblush: string;
+    lawngreen: string;
+    lemonchiffon: string;
+    lightblue: string;
+    lightcoral: string;
+    lightcyan: string;
+    lightgoldenrodyellow: string;
+    lightgray: string;
+    lightgrey: string;
+    lightgreen: string;
+    lightpink: string;
+    lightsalmon: string;
+    lightseagreen: string;
+    lightskyblue: string;
+    lightslategray: string;
+    lightslategrey: string;
+    lightsteelblue: string;
+    lightyellow: string;
+    lime: string;
+    limegreen: string;
+    linen: string;
+    magenta: string;
+    maroon: string;
+    mediumaquamarine: string;
+    mediumblue: string;
+    mediumorchid: string;
+    mediumpurple: string;
+    mediumseagreen: string;
+    mediumslateblue: string;
+    mediumspringgreen: string;
+    mediumturquoise: string;
+    mediumvioletred: string;
+    midnightblue: string;
+    mintcream: string;
+    mistyrose: string;
+    moccasin: string;
+    navajowhite: string;
+    navy: string;
+    oldlace: string;
+    olive: string;
+    olivedrab: string;
+    orange: string;
+    orangered: string;
+    orchid: string;
+    palegoldenrod: string;
+    palegreen: string;
+    paleturquoise: string;
+    palevioletred: string;
+    papayawhip: string;
+    peachpuff: string;
+    peru: string;
+    pink: string;
+    plum: string;
+    powderblue: string;
+    purple: string;
+    rebeccapurple: string;
+    red: string;
+    rosybrown: string;
+    royalblue: string;
+    saddlebrown: string;
+    salmon: string;
+    sandybrown: string;
+    seagreen: string;
+    seashell: string;
+    sienna: string;
+    silver: string;
+    skyblue: string;
+    slateblue: string;
+    slategray: string;
+    slategrey: string;
+    snow: string;
+    springgreen: string;
+    steelblue: string;
+    tan: string;
+    teal: string;
+    thistle: string;
+    tomato: string;
+    turquoise: string;
+    violet: string;
+    wheat: string;
+    white: string;
+    whitesmoke: string;
+    yellow: string;
+    yellowgreen: string;
+};
+//# sourceMappingURL=color_map.d.ts.map

package/dist/src/color/constants.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Regex matching color in RGB or RGBA formats (ex: rgb(0, 0, 0), rgba(255, 100, 10, 0.5), rgba( 255 , 100 , 10 , 0.5 ), rgb(1,1,1), rgba(100%, 60%, 10%, 0.5))
+ * @static
+ * @field
+ * @memberOf Color
+ */
+export declare const reRGBa: RegExp;
+/**
+ * Regex matching color in HSL or HSLA formats (ex: hsl(200, 80%, 10%), hsla(300, 50%, 80%, 0.5), hsla( 300 , 50% , 80% , 0.5 ))
+ * @static
+ * @field
+ * @memberOf Color
+ */
+export declare const reHSLa: RegExp;
+/**
+ * Regex matching color in HEX format (ex: #FF5544CC, #FF5555, 010155, aff)
+ * @static
+ * @field
+ * @memberOf Color
+ */
+export declare const reHex: RegExp;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/color/util.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @param {Number} p
+ * @param {Number} q
+ * @param {Number} t
+ * @return {Number}
+ */
+export declare function hue2rgb(p: number, q: number, t: number): number;
+/**
+ * Convert a value ∈ [0, 255] to hex
+ */
+export declare function hexify(value: number): string;
+//# sourceMappingURL=util.d.ts.map

package/dist/src/config.d.ts

@@ -0,0 +1,115 @@
+export type TConfiguration = Partial<BaseConfiguration>;
+declare class BaseConfiguration {
+    /**
+     * Browser-specific constant to adjust CanvasRenderingContext2D.shadowBlur value,
+     * which is unitless and not rendered equally across browsers.
+     *
+     * Values that work quite well (as of October 2017) are:
+     * - Chrome: 1.5
+     * - Edge: 1.75
+     * - Firefox: 0.9
+     * - Safari: 0.95
+     *
+     * @since 2.0.0
+     * @type Number
+     * @default 1
+     */
+    browserShadowBlurConstant: number;
+    /**
+     * Pixel per Inch as a default value set to 96. Can be changed for more realistic conversion.
+     */
+    DPI: number;
+    /**
+     * Device Pixel Ratio
+     * @see https://developer.apple.com/library/safari/documentation/AudioVideo/Conceptual/HTML-canvas-guide/SettingUptheCanvas/SettingUptheCanvas.html
+     */
+    devicePixelRatio: number;
+    /**
+     * Pixel limit for cache canvases. 1Mpx , 4Mpx should be fine.
+     * @since 1.7.14
+     * @type Number
+     * @default
+     */
+    perfLimitSizeTotal: number;
+    /**
+     * Pixel limit for cache canvases width or height. IE fixes the maximum at 5000
+     * @since 1.7.14
+     * @type Number
+     * @default
+     */
+    maxCacheSideLimit: number;
+    /**
+     * Lowest pixel limit for cache canvases, set at 256PX
+     * @since 1.7.14
+     * @type Number
+     * @default
+     */
+    minCacheSideLimit: number;
+    /**
+     * When 'true', style information is not retained when copy/pasting text, making
+     * pasted text use destination style.
+     * Defaults to 'false'.
+     * @type Boolean
+     * @default
+     * @deprecated
+     */
+    disableStyleCopyPaste: boolean;
+    /**
+     * Enable webgl for filtering picture is available
+     * A filtering backend will be initialized, this will both take memory and
+     * time since a default 2048x2048 canvas will be created for the gl context
+     * @since 2.0.0
+     * @type Boolean
+     * @default
+     */
+    enableGLFiltering: boolean;
+    /**
+     * if webgl is enabled and available, textureSize will determine the size
+     * of the canvas backend
+     *
+     * In order to support old hardware set to `2048` to avoid OOM
+     *
+     * @since 2.0.0
+     * @type Number
+     * @default
+     */
+    textureSize: number;
+    /**
+     * Skip performance testing of setupGLContext and force the use of putImageData that seems to be the one that works best on
+     * Chrome + old hardware. if your users are experiencing empty images after filtering you may try to force this to true
+     * this has to be set before instantiating the filtering backend ( before filtering the first image )
+     * @type Boolean
+     * @default false
+     */
+    forceGLPutImageData: boolean;
+    /**
+     * If disabled boundsOfCurveCache is not used. For apps that make heavy usage of pencil drawing probably disabling it is better
+     * @default true
+     */
+    cachesBoundsOfCurve: boolean;
+    /**
+     * Map of font files
+     * Map<fontFamily, pathToFile> of font files
+     */
+    fontPaths: Record</** fontFamily */ string, /** pathToFile */ string>;
+    /**
+     * Defines the number of fraction digits to use when serializing object values.
+     * Used in exporting methods (`toObject`, `toJSON`, `toSVG`)
+     * You can use it to increase/decrease precision of such values like left, top, scaleX, scaleY, etc.
+     */
+    NUM_FRACTION_DIGITS: number;
+}
+export declare class Configuration extends BaseConfiguration {
+    constructor(config?: TConfiguration);
+    configure(config?: TConfiguration): void;
+    /**
+     * Map<fontFamily, pathToFile> of font files
+     */
+    addFonts(paths?: Record</** fontFamily */ string, /** pathToFile */ string>): void;
+    removeFonts(fontFamilys?: string[]): void;
+    clearFonts(): void;
+    restoreDefaults<T extends BaseConfiguration>(keys?: (keyof T)[]): void;
+}
+export declare const config: Configuration;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/src/constants.d.ts

@@ -0,0 +1,14 @@
+import { TMat2D } from './typedefs';
+export declare const VERSION: string;
+export declare function noop(): void;
+export declare const halfPI: number;
+export declare const twoMathPi: number;
+export declare const PiBy180: number;
+export declare const iMatrix: TMat2D;
+export declare const DEFAULT_SVG_FONT_SIZE = 16;
+export declare const ALIASING_LIMIT = 2;
+export declare const kRect: number;
+export declare const LEFT_CLICK = 1;
+export declare const MIDDLE_CLICK = 2;
+export declare const RIGHT_CLICK = 3;
+//# sourceMappingURL=constants.d.ts.map