fabric 5.3.0 → 6.0.0-beta1

package/src/color/color_map.ts

@@ -0,0 +1,154 @@
+/**
+ * Map of the 148 color names with HEX code
+ * @see: https://www.w3.org/TR/css3-color/#svg-color
+ */
+export const ColorNameMap = {
+  aliceblue: '#F0F8FF',
+  antiquewhite: '#FAEBD7',
+  aqua: '#00FFFF',
+  aquamarine: '#7FFFD4',
+  azure: '#F0FFFF',
+  beige: '#F5F5DC',
+  bisque: '#FFE4C4',
+  black: '#000000',
+  blanchedalmond: '#FFEBCD',
+  blue: '#0000FF',
+  blueviolet: '#8A2BE2',
+  brown: '#A52A2A',
+  burlywood: '#DEB887',
+  cadetblue: '#5F9EA0',
+  chartreuse: '#7FFF00',
+  chocolate: '#D2691E',
+  coral: '#FF7F50',
+  cornflowerblue: '#6495ED',
+  cornsilk: '#FFF8DC',
+  crimson: '#DC143C',
+  cyan: '#00FFFF',
+  darkblue: '#00008B',
+  darkcyan: '#008B8B',
+  darkgoldenrod: '#B8860B',
+  darkgray: '#A9A9A9',
+  darkgrey: '#A9A9A9',
+  darkgreen: '#006400',
+  darkkhaki: '#BDB76B',
+  darkmagenta: '#8B008B',
+  darkolivegreen: '#556B2F',
+  darkorange: '#FF8C00',
+  darkorchid: '#9932CC',
+  darkred: '#8B0000',
+  darksalmon: '#E9967A',
+  darkseagreen: '#8FBC8F',
+  darkslateblue: '#483D8B',
+  darkslategray: '#2F4F4F',
+  darkslategrey: '#2F4F4F',
+  darkturquoise: '#00CED1',
+  darkviolet: '#9400D3',
+  deeppink: '#FF1493',
+  deepskyblue: '#00BFFF',
+  dimgray: '#696969',
+  dimgrey: '#696969',
+  dodgerblue: '#1E90FF',
+  firebrick: '#B22222',
+  floralwhite: '#FFFAF0',
+  forestgreen: '#228B22',
+  fuchsia: '#FF00FF',
+  gainsboro: '#DCDCDC',
+  ghostwhite: '#F8F8FF',
+  gold: '#FFD700',
+  goldenrod: '#DAA520',
+  gray: '#808080',
+  grey: '#808080',
+  green: '#008000',
+  greenyellow: '#ADFF2F',
+  honeydew: '#F0FFF0',
+  hotpink: '#FF69B4',
+  indianred: '#CD5C5C',
+  indigo: '#4B0082',
+  ivory: '#FFFFF0',
+  khaki: '#F0E68C',
+  lavender: '#E6E6FA',
+  lavenderblush: '#FFF0F5',
+  lawngreen: '#7CFC00',
+  lemonchiffon: '#FFFACD',
+  lightblue: '#ADD8E6',
+  lightcoral: '#F08080',
+  lightcyan: '#E0FFFF',
+  lightgoldenrodyellow: '#FAFAD2',
+  lightgray: '#D3D3D3',
+  lightgrey: '#D3D3D3',
+  lightgreen: '#90EE90',
+  lightpink: '#FFB6C1',
+  lightsalmon: '#FFA07A',
+  lightseagreen: '#20B2AA',
+  lightskyblue: '#87CEFA',
+  lightslategray: '#778899',
+  lightslategrey: '#778899',
+  lightsteelblue: '#B0C4DE',
+  lightyellow: '#FFFFE0',
+  lime: '#00FF00',
+  limegreen: '#32CD32',
+  linen: '#FAF0E6',
+  magenta: '#FF00FF',
+  maroon: '#800000',
+  mediumaquamarine: '#66CDAA',
+  mediumblue: '#0000CD',
+  mediumorchid: '#BA55D3',
+  mediumpurple: '#9370DB',
+  mediumseagreen: '#3CB371',
+  mediumslateblue: '#7B68EE',
+  mediumspringgreen: '#00FA9A',
+  mediumturquoise: '#48D1CC',
+  mediumvioletred: '#C71585',
+  midnightblue: '#191970',
+  mintcream: '#F5FFFA',
+  mistyrose: '#FFE4E1',
+  moccasin: '#FFE4B5',
+  navajowhite: '#FFDEAD',
+  navy: '#000080',
+  oldlace: '#FDF5E6',
+  olive: '#808000',
+  olivedrab: '#6B8E23',
+  orange: '#FFA500',
+  orangered: '#FF4500',
+  orchid: '#DA70D6',
+  palegoldenrod: '#EEE8AA',
+  palegreen: '#98FB98',
+  paleturquoise: '#AFEEEE',
+  palevioletred: '#DB7093',
+  papayawhip: '#FFEFD5',
+  peachpuff: '#FFDAB9',
+  peru: '#CD853F',
+  pink: '#FFC0CB',
+  plum: '#DDA0DD',
+  powderblue: '#B0E0E6',
+  purple: '#800080',
+  rebeccapurple: '#663399',
+  red: '#FF0000',
+  rosybrown: '#BC8F8F',
+  royalblue: '#4169E1',
+  saddlebrown: '#8B4513',
+  salmon: '#FA8072',
+  sandybrown: '#F4A460',
+  seagreen: '#2E8B57',
+  seashell: '#FFF5EE',
+  sienna: '#A0522D',
+  silver: '#C0C0C0',
+  skyblue: '#87CEEB',
+  slateblue: '#6A5ACD',
+  slategray: '#708090',
+  slategrey: '#708090',
+  snow: '#FFFAFA',
+  springgreen: '#00FF7F',
+  steelblue: '#4682B4',
+  tan: '#D2B48C',
+  teal: '#008080',
+  thistle: '#D8BFD8',
+  tomato: '#FF6347',
+  turquoise: '#40E0D0',
+  violet: '#EE82EE',
+  wheat: '#F5DEB3',
+  white: '#FFFFFF',
+  whitesmoke: '#F5F5F5',
+  yellow: '#FFFF00',
+  yellowgreen: '#9ACD32',
+};

package/src/color/constants.ts

@@ -0,0 +1,26 @@
+/**
+ * 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
+ */
+// eslint-disable-next-line max-len
+export const reRGBa =
+  /^rgba?\(\s*(\d{1,3}(?:\.\d+)?%?)\s*,\s*(\d{1,3}(?:\.\d+)?%?)\s*,\s*(\d{1,3}(?:\.\d+)?%?)\s*(?:\s*,\s*((?:\d*\.?\d+)?)\s*)?\)$/i;
+
+/**
+ * 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 const reHSLa =
+  /^hsla?\(\s*(\d{1,3})\s*,\s*(\d{1,3}%)\s*,\s*(\d{1,3}%)\s*(?:\s*,\s*(\d+(?:\.\d+)?)\s*)?\)$/i;
+
+/**
+ * Regex matching color in HEX format (ex: #FF5544CC, #FF5555, 010155, aff)
+ * @static
+ * @field
+ * @memberOf Color
+ */
+export const reHex = /^#?([0-9a-f]{8}|[0-9a-f]{6}|[0-9a-f]{4}|[0-9a-f]{3})$/i;

package/src/color/util.ts

@@ -0,0 +1,32 @@
+/**
+ * @param {Number} p
+ * @param {Number} q
+ * @param {Number} t
+ * @return {Number}
+ */
+export function hue2rgb(p: number, q: number, t: number): number {
+  if (t < 0) {
+    t += 1;
+  }
+  if (t > 1) {
+    t -= 1;
+  }
+  if (t < 1 / 6) {
+    return p + (q - p) * 6 * t;
+  }
+  if (t < 1 / 2) {
+    return q;
+  }
+  if (t < 2 / 3) {
+    return p + (q - p) * (2 / 3 - t) * 6;
+  }
+  return p;
+}
+
+/**
+ * Convert a value ∈ [0, 255] to hex
+ */
+export function hexify(value: number) {
+  const hexValue = value.toString(16).toUpperCase();
+  return hexValue.length === 1 ? `0${hexValue}` : hexValue;
+}

package/src/config.ts

@@ -0,0 +1,159 @@
+export type TConfiguration = Partial<BaseConfiguration>;
+
+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 = 1;
+
+  /**
+   * Pixel per Inch as a default value set to 96. Can be changed for more realistic conversion.
+   */
+  DPI = 96;
+
+  /**
+   * Device Pixel Ratio
+   * @see https://developer.apple.com/library/safari/documentation/AudioVideo/Conceptual/HTML-canvas-guide/SettingUptheCanvas/SettingUptheCanvas.html
+   */
+  devicePixelRatio = 1;
+
+  /**
+   * Pixel limit for cache canvases. 1Mpx , 4Mpx should be fine.
+   * @since 1.7.14
+   * @type Number
+   * @default
+   */
+  perfLimitSizeTotal = 2097152;
+
+  /**
+   * Pixel limit for cache canvases width or height. IE fixes the maximum at 5000
+   * @since 1.7.14
+   * @type Number
+   * @default
+   */
+  maxCacheSideLimit = 4096;
+
+  /**
+   * Lowest pixel limit for cache canvases, set at 256PX
+   * @since 1.7.14
+   * @type Number
+   * @default
+   */
+  minCacheSideLimit = 256;
+
+  /**
+   * 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 = false;
+
+  /**
+   * 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 = true;
+
+  /**
+   * 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 = 4096;
+
+  /**
+   * 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 = false;
+
+  /**
+   * If disabled boundsOfCurveCache is not used. For apps that make heavy usage of pencil drawing probably disabling it is better
+   * @default true
+   */
+  cachesBoundsOfCurve = true;
+
+  /**
+   * 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 = 4;
+}
+
+export class Configuration extends BaseConfiguration {
+  constructor(config?: TConfiguration) {
+    super();
+    this.configure(config);
+  }
+
+  configure(config: TConfiguration = {}) {
+    Object.assign(this, config);
+  }
+
+  /**
+   * Map<fontFamily, pathToFile> of font files
+   */
+  addFonts(
+    paths: Record</** fontFamily */ string, /** pathToFile */ string> = {}
+  ) {
+    this.fontPaths = {
+      ...this.fontPaths,
+      ...paths,
+    };
+  }
+
+  removeFonts(fontFamilys: string[] = []) {
+    fontFamilys.forEach((fontFamily) => {
+      delete this.fontPaths[fontFamily];
+    });
+  }
+
+  clearFonts() {
+    this.fontPaths = {};
+  }
+
+  restoreDefaults<T extends BaseConfiguration>(keys?: (keyof T)[]) {
+    const defaults = new BaseConfiguration() as T;
+    const config =
+      keys?.reduce((acc, key) => {
+        acc[key] = defaults[key];
+        return acc;
+      }, {} as T) || defaults;
+    this.configure(config);
+  }
+}
+
+export const config = new Configuration();

package/src/constants.ts

@@ -0,0 +1,19 @@
+import { TMat2D } from './typedefs';
+// use this syntax so babel plugin see this import here
+import { version } from '../package.json';
+
+export const VERSION = version;
+export function noop() {}
+export const halfPI = Math.PI / 2;
+export const twoMathPi = Math.PI * 2;
+export const PiBy180 = Math.PI / 180;
+export const iMatrix = Object.freeze([1, 0, 0, 1, 0, 0]) as TMat2D;
+export const DEFAULT_SVG_FONT_SIZE = 16;
+export const ALIASING_LIMIT = 2;
+
+/* "magic number" for bezier approximations of arcs (http://itc.ktu.lt/itc354/Riskus354.pdf) */
+export const kRect = 1 - 0.5522847498;
+
+export const LEFT_CLICK = 1;
+export const MIDDLE_CLICK = 2;
+export const RIGHT_CLICK = 3;