fabric/dist/src/Observable.mjs.map

Object model for HTML5 canvas, and SVG-to-canvas parser. Backed by jsdom and node-canvas.

{"version":3,"file":"Observable.mjs","names":[],"sources":["../../src/Observable.ts"],"sourcesContent":["export type TEventCallback<T = any> = (options: T) => any;\n\ntype EventRegistryObject<E> = {\n  [K in keyof E]?: TEventCallback<E[K]>;\n};\n\n/**\n * @see {@link http://fabric5.fabricjs.com/fabric-intro-part-2#events}\n * @see {@link http://fabric5.fabricjs.com/events|Events demo}\n */\nexport class Observable<EventSpec> {\n  private __eventListeners: Record<keyof EventSpec, TEventCallback[]> =\n    {} as Record<keyof EventSpec, TEventCallback[]>;\n\n  /**\n   * Observes specified event\n   * @alias on\n   * @param {string} eventName Event name (eg. 'after:render')\n   * @param {EventRegistryObject} handlers key/value pairs (eg. {'after:render': handler, 'selection:cleared': handler})\n   * @param {Function} handler Function that receives a notification when an event of the specified type occurs\n   * @return {Function} disposer\n   */\n  on<K extends keyof EventSpec, E extends EventSpec[K]>(\n    eventName: K,\n    handler: TEventCallback<E>,\n  ): VoidFunction;\n  on(handlers: EventRegistryObject<EventSpec>): VoidFunction;\n  on<K extends keyof EventSpec, E extends EventSpec[K]>(\n    arg0: K | EventRegistryObject<EventSpec>,\n    handler?: TEventCallback<E>,\n  ): VoidFunction {\n    if (!this.__eventListeners) {\n      this.__eventListeners = {} as Record<keyof EventSpec, TEventCallback[]>;\n    }\n    if (typeof arg0 === 'object') {\n      // one object with key/value pairs was passed\n      Object.entries(arg0).forEach(([eventName, handler]) => {\n        this.on(eventName as K, handler as TEventCallback);\n      });\n      return () => this.off(arg0);\n    } else if (handler) {\n      const eventName = arg0;\n      if (!this.__eventListeners[eventName]) {\n        this.__eventListeners[eventName] = [];\n      }\n      this.__eventListeners[eventName].push(handler);\n      return () => this.off(eventName, handler);\n    } else {\n      // noop\n      return () => false;\n    }\n  }\n\n  /**\n   * Observes specified event **once**\n   * @alias once\n   * @param {string} eventName Event name (eg. 'after:render')\n   * @param {EventRegistryObject} handlers key/value pairs (eg. {'after:render': handler, 'selection:cleared': handler})\n   * @param {Function} handler Function that receives a notification when an event of the specified type occurs\n   * @return {Function} disposer\n   */\n  once<K extends keyof EventSpec, E extends EventSpec[K]>(\n    eventName: K,\n    handler: TEventCallback<E>,\n  ): VoidFunction;\n  once(handlers: EventRegistryObject<EventSpec>): VoidFunction;\n  once<K extends keyof EventSpec, E extends EventSpec[K]>(\n    arg0: K | EventRegistryObject<EventSpec>,\n    handler?: TEventCallback<E>,\n  ): VoidFunction {\n    if (typeof arg0 === 'object') {\n      // one object with key/value pairs was passed\n      const disposers: VoidFunction[] = [];\n      Object.entries(arg0).forEach(([eventName, handler]) => {\n        disposers.push(this.once(eventName as K, handler as TEventCallback));\n      });\n      return () => disposers.forEach((d) => d());\n    } else if (handler) {\n      const disposer = this.on<K, E>(\n        arg0,\n        function onceHandler(this: Observable<EventSpec>, ...args) {\n          handler.call(this, ...args);\n          disposer();\n        },\n      );\n      return disposer;\n    } else {\n      // noop\n      return () => false;\n    }\n  }\n\n  /**\n   * @private\n   * @param {string} eventName\n   * @param {Function} [handler]\n   */\n  private _removeEventListener<K extends keyof EventSpec>(\n    eventName: K,\n    handler?: TEventCallback,\n  ) {\n    if (!this.__eventListeners[eventName]) {\n      return;\n    }\n\n    if (handler) {\n      const eventListener = this.__eventListeners[eventName];\n      const index = eventListener.indexOf(handler);\n      index > -1 && eventListener.splice(index, 1);\n    } else {\n      this.__eventListeners[eventName] = [];\n    }\n  }\n\n  /**\n   * Unsubscribe all event listeners for eventname.\n   * Do not use this pattern. You could kill internal fabricJS events.\n   * We know we should have protected events for internal flows, but we don't have yet\n   * @deprecated\n   * @param {string} eventName event name (eg. 'after:render')\n   */\n  off<K extends keyof EventSpec>(eventName: K): void;\n  /**\n   * unsubscribe an event listener\n   * @param {string} eventName event name (eg. 'after:render')\n   * @param {TEventCallback} handler event listener to unsubscribe\n   */\n  off<K extends keyof EventSpec>(eventName: K, handler: TEventCallback): void;\n  /**\n   * unsubscribe event listeners\n   * @param handlers handlers key/value pairs (eg. {'after:render': handler, 'selection:cleared': handler})\n   */\n  off(handlers: EventRegistryObject<EventSpec>): void;\n  /**\n   * unsubscribe all event listeners\n   */\n  off(): void;\n  off<K extends keyof EventSpec>(\n    arg0?: K | EventRegistryObject<EventSpec>,\n    handler?: TEventCallback,\n  ) {\n    if (!this.__eventListeners) {\n      return;\n    }\n\n    // remove all key/value pairs (event name -> event handler)\n    if (typeof arg0 === 'undefined') {\n      for (const eventName in this.__eventListeners) {\n        this._removeEventListener(eventName);\n      }\n    }\n    // one object with key/value pairs was passed\n    else if (typeof arg0 === 'object') {\n      Object.entries(arg0).forEach(([eventName, handler]) => {\n        this._removeEventListener(eventName as K, handler as TEventCallback);\n      });\n    } else {\n      this._removeEventListener(arg0, handler);\n    }\n  }\n\n  /**\n   * Fires event with an optional options object\n   * @param {String} eventName Event name to fire\n   * @param {Object} [options] Options object\n   */\n  fire<K extends keyof EventSpec>(eventName: K, options?: EventSpec[K]) {\n    if (!this.__eventListeners) {\n      return;\n    }\n\n    const listenersForEvent = this.__eventListeners[eventName]?.concat();\n    if (listenersForEvent) {\n      for (let i = 0; i < listenersForEvent.length; i++) {\n        listenersForEvent[i].call(this, options || {});\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;AAUA,IAAa,aAAb,MAAmC;;wBACzB,oBACN,EAAE,CAA8C;;CAelD,GACE,MACA,SACc;AACd,MAAI,CAAC,KAAK,iBACR,MAAK,mBAAmB,EAAE;AAE5B,MAAI,OAAO,SAAS,UAAU;AAE5B,UAAO,QAAQ,KAAK,CAAC,SAAS,CAAC,WAAW,aAAa;AACrD,SAAK,GAAG,WAAgB,QAA0B;KAClD;AACF,gBAAa,KAAK,IAAI,KAAK;aAClB,SAAS;GAClB,MAAM,YAAY;AAClB,OAAI,CAAC,KAAK,iBAAiB,WACzB,MAAK,iBAAiB,aAAa,EAAE;AAEvC,QAAK,iBAAiB,WAAW,KAAK,QAAQ;AAC9C,gBAAa,KAAK,IAAI,WAAW,QAAQ;QAGzC,cAAa;;CAiBjB,KACE,MACA,SACc;AACd,MAAI,OAAO,SAAS,UAAU;GAE5B,MAAM,YAA4B,EAAE;AACpC,UAAO,QAAQ,KAAK,CAAC,SAAS,CAAC,WAAW,aAAa;AACrD,cAAU,KAAK,KAAK,KAAK,WAAgB,QAA0B,CAAC;KACpE;AACF,gBAAa,UAAU,SAAS,MAAM,GAAG,CAAC;aACjC,SAAS;GAClB,MAAM,WAAW,KAAK,GACpB,MACA,SAAS,YAAyC,GAAG,MAAM;AACzD,YAAQ,KAAK,MAAM,GAAG,KAAK;AAC3B,cAAU;KAEb;AACD,UAAO;QAGP,cAAa;;;;;;;CASjB,qBACE,WACA,SACA;AACA,MAAI,CAAC,KAAK,iBAAiB,WACzB;AAGF,MAAI,SAAS;GACX,MAAM,gBAAgB,KAAK,iBAAiB;GAC5C,MAAM,QAAQ,cAAc,QAAQ,QAAQ;AAC5C,WAAQ,MAAM,cAAc,OAAO,OAAO,EAAE;QAE5C,MAAK,iBAAiB,aAAa,EAAE;;CA2BzC,IACE,MACA,SACA;AACA,MAAI,CAAC,KAAK,iBACR;AAIF,MAAI,OAAO,SAAS,YAClB,MAAK,MAAM,aAAa,KAAK,iBAC3B,MAAK,qBAAqB,UAAU;WAI/B,OAAO,SAAS,SACvB,QAAO,QAAQ,KAAK,CAAC,SAAS,CAAC,WAAW,aAAa;AACrD,QAAK,qBAAqB,WAAgB,QAA0B;IACpE;MAEF,MAAK,qBAAqB,MAAM,QAAQ;;;;;;;CAS5C,KAAgC,WAAc,SAAwB;;AACpE,MAAI,CAAC,KAAK,iBACR;EAGF,MAAM,qBAAA,wBAAoB,KAAK,iBAAiB,gBAAA,QAAA,0BAAA,KAAA,IAAA,KAAA,IAAA,sBAAY,QAAQ;AACpE,MAAI,kBACF,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,QAAQ,IAC5C,mBAAkB,GAAG,KAAK,MAAM,WAAW,EAAE,CAAC"}