@syncfusion/ej2-lists 25.2.3 → 26.1.35-750253

package/src/common/list-base.js

@@ -89,17 +89,15 @@ export var ListBase;
      *
      * @param  {{Object}[]} dataSource - Specifies an array of JSON data.
      *
-     * @param  {ListBaseOptions} options? - Specifies the list options that need to provide.
+     * @param  {ListBaseOptions} [options] - Specifies the list options that need to provide.
      *
-     * @param  {boolean} isSingleLevel? - Specifies the list options that need to provide.
+     * @param  {boolean} [isSingleLevel] - Specifies the list options that need to provide.
      *
-     * @param  {any} componentInstance? - Specifies the list options that need to provide.
+     * @param  {any} [componentInstance] - Specifies the list options that need to provide.
      *
      * @returns  {createElement} createListFromJson - Specifies the list options that need to provide.
      */
-    function createList(createElement, dataSource, 
-    // eslint-disable-next-line
-    options, isSingleLevel, componentInstance) {
+    function createList(createElement, dataSource, options, isSingleLevel, componentInstance) {
         var curOpt = extend({}, defaultListBaseOptions, options);
         var ariaAttributes = extend({}, defaultAriaAttributes, curOpt.ariaAttributes);
         var type = typeofData(dataSource).typeof;
@@ -118,18 +116,15 @@ export var ListBase;
      *
      * @param  {{Object}[]} dataSource - Specifies an array of JSON data.
      *
-     * @param  {ListBaseOptions} options? - Specifies the list options that need to provide.
+     * @param  {boolean} [isSingleLevel] - Specifies the list options that need to provide.
      *
-     * @param  {boolean} isSingleLevel? - Specifies the list options that need to provide.
+     * @param  {ListBaseOptions} [options] - Specifies the list options that need to provide.
      *
-     * @param  {any} componentInstance? - Specifies the list options that need to provide.
+     * @param  {any} [componentInstance] - Specifies the list options that need to provide.
      *
      * @returns  {createElement} generateUL - returns the list options that need to provide.
      */
-    function createListFromArray(createElement, dataSource, 
-    // tslint:disable-next-line
-    // eslint-disable-next-line
-    isSingleLevel, options, componentInstance) {
+    function createListFromArray(createElement, dataSource, isSingleLevel, options, componentInstance) {
         var subChild = createListItemFromArray(createElement, dataSource, isSingleLevel, options, componentInstance);
         return generateUL(createElement, subChild, null, options);
     }
@@ -141,17 +136,15 @@ export var ListBase;
      *
      * @param  {{Object}[]} dataSource - Specifies an array of JSON data.
      *
-     * @param  {ListBaseOptions} options? - Specifies the list options that need to provide.
+     * @param  {boolean} [isSingleLevel] - Specifies the list options that need to provide.
      *
-     * @param  {boolean} isSingleLevel? - Specifies the list options that need to provide.
+     * @param  {ListBaseOptions} [options] - Specifies the list options that need to provide.
      *
-     * @param  {any} componentInstance? - Specifies the list options that need to provide.
+     * @param  {any} [componentInstance] - Specifies the list options that need to provide.
      *
      * @returns  {HTMLElement[]} subChild - returns the list options that need to provide.
      */
-    function createListItemFromArray(createElement, dataSource, 
-    // eslint-disable-next-line
-    isSingleLevel, options, componentInstance) {
+    function createListItemFromArray(createElement, dataSource, isSingleLevel, options, componentInstance) {
         var subChild = [];
         var curOpt = extend({}, defaultListBaseOptions, options);
         cssClass = getModuleClass(curOpt.moduleName);
@@ -198,19 +191,17 @@ export var ListBase;
      *
      * @param  {{Object}[]} dataSource - Specifies an array of JSON data.
      *
-     * @param  {ListBaseOptions} options? - Specifies the list options that need to provide.
+     * @param  {ListBaseOptions} [options] - Specifies the list options that need to provide.
      *
-     * @param  {boolean} isSingleLevel? - Specifies the list options that need to provide.
+     * @param  {number} [level] - Specifies the list options that need to provide.
      *
-     * @param  {number} level? - Specifies the list options that need to provide.
+     * @param  {boolean} [isSingleLevel] - Specifies the list options that need to provide.
      *
-     * @param  {any} componentInstance? - Specifies the list options that need to provide.
+     * @param  {any} [componentInstance] - Specifies the list options that need to provide.
      *
      * @returns  {HTMLElement[]} child - returns the list options that need to provide.
      */
-    function createListItemFromJson(createElement, dataSource, 
-    // eslint-disable-next-line
-    options, level, isSingleLevel, componentInstance) {
+    function createListItemFromJson(createElement, dataSource, options, level, isSingleLevel, componentInstance) {
         var curOpt = extend({}, defaultListBaseOptions, options);
         cssClass = getModuleClass(curOpt.moduleName);
         var fields = (componentInstance &&
@@ -226,8 +217,7 @@ export var ListBase;
         var li;
         var anchorElement;
         if (dataSource && dataSource.length && !isNullOrUndefined(typeofData(dataSource).item) &&
-            // eslint-disable-next-line no-prototype-builtins
-            !typeofData(dataSource).item.hasOwnProperty(fields.id)) {
+            !Object.prototype.hasOwnProperty.call(typeofData(dataSource).item, fields.id)) {
             id = generateId(); // generate id for drop-down-list option.
         }
         for (var i = 0; i < dataSource.length; i++) {
@@ -249,8 +239,7 @@ export var ListBase;
             if (curOpt.itemCreating && typeof curOpt.itemCreating === 'function') {
                 fieldData = getFieldValues(dataSource[i], fields);
             }
-            // eslint-disable-next-line no-prototype-builtins
-            if (fieldData.hasOwnProperty(fields.id) && !isNullOrUndefined(fieldData[fields.id])) {
+            if (Object.prototype.hasOwnProperty.call(fieldData, fields.id) && !isNullOrUndefined(fieldData[fields.id])) {
                 id = fieldData[fields.id];
             }
             var innerEle = [];
@@ -263,13 +252,11 @@ export var ListBase;
                 }
             }
             if (isSingleLevel === true) {
-                // eslint-disable-next-line no-prototype-builtins
-                if (curOpt.showIcon && fieldData.hasOwnProperty(fields.iconCss) && !isNullOrUndefined(fieldData[fields.iconCss])) {
+                if (curOpt.showIcon && Object.prototype.hasOwnProperty.call(fieldData, fields.iconCss)
+                    && !isNullOrUndefined(fieldData[fields.iconCss])) {
                     innerEle.push(createElement('span', { className: cssClass.icon + ' ' + fieldData[fields.iconCss] }));
                 }
-                li = generateSingleLevelLI(createElement, curItem, fieldData, fields, curOpt.itemClass, innerEle, 
-                // eslint-disable-next-line no-prototype-builtins
-                (curItem.hasOwnProperty('isHeader') &&
+                li = generateSingleLevelLI(createElement, curItem, fieldData, fields, curOpt.itemClass, innerEle, (Object.prototype.hasOwnProperty.call(curItem, 'isHeader') &&
                     curItem.isHeader) ? true : false, id, i, options);
                 anchorElement = li.querySelector('.' + cssClass.anchorWrap);
                 if (curOpt.itemNavigable && checkboxElement.length) {
@@ -284,8 +271,7 @@ export var ListBase;
                     li.removeAttribute('aria-level');
                 }
                 anchorElement = li.querySelector('.' + cssClass.anchorWrap);
-                // eslint-disable-next-line no-prototype-builtins
-                if (fieldData.hasOwnProperty(fields.tooltip)) {
+                if (Object.prototype.hasOwnProperty.call(fieldData, fields.tooltip)) {
                     var tooltipText = fieldData[fields.tooltip];
                     if (options && options.enableHtmlSanitizer) {
                         tooltipText = SanitizeHtmlHelper.sanitize(tooltipText);
@@ -297,8 +283,7 @@ export var ListBase;
                     }
                     li.setAttribute('title', tooltipText);
                 }
-                // eslint-disable-next-line no-prototype-builtins
-                if (fieldData.hasOwnProperty(fields.htmlAttributes) && fieldData[fields.htmlAttributes]) {
+                if (Object.prototype.hasOwnProperty.call(fieldData, fields.htmlAttributes) && fieldData[fields.htmlAttributes]) {
                     var htmlAttributes = fieldData[fields.htmlAttributes];
                     // Check if 'class' attribute is present and not an empty string
                     if ('class' in htmlAttributes && typeof htmlAttributes['class'] === 'string' && htmlAttributes['class'].trim() === '') {
@@ -306,18 +291,15 @@ export var ListBase;
                     }
                     setAttribute(li, htmlAttributes);
                 }
-                // eslint-disable-next-line no-prototype-builtins
-                if (fieldData.hasOwnProperty(fields.enabled) && fieldData[fields.enabled] === false) {
+                if (Object.prototype.hasOwnProperty.call(fieldData, fields.enabled) && fieldData[fields.enabled] === false) {
                     li.classList.add(cssClass.disabled);
                 }
-                // eslint-disable-next-line no-prototype-builtins
-                if (fieldData.hasOwnProperty(fields.isVisible) && fieldData[fields.isVisible] === false) {
+                if (Object.prototype.hasOwnProperty.call(fieldData, fields.isVisible) && fieldData[fields.isVisible] === false) {
                     li.style.display = 'none';
                 }
-                // eslint-disable-next-line no-prototype-builtins
-                if (fieldData.hasOwnProperty(fields.imageUrl) && !isNullOrUndefined(fieldData[fields.imageUrl])
+                if (Object.prototype.hasOwnProperty.call(fieldData, fields.imageUrl) && !isNullOrUndefined(fieldData[fields.imageUrl])
                     && !curOpt.template) {
-                    var attr = { src: fieldData[fields.imageUrl] };
+                    var attr = { src: fieldData[fields.imageUrl], alt: !isNullOrUndefined(fieldData.name) ? ('Displaying ' + fieldData.name + ' Image') : 'Displaying Image' };
                     merge(attr, fieldData[fields.imageAttributes]);
                     var imageElemnt = createElement('img', { className: cssClass.image, attrs: attr });
                     if (anchorElement) {
@@ -327,8 +309,7 @@ export var ListBase;
                         prepend([imageElemnt], li.firstElementChild);
                     }
                 }
-                // eslint-disable-next-line no-prototype-builtins
-                if (curOpt.showIcon && fieldData.hasOwnProperty(fields.iconCss) &&
+                if (curOpt.showIcon && Object.prototype.hasOwnProperty.call(fieldData, fields.iconCss) &&
                     !isNullOrUndefined(fieldData[fields.iconCss]) && !curOpt.template) {
                     var iconElement = createElement('div', { className: cssClass.icon + ' ' + fieldData[fields.iconCss] });
                     if (anchorElement) {
@@ -373,19 +354,17 @@ export var ListBase;
      *
      * @param  {{Object}[]} dataSource - Specifies an array of JSON data.
      *
-     * @param  {ListBaseOptions} options? - Specifies the list options that need to provide.
+     * @param  {ListBaseOptions} [options] - Specifies the list options that need to provide.
      *
-     * @param  {number} level? - Specifies the list options that need to provide.
+     * @param  {number} [level] - Specifies the list options that need to provide.
      *
-     * @param  {boolean} isSingleLevel? - Specifies the list options that need to provide.
+     * @param  {boolean} [isSingleLevel] - Specifies the list options that need to provide.
      *
-     * @param  {any} componentInstance? - Specifies the list options that need to provide.
+     * @param  {any} [componentInstance] - Specifies the list options that need to provide.
      *
      * @returns  {createElement} generateUL - Specifies the list options that need to provide.
      */
-    function createListFromJson(createElement, dataSource, 
-    // eslint-disable-next-line
-    options, level, isSingleLevel, componentInstance) {
+    function createListFromJson(createElement, dataSource, options, level, isSingleLevel, componentInstance) {
         var curOpt = extend({}, defaultListBaseOptions, options);
         var li = createListItemFromJson(createElement, dataSource, options, level, isSingleLevel, componentInstance);
         return generateUL(createElement, li, curOpt.listClass, options);
@@ -395,8 +374,9 @@ export var ListBase;
      * Return the next or previous visible element.
      *
      * @param  {Element[]|NodeList} elementArray - An element array to find next or previous element.
-     * @param  {Element} li - An element to find next or previous after this element.
-     * @param  {boolean} isPrevious? - Specify when the need get previous element from array.
+     * @param  {Element} element - An element to find next or previous after this element.
+     * @param  {boolean} [isPrevious] - Specify when the need get previous element from array.
+     * @returns {Element|undefined} The next or previous visible element, or undefined if the element array is empty.
      */
     function getSiblingLI(elementArray, element, isPrevious) {
         cssClass = getModuleClass(defaultListBaseOptions.moduleName);
@@ -425,6 +405,7 @@ export var ListBase;
      *
      * @param  {Element} item - An element to find next or previous after this element.
      * @param  {Element[]} elementArray - An element array to find index of given li.
+     * @returns {number} - The index of the item in the element array, or undefined if either parameter is false.
      */
     function indexOf(item, elementArray) {
         if (!elementArray || !item) {
@@ -442,7 +423,8 @@ export var ListBase;
      *
      * @param  {{Object}[]} dataSource - The JSON data which is necessary to process.
      * @param  {FieldsMapping} fields - Fields that are mapped from the data source.
-     * @param  {SortOrder} sortOrder- Specifies final result sort order.
+     * @param  {SortOrder} [sortOrder='None'] - Specifies final result sort order. Defaults to 'None'.
+     * @returns {Object[]} - The grouped data.
      */
     function groupDataSource(dataSource, fields, sortOrder) {
         if (sortOrder === void 0) { sortOrder = 'None'; }
@@ -480,6 +462,7 @@ export var ListBase;
      * @param  {SortOrder} sortOrder - Specifies that sort order.
      * @param  {string} sortBy - Specifies sortBy fields.
      * @param  {Query} query - Pass if any existing query.
+     * @returns {Query} - The updated query object with sorting applied.
      */
     function addSorting(sortOrder, sortBy, query) {
         if (query === void 0) { query = new Query(); }
@@ -505,9 +488,10 @@ export var ListBase;
      * @param  {{Object}[]} dataSource - Specifies local JSON data source.
      *
      * @param  {Query} query - Specifies query that need to process.
+     *
+     * @returns {Object[]} - An array of objects representing the retrieved data.
      */
     function getDataSource(dataSource, query) {
-        // eslint-disable-next-line
         return new DataManager(dataSource)
             .executeLocal(query);
     }
@@ -516,7 +500,8 @@ export var ListBase;
      * Created JSON data based the UL and LI element
      *
      * @param  {HTMLElement|Element} element - UL element that need to convert as a JSON
-     * @param  {ListBaseOptions} options? - Specifies listbase option for fields.
+     * @param  {ListBaseOptions} [options] - Specifies ListBase option for fields.
+     * @returns {Object[]} - An array of objects representing the JSON data.
      */
     function createJsonFromElement(element, options) {
         var curOpt = extend({}, defaultListBaseOptions, options);
@@ -563,6 +548,12 @@ export var ListBase;
         return jsonAr;
     }
     ListBase.createJsonFromElement = createJsonFromElement;
+    /**
+     * Determines the type of data in an array of objects, strings, or numbers.
+     *
+     * @param {Object[] | string[] | number[]} data - The array containing objects, strings, or numbers.
+     * @returns {{typeof: (string | null), item: (Object | string | number)}} - An object containing the type of data and the corresponding item.
+     */
     function typeofData(data) {
         var match = { typeof: null, item: null };
         for (var i = 0; i < data.length; i++) {
@@ -572,6 +563,13 @@ export var ListBase;
         }
         return match;
     }
+    /**
+     * Sets attributes on an HTML element.
+     *
+     * @param {HTMLElement} element - The HTML element to set attributes on.
+     * @param {Object.<string, string>} elementAttributes - An object containing attribute names and their corresponding values.
+     * @returns {void}
+     */
     function setAttribute(element, elementAttributes) {
         var attr = {};
         merge(attr, elementAttributes);
@@ -581,6 +579,12 @@ export var ListBase;
         }
         attributes(element, attr);
     }
+    /**
+     * Retrieves all attributes of an HTML element.
+     *
+     * @param {HTMLElement} element - The HTML element to retrieve attributes from.
+     * @returns {Object.<string, string>} - An object containing attribute names as keys and their corresponding values as values.
+     */
     function getAllAttributes(element) {
         var attributes = {};
         var attr = element.attributes;
@@ -592,13 +596,15 @@ export var ListBase;
     /**
      * Created UL element from content template.
      *
+     * @param  {createElementParams} createElement - Specifies an array of JSON data.
      * @param  {string} template - that need to convert and generate li element.
      * @param  {{Object}[]} dataSource - Specifies local JSON data source.
-     * @param  {ListBaseOptions} options? - Specifies listbase option for fields.
+     * @param  {FieldsMapping} [fields] - Specifies fields for mapping the dataSource.
+     * @param  {ListBaseOptions} [options] - Specifies ListBase option for fields.
+     * @param  {any} [componentInstance] - Specifies component instance.
+     * @returns {HTMLElement} - The generated LI element.
      */
-    function renderContentTemplate(createElement, template, dataSource, 
-    // eslint-disable-next-line
-    fields, options, componentInstance) {
+    function renderContentTemplate(createElement, template, dataSource, fields, options, componentInstance) {
         cssClass = getModuleClass(defaultListBaseOptions.moduleName);
         var ulElement = createElement('ul', { className: cssClass.ul, attrs: { role: 'presentation' } });
         var curOpt = extend({}, defaultListBaseOptions, options);
@@ -652,7 +658,6 @@ export var ListBase;
                 var currentID = isHeader ? curOpt.groupTemplateID : curOpt.templateID;
                 if (isHeader) {
                     if (componentInstance && componentInstance.getModuleName() !== 'listview') {
-                        // eslint-disable-next-line
                         var compiledElement = compiledString(curItem, componentInstance, 'headerTemplate', currentID, !!curOpt.isStringTemplate, null, li);
                         if (compiledElement) {
                             append(compiledElement, li);
@@ -664,7 +669,6 @@ export var ListBase;
                 }
                 else {
                     if (componentInstance && componentInstance.getModuleName() !== 'listview') {
-                        // eslint-disable-next-line
                         var compiledElement = compiledString(curItem, componentInstance, 'template', currentID, !!curOpt.isStringTemplate, null, li);
                         if (compiledElement) {
                             append(compiledElement, li);
@@ -697,18 +701,23 @@ export var ListBase;
     /**
      * Created header items from group template.
      *
-     * @param  {string} template - that need to convert and generate li element.
+     * @param  {string | Function} groupTemplate - that need to convert and generate li element.
      *
-     * @param  {{Object}[]} dataSource - Specifies local JSON data source.
+     * @param {{Object}[]} groupDataSource - Specifies local JSON data source.
      *
      * @param  {FieldsMapping} fields - Specifies fields for mapping the dataSource.
      *
-     * @param  {Element[]} headerItems? - Specifies listbase header items.
+     * @param  {Element[]} headerItems - Specifies ListBase header items.
+     *
+     * @param {ListBaseOptions} [options] - Optional ListBase options.
+     *
+     * @param {*} [componentInstance] - Optional component instance.
+     *
+     * @returns {Element[]} - An array of header elements with the rendered group template content.
      */
+    function renderGroupTemplate(groupTemplate, 
     // tslint:disable-next-line
-    function renderGroupTemplate(groupTemplate, groupDataSource, fields, 
-    // eslint-disable-next-line
-    headerItems, options, componentInstance) {
+    groupDataSource, fields, headerItems, options, componentInstance) {
         var compiledString = compileTemplate(groupTemplate);
         var curFields = extend({}, ListBase.defaultMappedFields, fields);
         var curOpt = extend({}, defaultListBaseOptions, options);
@@ -719,7 +728,6 @@ export var ListBase;
             headerData["" + category] = header.textContent;
             header.innerHTML = '';
             if (componentInstance && componentInstance.getModuleName() !== 'listview') {
-                // eslint-disable-next-line
                 var compiledElement = compiledString(headerData, componentInstance, 'groupTemplate', curOpt.groupTemplateID, !!curOpt.isStringTemplate, null, header);
                 if (compiledElement) {
                     append(compiledElement, header);
@@ -732,12 +740,29 @@ export var ListBase;
         return headerItems;
     }
     ListBase.renderGroupTemplate = renderGroupTemplate;
+    /**
+     * Generates a random hexadecimal ID string.
+     *
+     * @returns {string} - The generated ID string.
+     */
     function generateId() {
         return Math.floor((1 + Math.random()) * 0x10000)
             .toString(16)
             .substring(1);
     }
     ListBase.generateId = generateId;
+    /**
+     * Processes the sub-child elements and creates corresponding elements based on the provided field data and options.
+     *
+     * @param {Function} createElement - Function for creating elements.
+     * @param {Object} fieldData - Field data containing sub-child information.
+     * @param {FieldsMapping} fields - Field mappings.
+     * @param {Object[]} ds - The data source array containing sub-child elements.
+     * @param {ListBaseOptions} options - ListBase options.
+     * @param {HTMLElement} element - The parent HTML element to append sub-child elements to.
+     * @param {number} level - The level of the sub-child elements.
+     * @returns {void}
+     */
     function processSubChild(createElement, fieldData, fields, ds, options, element, level) {
         // Get SubList
         var subDS = fieldData[fields.child] || [];
@@ -758,6 +783,21 @@ export var ListBase;
             expandElement([createElement('div', { className: 'e-icons ' + options.expandIconClass })], element.querySelector('.' + cssClass.textContent));
         }
     }
+    /**
+     * Generates a single-level LI (list item) element based on the provided item and field data.
+     *
+     * @param {Function} createElement - Function for creating elements.
+     * @param {string | Object | number} item - The item data.
+     * @param {Object} fieldData - Field data mapped from the item.
+     * @param {FieldsMapping} [fields] - Field mappings.
+     * @param {string} [className] - Optional class name to add to the created LI element.
+     * @param {HTMLElement[]} [innerElements] - Optional array of inner elements to append to the LI element.
+     * @param {boolean} [grpLI] - Indicates if the LI element is a group item.
+     * @param {string} [id] - The ID of the LI element.
+     * @param {number} [index] - The index of the LI element.
+     * @param {ListBaseOptions} [options] - Optional ListBase options.
+     * @returns {HTMLElement} - The generated LI element.
+     */
     function generateSingleLevelLI(createElement, item, fieldData, fields, className, innerElements, grpLI, id, index, options) {
         var curOpt = extend({}, defaultListBaseOptions, options);
         var ariaAttributes = extend({}, defaultAriaAttributes, curOpt.ariaAttributes);
@@ -783,8 +823,7 @@ export var ListBase;
             id: elementID, attrs: (ariaAttributes.groupItemRole !== '' && ariaAttributes.itemRole !== '' ?
                 { role: (grpLI === true ? ariaAttributes.groupItemRole : ariaAttributes.itemRole) } : {})
         });
-        // eslint-disable-next-line no-prototype-builtins
-        if (dataSource && fieldData.hasOwnProperty(fields.enabled) && fieldData[fields.enabled].toString() === 'false') {
+        if (dataSource && Object.prototype.hasOwnProperty.call(fieldData, fields.enabled) && fieldData[fields.enabled].toString() === 'false') {
             li.classList.add(cssClass.disabled);
         }
         if (grpLI) {
@@ -793,8 +832,7 @@ export var ListBase;
         else {
             li.setAttribute('data-value', isNullOrUndefined(value) ? 'null' : value);
             li.setAttribute('role', 'option');
-            // eslint-disable-next-line no-prototype-builtins
-            if (dataSource && fieldData.hasOwnProperty(fields.htmlAttributes) && fieldData[fields.htmlAttributes]) {
+            if (dataSource && Object.prototype.hasOwnProperty.call(fieldData, fields.htmlAttributes) && fieldData[fields.htmlAttributes]) {
                 setAttribute(li, fieldData[fields.htmlAttributes]);
             }
             if (innerElements.length && !curOpt.itemNavigable) {
@@ -813,6 +851,12 @@ export var ListBase;
         }
         return li;
     }
+    /**
+     * Returns a set of CSS class names based on the provided module name.
+     *
+     * @param {string} moduleName - The name of the module.
+     * @returns {ClassList} - The CSS class names associated with the module.
+     */
     function getModuleClass(moduleName) {
         var moduleClass;
         // eslint-disable-next-line
@@ -838,11 +882,21 @@ export var ListBase;
             navigable: 'e-navigable'
         };
     }
+    /**
+     * Creates an anchor tag (<a>) element based on the provided data source, fields, and text.
+     *
+     * @param {Function} createElement - Function for creating elements.
+     * @param {object} dataSource - The data source containing URL-related fields.
+     * @param {FieldsMapping} fields - Field mappings for the data source.
+     * @param {string} text - The text content of the anchor tag.
+     * @param {HTMLElement[]} innerElements - Optional array of inner elements to append to the anchor tag.
+     * @param {boolean} isFullNavigation - Indicates whether the anchor tag should be for full navigation.
+     * @returns {HTMLElement} The created anchor tag element.
+     */
     function anchorTag(createElement, dataSource, fields, text, innerElements, isFullNavigation) {
         var fieldData = getFieldValues(dataSource, fields);
         var attr = { href: fieldData[fields.url] };
-        // eslint-disable-next-line no-prototype-builtins
-        if (fieldData.hasOwnProperty(fields.urlAttributes) && fieldData[fields.urlAttributes]) {
+        if (Object.prototype.hasOwnProperty.call(fieldData, fields.urlAttributes) && fieldData[fields.urlAttributes]) {
             merge(attr, fieldData[fields.urlAttributes]);
             attr.href = fieldData[fields.url] ? fieldData[fields.url] :
                 fieldData[fields.urlAttributes].href;
@@ -863,11 +917,19 @@ export var ListBase;
         setAttribute(anchorTag, attr);
         return anchorTag;
     }
-    // tslint:disable-next-line
-    /* tslint:disable:align */
-    function generateLI(createElement, item, fieldData, 
-    // eslint-disable-next-line
-    fields, className, options, componentInstance) {
+    /**
+     * Generates an LI element based on the provided item and field data.
+     *
+     * @param {Function} createElement - Function for creating elements.
+     * @param {string | Object | number} item - The item data.
+     * @param {Object} fieldData - Field data mapped from the item.
+     * @param {FieldsMapping} fields - Field mappings.
+     * @param {string} [className] - Optional class name to add to the created LI element.
+     * @param {ListBaseOptions} [options] - Optional ListBase options.
+     * @param {*} [componentInstance] - Optional component instance.
+     * @returns {HTMLElement} - The generated LI element.
+     */
+    function generateLI(createElement, item, fieldData, fields, className, options, componentInstance) {
         var curOpt = extend({}, defaultListBaseOptions, options);
         var ariaAttributes = extend({}, defaultAriaAttributes, curOpt.ariaAttributes);
         var text = item;
@@ -877,10 +939,8 @@ export var ListBase;
         if (typeof item !== 'string' && typeof item !== 'number') {
             dataSource = item;
             text = fieldData[fields.text] || '';
-            // tslint:disable-next-line
             uID = (isNullOrUndefined(fieldData['_id'])) ? fieldData[fields.id] : fieldData['_id'];
-            // eslint-disable-next-line no-prototype-builtins
-            grpLI = (item.hasOwnProperty('isHeader') && item.isHeader)
+            grpLI = (Object.prototype.hasOwnProperty.call(item, 'isHeader') && item.isHeader)
                 ? true : false;
         }
         if (options && options.enableHtmlSanitizer) {
@@ -901,7 +961,6 @@ export var ListBase;
         if (grpLI && options && options.groupTemplate) {
             var compiledString = compileTemplate(options.groupTemplate);
             if (componentInstance && componentInstance.getModuleName() !== 'listview') {
-                // eslint-disable-next-line
                 var compiledElement = compiledString(item, componentInstance, 'groupTemplate', curOpt.groupTemplateID, !!curOpt.isStringTemplate, null, li);
                 if (compiledElement) {
                     append(compiledElement, li);
@@ -914,7 +973,6 @@ export var ListBase;
         else if (!grpLI && options && options.template) {
             var compiledString = compileTemplate(options.template);
             if (componentInstance && componentInstance.getModuleName() !== 'listview') {
-                // eslint-disable-next-line
                 var compiledElement = compiledString(item, componentInstance, 'template', curOpt.templateID, !!curOpt.isStringTemplate, null, li);
                 if (compiledElement) {
                     append(compiledElement, li);
@@ -953,11 +1011,15 @@ export var ListBase;
     /**
      * Returns UL element based on the given LI element.
      *
+     * @param {Function} createElement - Function for creating elements.
+     *
      * @param  {HTMLElement[]} liElement - Specifies array of LI element.
      *
-     * @param  {string} className? - Specifies class name that need to be added in UL element.
+     * @param  {string} [className] - Specifies class name that need to be added in UL element.
+     *
+     * @param  {ListBaseOptions} [options] - Specifies ListBase options.
      *
-     * @param  {ListBaseOptions} options? - Specifies ListBase options.
+     * @returns {HTMLElement} - The created UL element.
      */
     function generateUL(createElement, liElement, className, options) {
         var curOpt = extend({}, defaultListBaseOptions, options);
@@ -974,11 +1036,15 @@ export var ListBase;
     /**
      * Returns LI element with additional DIV tag based on the given LI element.
      *
+     * @param {Function} createElement - Function for creating elements.
+     *
      * @param  {liElement} liElement - Specifies LI element.
      *
-     * @param  {string} className? - Specifies class name that need to be added in created DIV element.
+     * @param  {string} [className] - Specifies class name that need to be added in created DIV element.
+     *
+     * @param  {ListBaseOptions} [options] - Specifies ListBase options.
      *
-     * @param  {ListBaseOptions} options? - Specifies ListBase options.
+     * @returns {HTMLElement} - The modified LI element.
      */
     function generateIcon(createElement, liElement, className, options) {
         var curOpt = extend({}, defaultListBaseOptions, options);
@@ -995,9 +1061,10 @@ export var ListBase;
 /**
  * Used to get dataSource item from complex data using fields.
  *
- * @param {Object} dataSource - Specifies an  JSON or String data.
+ * @param {Object} dataItem - Specifies an  JSON or String data.
  *
  * @param {FieldsMapping} fields - Fields that are mapped from the dataSource.
+ * @returns {Object|string|number} - The retrieved field values.
  */
 export function getFieldValues(dataItem, fields) {
     var fieldData = {};
@@ -1018,6 +1085,12 @@ export function getFieldValues(dataItem, fields) {
     }
     return fieldData;
 }
+/**
+ * Compiles a template string or function into a compiled function.
+ *
+ * @param {string | Function} template - The template string or function to compile.
+ * @returns {Function | undefined} - The compiled function, or undefined if the input is false.
+ */
 function compileTemplate(template) {
     if (template) {
         try {

package/src/list-view/list-view.d.ts

@@ -482,8 +482,6 @@ export declare class ListView extends Component<HTMLElement> implements INotifyP
     private resetCurrentList;
     private setAttributes;
     private createList;
-    private exceptionEvent;
-    private UpdateCurrentUL;
     private renderSubList;
     private renderIntoDom;
     private renderList;
@@ -663,13 +661,13 @@ export interface ListSelectedItem {
     parentId?: string[];
 }
 /**
-* An enum type that denotes the ListView scroll direction when it reaches the end.
-* ```props
-* Top:- The scrollbar is moved upwards.
-* Bottom:- The scrollbar is moved downwards.
- 
-* ```
-*/
+ * An enum type that denotes the ListView scroll direction when it reaches the end.
+ * ```props
+ * Top:- The scrollbar is moved upwards.
+ * Bottom:- The scrollbar is moved downwards.
+
+ * ```
+ */
 export declare type direction = 'Top' | 'Bottom';
 /**
  * An interface that holds selected item.