@syncfusion/ej2-base 19.2.55 → 19.3.47

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;

package/src/child-property.js

@@ -2,6 +2,7 @@ import { getValue, setValue, merge, isBlazor } from './util';
 import { Base } from './base';
 /**
  * To detect the changes for inner properties.
+ *
  * @private
  */
 var ChildProperty = /** @class */ (function () {
@@ -11,7 +12,7 @@ var ChildProperty = /** @class */ (function () {
         this.changedProperties = {};
         this.childChangedProperties = {};
         this.oldProperties = {};
-        // tslint:disable-next-line:no-empty
+        // eslint-disable-next-line
         this.finalUpdate = function () { };
         this.callChildDataBind = getValue('callChildDataBind', Base);
         this.parentObj = parent;
@@ -22,9 +23,10 @@ var ChildProperty = /** @class */ (function () {
     }
     /**
      * Updates the property changes
-     * @param {boolean} val
-     * @param {string} propName
-     * @returns {void}
+     *
+     * @param {boolean} val ?
+     * @param {string} propName ?
+     * @returns {void} ?
      */
     ChildProperty.prototype.updateChange = function (val, propName) {
         if (val === true) {
@@ -39,6 +41,8 @@ var ChildProperty = /** @class */ (function () {
     };
     /**
      * Updates time out duration
+     *
+     * @returns {void} ?
      */
     ChildProperty.prototype.updateTimeOut = function () {
         if (this.parentObj.updateTimeOut) {
@@ -55,6 +59,8 @@ var ChildProperty = /** @class */ (function () {
     };
     /**
      * Clears changed properties
+     *
+     * @returns {void} ?
      */
     ChildProperty.prototype.clearChanges = function () {
         this.finalUpdate();
@@ -64,9 +70,10 @@ var ChildProperty = /** @class */ (function () {
     };
     /**
      * Set property changes
-     * @param {Object} prop
-     * @param {boolean} muteOnChange
-     * {void}
+     *
+     * @param {Object} prop ?
+     * @param {boolean} muteOnChange ?
+     * @returns {void} ?
      */
     ChildProperty.prototype.setProperties = function (prop, muteOnChange) {
         if (muteOnChange === true) {
@@ -80,6 +87,8 @@ var ChildProperty = /** @class */ (function () {
     };
     /**
      * Binds data
+     *
+     * @returns {void} ?
      */
     ChildProperty.prototype.dataBind = function () {
         this.callChildDataBind(this.childChangedProperties, this);
@@ -98,10 +107,12 @@ var ChildProperty = /** @class */ (function () {
     };
     /**
      * 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} ?
      */
     ChildProperty.prototype.saveChanges = function (key, newValue, oldValue, restrictServerDataBind) {
         if (this.controlParent.isProtectedOnChange) {
@@ -118,7 +129,6 @@ var ChildProperty = /** @class */ (function () {
     };
     ChildProperty.prototype.serverDataBind = function (key, value, isSaveChanges, action) {
         if (isBlazor() && !this.parentObj.isComplexArraySetter) {
-            // tslint:disable-next-line:no-any
             var parent_1;
             var newChanges = {};
             var parentKey = isSaveChanges ? this.getParentKey(true) + '.' + key : key;
@@ -146,7 +156,7 @@ var ChildProperty = /** @class */ (function () {
         }
     };
     ChildProperty.prototype.getParentKey = function (isSaveChanges) {
-        // tslint:disable-next-line:no-any
+        // eslint-disable-next-line
         var index = '';
         var propName = this.propName;
         /* istanbul ignore next */

package/src/component-model.d.ts

@@ -1,4 +1,4 @@
-import { isUndefined, getValue, isNullOrUndefined, setValue, uniqueID, isBlazor } from './util';import { ModuleLoader, ModuleDeclaration } from './module-loader';import { Base } from './base';import { Observer, BoundOptions } from './observer';import { ChildProperty } from './child-property';import { Property, NotifyPropertyChanges } from './notify-property-change';import { onIntlChange, rightToLeft, defaultCulture } from './internationalization';import { createElement, addClass, removeClass, ElementProperties, select } from './dom';import { VirtualDOM } from './virtual-dom';import { getRandomId } from './template-engine';
+import { isUndefined, getValue, isNullOrUndefined, setValue, uniqueID, isBlazor } from './util';import { ModuleLoader, ModuleDeclaration } from './module-loader';import { Base } from './base';import { Observer, BoundOptions } from './observer';import { ChildProperty } from './child-property';import { Property, NotifyPropertyChanges } from './notify-property-change';import { onIntlChange, rightToLeft, defaultCulture } from './internationalization';import { createElement, addClass, removeClass, ElementProperties, select } from './dom';
 
 /**
  * Interface for a class Component
@@ -7,18 +7,21 @@ export interface ComponentModel {
 
     /**
      * Enable or disable persisting component's state between page reloads.
+     *
      * @default false
      */
     enablePersistence?: boolean;
 
     /**
      * Enable or disable rendering component in right to left direction.
+     *
      * @default false
      */
     enableRtl?: boolean;
 
     /**
      * Overrides the global culture and localization value for this component. Default global culture is 'en-US'.
+     *
      * @default ''
      */
     locale?: string;

package/src/component.d.ts

@@ -5,6 +5,7 @@ import { ElementProperties } from './dom';
 export declare let versionBasedStatePersistence: boolean;
 /**
  * To enable or disable version based statePersistence functionality for all components globally.
+ *
  * @param {boolean} status - Optional argument Specifies the status value to enable or disable versionBasedStatePersistence option.
  * @returns {void}
  */
@@ -18,21 +19,25 @@ export declare abstract class Component<ElementType extends HTMLElement> extends
     ej2StatePersistenceVersion: string;
     /**
      * Enable or disable persisting component's state between page reloads.
+     *
      * @default false
      */
     enablePersistence: boolean;
     /**
      * Enable or disable rendering component in right to left direction.
+     *
      * @default false
      */
     enableRtl: boolean;
     /**
      * Overrides the global culture and localization value for this component. Default global culture is 'en-US'.
+     *
      * @default ''
      */
     locale: string;
     /**
      * string template option for Blazor template rendering
+     *
      * @private
      */
     isStringTemplate: boolean;
@@ -52,82 +57,114 @@ export declare abstract class Component<ElementType extends HTMLElement> extends
     protected requiredModules(): ModuleDeclaration[];
     /**
      * Destroys the sub modules while destroying the widget
+     *
+     * @returns {void} ?
      */
     protected destroy(): void;
     /**
      * Applies all the pending property changes and render the component again.
+     *
+     * @returns {void} ?
      */
     refresh(): void;
     private accessMount;
     /**
      * Returns the route element of the component
+     *
+     * @returns {HTMLElement} ?
      */
     getRootElement(): HTMLElement;
     /**
      * Returns the persistence data for component
+     *
+     * @returns {any} ?
      */
     getLocalData(): any;
     /**
      * Appends the control within the given HTML element
+     *
      * @param {string | HTMLElement} selector - Target element where control needs to be appended
+     * @returns {void} ?
      */
     appendTo(selector?: string | HTMLElement): void;
     /**
      * It is used to process the post rendering functionalities to a component.
+     *
+     * @param {Node} wrapperElement ?
+     * @returns {void} ?
      */
     protected renderComplete(wrapperElement?: Node): void;
     /**
      * When invoked, applies the pending property changes immediately to the component.
+     *
+     * @returns {void} ?
      */
     dataBind(): void;
     /**
      * Attach one or more  event handler to the current component context.
      * It is used for internal handling event internally within the component only.
+     *
      * @param {BoundOptions[]| string} event - It is  optional type either to  Set the collection of event list or the eventName.
      * @param {Function} handler - optional parameter Specifies the handler to run when the event occurs
      * @param {Object} context - optional parameter Specifies the context to be bind in the handler.
-     * @return {void}
+     * @returns {void} ?
      * @private
      */
     on(event: BoundOptions[] | string, handler?: Function, context?: Object): void;
     /**
      * To remove one or more event handler that has been attached with the on() method.
+     *
      * @param {BoundOptions[]| string} event - It is  optional type either to  Set the collection of event list or the eventName.
      * @param {Function} handler - optional parameter Specifies the function to run when the event occurs
-     * @return {void}
+     * @returns {void} ?
      * @private
      */
     off(event: BoundOptions[] | string, handler?: Function): void;
     /**
      * To notify the handlers in the specified event.
+     *
      * @param {string} property - Specifies the event to be notify.
      * @param {Object} argument - Additional parameters to pass while calling the handler.
-     * @return {void}
+     * @returns {void} ?
      * @private
      */
     notify(property: string, argument: Object): void;
     /**
      * Get injected modules
+     *
+     * @returns {Function} ?
      * @private
      */
     getInjectedModules(): Function[];
     /**
      * Dynamically injects the required modules to the component.
+     *
+     * @param {Function} moduleList ?
+     * @returns {void} ?
      */
     static Inject(...moduleList: Function[]): void;
     /**
      * Initialize the constructor for component base
+     *
+     * @param {Object} options ?
+     * @param {string} selector ?
      */
     constructor(options?: Object, selector?: string | ElementType);
     /**
      * This is a instance method to create an element.
+     *
+     * @param {string} tagName ?
+     * @param {ElementProperties} prop ?
+     * @param {boolean} isVDOM ?
+     * @returns {any} ?
      * @private
      */
     createElement(tagName: string, prop?: ElementProperties, isVDOM?: boolean): any;
     /**
      *
-     * @param handler - handler to be triggered after state Updated.
-     * @param argument - Arguments to be passed to caller.
+     * @param {Function} handler - handler to be triggered after state Updated.
+     * @param {any} argument - Arguments to be passed to caller.
+     * @returns {void} .
      * @private
      */
     triggerStateChange(handler?: Function, argument?: any): void;