@syncfusion/ej2-base 19.2.57 → 19.3.53

package/src/base.js

@@ -1,15 +1,19 @@
 import { isUndefined, isNullOrUndefined, merge, setImmediate, setValue, isBlazor, getValue, extend } from './util';
 import { addClass, removeClass } from './dom';
 import { Observer } from './observer';
-var isColEName = new RegExp('\]');
+var isColEName = new RegExp(']');
 /* tslint:enable:no-any */
 /**
  * Base library module is common module for Framework modules like touch,keyboard and etc.,
+ *
  * @private
  */
 var Base = /** @class */ (function () {
     /**
      * Base constructor accept options and element
+     *
+     * @param {Object} options ?
+     * @param {string} element ?
      */
     function Base(options, element) {
         this.isRendered = false;
@@ -23,7 +27,7 @@ var Base = /** @class */ (function () {
         this.bulkChanges = {};
         this.refreshing = false;
         this.ignoreCollectionWatch = false;
-        // tslint:disable-next-line:no-empty
+        // eslint-disable-next-line
         this.finalUpdate = function () { };
         this.childChangedProperties = {};
         this.modelObserver = new Observer(this);
@@ -47,9 +51,11 @@ var Base = /** @class */ (function () {
     /** Property base section */
     /**
      * Function used to set bunch of property at a time.
+     *
      * @private
      * @param  {Object} prop - JSON object which holds components properties.
-     * @param  {boolean} muteOnChange? - Specifies to true when we set properties.
+     * @param  {boolean} muteOnChange ? - Specifies to true when we set properties.
+     * @returns {void} ?
      */
     Base.prototype.setProperties = function (prop, muteOnChange) {
         var prevDetection = this.isProtectedOnChange;
@@ -67,12 +73,12 @@ var Base = /** @class */ (function () {
         this.oldProperties = {};
         this.isProtectedOnChange = prevDetection;
     };
-    ;
     /**
      * Calls for child element data bind
-     * @param {Object} obj
-     * @param {Object} parent
-     * @returns {void}
+     *
+     * @param {Object} obj ?
+     * @param {Object} parent ?
+     * @returns {void} ?
      */
     // tslint:disable-next-line:no-any
     Base.callChildDataBind = function (obj, parent) {
@@ -100,6 +106,8 @@ var Base = /** @class */ (function () {
     };
     /**
      * Bind property changes immediately to components
+     *
+     * @returns {void} ?
      */
     Base.prototype.dataBind = function () {
         Base.callChildDataBind(this.childChangedProperties, this);
@@ -113,7 +121,6 @@ var Base = /** @class */ (function () {
             this.isProtectedOnChange = prevDetection;
         }
     };
-    ;
     /* tslint:disable:no-any */
     Base.prototype.serverDataBind = function (newChanges) {
         if (!isBlazor()) {
@@ -143,35 +150,37 @@ var Base = /** @class */ (function () {
         this.finalUpdate();
         this.finalUpdate = setImmediate(this.dataBind.bind(this));
     };
-    ;
     /** Event Base Section */
     /**
      * Adds the handler to the given event listener.
+     *
      * @param {string} eventName - A String that specifies the name of the event
-     * @param {Function} listener - Specifies the call to run when the event occurs.
-     * @return {void}
+     * @param {Function} handler - Specifies the call to run when the event occurs.
+     * @returns {void} ?
      */
     Base.prototype.addEventListener = function (eventName, handler) {
         this.modelObserver.on(eventName, handler);
     };
     /**
      * Removes the handler from the given event listener.
+     *
      * @param {string} eventName - A String that specifies the name of the event to remove
-     * @param {Function} listener - Specifies the function to remove
-     * @return {void}
+     * @param {Function} handler - Specifies the function to remove
+     * @returns {void} ?
      */
     Base.prototype.removeEventListener = function (eventName, handler) {
         this.modelObserver.off(eventName, handler);
     };
     /**
      * Triggers the handlers in the specified event.
+     *
      * @private
      * @param {string} eventName - Specifies the event to trigger for the specified component properties.
      * Can be a custom event, or any of the standard events.
      * @param {Event} eventProp - Additional parameters to pass on to the event properties
      * @param {Function} successHandler - this function will invoke after event successfully triggered
      * @param {Function} errorHandler - this function will invoke after event if it failured to call.
-     * @return {void}
+     * @returns {void} ?
      */
     Base.prototype.trigger = function (eventName, eventProp, successHandler, errorHandler) {
         var _this = this;
@@ -225,6 +234,8 @@ var Base = /** @class */ (function () {
     };
     /**
      * To maintain instance in base class
+     *
+     * @returns {void} ?
      */
     Base.prototype.addInstance = function () {
         // Add module class to the root element
@@ -239,9 +250,12 @@ var Base = /** @class */ (function () {
     };
     /**
      * To remove the instance from the element
+     *
+     * @returns {void} ?
      */
     Base.prototype.destroy = function () {
         var _this = this;
+        // eslint-disable-next-line
         this.element.ej2_instances =
             this.element.ej2_instances.filter(function (i) { return i !== _this; });
         removeClass([this.element], ['e-' + this.getModuleName()]);
@@ -258,8 +272,10 @@ var Base = /** @class */ (function () {
 export { Base };
 /**
  * Global function to get the component instance from the rendered element.
- * @param elem Specifies the HTMLElement or element id string.
- * @param comp Specifies the component module name or Component.
+ *
+ * @param {HTMLElement} elem Specifies the HTMLElement or element id string.
+ * @param {string} comp Specifies the component module name or Component.
+ * @returns {any} ?
  */
 // tslint:disable-next-line:no-any
 export function getComponent(elem, comp) {
@@ -285,6 +301,8 @@ export function getComponent(elem, comp) {
 }
 /**
  * Function to remove the child instances.
+ *
+ * @param {HTMLElement} element ?
  * @return {void}
  * @private
  */

package/src/browser.d.ts

@@ -1,5 +1,6 @@
 /**
  * Get configuration details for Browser
+ *
  * @private
  */
 export declare class Browser {
@@ -7,115 +8,152 @@ export declare class Browser {
     private static extractBrowserDetail;
     /**
      * To get events from the browser
+     *
      * @param {string} event - type of event triggered.
-     * @returns {Boolean}
+     * @returns {boolean}
      */
     private static getEvent;
     /**
      * To get the Touch start event from browser
+     *
      * @returns {string}
      */
     private static getTouchStartEvent;
     /**
      * To get the Touch end event from browser
+     *
      * @returns {string}
      */
     private static getTouchEndEvent;
     /**
      * To get the Touch move event from browser
+     *
      * @returns {string}
      */
     private static getTouchMoveEvent;
     /**
      * To cancel the touch event from browser
+     *
      * @returns {string}
      */
     private static getTouchCancelEvent;
     /**
      * To get the value based on provided key and regX
-     * @param {string} key
-     * @param {RegExp} regX
-     * @returns {Object}
+     *
+     * @param {string} key ?
+     * @param {RegExp} regX ?
+     * @returns {Object} ?
      */
     private static getValue;
     /**
      * Property specifies the userAgent of the browser. Default userAgent value is based on the browser.
      * Also we can set our own userAgent.
+     *
+     * @param {string} uA ?
      */
     static userAgent: string;
     /**
      * Property is to get the browser information like Name, Version and Language
-     * @returns BrowserInfo
+     *
+     * @returns {BrowserInfo} ?
      */
     static readonly info: BrowserInfo;
     /**
      * Property is to get whether the userAgent is based IE.
+     *
+     * @returns {boolean} ?
      */
-    static readonly isIE: Boolean;
+    static readonly isIE: boolean;
     /**
      * Property is to get whether the browser has touch support.
+     *
+     * @returns {boolean} ?
      */
-    static readonly isTouch: Boolean;
+    static readonly isTouch: boolean;
     /**
      * Property is to get whether the browser has Pointer support.
+     *
+     * @returns {boolean} ?
      */
-    static readonly isPointer: Boolean;
+    static readonly isPointer: boolean;
     /**
      * Property is to get whether the browser has MSPointer support.
+     *
+     * @returns {boolean} ?
      */
-    static readonly isMSPointer: Boolean;
+    static readonly isMSPointer: boolean;
     /**
      * Property is to get whether the userAgent is device based.
+     *
+     * @returns {boolean} ?
      */
-    static readonly isDevice: Boolean;
+    static readonly isDevice: boolean;
     /**
      * Property is to get whether the userAgent is IOS.
+     *
+     * @returns {boolean} ?
      */
-    static readonly isIos: Boolean;
+    static readonly isIos: boolean;
     /**
      * Property is to get whether the userAgent is Ios7.
+     *
+     * @returns {boolean} ?
      */
-    static readonly isIos7: Boolean;
+    static readonly isIos7: boolean;
     /**
      * Property is to get whether the userAgent is Android.
+     *
+     * @returns {boolean} ?
      */
-    static readonly isAndroid: Boolean;
+    static readonly isAndroid: boolean;
     /**
      * Property is to identify whether application ran in web view.
+     *
+     * @returns {boolean} ?
      */
-    static readonly isWebView: Boolean;
+    static readonly isWebView: boolean;
     /**
      * Property is to get whether the userAgent is Windows.
+     *
+     * @returns {boolean} ?
      */
-    static readonly isWindows: Boolean;
+    static readonly isWindows: boolean;
     /**
      * Property is to get the touch start event. It returns event name based on browser.
+     *
+     * @returns {string} ?
      */
     static readonly touchStartEvent: string;
     /**
      * Property is to get the touch move event. It returns event name based on browser.
+     *
+     * @returns {string} ?
      */
     static readonly touchMoveEvent: string;
     /**
      * Property is to get the touch end event. It returns event name based on browser.
+     *
+     * @returns {string} ?
      */
     static readonly touchEndEvent: string;
     /**
      * Property is to cancel the touch end event.
+     *
+     * @returns {string} ?
      */
     static readonly touchCancelEvent: string;
 }
 export interface BrowserDetails {
-    isAndroid?: Boolean;
-    isDevice?: Boolean;
-    isIE?: Boolean;
-    isIos?: Boolean;
-    isIos7?: Boolean;
-    isMSPointer?: Boolean;
-    isPointer?: Boolean;
-    isTouch?: Boolean;
-    isWebView?: Boolean;
-    isWindows?: Boolean;
+    isAndroid?: boolean;
+    isDevice?: boolean;
+    isIE?: boolean;
+    isIos?: boolean;
+    isIos7?: boolean;
+    isMSPointer?: boolean;
+    isPointer?: boolean;
+    isTouch?: boolean;
+    isWebView?: boolean;
+    isWindows?: boolean;
     info?: BrowserInfo;
     touchStartEvent?: string;
     touchMoveEvent?: string;

package/src/browser.js

@@ -6,14 +6,14 @@ var REGX_IOS = /(ipad|iphone|ipod touch)/i;
 var REGX_IOS7 = /(ipad|iphone|ipod touch);.*os 7_\d|(ipad|iphone|ipod touch);.*os 8_\d/i;
 var REGX_ANDROID = /android/i;
 var REGX_WINDOWS = /trident|windows phone|edge/i;
-var REGX_VERSION = /(version)[ \/]([\w.]+)/i;
+var REGX_VERSION = /(version)[ /]([\w.]+)/i;
 var REGX_BROWSER = {
-    OPERA: /(opera|opr)(?:.*version|)[ \/]([\w.]+)/i,
-    EDGE: /(edge)(?:.*version|)[ \/]([\w.]+)/i,
-    CHROME: /(chrome|crios)[ \/]([\w.]+)/i,
-    PANTHOMEJS: /(phantomjs)[ \/]([\w.]+)/i,
-    SAFARI: /(safari)[ \/]([\w.]+)/i,
-    WEBKIT: /(webkit)[ \/]([\w.]+)/i,
+    OPERA: /(opera|opr)(?:.*version|)[ /]([\w.]+)/i,
+    EDGE: /(edge)(?:.*version|)[ /]([\w.]+)/i,
+    CHROME: /(chrome|crios)[ /]([\w.]+)/i,
+    PANTHOMEJS: /(phantomjs)[ /]([\w.]+)/i,
+    SAFARI: /(safari)[ /]([\w.]+)/i,
+    WEBKIT: /(webkit)[ /]([\w.]+)/i,
     MSIE: /(msie|trident) ([\w.]+)/i,
     MOZILLA: /(mozilla)(?:.*? rv:([\w.]+)|)/i
 };
@@ -23,6 +23,7 @@ if (typeof window !== 'undefined') {
 }
 /**
  * Get configuration details for Browser
+ *
  * @private
  */
 var Browser = /** @class */ (function () {
@@ -40,6 +41,7 @@ var Browser = /** @class */ (function () {
                 browserInfo.name = (clientInfo[1].toLowerCase() === 'crios' ? 'chrome' : browserInfo.name);
                 browserInfo.version = clientInfo[2];
                 browserInfo.culture.name = browserInfo.culture.language = navigator.language;
+                // eslint-disable-next-line
                 if (!!Browser.userAgent.match(REGX_IE11)) {
                     browserInfo.name = 'msie';
                     break;
@@ -55,11 +57,12 @@ var Browser = /** @class */ (function () {
     };
     /**
      * To get events from the browser
+     *
      * @param {string} event - type of event triggered.
-     * @returns {Boolean}
+     * @returns {boolean}
      */
     Browser.getEvent = function (event) {
-        // tslint:disable-next-line:no-any
+        // eslint-disable-next-line
         var events = {
             start: {
                 isPointer: 'pointerdown', isTouch: 'touchstart', isDevice: 'mousedown'
@@ -74,12 +77,13 @@ var Browser = /** @class */ (function () {
                 isPointer: 'pointercancel', isTouch: 'touchcancel', isDevice: 'mouseleave'
             }
         };
-        return (Browser.isPointer && !Browser.isWindows ? events[event].isPointer :
+        return (Browser.isPointer ? events[event].isPointer :
             (Browser.isTouch ? events[event].isTouch + (!Browser.isDevice ? ' ' + events[event].isDevice : '')
                 : events[event].isDevice));
     };
     /**
      * To get the Touch start event from browser
+     *
      * @returns {string}
      */
     Browser.getTouchStartEvent = function () {
@@ -87,6 +91,7 @@ var Browser = /** @class */ (function () {
     };
     /**
      * To get the Touch end event from browser
+     *
      * @returns {string}
      */
     Browser.getTouchEndEvent = function () {
@@ -94,6 +99,7 @@ var Browser = /** @class */ (function () {
     };
     /**
      * To get the Touch move event from browser
+     *
      * @returns {string}
      */
     Browser.getTouchMoveEvent = function () {
@@ -101,6 +107,7 @@ var Browser = /** @class */ (function () {
     };
     /**
      * To cancel the touch event from browser
+     *
      * @returns {string}
      */
     Browser.getTouchCancelEvent = function () {
@@ -108,25 +115,34 @@ var Browser = /** @class */ (function () {
     };
     /**
      * To get the value based on provided key and regX
-     * @param {string} key
-     * @param {RegExp} regX
-     * @returns {Object}
+     *
+     * @param {string} key ?
+     * @param {RegExp} regX ?
+     * @returns {Object} ?
      */
     Browser.getValue = function (key, regX) {
         var browserDetails = window.browserDetails;
         if ('undefined' === typeof browserDetails[key]) {
             return browserDetails[key] = regX.test(Browser.userAgent);
         }
+        if (navigator.platform === 'MacIntel' && navigator.maxTouchPoints > 1 && Browser.isTouch === true) {
+            browserDetails['isIos'] = true;
+            browserDetails['isDevice'] = true;
+            browserDetails['isTouch'] = true;
+            browserDetails['isPointer'] = true;
+        }
         return browserDetails[key];
     };
     Object.defineProperty(Browser, "userAgent", {
         get: function () {
             return Browser.uA;
         },
-        //Properties 
+        //Properties
         /**
          * Property specifies the userAgent of the browser. Default userAgent value is based on the browser.
          * Also we can set our own userAgent.
+         *
+         * @param {string} uA ?
          */
         set: function (uA) {
             Browser.uA = uA;
@@ -139,7 +155,8 @@ var Browser = /** @class */ (function () {
         //Read Only Properties
         /**
          * Property is to get the browser information like Name, Version and Language
-         * @returns BrowserInfo
+         *
+         * @returns {BrowserInfo} ?
          */
         get: function () {
             if (isUndefined(window.browserDetails.info)) {
@@ -153,6 +170,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "isIE", {
         /**
          * Property is to get whether the userAgent is based IE.
+         *
+         * @returns {boolean} ?
          */
         get: function () {
             return Browser.getValue('isIE', REGX_IE);
@@ -163,6 +182,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "isTouch", {
         /**
          * Property is to get whether the browser has touch support.
+         *
+         * @returns {boolean} ?
          */
         get: function () {
             if (isUndefined(window.browserDetails.isTouch)) {
@@ -180,6 +201,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "isPointer", {
         /**
          * Property is to get whether the browser has Pointer support.
+         *
+         * @returns {boolean} ?
          */
         get: function () {
             if (isUndefined(window.browserDetails.isPointer)) {
@@ -193,6 +216,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "isMSPointer", {
         /**
          * Property is to get whether the browser has MSPointer support.
+         *
+         * @returns {boolean} ?
          */
         get: function () {
             if (isUndefined(window.browserDetails.isMSPointer)) {
@@ -206,6 +231,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "isDevice", {
         /**
          * Property is to get whether the userAgent is device based.
+         *
+         * @returns {boolean} ?
          */
         get: function () {
             return Browser.getValue('isDevice', REGX_MOBILE);
@@ -216,6 +243,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "isIos", {
         /**
          * Property is to get whether the userAgent is IOS.
+         *
+         * @returns {boolean} ?
          */
         get: function () {
             return Browser.getValue('isIos', REGX_IOS);
@@ -226,6 +255,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "isIos7", {
         /**
          * Property is to get whether the userAgent is Ios7.
+         *
+         * @returns {boolean} ?
          */
         get: function () {
             return Browser.getValue('isIos7', REGX_IOS7);
@@ -236,6 +267,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "isAndroid", {
         /**
          * Property is to get whether the userAgent is Android.
+         *
+         * @returns {boolean} ?
          */
         get: function () {
             return Browser.getValue('isAndroid', REGX_ANDROID);
@@ -246,6 +279,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "isWebView", {
         /**
          * Property is to identify whether application ran in web view.
+         *
+         * @returns {boolean} ?
          */
         get: function () {
             if (isUndefined(window.browserDetails.isWebView)) {
@@ -261,6 +296,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "isWindows", {
         /**
          * Property is to get whether the userAgent is Windows.
+         *
+         * @returns {boolean} ?
          */
         get: function () {
             return Browser.getValue('isWindows', REGX_WINDOWS);
@@ -271,6 +308,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "touchStartEvent", {
         /**
          * Property is to get the touch start event. It returns event name based on browser.
+         *
+         * @returns {string} ?
          */
         get: function () {
             if (isUndefined(window.browserDetails.touchStartEvent)) {
@@ -284,6 +323,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "touchMoveEvent", {
         /**
          * Property is to get the touch move event. It returns event name based on browser.
+         *
+         * @returns {string} ?
          */
         get: function () {
             if (isUndefined(window.browserDetails.touchMoveEvent)) {
@@ -297,6 +338,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "touchEndEvent", {
         /**
          * Property is to get the touch end event. It returns event name based on browser.
+         *
+         * @returns {string} ?
          */
         get: function () {
             if (isUndefined(window.browserDetails.touchEndEvent)) {
@@ -310,6 +353,8 @@ var Browser = /** @class */ (function () {
     Object.defineProperty(Browser, "touchCancelEvent", {
         /**
          * Property is to cancel the touch end event.
+         *
+         * @returns {string} ?
          */
         get: function () {
             if (isUndefined(window.browserDetails.touchCancelEvent)) {

package/src/child-property.d.ts

@@ -1,5 +1,6 @@
 /**
  * To detect the changes for inner properties.
+ *
  * @private
  */
 export declare class ChildProperty<T> {
@@ -25,36 +26,46 @@ export declare class ChildProperty<T> {
     constructor(parent: T, propName: string, defaultValue: Object, isArray?: boolean);
     /**
      * Updates the property changes
-     * @param {boolean} val
-     * @param {string} propName
-     * @returns {void}
+     *
+     * @param {boolean} val ?
+     * @param {string} propName ?
+     * @returns {void} ?
      */
     private updateChange;
     /**
      * Updates time out duration
+     *
+     * @returns {void} ?
      */
     private updateTimeOut;
     /**
      * Clears changed properties
+     *
+     * @returns {void} ?
      */
     private clearChanges;
     /**
      * Set property changes
-     * @param {Object} prop
-     * @param {boolean} muteOnChange
-     * {void}
+     *
+     * @param {Object} prop ?
+     * @param {boolean} muteOnChange ?
+     * @returns {void} ?
      */
     protected setProperties(prop: Object, muteOnChange: boolean): void;
     /**
      * Binds data
+     *
+     * @returns {void} ?
      */
     protected dataBind(): void;
     /**
      * Saves changes to newer values
-     * @param {string} key
-     * @param {Object} newValue
-     * @param {Object} oldValue
-     * @returns {void}
+     *
+     * @param {string} key ?
+     * @param {Object} newValue ?
+     * @param {Object} oldValue ?
+     * @param {boolean} restrictServerDataBind ?
+     * @returns {void} ?
      */
     protected saveChanges(key: string, newValue: Object, oldValue: Object, restrictServerDataBind?: boolean): void;
     protected serverDataBind(key: string, value: Object, isSaveChanges?: boolean, action?: string): void;