@guiexpert/solid-table 1.1.72 → 1.1.75

package/index.js

@@ -1,36 +1,36 @@
-const Fe = (l, e) => l === e, oe = Symbol("solid-proxy"), Ie = typeof Proxy == "function", fe = {
-  equals: Fe
+const ke = (l, e) => l === e, oe = Symbol("solid-proxy"), Ie = typeof Proxy == "function", fe = {
+  equals: ke
 };
-let we = ve;
-const L = 1, z = 2, xe = {
+let we = Ce;
+const B = 1, z = 2, xe = {
   owned: null,
   cleanups: null,
   context: null,
   owner: null
 };
-var R = null;
-let te = null, Oe = null, x = null, M = null, O = null, Z = 0;
+var M = null;
+let te = null, Oe = null, x = null, R = null, O = null, Z = 0;
 function Le(l, e) {
-  const t = x, s = R, o = l.length === 0, i = e === void 0 ? s : e, r = o ? xe : {
+  const t = x, s = M, o = l.length === 0, i = e === void 0 ? s : e, r = o ? xe : {
     owned: null,
     cleanups: null,
     context: i ? i.context : null,
     owner: i
   }, a = o ? l : () => l(() => Q(() => $(r)));
-  R = r, x = null;
+  M = r, x = null;
   try {
     return _(a, !0);
   } finally {
-    x = t, R = s;
+    x = t, M = s;
   }
 }
 function ie(l, e, t) {
-  const s = ae(l, e, !1, L);
+  const s = ae(l, e, !1, B);
   V(s);
 }
 function Be(l, e, t) {
   we = Ne;
-  const s = ae(l, e, !1, L);
+  const s = ae(l, e, !1, B);
   s.user = !0, O ? O.push(s) : V(s);
 }
 function Pe(l, e, t) {
@@ -53,10 +53,10 @@ function We(l) {
 }
 function He() {
   if (this.sources && this.state)
-    if (this.state === L) V(this);
+    if (this.state === B) V(this);
     else {
-      const l = M;
-      M = null, _(() => j(this), !1), M = l;
+      const l = R;
+      R = null, _(() => j(this), !1), R = l;
     }
   if (x) {
     const l = this.observers ? this.observers.length : 0;
@@ -69,10 +69,10 @@ function $e(l, e, t) {
   return (!l.comparator || !l.comparator(s, e)) && (l.value = e, l.observers && l.observers.length && _(() => {
     for (let o = 0; o < l.observers.length; o += 1) {
       const i = l.observers[o], r = te && te.running;
-      r && te.disposed.has(i), (r ? !i.tState : !i.state) && (i.pure ? M.push(i) : O.push(i), i.observers && Ce(i)), r || (i.state = L);
+      r && te.disposed.has(i), (r ? !i.tState : !i.state) && (i.pure ? R.push(i) : O.push(i), i.observers && ve(i)), r || (i.state = B);
     }
-    if (M.length > 1e6)
-      throw M = [], new Error();
+    if (R.length > 1e6)
+      throw R = [], new Error();
   }, !1)), e;
 }
 function V(l) {
@@ -87,18 +87,18 @@ function V(l) {
 }
 function Ve(l, e, t) {
   let s;
-  const o = R, i = x;
-  x = R = l;
+  const o = M, i = x;
+  x = M = l;
   try {
     s = l.fn(e);
   } catch (r) {
-    return l.pure && (l.state = L, l.owned && l.owned.forEach($), l.owned = null), l.updatedAt = t + 1, Ee(r);
+    return l.pure && (l.state = B, l.owned && l.owned.forEach($), l.owned = null), l.updatedAt = t + 1, Ae(r);
   } finally {
-    x = i, R = o;
+    x = i, M = o;
   }
   (!l.updatedAt || l.updatedAt <= t) && (l.updatedAt != null && "observers" in l ? $e(l, s) : l.value = s, l.updatedAt = t);
 }
-function ae(l, e, t, s = L, o) {
+function ae(l, e, t, s = B, o) {
   const i = {
     fn: l,
     state: s,
@@ -108,11 +108,11 @@ function ae(l, e, t, s = L, o) {
     sourceSlots: null,
     cleanups: null,
     value: e,
-    owner: R,
-    context: R ? R.context : null,
+    owner: M,
+    context: M ? M.context : null,
     pure: t
   };
-  return R === null || R !== xe && (R.owned ? R.owned.push(i) : R.owned = [i]), i;
+  return M === null || M !== xe && (M.owned ? M.owned.push(i) : M.owned = [i]), i;
 }
 function U(l) {
   if (l.state === 0) return;
@@ -122,30 +122,30 @@ function U(l) {
   for (; (l = l.owner) && (!l.updatedAt || l.updatedAt < Z); )
     l.state && e.push(l);
   for (let t = e.length - 1; t >= 0; t--)
-    if (l = e[t], l.state === L)
+    if (l = e[t], l.state === B)
       V(l);
     else if (l.state === z) {
-      const s = M;
-      M = null, _(() => j(l, e[0]), !1), M = s;
+      const s = R;
+      R = null, _(() => j(l, e[0]), !1), R = s;
     }
 }
 function _(l, e) {
-  if (M) return l();
+  if (R) return l();
   let t = !1;
-  e || (M = []), O ? t = !0 : O = [], Z++;
+  e || (R = []), O ? t = !0 : O = [], Z++;
   try {
     const s = l();
     return _e(t), s;
   } catch (s) {
-    t || (O = null), M = null, Ee(s);
+    t || (O = null), R = null, Ae(s);
   }
 }
 function _e(l) {
-  if (M && (ve(M), M = null), l) return;
+  if (R && (Ce(R), R = null), l) return;
   const e = O;
   O = null, e.length && _(() => we(e), !1);
 }
-function ve(l) {
+function Ce(l) {
   for (let e = 0; e < l.length; e++) U(l[e]);
 }
 function Ne(l) {
@@ -162,14 +162,14 @@ function j(l, e) {
     const s = l.sources[t];
     if (s.sources) {
       const o = s.state;
-      o === L ? s !== e && (!s.updatedAt || s.updatedAt < Z) && U(s) : o === z && j(s, e);
+      o === B ? s !== e && (!s.updatedAt || s.updatedAt < Z) && U(s) : o === z && j(s, e);
     }
   }
 }
-function Ce(l) {
+function ve(l) {
   for (let e = 0; e < l.observers.length; e += 1) {
     const t = l.observers[e];
-    t.state || (t.state = z, t.pure ? M.push(t) : O.push(t), t.observers && Ce(t));
+    t.state || (t.state = z, t.pure ? R.push(t) : O.push(t), t.observers && ve(t));
   }
 }
 function $(l) {
@@ -201,7 +201,7 @@ function Ge(l) {
     cause: l
   });
 }
-function Ee(l, e = R) {
+function Ae(l, e = M) {
   throw Ge(l);
 }
 function G() {
@@ -240,7 +240,7 @@ function Ue() {
     if (t !== void 0) return t;
   }
 }
-function Ae(...l) {
+function Ee(...l) {
   let e = !1;
   for (let r = 0; r < l.length; r++) {
     const a = l[r];
@@ -368,11 +368,11 @@ function X(l, e, t, s, o) {
       return t;
     if (r) {
       let a = t[0];
-      a && a.nodeType === 3 ? a.data !== e && (a.data = e) : a = document.createTextNode(e), t = P(l, t, s, a);
+      a && a.nodeType === 3 ? a.data !== e && (a.data = e) : a = document.createTextNode(e), t = W(l, t, s, a);
     } else
       t !== "" && typeof t == "string" ? t = l.firstChild.data = e : t = l.textContent = e;
   } else if (e == null || i === "boolean")
-    t = P(l, t, s);
+    t = W(l, t, s);
   else {
     if (i === "function")
       return ie(() => {
@@ -385,13 +385,13 @@ function X(l, e, t, s, o) {
       if (re(a, e, t, o))
         return ie(() => t = X(l, a, t, s, !0)), () => t;
       if (a.length === 0) {
-        if (t = P(l, t, s), r) return t;
-      } else n ? t.length === 0 ? ue(l, a, s) : je(l, t, a) : (t && P(l), ue(l, a));
+        if (t = W(l, t, s), r) return t;
+      } else n ? t.length === 0 ? ue(l, a, s) : je(l, t, a) : (t && W(l), ue(l, a));
       t = a;
     } else if (e.nodeType) {
       if (Array.isArray(t)) {
-        if (r) return t = P(l, t, s, e);
-        P(l, t, null, e);
+        if (r) return t = W(l, t, s, e);
+        W(l, t, null, e);
       } else t == null || t === "" || !l.firstChild ? l.appendChild(e) : l.replaceChild(e, l.firstChild);
       t = e;
     }
@@ -426,7 +426,7 @@ function re(l, e, t, s) {
 function ue(l, e, t = null) {
   for (let s = 0, o = e.length; s < o; s++) l.insertBefore(e[s], t);
 }
-function P(l, e, t, s) {
+function W(l, e, t, s) {
   if (t === void 0) return l.textContent = "";
   const o = s || document.createTextNode("");
   if (e.length) {
@@ -446,7 +446,7 @@ class Tt {
     this.code = e;
   }
   render(e, t, s, o, i, r, a) {
-    const n = Ae({
+    const n = Ee({
       rowIndex: t,
       columnIndex: s,
       areaIdent: o,
@@ -470,14 +470,14 @@ function qe(l, e = 500) {
     }, e);
   };
 }
-class B {
+class P {
   // The constructor is private to prevent direct construction calls
   // with the `new` operator
   constructor() {
     this.alreadySet = !1;
   }
   static getInstance() {
-    return B.instance || (B.instance = new B()), B.instance;
+    return P.instance || (P.instance = new P()), P.instance;
   }
   /**
    * Method to set the license key for the application.
@@ -526,7 +526,7 @@ class I {
     this.content = e, this.style = t, this.classes = s;
   }
 }
-class Me {
+class Re {
   constructor(e = new I(
     ">",
     "transform: rotate(90deg) translate(66%, -66%); transform-origin: 0 0;",
@@ -547,7 +547,7 @@ class Me {
     this.arrowExpanded = e, this.arrowCollapsed = t, this.arrowPlaceholder = s, this.arrowExpandCollapseAll = o;
   }
 }
-class Re {
+class Me {
   constructor(e = new I("↑", "", ["ge-header-sorted-asc"]), t = new I("↓", "", ["ge-header-sorted-desc"]), s = new I("↑", "color:transparent;", [])) {
     this.iconAsc = e, this.iconDesc = t, this.iconPlaceholder = s;
   }
@@ -672,7 +672,7 @@ class Ze {
       }
     return this.domService.appendChild(e, a), a;
   }
-  addSortedIcon(e, t = "", s = new Re(), o = -1) {
+  addSortedIcon(e, t = "", s = new Me(), o = -1) {
     const i = this.domService.createElement("div");
     this.domService.addClass(i, "ge-table-sorted-icon-div"), this.domService.setStyle(i, "position", "absolute"), this.domService.setStyle(i, "top", "0"), this.domService.setStyle(i, "right", "0"), this.domService.setStyle(i, "width", "20px"), this.domService.setStyle(i, "background", "transparent"), this.domService.setStyle(i, "cursor", "pointer"), this.domService.setAttribute(i, "data-col-index", `${o}`), this.domService.setAttribute(i, "data-area", "header");
     let r;
@@ -683,7 +683,7 @@ class Ze {
       this.domService.addClass(i, d);
     return this.domService.appendChild(e, i), i;
   }
-  addArrowDiv(e, t = "none", s = new Me(), o = -1, i = -1, r = "body") {
+  addArrowDiv(e, t = "none", s = new Re(), o = -1, i = -1, r = "body") {
     const a = this.domService.createElement("div");
     this.domService.addClass(a, "ge-table-tree-arrow-div"), this.domService.setStyle(a, "display", "inline-block"), this.domService.setStyle(a, "position", ""), this.domService.setStyle(a, "width", "20px"), this.domService.setStyle(a, "background", "transparent"), this.domService.setStyle(a, "cursor", "pointer"), this.domService.setAttribute(a, "data-row-index", `${o}`), this.domService.setAttribute(a, "data-col-index", `${i}`), this.domService.setAttribute(a, "data-area", `${r}`);
     let n;
@@ -940,6 +940,8 @@ class tt {
   doSort(e) {
     return !1;
   }
+  sort(e) {
+  }
   isEditable(e, t) {
     var o, i;
     const s = (o = this.columnDefs) == null ? void 0 : o[t];
@@ -995,9 +997,15 @@ class st {
     return s * ("" + e).localeCompare("" + t);
   }
 }
-class W extends tt {
+class L extends tt {
   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 st(), this.filteredRows = [...t], this.properties = o.map((a) => a.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 st(), this._focusedRowIndex = 0, this.filteredRows = [...t], this.properties = o.map((a) => a.property);
+  }
+  get focusedRowIndex() {
+    return this._focusedRowIndex;
+  }
+  set focusedRowIndex(e) {
+    this._focusedRowIndex = e;
   }
   setRows(e) {
     this.rows = e, this.filteredRows = [...e];
@@ -1029,6 +1037,28 @@ class W extends tt {
   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;
   }
@@ -1045,15 +1075,19 @@ class W extends tt {
     }
     return !0;
   }
+  sort(e) {
+    this.filteredRows = this.filteredRows.sort(e);
+  }
   getValueByT(e, t) {
-    return t.includes(".") ? this.getPropertyValue(e, t.split(".")) : e[t];
+    if (e && t)
+      return t.includes(".") ? this.getPropertyValue(e, t.split(".")) : e[t];
   }
   changeColumnOrder(e, t) {
     this.arrayMove(this.properties, e, t), super.changeColumnOrder(e, t);
   }
   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);
@@ -1281,58 +1315,314 @@ class ot {
   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 W ? t.setRows(e) : console.warn("setRows<T>(rows: T[]) only works with AreaModelObjectArray<T>, but this body area model is ", typeof t, t);
+    t instanceof L ? 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 W) {
+    if (t instanceof L) {
       const s = t;
       let o = s.getAllRows();
       s.setRows([...o, ...e]);
     } 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 W) {
+    if (s instanceof L) {
       const o = s;
       let i = o.getAllRows();
       o.setRows([...i.slice(0, t), ...e, ...i.slice(t)]);
     } 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 W) {
+    if (s instanceof L) {
       const o = s, i = o.getAllRows().filter((r) => !e.some((a) => t(r, a)));
       o.setRows(i);
     } 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 W ? 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), []);
+    return s instanceof L ? 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 L)
+      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 L)
+      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 W) {
+    if (s instanceof L) {
       let i = s.getAllRows();
       for (const r of i)
         for (const a of e)
@@ -1342,12 +1632,165 @@ class ot {
     } 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 de {
   constructor(e) {
@@ -1498,14 +1941,14 @@ class at extends de {
     }
   }
 }
-class F {
+class k {
   constructor(e = 0, t = 0, s = 0, o = 0, i) {
     this.left = e, this.width = t, this.height = s, this.top = o, this.index = i;
   }
 }
 class nt {
   constructor(e, t, s, o) {
-    this.hostElement = e, this.tableModel = t, this.dom = s, this.tableOptions = o, this.scrollTop = 0, this.areaBodyWestGeo = new F(), this.areaBodyCenterGeo = new F(), this.areaBodyEastGeo = new F();
+    this.hostElement = e, this.tableModel = t, this.dom = s, this.tableOptions = o, this.scrollTop = 0, this.areaBodyWestGeo = new k(), this.areaBodyCenterGeo = new k(), this.areaBodyEastGeo = new k();
     const i = this.hostElement;
     i.innerText = "", this.dom.setAttribute(i, "tabindex", "0"), this.dom.setStyle(
       this.dom.addClass("ge-table", i),
@@ -1674,7 +2117,7 @@ class nt {
     this.dom.setStyle(this.contentWrapperDiv, "width", e), this.dom.setStyle(this.contentWrapperDiv, "height", t);
   }
 }
-class A {
+class E {
   /**
    * Represents a constructor for a class.
    * @constructor
@@ -1688,7 +2131,7 @@ class A {
     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 A(
+    return e.gammaRange === void 0 && (e.gammaRange = !1), new E(
       e.rowIndex1,
       e.columnIndex1,
       e.rowIndex2,
@@ -1697,13 +2140,13 @@ class A {
     );
   }
   static singleCell(e, t) {
-    return new A(e, t, e, t);
+    return new E(e, t, e, t);
   }
   static singleRow(e) {
-    return new A(e, 0, e, Number.MAX_SAFE_INTEGER);
+    return new E(e, 0, e, Number.MAX_SAFE_INTEGER);
   }
   static singleColumn(e) {
-    return new A(0, e, Number.MAX_SAFE_INTEGER, e);
+    return new E(0, e, Number.MAX_SAFE_INTEGER, e);
   }
   isInRange(e, t) {
     return e >= this.r1 && e <= this.r2 && t >= this.c1 && t <= this.c2;
@@ -1725,7 +2168,7 @@ class ct {
           i === 0 && (i = 1), r === 0 && (r = 1);
           const a = "gammaCells" in this.areaModel;
           this.colAndRowspanRanges.push(
-            new A(s, o, s + r - 1, o + i - 1, a)
+            new E(s, o, s + r - 1, o + i - 1, a)
           );
         }
       }
@@ -1843,19 +2286,19 @@ class ht extends nt {
     for (const t of this.removables)
       t.remove();
     this.hideHoverRow(), this.hideHoverColumn(), this.scrollTop = this.scrollViewport.scrollTop, this.scrollLeft = this.scrollViewport.scrollLeft, this.debounce(this.checkForScrollPosSaving.bind(this)), this.scrollFactorY = this.scrollTop / (this.scrollViewport.scrollHeight - this.scrollViewport.clientHeight), this.scrollFactorX = this.scrollLeft / (this.scrollViewport.scrollWidth - this.scrollViewport.clientWidth), isNaN(this.scrollFactorY) && (this.scrollFactorY = 0), isNaN(this.scrollFactorX) && (this.scrollFactorX = 0), this.adjustBody(), this.adjustArea("footer"), this.adjustArea("header"), this.tableOptions.tableTopBorderVisible && this.removables.push(this.dom.addHorizontalBorder(
-      new F(0, this.hostElement.clientWidth, 1, 0),
+      new k(0, this.hostElement.clientWidth, 1, 0),
       this.hostElement,
       "ge-table-border"
     )), this.tableOptions.tableBottomBorderVisible && this.removables.push(this.dom.addHorizontalBorder(
-      new F(0, this.hostElement.clientWidth, 1, this.hostElement.clientHeight - 1),
+      new k(0, this.hostElement.clientWidth, 1, this.hostElement.clientHeight - 1),
       this.hostElement,
       "ge-table-border"
     )), this.tableModel.getFixedLeftColumnCount() > 0 && this.removables.push(this.dom.addVerticalBorder(
-      new F(this.areaBodyWest.child.clientWidth, 1, this.hostElement.clientHeight, 0),
+      new k(this.areaBodyWest.child.clientWidth, 1, this.hostElement.clientHeight, 0),
       this.hostElement,
       "ge-table-body-west-vertical-border"
     )), ((e = this.tableModel.getAreaModel("header")) == null ? void 0 : e.getRowCount()) > 0 && this.removables.push(this.dom.addHorizontalBorder(
-      new F(0, this.hostElement.clientWidth, 1, this.areaHeaderCenter.child.clientHeight),
+      new k(0, this.hostElement.clientWidth, 1, this.areaHeaderCenter.child.clientHeight),
       this.hostElement,
       "ge-table-body-west-vertical-border"
     ));
@@ -2019,11 +2462,11 @@ class ht extends nt {
     let p = t;
     const u = this.tableModel.getColumnCount(), g = this.tableModel.getFixedRightColumnCount(), b = this.tableModel.getFixedLeftColumnCount();
     for (let m = 0; m < h; m++) {
-      const w = p, v = m === h - 1, E = this.tableModel.getRowHeight(e, m);
-      if (w + E > 0) {
+      const w = p, C = m === h - 1, A = this.tableModel.getRowHeight(e, m);
+      if (w + A > 0) {
         this.firstVisibleRowIndex = m;
-        let y = { left: a, width: n, height: E, top: w, index: m }, S = this.dom.addRowDiv(o, y, m, e, "center");
-        const k = b;
+        let y = { left: a, width: n, height: A, top: w, index: m }, S = this.dom.addRowDiv(o, y, m, e, "center");
+        const F = b;
         if (this.adjustColumnsToRowParent({
           areaIdent: e,
           sideIdent: "center",
@@ -2031,11 +2474,11 @@ class ht extends nt {
           geo: y,
           parent: S,
           rowIndex: m,
-          columnIndexStart: k,
+          columnIndexStart: F,
           columnIndexEnd: u - g - 1,
           verticalFixed: !1,
-          lastRowOfModel: v
-        }), d.left > 0 && (y = { left: a, width: this.areaBodyWestGeo.width, height: E, top: w, index: m }, S = this.dom.addRowDiv(s, y, m, e, "west"), this.adjustColumnsToRowParent({
+          lastRowOfModel: C
+        }), d.left > 0 && (y = { left: a, width: this.areaBodyWestGeo.width, height: A, top: w, index: m }, S = this.dom.addRowDiv(s, y, m, e, "west"), this.adjustColumnsToRowParent({
           areaIdent: e,
           sideIdent: "west",
           areaModel: c,
@@ -2043,10 +2486,10 @@ class ht extends nt {
           parent: S,
           rowIndex: m,
           columnIndexStart: 0,
-          columnIndexEnd: k - 1,
+          columnIndexEnd: F - 1,
           verticalFixed: !0,
-          lastRowOfModel: v
-        })), d.right > 0 && (y = { left: a, width: this.areaBodyEastGeo.width, height: E, top: w, index: m }, S = this.dom.addRowDiv(i, y, m, e, "east"), this.adjustColumnsToRowParent({
+          lastRowOfModel: C
+        })), d.right > 0 && (y = { left: a, width: this.areaBodyEastGeo.width, height: A, top: w, index: m }, S = this.dom.addRowDiv(i, y, m, e, "east"), this.adjustColumnsToRowParent({
           areaIdent: e,
           sideIdent: "east",
           areaModel: c,
@@ -2056,11 +2499,11 @@ class ht extends nt {
           columnIndexStart: u - g,
           columnIndexEnd: u - 1,
           verticalFixed: !0,
-          lastRowOfModel: v
+          lastRowOfModel: C
         })), e === "header" && this.tree && m === h - 1) {
           const T = this.dom.applyStyle(
             this.dom.setAttribute(
-              this.dom.addDiv(S, new F(16, 20, 20, 8)),
+              this.dom.addDiv(S, new k(16, 20, 20, 8)),
               "data-ge-action",
               "toggleExpandCollapseAll"
             ),
@@ -2072,7 +2515,7 @@ class ht extends nt {
           }
         }
       }
-      if (p = p + E, p > r) {
+      if (p = p + A, p > r) {
         e === "body" && (this.displayedRowCount = this.firstVisibleRowIndex - m);
         break;
       }
@@ -2081,16 +2524,16 @@ class ht extends nt {
       const m = ((f = this.colAndRowspanModels[e]) == null ? void 0 : f.getRanges()) ?? [];
       if (m.length)
         for (const w of m) {
-          let v = 0, E = o.child, y = "center";
+          let C = 0, A = o.child, y = "center";
           if (w.c1 < b)
-            E = s.child, y = "west";
+            A = s.child, y = "west";
           else if (g > 0 && w.c1 >= u - g)
-            E = i.child, y = "east";
+            A = i.child, y = "east";
           else {
             const S = this.areaBodyCenterGeo.width - this.tableModel.getContentWidthInPixel();
-            v = this.scrollFactorX * S - this.areaBodyWestGeo.width, y = "center";
+            C = this.scrollFactorX * S - this.areaBodyWestGeo.width, y = "center";
           }
-          this.drawBigCell(w, v, t, c, E, y);
+          this.drawBigCell(w, C, t, c, A, y);
         }
     }
   }
@@ -2200,19 +2643,19 @@ class ht extends nt {
     for (let f = a; f <= n; f++) {
       const m = g, w = this.tableModel.getColumnWidth(f);
       if (w > 0 && m + w > 0) {
-        let v = o.height;
-        const E = s.getRowspanAt(r, f), y = s.getColspanAt(r, f);
-        E > 1 && (v = this.getRowHeights(r, r + E - 1, s).reduce((T, D) => T + D, 0));
+        let C = o.height;
+        const A = s.getRowspanAt(r, f), y = s.getColspanAt(r, f);
+        A > 1 && (C = this.getRowHeights(r, r + A - 1, s).reduce((T, D) => T + D, 0));
         let S = w;
         y > 1 && (S = this.getColumnWidths(f, f + y - 1).reduce((T, D) => T + D, 0));
-        let k = !1;
-        if (this.colAndRowspanModels && this.colAndRowspanModels[e] && (b = this.colAndRowspanModels[e]) != null && b.isInRange(r, f) && (k = !0), this.draggingTargetColumnIndex === f && e !== "header") {
-          this.renderDragTargetDiv(i, m, p, S, v);
-          const T = { left: m, top: p, width: S, height: v };
+        let F = !1;
+        if (this.colAndRowspanModels && this.colAndRowspanModels[e] && (b = this.colAndRowspanModels[e]) != null && b.isInRange(r, f) && (F = !0), this.draggingTargetColumnIndex === f && e !== "header") {
+          this.renderDragTargetDiv(i, m, p, S, C);
+          const T = { left: m, top: p, width: S, height: C };
           this.dom.addColumnBorderDivs(this.tableOptions, i, T, e, t);
         } else {
-          const T = this.renderSelectedBackgroundDiv(k, u, t, s, r, f, i, m, p, S, v);
-          "gammaCells" in s && s.getValueAt(r, f) && (k = !1), k || this.renderCell({
+          const T = this.renderSelectedBackgroundDiv(F, u, t, s, r, f, i, m, p, S, C);
+          "gammaCells" in s && s.getValueAt(r, f) && (F = !1), F || this.renderCell({
             areaModel: s,
             areaIdent: e,
             sideIdent: t,
@@ -2221,7 +2664,7 @@ class ht extends nt {
             left: m,
             top: p,
             width: S,
-            height: v,
+            height: C,
             parent: i,
             cellSelected: T,
             lastRowOfModel: c,
@@ -2232,7 +2675,7 @@ class ht extends nt {
             cellLeft: m,
             cellTop: p,
             cellWidth: S,
-            cellHeight: v,
+            cellHeight: C,
             parent: i
           });
         }
@@ -2240,7 +2683,7 @@ class ht extends nt {
       if (g = g + w, g > this.areaBodyCenterGeo.width)
         break;
     }
-    this.tableOptions.verticalBorderVisible && this.dom.addVerticalBorder(new F(g - 1, 1, o.height, 0), i);
+    this.tableOptions.verticalBorderVisible && this.dom.addVerticalBorder(new k(g - 1, 1, o.height, 0), i);
   }
   /**
    * Retrieves the column index of the tree arrow column in the table.
@@ -2271,15 +2714,15 @@ class ht extends nt {
     const u = this.editorRenderer && this.editorRendererRow === o && this.editorRendererColumn === i ? this.editorRenderer : e.getCellRenderer(o, i), g = { left: r, width: a, height: n, top: d, index: i }, b = e.getRowByIndex(o);
     let f = "none";
     if (i === this.getTreeArrowColumnIndex() && K(b)) {
-      const C = b;
-      (ge = C.children) != null && ge.length ? C.expanded ? f = "expanded" : f = "collapsed" : f = "hidden";
+      const v = b;
+      (ge = v.children) != null && ge.length ? v.expanded ? f = "expanded" : f = "collapsed" : f = "hidden";
     }
     let w;
     if (t === "header") {
-      const C = this.tableModel.getColumnDef(i);
-      (!(C != null && C.sortIconVisible) || C != null && C.sortIconVisible()) && (w = C == null ? void 0 : C.sortState);
+      const v = this.tableModel.getColumnDef(i);
+      (!(v != null && v.sortIconVisible) || v != null && v.sortIconVisible()) && (w = v == null ? void 0 : v.sortState);
     }
-    const v = e.getValueAt(o, i), E = u ? "" : `${v}`, y = e.isRowChecked(o), S = this.dom.addColumnDiv(
+    const C = e.getValueAt(o, i), A = u ? "" : `${C}`, y = e.isRowChecked(o), S = this.dom.addColumnDiv(
       {
         parent: c,
         geo: g,
@@ -2287,28 +2730,28 @@ class ht extends nt {
         columnIndex: i,
         areaIdent: t,
         sideIdent: s,
-        text: E,
+        text: A,
         treeArrow: f,
         tableOptions: this.tableOptions,
         checkedType: y,
         sortState: w
       }
-    ), k = e.getTooltipAt(o, i);
-    k && this.dom.setAttribute(S, "title", k);
+    ), F = e.getTooltipAt(o, i);
+    F && this.dom.setAttribute(S, "title", F);
     const T = this.tableModel.getColumnDef(i);
     T && T.classes[t] && this.dom.addClasses(T.classes[t], S);
     let D;
-    u && (D = u.render(S, o, i, t, e, v, this.dom.domService));
+    u && (D = u.render(S, o, i, t, e, C, this.dom.domService));
     const N = e.getCustomClassesAt(o, i);
     if (N.length && this.dom.addClasses(N, S), this.dom.addColumnBorderDivs(this.tableOptions, c, g, t, s), h && this.dom.addHorizontalBorder({ left: r, width: a, height: n, top: d + n }, c), this.getFocusModel && t === "body") {
-      const C = this.getFocusModel();
-      C != null && C.hasFocus(o, i) && this.dom.addFocusBorderDivs(c, g, {});
+      const v = this.getFocusModel();
+      v != null && v.hasFocus(o, i) && this.dom.addFocusBorderDivs(c, g, {});
     }
     t === "header" && this.dom.setAttribute(S, "data-ge-action", "drag-column");
     const ee = e.getCustomStyleAt(o, i);
     if (ee)
-      for (const C in ee)
-        this.dom.setStyle(S, C, ee[C]);
+      for (const v in ee)
+        this.dom.setStyle(S, v, ee[v]);
     return [S, D];
   }
   /**
@@ -2486,10 +2929,10 @@ class ht extends nt {
         }, m = this.dom.addColumnDiv(f);
         let w;
         g && (w = g.render(m, d, a, t, i, u, this.dom.domService), w && this.cleanupFunctions[t].push(w));
-        const v = i.getCustomClassesAt(d, a);
-        v.length && this.dom.addClasses(v, m);
-        const E = this.tableModel.getColumnDef(a);
-        E && E.classes[t] && this.dom.addClasses(E.classes[t], m), this.dom.addColumnBorderDivs(this.tableOptions, n, p, t, o);
+        const C = i.getCustomClassesAt(d, a);
+        C.length && this.dom.addClasses(C, m);
+        const A = this.tableModel.getColumnDef(a);
+        A && A.classes[t] && this.dom.addClasses(A.classes[t], m), this.dom.addColumnBorderDivs(this.tableOptions, n, p, t, o);
         const y = i.getCustomStyleAt(d, a);
         if (y)
           for (const S in y)
@@ -2678,7 +3121,7 @@ class ut {
     let s = !1, o = !1;
     if (this.getSelectionModel && this.getFocusModel) {
       const p = this.getSelectionModel(), u = this.getFocusModel();
-      p && 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 || p.hasSelection() && (p.clear(), s = !0), (r = e.originalEvent) != null && r.shiftKey && this.previousEvt ? (p.addSelection(this.createRangeByEvents(e, this.previousEvt)), o = !0, s = !0) : (a = e.originalEvent) != null && a.altKey && ((n = e.originalEvent) != null && n.ctrlKey || (d = e.originalEvent) != null && d.metaKey) ? (p.removeSelection(A.singleCell(e.rowIndex, e.columnIndex)), o = !0, s = !0) : (c = e.originalEvent) != null && c.ctrlKey || (h = e.originalEvent) != null && h.metaKey ? (p.addSelection(A.singleCell(e.rowIndex, e.columnIndex)), o = !0, s = !0) : (p.firstClick(e.rowIndex, e.columnIndex), s = !0), this.tableScope.onSelectionChanged(p));
+      p && 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 || p.hasSelection() && (p.clear(), s = !0), (r = e.originalEvent) != null && r.shiftKey && this.previousEvt ? (p.addSelection(this.createRangeByEvents(e, this.previousEvt)), o = !0, s = !0) : (a = e.originalEvent) != null && a.altKey && ((n = e.originalEvent) != null && n.ctrlKey || (d = e.originalEvent) != null && d.metaKey) ? (p.removeSelection(E.singleCell(e.rowIndex, e.columnIndex)), o = !0, s = !0) : (c = e.originalEvent) != null && c.ctrlKey || (h = e.originalEvent) != null && h.metaKey ? (p.addSelection(E.singleCell(e.rowIndex, e.columnIndex)), o = !0, s = !0) : (p.firstClick(e.rowIndex, e.columnIndex), s = !0), this.tableScope.onSelectionChanged(p));
     }
     return o ? this.previousEvt = void 0 : this.previousEvt = e == null ? void 0 : e.clone(), s;
   }
@@ -2701,7 +3144,7 @@ class ut {
   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 A.create({
+    return E.create({
       rowIndex1: s,
       columnIndex1: i,
       rowIndex2: o,
@@ -2949,7 +3392,7 @@ class xt {
     this.silent || this.listenerArr.forEach((e) => e.onSelectionChanged(this));
   }
   firstClick(e, t) {
-    this.selectionType === "row" ? this.addRange(A.singleRow(e)) : this.selectionType === "column" && this.addRange(A.singleColumn(t));
+    this.selectionType === "row" ? this.addRange(E.singleRow(e)) : this.selectionType === "column" && this.addRange(E.singleColumn(t));
   }
   getSelectionCount(e, t) {
     let s = 0;
@@ -3000,10 +3443,10 @@ class xt {
     if (this.selectionType === "none")
       return;
     let t = e;
-    this.selectionType === "row" ? t = A.singleRow(e.r1) : this.selectionType === "column" && (t = A.singleColumn(e.c1)), this.negativeRanges.push(t), this.fireChangeEvent();
+    this.selectionType === "row" ? t = E.singleRow(e.r1) : this.selectionType === "column" && (t = E.singleColumn(e.c1)), this.negativeRanges.push(t), this.fireChangeEvent();
   }
   togglePoint(e, t) {
-    this.getSelectionCount(e, t) > 0 ? this.removeSelection(A.singleCell(e, t)) : this.addSelection(A.singleCell(e, t));
+    this.getSelectionCount(e, t) > 0 ? this.removeSelection(E.singleCell(e, t)) : this.addSelection(E.singleCell(e, t));
   }
   isSelected(e, t) {
     return this.getSelectionCount(e, t) > 0;
@@ -3012,7 +3455,7 @@ class xt {
     this.selectionType !== "none" && (this.allSelected = !1, this.selectionMode === "single" && (this.ranges = []), this.selectionType === "row" ? (e.c1 = 0, e.c2 = Number.MAX_SAFE_INTEGER) : this.selectionType === "column" ? (e.r1 = 0, e.r2 = Number.MAX_SAFE_INTEGER) : this.selectionType === "cell" ? (e.r2 = e.r1, e.c2 = e.c1) : this.selectionType, this.ranges.push(e), this.fireChangeEvent());
   }
 }
-class vt {
+class Ct {
   constructor(e = "none") {
     this.selectionType = e, this.rowIndex = -1, this.columnIndex = -1, this.changed = !1, this.listenerArr = [];
   }
@@ -3063,14 +3506,14 @@ class De {
   }
   // `⊖ `,  `⊕ `;
 }
-const Ct = new xt(), Et = new vt("cell");
-class ke {
+const vt = new xt(), At = new Ct("cell");
+class Fe {
   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 Me(), this.headerGroupOptions = new De(), this.showCheckboxWihoutExtraColumn = !1, this.externalFilterFunction = void 0, this.sortedOptions = new Re(), this.sortOrder = ["asc", "desc"], this.shortcutActionsDisabled = !1, this.resizeEventDebounceDelay = 500, this.getEditRenderer = (e, t) => new wt(), this.getSelectionModel = () => Ct, this.getFocusModel = () => Et;
+    }, this.footerVerticalSeparator = !1, this.headerToggleExpandCollapseIcons = !1, this.headerVerticalSeparator = !1, this.treeOptions = new Re(), this.headerGroupOptions = new De(), this.showCheckboxWihoutExtraColumn = !1, this.externalFilterFunction = void 0, this.sortedOptions = new Me(), this.sortOrder = ["asc", "desc"], this.shortcutActionsDisabled = !1, this.resizeEventDebounceDelay = 500, this.getEditRenderer = (e, t) => new wt(), this.getSelectionModel = () => vt, this.getFocusModel = () => At;
   }
 }
 const H = class H {
@@ -3151,14 +3594,14 @@ const H = class H {
   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 A(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 E(s.r1, s.c1, s.r2, s.c2);
     return t;
   }
 };
 H.columnSeparatorChar = "	", H.rowSeparatorChar = `
 `;
 let Y = H;
-class At {
+class Et {
   constructor(e, t = 500) {
     this.tableScope = e, this.debounceDelay = t, new ResizeObserver(qe(this.handleResize.bind(this), t)).observe(this.tableScope.hostElement);
   }
@@ -3167,7 +3610,7 @@ class At {
     this.tableScope.recalcColumnWidths(s);
   }
 }
-class Mt {
+class Rt {
   /**
    * Downloads a matrix data as an Excel file.
    *
@@ -3274,13 +3717,13 @@ class Mt {
   }
 }
 class pe extends ht {
-  constructor(e, t, s, o, i, r = new Y(), a = new Mt()) {
+  constructor(e, t, s, o, i, r = new Y(), a = new Rt()) {
     var c;
-    if (super(e, t, new Ze(s), o), this.eventListener = i, this.copyService = r, this.excelService = a, this.licenseManager = B.getInstance(), this.selectionService = new ut(this), this.api = new ot(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 be()), (c = this.tableOptions) != null && c.autoRestoreOptions) {
+    if (super(e, t, new Ze(s), o), this.eventListener = i, this.copyService = r, this.excelService = a, this.licenseManager = P.getInstance(), this.selectionService = new ut(this), this.api = new ot(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 be()), (c = this.tableOptions) != null && c.autoRestoreOptions) {
       const h = this.tableOptions.autoRestoreOptions, p = h.getStorageKeyFn;
       p && (h.autoRestoreScrollPosition && (this.storeScrollPosStateService = new it(p)), h.autoRestoreCollapsedExpandedState && (this.storeStateCollapsedExpandService = new lt(p)), h.autoRestoreSortingState && (this.storeSortingService = new at(p)));
     }
-    this.mouseHandler = new et(this), this.inputHandler = new gt(this), this.resizeHandler = new At(this, o.resizeEventDebounceDelay), this.shortcutService = new yt(this), this.shortcutService.addListener(this.selectionService);
+    this.mouseHandler = new et(this), this.inputHandler = new gt(this), this.resizeHandler = new Et(this, o.resizeEventDebounceDelay), this.shortcutService = new yt(this), this.shortcutService.addListener(this.selectionService);
     const n = this.getSelectionModel ? this.getSelectionModel() : void 0;
     n && n.addEventSelectionChangedListener(this);
     const d = this.getFocusModel ? this.getFocusModel() : void 0;
@@ -3298,7 +3741,7 @@ class pe extends ht {
    *
    * @return {TableScope} - The newly created TableScope instance.
    */
-  static create(e, t, s = new ke(), o = new be(), i = new Te(), r = new Y()) {
+  static create(e, t, s = new Fe(), o = new be(), i = new Te(), r = new Y()) {
     return new pe(e, t, i, s, o, r);
   }
   /**
@@ -3698,9 +4141,70 @@ class pe extends ht {
     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 J = class J {
 };
@@ -3980,12 +4484,12 @@ const q = class q {
 };
 q.toggleHeaderGroup = "toggleHeaderGroup";
 let ye = q;
-var Rt = /* @__PURE__ */ Ke("<div>");
-const kt = (l) => {
+var Mt = /* @__PURE__ */ Ke("<div>");
+const Ft = (l) => {
   let e;
-  const t = Ae({
+  const t = Ee({
     tableModel: null,
-    tableOptions: new ke()
+    tableOptions: new Fe()
   }, l);
   return We(() => {
     const s = {
@@ -4058,14 +4562,14 @@ const kt = (l) => {
       detail: o.getApi(),
       bubbles: !0
     });
-    e && e.dispatchEvent(i), t.licenseKey && B.getInstance().setLicenseKey(t.licenseKey);
+    e && e.dispatchEvent(i), t.licenseKey && P.getInstance().setLicenseKey(t.licenseKey);
   }), (() => {
-    var s = Rt(), o = e;
+    var s = Mt(), o = e;
     return typeof o == "function" ? Ye(o, s) : e = s, s;
   })();
 };
 export {
   Tt as ComponentRendererWrapper,
-  kt as GuiexpertTable,
+  Ft as GuiexpertTable,
   Dt as GuiexpertTableProps
 };