@guiexpert/react-table 18.1.74 → 18.1.76

package/index.js

@@ -479,6 +479,8 @@ class he {
   doSort(e) {
     return !1;
   }
+  sort(e) {
+  }
   isEditable(e, t) {
     var o, i;
     const s = (o = this.columnDefs) == null ? void 0 : o[t];
@@ -536,7 +538,13 @@ class pe {
 }
 class F extends he {
   constructor(e, t, s, o = [], i = "ge-selected-row", r = "ge-focused-row") {
-    super(e, o, s), this.areaIdent = e, this.rows = t, this.defaultRowHeight = s, this.columnDefs = o, this.selectedRowClass = i, this.focusedRowClass = r, this.focusedRowIndex = 0, this.sorterService = new pe(), this.filteredRows = [...t], this.properties = o.map((l) => l.property);
+    super(e, o, s), this.areaIdent = e, this.rows = t, this.defaultRowHeight = s, this.columnDefs = o, this.selectedRowClass = i, this.focusedRowClass = r, this.sorterService = new pe(), this._focusedRowIndex = 0, this.filteredRows = [...t], this.properties = o.map((l) => l.property);
+  }
+  getFocusedRowIndex() {
+    return this._focusedRowIndex;
+  }
+  setFocusedRowIndex(e) {
+    this._focusedRowIndex = e;
   }
   setRows(e) {
     this.rows = e, this.filteredRows = [...e];
@@ -568,6 +576,28 @@ class F extends he {
   getAllRows() {
     return this.rows;
   }
+  /**
+   * Returns the first row from the filtered rows that matches the given criteria based on the provided predicate function.
+   *
+   * @param {Partial<T>} criteria - A partial object containing the search criteria
+   * @param {(criteria: Partial<T>, row: T) => boolean} predicate - A function that takes the search criteria and a row,
+   *        and returns true if the row matches the criteria
+   * @returns {T | undefined} The first matching row, or undefined if no match is found
+   */
+  findRowFromFilteredRowsByAllCriteria(e, t) {
+    return this.getFilteredRows().find((s) => t(e, s));
+  }
+  /**
+   * Searches through all rows to find a row that matches the given criteria based on the predicate function.
+   *
+   * @param {Partial<T>} criteria - A partial object containing the search criteria
+   * @param {(criteria: Partial<T>, row: T) => boolean} predicate - A function that takes the search criteria and a row,
+   *        and returns true if the row matches the criteria
+   * @returns {T | undefined} The first matching row from all rows, or undefined if no match is found
+   */
+  findRowFromAllRowsByAllCriteria(e, t) {
+    return this.getAllRows().find((s) => t(e, s));
+  }
   getRowHeight(e) {
     return this.defaultRowHeight;
   }
@@ -584,6 +614,9 @@ class F extends he {
     }
     return !0;
   }
+  sort(e) {
+    this.filteredRows = this.filteredRows.sort(e);
+  }
   getValueByT(e, t) {
     if (e && t)
       return t.includes(".") ? this.getPropertyValue(e, t.split(".")) : e[t];
@@ -593,7 +626,7 @@ class F extends he {
   }
   getCustomClassesAt(e, t) {
     const s = super.getCustomClassesAt(e, t);
-    return this.getRowByIndex(e).selected && s.push(this.selectedRowClass), this.focusedRowIndex === e && s.push(this.focusedRowClass), s;
+    return this.getRowByIndex(e).selected && s.push(this.selectedRowClass), this._focusedRowIndex === e && s.push(this.focusedRowClass), s;
   }
   genericFlatTableSortComparator(e, t) {
     const s = this.columnDefs.find((o) => o.property === e);
@@ -821,25 +854,90 @@ class ge {
   getSelectionModel() {
     return this.tableScope.selectionModel();
   }
+  /**
+   * Automatically resizes all columns to fit their content.
+   *
+   * @param {boolean} recalcWrappers - Determines whether to recalculate wrapper dimensions after resizing columns.
+   *                                   Default value is true.
+   * 
+   * @return {void} - This method doesn't return anything.
+   */
   autoResizeColumns(e = !0) {
     this.tableScope.autoResizeColumns(e);
   }
+  /**
+   * Recalculates the dimensions of all wrapper elements in the table.
+   * 
+   * This method is typically called after changes to the table structure or content
+   * that might affect the layout, such as resizing columns or changing row heights.
+   * It ensures that all wrapper elements are properly sized to match their content.
+   *
+   * @return {void} - This method doesn't return anything.
+   */
   recalcWrappers() {
     this.tableScope.recalcWrappers();
   }
+  /**
+   * Sets the width of a specific column in the table.
+   *
+   * @param {number} columnIndex - The index of the column to resize.
+   * @param {number} width - The new width to set for the column, in pixels.
+   * 
+   * @return {void} - This method doesn't return anything.
+   */
   setColumnWidth(e, t) {
     this.tableScope.setColumnWidth(e, t);
   }
+  /**
+   * Retrieves the table model that contains all data and structure information for the table.
+   *
+   * @return {TableModelIf} The table model interface that provides access to the table's data structure,
+   *                        including header, body, and footer area models.
+   */
   getTableModel() {
     return this.tableScope.tableModel;
   }
+  /**
+   * Retrieves the area model for the body section of the table.
+   *
+   * @return {AreaModelIf} The area model interface that provides access to the table's body data,
+   *                       including rows, cells, and their values.
+   */
   getBodyModel() {
     return this.tableScope.tableModel.getBodyModel();
   }
+  /**
+   * Sets the rows data for the table body, replacing any existing rows.
+   *
+   * @template T - The type of elements in the rows array
+   * @param {T[]} rows - An array of data objects to set as the table's rows
+   * 
+   * @description
+   * This method replaces all existing rows in the table body with the provided array of data objects.
+   * It only works with tables that use AreaModelObjectArray as their body model.
+   * 
+   * @return {void} - This method doesn't return anything.
+   * 
+   * @throws {Warning} Logs a console warning if the table's body model is not an AreaModelObjectArray
+   */
   setRows(e) {
     const t = this.getBodyModel();
     t instanceof F ? t.setRows(e) : console.warn("setRows<T>(rows: T[]) only works with AreaModelObjectArray<T>, but this body area model is ", typeof t, t);
   }
+  /**
+   * Adds new rows to the end of the table body.
+   *
+   * @template T - The type of elements in the rows array
+   * @param {T[]} rows - An array of data objects to append to the table's existing rows
+   * 
+   * @description
+   * This method appends the provided array of data objects to the end of the existing rows in the table body.
+   * It only works with tables that use AreaModelObjectArray as their body model.
+   * 
+   * @return {void} - This method doesn't return anything.
+   * 
+   * @throws {Warning} Logs a console warning if the table's body model is not an AreaModelObjectArray
+   */
   addRows(e) {
     const t = this.getBodyModel();
     if (t instanceof F) {
@@ -849,6 +947,22 @@ class ge {
     } else
       console.warn("addRows<T>(rows: T[]) only works with AreaModelObjectArray<T>, but this body area model is ", typeof t, t);
   }
+  /**
+   * Inserts new rows at a specific position in the table body.
+   *
+   * @template T - The type of elements in the rows array
+   * @param {T[]} rows - An array of data objects to insert into the table
+   * @param {number} rowIndex - The index position where the new rows should be inserted
+   * 
+   * @description
+   * This method inserts the provided array of data objects at the specified index position in the table body.
+   * Existing rows at or after the specified index will be shifted down.
+   * It only works with tables that use AreaModelObjectArray as their body model.
+   * 
+   * @return {void} - This method doesn't return anything.
+   * 
+   * @throws {Warning} Logs a console warning if the table's body model is not an AreaModelObjectArray
+   */
   addRowsAt(e, t) {
     const s = this.getBodyModel();
     if (s instanceof F) {
@@ -858,6 +972,23 @@ class ge {
     } else
       console.warn("addRowsAt<T>(rows: T[]) only works with AreaModelObjectArray<T>, but this body area model is ", typeof s, s);
   }
+  /**
+   * Removes specified rows from the table body.
+   *
+   * @template T - The type of elements in the rows array
+   * @param {T[]} rows - An array of data objects to remove from the table
+   * @param {(a: T, b: T) => boolean} predicate - A comparison function that determines if two rows match
+   *   - Default predicate uses strict equality (===)
+   *   - The function should return true if the rows are considered a match
+   * 
+   * @description
+   * This method removes rows from the table body that match any of the provided rows based on the predicate function.
+   * It only works with tables that use AreaModelObjectArray as their body model.
+   * 
+   * @return {void} - This method doesn't return anything.
+   * 
+   * @throws {Warning} Logs a console warning if the table's body model is not an AreaModelObjectArray
+   */
   removeRows(e, t = (s, o) => s === o) {
     const s = this.getBodyModel();
     if (s instanceof F) {
@@ -866,10 +997,168 @@ class ge {
     } else
       console.warn("removeRows<T>(rows: T[]) only works with AreaModelObjectArray<T>, but this body area model is ", typeof s, s);
   }
+  /**
+   * Searches for and returns rows from the table body that match the given criteria.
+   *
+   * @template T - The type of elements in the rows array
+   * 
+   * @description
+   * This method searches through the table body model for rows that match the provided criteria.
+   * It only works with tables that use AreaModelObjectArray as their body model.
+   * The method uses a predicate function to determine matches between rows.
+   *
+   * @param {T[]} rows - An array of rows to search for in the table body
+   * @param {(a: T, b: T) => boolean} predicate - A comparison function that determines if two rows match
+   *   - Default predicate uses strict equality (===)
+   *   - The function should return true if the rows are considered a match
+   *   - Parameters:
+   *     - a: The row from the table body being checked
+   *     - b: The row from the input array being searched for
+   *
+   * @returns {T[]} An array containing all matching rows found in the table body
+   *   - Returns an empty array if:
+   *     - The body model is not an instance of AreaModelObjectArray
+   *     - No matches are found
+   *
+   * @example
+   * // Find rows with simple equality comparison
+   * const matchingRows = table.findRows([row1, row2]);
+   *
+   * @example
+   * // Find rows with custom comparison logic
+   * const matchingRows = table.findRows([row1, row2], (a, b) => a.id === b.id);
+   *
+   * @throws {Warning} Logs a console warning if the table's body model is not an AreaModelObjectArray
+   */
   findRows(e, t = (s, o) => s === o) {
     const s = this.getBodyModel();
     return s instanceof F ? s.getAllRows().filter((i) => e.some((r) => t(i, r))) : (console.warn("findRows<T>(rows: T[], predicate: (a: T, b: T) => boolean) only works with AreaModelObjectArray<T>, but this body area model is ", typeof s, s), []);
   }
+  /**
+   * Searches through the filtered rows of the table to find a row that matches specific criteria.
+   * This method only works with tables that use AreaModelObjectArray as their body model.
+   *
+   * @template T - The type of the row objects in the table
+   * 
+   * @param {Partial<T>} criteria - A partial object containing the search criteria.
+   *                               Only needs to include the properties you want to match against.
+   * 
+   * @param {(criteria: Partial<T>, row: T) => boolean} predicate - A function that defines how to match rows against the criteria.
+   *                                                               Returns true if the row matches the criteria, false otherwise.
+   * 
+   * @returns {T | undefined} The first matching row from the filtered rows, or undefined if no match is found
+   *                         or if the body model is not an instance of AreaModelObjectArray.
+   * 
+   * @example
+   * ```typescript
+   * interface Person {
+   *   id: number;
+   *   name: string;
+   *   age: number;
+   * }
+   * 
+   * // Find a person by exact match
+   * const criteria = { name: "John", age: 30 };
+   * const person = tableApi.findRowFromFilteredRowsByAllCriteria<Person>(
+   *   criteria,
+   *   (criteria, row) => row.name === criteria.name && row.age === criteria.age
+   * );
+   * 
+   * // Find a person by partial name match
+   * const searchCriteria = { name: "Jo" };
+   * const person2 = tableApi.findRowFromFilteredRowsByAllCriteria<Person>(
+   *   searchCriteria,
+   *   (criteria, row) => row.name.toLowerCase().includes(criteria.name!.toLowerCase())
+   * );
+   * 
+   * // Find a person within age range
+   * const ageCriteria = { minAge: 25, maxAge: 35 };
+   * const person3 = tableApi.findRowFromFilteredRowsByAllCriteria<Person>(
+   *   ageCriteria,
+   *   (criteria, row) => row.age >= criteria.minAge! && row.age <= criteria.maxAge!
+   * );
+   * ```
+   * 
+   * @throws {Warning} Logs a warning to console if the body model is not an instance of AreaModelObjectArray
+   * 
+   * @remarks
+   * - This method only searches through filtered rows (rows that are currently visible in the table)
+   * - If you need to search through all rows (including filtered out ones), use findRowFromAllRowsByAllCriteria instead
+   * - The predicate function gives you full control over how to match rows against your criteria
+   * - Returns undefined if either no match is found or if the table's body model is not compatible
+   */
+  findRowFromFilteredRowsByAllCriteria(e, t) {
+    const s = this.getBodyModel();
+    if (s instanceof F)
+      return s.getFilteredRows().find((i) => t(e, i));
+    console.warn("findRowFromFilteredRowsByAllCriteria(...) only works with AreaModelObjectArray<T>, but this body area model is ", typeof s, s);
+  }
+  /**
+   * Searches through all rows in the table's body model to find a row that matches specified criteria.
+   * This method works only with AreaModelObjectArray<T> body models.
+   *
+   * @template T - The type of objects/rows in the table
+   * 
+   * @param {Partial<T>} criteria - A partial object containing the search criteria.
+   *                               Only needs to include the properties you want to match against.
+   * 
+   * @param {(criteria: Partial<T>, row: T) => boolean} predicate - A function that defines how to match rows against the criteria.
+   *                                                               Returns true if the row matches the criteria, false otherwise.
+   * 
+   * @returns {T | undefined} The first matching row, or undefined if no match is found or if the body model is not AreaModelObjectArray.
+   * 
+   * @example
+   * // Find a user row by id and name
+   * const criteria = { id: 1, name: "John" };
+   * const user = tableApi.findRowFromAllRowsByAllCriteria(criteria, 
+   *   (criteria, row) => row.id === criteria.id && row.name === criteria.name
+   * );
+   * 
+   * @example
+   * // Find a product row with partial match on name
+   * const criteria = { name: "Phone" };
+   * const product = tableApi.findRowFromAllRowsByAllCriteria(criteria,
+   *   (criteria, row) => row.name.includes(criteria.name)
+   * );
+   * 
+   * @example
+   * // Find an order with complex matching logic
+   * const criteria = { total: 100, status: "pending" };
+   * const order = tableApi.findRowFromAllRowsByAllCriteria(criteria,
+   *   (criteria, row) => {
+   *     return row.total > criteria.total && 
+   *            row.status === criteria.status &&
+   *            row.items.length > 0;
+   *   }
+   * );
+   * 
+   * @throws {Warning} Logs a warning to console if the body model is not an instance of AreaModelObjectArray
+   */
+  findRowFromAllRowsByAllCriteria(e, t) {
+    const s = this.getBodyModel();
+    if (s instanceof F)
+      return s.getAllRows().find((i) => t(e, i));
+    console.warn("findRowFromAllRowsByAllCriteria(...) only works with AreaModelObjectArray<T>, but this body area model is ", typeof s, s);
+  }
+  /**
+   * Updates existing rows in the table body with new data.
+   *
+   * @template T - The type of elements in the rows array
+   * @param {T[]} rows - An array of data objects containing the updated values
+   * @param {(a: T, b: T) => boolean} predicate - A comparison function that determines which rows to update
+   *   - Default predicate uses strict equality (===)
+   *   - The function should return true if the row should be updated
+   * 
+   * @description
+   * This method updates existing rows in the table body with new values from the provided rows array.
+   * For each row in the table, if the predicate returns true when compared with any row in the provided array,
+   * all properties from the provided row will be copied to the existing row.
+   * It only works with tables that use AreaModelObjectArray as their body model.
+   * 
+   * @return {void} - This method doesn't return anything.
+   * 
+   * @throws {Warning} Logs a console warning if the table's body model is not an AreaModelObjectArray
+   */
   updateRows(e, t = (s, o) => s === o) {
     const s = this.getBodyModel();
     if (s instanceof F) {
@@ -882,12 +1171,165 @@ class ge {
     } else
       console.warn("updateRows<T>(rows: T[], predicate: (a: T, b: T) => boolean) only works with AreaModelObjectArray<T>, but this body area model is ", typeof s, s);
   }
+  /**
+   * Re-applies the current sorting configuration to the table data.
+   *
+   * @description
+   * This method triggers a re-sort of the table data using the current sorting configuration.
+   * It's useful when the underlying data has changed and needs to be re-sorted without changing
+   * the sort columns or direction.
+   * 
+   * @return {void} - This method doesn't return anything.
+   */
   reSort() {
     this.tableScope.reSort();
   }
+  /**
+   * Sorts the table data using a custom comparison function.
+   * 
+   * This method allows sorting of table rows by providing a custom comparison function. The comparison function
+   * should follow the standard JavaScript array sort comparator pattern, returning:
+   * - A negative number if the first element should be sorted before the second
+   * - A positive number if the first element should be sorted after the second
+   * - Zero if the elements are equal
+   * 
+   * @param compareFn - A function that defines the sort order. The function should accept two arguments
+   *                   and return a number indicating their relative order:
+   *                   - Negative number: first argument should come before second
+   *                   - Positive number: second argument should come before first
+   *                   - Zero: elements are equal
+   * 
+   * @example
+   * // Sort table rows by a specific property in ascending order
+   * table.api.sort((a, b) => {
+   *   if (a.name < b.name) return -1;
+   *   if (a.name > b.name) return 1;
+   *   return 0;
+   * });
+   * 
+   * @example
+   * // Sort numbers in descending order
+   * table.api.sort((a, b) => b.value - a.value);
+   * 
+   * @example
+   * // Sort with multiple criteria
+   * table.api.sort((a, b) => {
+   *   // First sort by status
+   *   const statusCompare = a.status.localeCompare(b.status);
+   *   if (statusCompare !== 0) return statusCompare;
+   *   
+   *   // Then sort by name if status is equal
+   *   return a.name.localeCompare(b.name);
+   * });
+   * 
+   * @example
+   * // Case-insensitive string sorting
+   * table.api.sort((a, b) => 
+   *   a.name.toLowerCase().localeCompare(b.name.toLowerCase())
+   * );
+   */
+  sort(e) {
+    this.tableScope.sort(e);
+  }
+  /**
+   * Ensures that a specific row is visible in the viewport by scrolling if necessary.
+   * This method checks if the target row is within the currently visible range and
+   * adjusts the scroll position if it's not visible.
+   *
+   * The method performs the following:
+   * 1. Checks if the row is above the current viewport (before first visible row)
+   * 2. Checks if the row is below the current viewport (after last visible row)
+   * 3. Scrolls to make the row visible if needed
+   *
+   * @param {number} rowIndex - The index of the row to make visible
+   * @returns {boolean} Returns true if scrolling was needed and performed, false if the row was already visible
+   *
+   * @example
+   * // Ensure row 5 is visible in the viewport
+   * tableApi.ensureRowIsVisible(5);
+   *
+   * @example
+   * // Example usage in a component
+   * class MyTableComponent {
+   *   private tableApi: TableApi;
+   *
+   *   scrollToSpecificRow(rowIndex: number) {
+   *     // This will scroll the row into view if it's not visible
+   *     const didScroll = this.tableApi.ensureRowIsVisible(rowIndex);
+   *
+   *     if (didScroll) {
+   *       console.log(`Table scrolled to show row ${rowIndex}`);
+   *     } else {
+   *       console.log(`Row ${rowIndex} was already visible`);
+   *     }
+   *   }
+   * }
+   *
+   * @example
+   * // Example with row selection
+   * class TableHandler {
+   *   selectAndShowRow(rowIndex: number) {
+   *     // First ensure the row is visible
+   *     this.tableApi.ensureRowIsVisible(rowIndex);
+   *
+   *     // Then perform selection
+   *     this.selectionModel.selectRow(rowIndex);
+   *   }
+   * }
+   *
+   * @throws {Error} Implicitly may throw if rowIndex is not a number or if required properties are undefined
+   *
+   * @see {@link scrollToIndex} - The underlying method used for scrolling
+   * @see {@link getDisplayedRowCount} - Related method for getting visible row count
+   */
+  ensureRowIsVisible(e) {
+    return this.tableScope.ensureRowIsVisible(e);
+  }
+  /**
+   * Retrieves the number of rows currently displayed in the table.
+   *
+   * @description
+   * This method returns the count of rows that are currently visible in the table after
+   * applying any filtering, pagination, or other visibility constraints.
+   * 
+   * @return {number} The number of rows currently displayed in the table.
+   */
   getDisplayedRowCount() {
     return this.tableScope.getDisplayedRowCount();
   }
+  /**
+   * Returns the index of the first visible row in the table's viewport.
+   *
+   * This method retrieves the first visible row index from the table's scope, which is useful
+   * for virtual scrolling and viewport-related calculations. The index represents the topmost
+   * visible row in the current scroll position of the table.
+   *
+   * This value is maintained internally by the table and updated during scrolling operations.
+   * It's particularly important for:
+   * - Virtual scrolling optimization
+   * - Calculating visible range of rows
+   * - Viewport-related operations
+   * - Scroll position restoration
+   *
+   * @returns {number} The index of the first visible row in the table's viewport.
+   *                   Returns -1 if no rows are visible or if the table is not yet rendered.
+   *
+   * @example
+   * ```typescript
+   * // Get the first visible row index
+   * const tableApi = new TableApi(tableScope);
+   * const firstVisibleIndex = tableApi.getFirstVisibleRowIndex();
+   *
+   * // Use the index for scroll position calculations
+   * if (firstVisibleIndex >= 0) {
+   *   // Perform operations with the first visible row
+   *   console.log(`First visible row index: ${firstVisibleIndex}`);
+   * }
+   * ```
+   */
+  getFirstVisibleRowIndex() {
+    return this.tableScope.getFirstVisibleRowIndex();
+  }
 }
 class z {
   constructor(e) {
@@ -1214,7 +1656,7 @@ class Se {
     this.dom.setStyle(this.contentWrapperDiv, "width", e), this.dom.setStyle(this.contentWrapperDiv, "height", t);
   }
 }
-class E {
+class A {
   /**
    * Represents a constructor for a class.
    * @constructor
@@ -1228,7 +1670,7 @@ class E {
     this.r1 = e, this.c1 = t, this.r2 = s, this.c2 = o, this.gammaRange = i;
   }
   static create(e) {
-    return e.gammaRange === void 0 && (e.gammaRange = !1), new E(
+    return e.gammaRange === void 0 && (e.gammaRange = !1), new A(
       e.rowIndex1,
       e.columnIndex1,
       e.rowIndex2,
@@ -1237,13 +1679,13 @@ class E {
     );
   }
   static singleCell(e, t) {
-    return new E(e, t, e, t);
+    return new A(e, t, e, t);
   }
   static singleRow(e) {
-    return new E(e, 0, e, Number.MAX_SAFE_INTEGER);
+    return new A(e, 0, e, Number.MAX_SAFE_INTEGER);
   }
   static singleColumn(e) {
-    return new E(0, e, Number.MAX_SAFE_INTEGER, e);
+    return new A(0, e, Number.MAX_SAFE_INTEGER, e);
   }
   isInRange(e, t) {
     return e >= this.r1 && e <= this.r2 && t >= this.c1 && t <= this.c2;
@@ -1265,7 +1707,7 @@ class ye {
           i === 0 && (i = 1), r === 0 && (r = 1);
           const l = "gammaCells" in this.areaModel;
           this.colAndRowspanRanges.push(
-            new E(s, o, s + r - 1, o + i - 1, l)
+            new A(s, o, s + r - 1, o + i - 1, l)
           );
         }
       }
@@ -1282,19 +1724,19 @@ class ye {
     return !1;
   }
 }
-class xe {
+class we {
   constructor(e, t, s) {
     this.header = e, this.body = t, this.footer = s;
   }
 }
-class we extends Se {
+class xe extends Se {
   constructor(e, t, s, o) {
     var r, l;
     super(e, t, s, o), this.dragging = !1, this.editing = !1, this.storedColumnWidths = [], this.scrollLeft = 0, this.scrollViewportLeft = 0, this.scrollFactorY = 0, this.scrollFactorX = 0, this.cleanupFunctions = {
       header: [],
       body: [],
       footer: []
-    }, this.tree = !1, this.colAndRowspanModels = new xe(), this.firstVisibleRowIndex = -1, this.draggingTargetColumnIndex = -1, this.removables = [], this.displayedRowCount = 0, this.tableModel.getSelectionModel ? this.getSelectionModel = this.tableModel.getSelectionModel : (r = this.tableOptions) != null && r.getSelectionModel && (this.getSelectionModel = this.tableOptions.getSelectionModel), (l = this.tableOptions) != null && l.getFocusModel && (this.getFocusModel = this.tableOptions.getFocusModel), V(t.getAreaModel("body")) && (this.tree = !0), ["header", "body", "footer"].forEach(
+    }, this.tree = !1, this.colAndRowspanModels = new we(), this.firstVisibleRowIndex = -1, this.draggingTargetColumnIndex = -1, this.removables = [], this.displayedRowCount = 0, this.tableModel.getSelectionModel ? this.getSelectionModel = this.tableModel.getSelectionModel : (r = this.tableOptions) != null && r.getSelectionModel && (this.getSelectionModel = this.tableOptions.getSelectionModel), (l = this.tableOptions) != null && l.getFocusModel && (this.getFocusModel = this.tableOptions.getFocusModel), V(t.getAreaModel("body")) && (this.tree = !0), ["header", "body", "footer"].forEach(
       (a) => {
         var n;
         this.colAndRowspanModels[a] = new ye(t, t.getAreaModel(a)), (n = this.colAndRowspanModels[a]) == null || n.init();
@@ -1559,38 +2001,38 @@ class we extends Se {
     let d = t;
     const u = this.tableModel.getColumnCount(), g = this.tableModel.getFixedRightColumnCount(), b = this.tableModel.getFixedLeftColumnCount();
     for (let m = 0; m < h; m++) {
-      const x = d, S = m === h - 1, v = this.tableModel.getRowHeight(e, m);
-      if (x + v > 0) {
+      const w = d, S = m === h - 1, v = this.tableModel.getRowHeight(e, m);
+      if (w + v > 0) {
         this.firstVisibleRowIndex = m;
-        let w = { left: l, width: a, height: v, top: x, index: m }, y = this.dom.addRowDiv(o, w, m, e, "center");
+        let x = { left: l, width: a, height: v, top: w, index: m }, y = this.dom.addRowDiv(o, x, m, e, "center");
         const M = b;
         if (this.adjustColumnsToRowParent({
           areaIdent: e,
           sideIdent: "center",
           areaModel: c,
-          geo: w,
+          geo: x,
           parent: y,
           rowIndex: m,
           columnIndexStart: M,
           columnIndexEnd: u - g - 1,
           verticalFixed: !1,
           lastRowOfModel: S
-        }), n.left > 0 && (w = { left: l, width: this.areaBodyWestGeo.width, height: v, top: x, index: m }, y = this.dom.addRowDiv(s, w, m, e, "west"), this.adjustColumnsToRowParent({
+        }), n.left > 0 && (x = { left: l, width: this.areaBodyWestGeo.width, height: v, top: w, index: m }, y = this.dom.addRowDiv(s, x, m, e, "west"), this.adjustColumnsToRowParent({
           areaIdent: e,
           sideIdent: "west",
           areaModel: c,
-          geo: w,
+          geo: x,
           parent: y,
           rowIndex: m,
           columnIndexStart: 0,
           columnIndexEnd: M - 1,
           verticalFixed: !0,
           lastRowOfModel: S
-        })), n.right > 0 && (w = { left: l, width: this.areaBodyEastGeo.width, height: v, top: x, index: m }, y = this.dom.addRowDiv(i, w, m, e, "east"), this.adjustColumnsToRowParent({
+        })), n.right > 0 && (x = { left: l, width: this.areaBodyEastGeo.width, height: v, top: w, index: m }, y = this.dom.addRowDiv(i, x, m, e, "east"), this.adjustColumnsToRowParent({
           areaIdent: e,
           sideIdent: "east",
           areaModel: c,
-          geo: w,
+          geo: x,
           parent: y,
           rowIndex: m,
           columnIndexStart: u - g,
@@ -1598,7 +2040,7 @@ class we extends Se {
           verticalFixed: !0,
           lastRowOfModel: S
         })), e === "header" && this.tree && m === h - 1) {
-          const A = this.dom.applyStyle(
+          const E = this.dom.applyStyle(
             this.dom.setAttribute(
               this.dom.addDiv(y, new T(16, 20, 20, 8)),
               "data-ge-action",
@@ -1607,8 +2049,8 @@ class we extends Se {
             { cursor: "pointer" }
           ), R = this.tableOptions.treeOptions.arrowExpandCollapseAll;
           if (R) {
-            const O = this.dom.domService.createText(R.content);
-            this.dom.domService.appendChild(A, O), R.style && this.dom.applyStyleString(A, R.style);
+            const L = this.dom.domService.createText(R.content);
+            this.dom.domService.appendChild(E, L), R.style && this.dom.applyStyleString(E, R.style);
           }
         }
       }
@@ -1620,17 +2062,17 @@ class we extends Se {
     if (this.colAndRowspanModels && this.colAndRowspanModels[e]) {
       const m = ((f = this.colAndRowspanModels[e]) == null ? void 0 : f.getRanges()) ?? [];
       if (m.length)
-        for (const x of m) {
-          let S = 0, v = o.child, w = "center";
-          if (x.c1 < b)
-            v = s.child, w = "west";
-          else if (g > 0 && x.c1 >= u - g)
-            v = i.child, w = "east";
+        for (const w of m) {
+          let S = 0, v = o.child, x = "center";
+          if (w.c1 < b)
+            v = s.child, x = "west";
+          else if (g > 0 && w.c1 >= u - g)
+            v = i.child, x = "east";
           else {
             const y = this.areaBodyCenterGeo.width - this.tableModel.getContentWidthInPixel();
-            S = this.scrollFactorX * y - this.areaBodyWestGeo.width, w = "center";
+            S = this.scrollFactorX * y - this.areaBodyWestGeo.width, x = "center";
           }
-          this.drawBigCell(x, S, t, c, v, w);
+          this.drawBigCell(w, S, t, c, v, x);
         }
     }
   }
@@ -1738,20 +2180,20 @@ class we extends Se {
     const d = 0, u = !!(e === "body" && t);
     let g = h;
     for (let f = l; f <= a; f++) {
-      const m = g, x = this.tableModel.getColumnWidth(f);
-      if (x > 0 && m + x > 0) {
+      const m = g, w = this.tableModel.getColumnWidth(f);
+      if (w > 0 && m + w > 0) {
         let S = o.height;
-        const v = s.getRowspanAt(r, f), w = s.getColspanAt(r, f);
-        v > 1 && (S = this.getRowHeights(r, r + v - 1, s).reduce((A, R) => A + R, 0));
-        let y = x;
-        w > 1 && (y = this.getColumnWidths(f, f + w - 1).reduce((A, R) => A + R, 0));
+        const v = s.getRowspanAt(r, f), x = s.getColspanAt(r, f);
+        v > 1 && (S = this.getRowHeights(r, r + v - 1, s).reduce((E, R) => E + R, 0));
+        let y = w;
+        x > 1 && (y = this.getColumnWidths(f, f + x - 1).reduce((E, R) => E + R, 0));
         let M = !1;
         if (this.colAndRowspanModels && this.colAndRowspanModels[e] && (b = this.colAndRowspanModels[e]) != null && b.isInRange(r, f) && (M = !0), this.draggingTargetColumnIndex === f && e !== "header") {
           this.renderDragTargetDiv(i, m, d, y, S);
-          const A = { left: m, top: d, width: y, height: S };
-          this.dom.addColumnBorderDivs(this.tableOptions, i, A, e, t);
+          const E = { left: m, top: d, width: y, height: S };
+          this.dom.addColumnBorderDivs(this.tableOptions, i, E, e, t);
         } else {
-          const A = this.renderSelectedBackgroundDiv(M, u, t, s, r, f, i, m, d, y, S);
+          const E = this.renderSelectedBackgroundDiv(M, u, t, s, r, f, i, m, d, y, S);
           "gammaCells" in s && s.getValueAt(r, f) && (M = !1), M || this.renderCell({
             areaModel: s,
             areaIdent: e,
@@ -1763,7 +2205,7 @@ class we extends Se {
             width: y,
             height: S,
             parent: i,
-            cellSelected: A,
+            cellSelected: E,
             lastRowOfModel: c,
             gammaRange: !0
           }), e === "header" && this.tableOptions.columnsResizable && this.renderHeaderCellResizeHandle({
@@ -1777,7 +2219,7 @@ class we extends Se {
           });
         }
       }
-      if (g = g + x, g > this.areaBodyCenterGeo.width)
+      if (g = g + w, g > this.areaBodyCenterGeo.width)
         break;
     }
     this.tableOptions.verticalBorderVisible && this.dom.addVerticalBorder(new T(g - 1, 1, o.height, 0), i);
@@ -1814,12 +2256,12 @@ class we extends Se {
       const C = b;
       (j = C.children) != null && j.length ? C.expanded ? f = "expanded" : f = "collapsed" : f = "hidden";
     }
-    let x;
+    let w;
     if (t === "header") {
       const C = this.tableModel.getColumnDef(i);
-      (!(C != null && C.sortIconVisible) || C != null && C.sortIconVisible()) && (x = C == null ? void 0 : C.sortState);
+      (!(C != null && C.sortIconVisible) || C != null && C.sortIconVisible()) && (w = C == null ? void 0 : C.sortState);
     }
-    const S = e.getValueAt(o, i), v = u ? "" : `${S}`, w = e.isRowChecked(o), y = this.dom.addColumnDiv(
+    const S = e.getValueAt(o, i), v = u ? "" : `${S}`, x = e.isRowChecked(o), y = this.dom.addColumnDiv(
       {
         parent: c,
         geo: g,
@@ -1830,17 +2272,17 @@ class we extends Se {
         text: v,
         treeArrow: f,
         tableOptions: this.tableOptions,
-        checkedType: w,
-        sortState: x
+        checkedType: x,
+        sortState: w
       }
     ), M = e.getTooltipAt(o, i);
     M && this.dom.setAttribute(y, "title", M);
-    const A = this.tableModel.getColumnDef(i);
-    A && A.classes[t] && this.dom.addClasses(A.classes[t], y);
+    const E = this.tableModel.getColumnDef(i);
+    E && E.classes[t] && this.dom.addClasses(E.classes[t], y);
     let R;
     u && (R = u.render(y, o, i, t, e, S, this.dom.domService));
-    const O = e.getCustomClassesAt(o, i);
-    if (O.length && this.dom.addClasses(O, y), this.dom.addColumnBorderDivs(this.tableOptions, c, g, t, s), h && this.dom.addHorizontalBorder({ left: r, width: l, height: a, top: n + a }, c), this.getFocusModel && t === "body") {
+    const L = e.getCustomClassesAt(o, i);
+    if (L.length && this.dom.addClasses(L, y), this.dom.addColumnBorderDivs(this.tableOptions, c, g, t, s), h && this.dom.addHorizontalBorder({ left: r, width: l, height: a, top: n + a }, c), this.getFocusModel && t === "body") {
       const C = this.getFocusModel();
       C != null && C.hasFocus(o, i) && this.dom.addFocusBorderDivs(c, g, {});
     }
@@ -2024,16 +2466,16 @@ class we extends Se {
           sideIdent: o,
           text: b
         }, m = this.dom.addColumnDiv(f);
-        let x;
-        g && (x = g.render(m, n, l, t, i, u, this.dom.domService), x && this.cleanupFunctions[t].push(x));
+        let w;
+        g && (w = g.render(m, n, l, t, i, u, this.dom.domService), w && this.cleanupFunctions[t].push(w));
         const S = i.getCustomClassesAt(n, l);
         S.length && this.dom.addClasses(S, m);
         const v = this.tableModel.getColumnDef(l);
         v && v.classes[t] && this.dom.addClasses(v.classes[t], m), this.dom.addColumnBorderDivs(this.tableOptions, a, d, t, o);
-        const w = i.getCustomStyleAt(n, l);
-        if (w)
-          for (const y in w)
-            this.dom.setStyle(m, y, w[y]);
+        const x = i.getCustomStyleAt(n, l);
+        if (x)
+          for (const y in x)
+            this.dom.setStyle(m, y, x[y]);
         s = s + h;
       }
     }
@@ -2195,7 +2637,7 @@ class ve {
     }
   }
 }
-class Ee {
+class Ae {
   constructor(e = -1, t = -1) {
     this.rowIndex = e, this.columnIndex = t;
   }
@@ -2205,10 +2647,10 @@ class G {
     this.cells = e;
   }
   static createSingle(e, t) {
-    return new G([new Ee(e, t)]);
+    return new G([new Ae(e, t)]);
   }
 }
-class Ae {
+class Ee {
   constructor(e) {
     var t, s;
     this.tableScope = e, (t = this.tableScope.tableOptions) != null && t.getSelectionModel && (this.getSelectionModel = this.tableScope.tableOptions.getSelectionModel), (s = this.tableScope.tableOptions) != null && s.getFocusModel && (this.getFocusModel = this.tableScope.tableOptions.getFocusModel);
@@ -2218,7 +2660,7 @@ class Ae {
     let s = !1, o = !1;
     if (this.getSelectionModel && this.getFocusModel) {
       const d = this.getSelectionModel(), u = this.getFocusModel();
-      d && u && (u.hasFocus(e.rowIndex, e.columnIndex) || (u.setFocus(e.rowIndex, e.columnIndex), this.tableScope.onFocusChanged(u), s = !0), (i = e.originalEvent) != null && i.shiftKey || d.hasSelection() && (d.clear(), s = !0), (r = e.originalEvent) != null && r.shiftKey && this.previousEvt ? (d.addSelection(this.createRangeByEvents(e, this.previousEvt)), o = !0, s = !0) : (l = e.originalEvent) != null && l.altKey && ((a = e.originalEvent) != null && a.ctrlKey || (n = e.originalEvent) != null && n.metaKey) ? (d.removeSelection(E.singleCell(e.rowIndex, e.columnIndex)), o = !0, s = !0) : (c = e.originalEvent) != null && c.ctrlKey || (h = e.originalEvent) != null && h.metaKey ? (d.addSelection(E.singleCell(e.rowIndex, e.columnIndex)), o = !0, s = !0) : (d.firstClick(e.rowIndex, e.columnIndex), s = !0), this.tableScope.onSelectionChanged(d));
+      d && u && (u.hasFocus(e.rowIndex, e.columnIndex) || (u.setFocus(e.rowIndex, e.columnIndex), this.tableScope.onFocusChanged(u), s = !0), (i = e.originalEvent) != null && i.shiftKey || d.hasSelection() && (d.clear(), s = !0), (r = e.originalEvent) != null && r.shiftKey && this.previousEvt ? (d.addSelection(this.createRangeByEvents(e, this.previousEvt)), o = !0, s = !0) : (l = e.originalEvent) != null && l.altKey && ((a = e.originalEvent) != null && a.ctrlKey || (n = e.originalEvent) != null && n.metaKey) ? (d.removeSelection(A.singleCell(e.rowIndex, e.columnIndex)), o = !0, s = !0) : (c = e.originalEvent) != null && c.ctrlKey || (h = e.originalEvent) != null && h.metaKey ? (d.addSelection(A.singleCell(e.rowIndex, e.columnIndex)), o = !0, s = !0) : (d.firstClick(e.rowIndex, e.columnIndex), s = !0), this.tableScope.onSelectionChanged(d));
     }
     return o ? this.previousEvt = void 0 : this.previousEvt = e == null ? void 0 : e.clone(), s;
   }
@@ -2241,7 +2683,7 @@ class Ae {
   createRangeByEvents(e, t) {
     t || (t = e);
     const s = Math.min(e.rowIndex, t == null ? void 0 : t.rowIndex), o = Math.max(e.rowIndex, t == null ? void 0 : t.rowIndex), i = Math.min(e.columnIndex, t == null ? void 0 : t.columnIndex), r = Math.max(e.columnIndex, t == null ? void 0 : t.columnIndex);
-    return E.create({
+    return A.create({
       rowIndex1: s,
       columnIndex1: i,
       rowIndex2: o,
@@ -2449,7 +2891,7 @@ class ee {
     e.setAttribute(t, s);
   }
 }
-class ke {
+class Fe {
   render(e, t, s, o, i, r, l) {
     if (i.isEditable(t, s)) {
       l.addClass(e, "ge-table-row-input-div");
@@ -2470,7 +2912,7 @@ class ke {
     }
   }
 }
-class Fe {
+class ke {
   constructor(e = "none", t = "single") {
     this.selectionType = e, this.selectionMode = t, this.ranges = [], this.negativeRanges = [], this.allSelected = !1, this.silent = !1, this.listenerArr = [];
   }
@@ -2489,7 +2931,7 @@ class Fe {
     this.silent || this.listenerArr.forEach((e) => e.onSelectionChanged(this));
   }
   firstClick(e, t) {
-    this.selectionType === "row" ? this.addRange(E.singleRow(e)) : this.selectionType === "column" && this.addRange(E.singleColumn(t));
+    this.selectionType === "row" ? this.addRange(A.singleRow(e)) : this.selectionType === "column" && this.addRange(A.singleColumn(t));
   }
   getSelectionCount(e, t) {
     let s = 0;
@@ -2540,10 +2982,10 @@ class Fe {
     if (this.selectionType === "none")
       return;
     let t = e;
-    this.selectionType === "row" ? t = E.singleRow(e.r1) : this.selectionType === "column" && (t = E.singleColumn(e.c1)), this.negativeRanges.push(t), this.fireChangeEvent();
+    this.selectionType === "row" ? t = A.singleRow(e.r1) : this.selectionType === "column" && (t = A.singleColumn(e.c1)), this.negativeRanges.push(t), this.fireChangeEvent();
   }
   togglePoint(e, t) {
-    this.getSelectionCount(e, t) > 0 ? this.removeSelection(E.singleCell(e, t)) : this.addSelection(E.singleCell(e, t));
+    this.getSelectionCount(e, t) > 0 ? this.removeSelection(A.singleCell(e, t)) : this.addSelection(A.singleCell(e, t));
   }
   isSelected(e, t) {
     return this.getSelectionCount(e, t) > 0;
@@ -2603,17 +3045,17 @@ class te {
   }
   // `⊖ `,  `⊕ `;
 }
-const Le = new Fe(), Oe = new Ie("cell");
+const Oe = new ke(), Le = new Ie("cell");
 class se {
   constructor() {
     this.overflowX = "auto", this.overflowY = "auto", this.horizontalBorderVisible = !0, this.verticalBorderVisible = !0, this.footerSeparatorBorderVisible = !0, this.headerSeparatorBorderVisible = !0, this.fixedEastSeparatorBorderVisible = !0, this.fixedWestSeparatorBorderVisible = !0, this.tableTopBorderVisible = !0, this.tableBottomBorderVisible = !0, this.hoverRowVisible = !0, this.hoverColumnVisible = !0, this.columnsResizable = !0, this.columnsDraggable = !0, this.columnResizeHandleWidthInPx = 4, this.defaultRowHeights = {
       header: 34,
       body: 34,
       footer: 34
-    }, this.footerVerticalSeparator = !1, this.headerToggleExpandCollapseIcons = !1, this.headerVerticalSeparator = !1, this.treeOptions = new Z(), this.headerGroupOptions = new te(), this.showCheckboxWihoutExtraColumn = !1, this.externalFilterFunction = void 0, this.sortedOptions = new Q(), this.sortOrder = ["asc", "desc"], this.shortcutActionsDisabled = !1, this.resizeEventDebounceDelay = 500, this.getEditRenderer = (e, t) => new ke(), this.getSelectionModel = () => Le, this.getFocusModel = () => Oe;
+    }, this.footerVerticalSeparator = !1, this.headerToggleExpandCollapseIcons = !1, this.headerVerticalSeparator = !1, this.treeOptions = new Z(), this.headerGroupOptions = new te(), this.showCheckboxWihoutExtraColumn = !1, this.externalFilterFunction = void 0, this.sortedOptions = new Q(), this.sortOrder = ["asc", "desc"], this.shortcutActionsDisabled = !1, this.resizeEventDebounceDelay = 500, this.getEditRenderer = (e, t) => new Fe(), this.getSelectionModel = () => Oe, this.getFocusModel = () => Le;
   }
 }
-const L = class L {
+const O = class O {
   /**
    * Returns the content to be copied based on the provided table model, selection model, and focus model.
    *
@@ -2636,9 +3078,9 @@ const L = class L {
               const h = t.isSelected(a, c) ? e.getBodyModel().getTextValueAt(a, c) : "";
               n.push(h);
             }
-            l.push(n.join(L.columnSeparatorChar));
+            l.push(n.join(O.columnSeparatorChar));
           }
-          return o(l.join(L.rowSeparatorChar));
+          return o(l.join(O.rowSeparatorChar));
         }
       }
       if (s) {
@@ -2691,13 +3133,13 @@ const L = class L {
   mergeRanges(e) {
     let t;
     for (const s of e)
-      t ? (t.r1 = Math.min(t.r1, s.r1), t.c1 = Math.min(t.c1, s.c1), t.r2 = Math.max(t.r2, s.r2), t.c2 = Math.max(t.c2, s.c2)) : t = new E(s.r1, s.c1, s.r2, s.c2);
+      t ? (t.r1 = Math.min(t.r1, s.r1), t.c1 = Math.min(t.c1, s.c1), t.r2 = Math.max(t.r2, s.r2), t.c2 = Math.max(t.c2, s.c2)) : t = new A(s.r1, s.c1, s.r2, s.c2);
     return t;
   }
 };
-L.columnSeparatorChar = "	", L.rowSeparatorChar = `
+O.columnSeparatorChar = "	", O.rowSeparatorChar = `
 `;
-let P = L;
+let P = O;
 class Be {
   constructor(e, t = 500) {
     this.tableScope = e, this.debounceDelay = t, new ResizeObserver(le(this.handleResize.bind(this), t)).observe(this.tableScope.hostElement);
@@ -2813,10 +3255,10 @@ class Pe {
     return this.createZip(s);
   }
 }
-class U extends we {
+class U extends xe {
   constructor(e, t, s, o, i, r = new P(), l = new Pe()) {
     var c;
-    if (super(e, t, new ne(s), o), this.eventListener = i, this.copyService = r, this.excelService = l, this.licenseManager = k.getInstance(), this.selectionService = new Ae(this), this.api = new ge(this), this.mouseStartAction = "", this.mouseStartWidth = -1, this.mouseStartColumnIndex = -1, this.dragFrom = -1, this.dragTo = -1, this.lastDragFrom = -1, this.lastDragTo = -1, this.firstDraggingRendering = !0, this.lastContextmenu = Date.now(), t.setTableScope(this), i || (this.eventListener = new K()), (c = this.tableOptions) != null && c.autoRestoreOptions) {
+    if (super(e, t, new ne(s), o), this.eventListener = i, this.copyService = r, this.excelService = l, this.licenseManager = k.getInstance(), this.selectionService = new Ee(this), this.api = new ge(this), this.mouseStartAction = "", this.mouseStartWidth = -1, this.mouseStartColumnIndex = -1, this.dragFrom = -1, this.dragTo = -1, this.lastDragFrom = -1, this.lastDragTo = -1, this.firstDraggingRendering = !0, this.lastContextmenu = Date.now(), t.setTableScope(this), i || (this.eventListener = new K()), (c = this.tableOptions) != null && c.autoRestoreOptions) {
       const h = this.tableOptions.autoRestoreOptions, d = h.getStorageKeyFn;
       d && (h.autoRestoreScrollPosition && (this.storeScrollPosStateService = new fe(d)), h.autoRestoreCollapsedExpandedState && (this.storeStateCollapsedExpandService = new me(d)), h.autoRestoreSortingState && (this.storeSortingService = new be(d)));
     }
@@ -3238,9 +3680,70 @@ class U extends we {
     let e = ((t = this.storeSortingService) == null ? void 0 : t.getSortItems()) ?? [];
     this.tableModel.doSort(e);
   }
+  sort(e) {
+    this.tableModel.sort(e);
+  }
   getDisplayedRowCount() {
     return this.displayedRowCount;
   }
+  /**
+   * Ensures that a specific row is visible in the viewport by scrolling if necessary.
+   * This method checks if the target row is within the currently visible range and
+   * adjusts the scroll position if it's not visible.
+   *
+   * The method performs the following:
+   * 1. Checks if the row is above the current viewport (before first visible row)
+   * 2. Checks if the row is below the current viewport (after last visible row)
+   * 3. Scrolls to make the row visible if needed
+   *
+   * @param {number} rowIndex - The index of the row to make visible
+   * @returns {boolean} Returns true if scrolling was needed and performed, false if the row was already visible
+   *
+   * @example
+   * // Ensure row 5 is visible in the viewport
+   * tableScope.ensureRowIsVisible(5);
+   *
+   * @example
+   * // Example usage in a component
+   * class MyTableComponent {
+   *   private tableScope: TableScope;
+   *
+   *   scrollToSpecificRow(rowIndex: number) {
+   *     // This will scroll the row into view if it's not visible
+   *     const didScroll = this.tableScope.ensureRowIsVisible(rowIndex);
+   *
+   *     if (didScroll) {
+   *       console.log(`Table scrolled to show row ${rowIndex}`);
+   *     } else {
+   *       console.log(`Row ${rowIndex} was already visible`);
+   *     }
+   *   }
+   * }
+   *
+   * @example
+   * // Example with row selection
+   * class TableHandler {
+   *   selectAndShowRow(rowIndex: number) {
+   *     // First ensure the row is visible
+   *     this.tableScope.ensureRowIsVisible(rowIndex);
+   *
+   *     // Then perform selection
+   *     this.selectionModel.selectRow(rowIndex);
+   *   }
+   * }
+   *
+   * @throws {Error} Implicitly may throw if rowIndex is not a number or if required properties are undefined
+   *
+   * @see {@link scrollToIndex} - The underlying method used for scrolling
+   * @see {@link getDisplayedRowCount} - Related method for getting visible row count
+   */
+  ensureRowIsVisible(e) {
+    const t = this.firstVisibleRowIndex, s = this.firstVisibleRowIndex + this.displayedRowCount - 1;
+    return e < t ? (this.scrollToIndex(0, e), !0) : e > s ? (this.scrollToIndex(0, e - this.displayedRowCount + 1), !0) : !1;
+  }
+  getFirstVisibleRowIndex() {
+    return this.firstVisibleRowIndex;
+  }
 }
 const W = class W {
 };
@@ -3569,14 +4072,14 @@ function Ne({
       onMouseMoved: (S) => {
         t && t(S);
       }
-    }, x = new U(
+    }, w = new U(
       f,
       p,
       new ee(),
       e,
       m
     );
-    x.firstInit(), h && h(x.getApi()), d && k.getInstance().setLicenseKey(d);
+    w.firstInit(), h && h(w.getApi()), d && k.getInstance().setLicenseKey(d);
   };
   return /* @__PURE__ */ oe(
     "div",