@1771technologies/lytenyte-pro 1.0.0-beta.8 → 1.0.0

package/dist/+types.d.ts

@@ -2,6 +2,8 @@ import type { ReactNode } from "react";
 /**
  * The initial props that may be passed to the `useLyteNyte` hook. The hook
  *     returns the state representation of LyteNyte Grid.
+ *
+ *   @group Grid State
  */
 export interface UseLyteNyteProps<T> {
     /**
@@ -256,6 +258,8 @@ export interface UseLyteNyteProps<T> {
  *   grid properties that affect layout, data, selection, and rendering. Updating any of these atoms will trigger
  *   corresponding changes in the grid UI. These state values can also be used to create and synchronize external
  *   components such as toolbars, panels, or widgets.
+ *
+ *   @group Grid State
  */
 export interface GridState<T> {
     /**
@@ -641,6 +645,8 @@ export interface GridState<T> {
 /**
  * Defines the viewport boundaries for rendering rows and columns in LyteNyte Grid.
  *   These bounds are calculated based on the scroll position and the visible area of the grid.
+ *
+ *   @group Grid View
  */
 export interface ViewBounds {
     /**
@@ -703,6 +709,8 @@ export interface ViewBounds {
 /**
  * The grid object encapsulates the full LyteNyte Grid instance, including its state, view, and imperative API.
  *   It is returned by the `useLyteNyte` hook and serves as the primary interface for interacting with the grid programmatically.
+ *
+ *   @group Grid State
  */
 export interface Grid<T> {
     /**
@@ -725,6 +733,8 @@ export interface Grid<T> {
  * Represents the current visual layout of the grid including headers and rows.
  *   This structure is used by LyteNyte Grid headless components
  *   or for building custom visualizations.
+ *
+ *   @group Grid View
  */
 export interface GridView<T> {
     /**
@@ -738,6 +748,8 @@ export interface GridView<T> {
 }
 /**
  * Describes a standard header cell layout in the grid, used to position and render individual column headers.
+ *
+ *   @group Grid View
  */
 export interface HeaderCellLayout<T> {
     /**
@@ -791,6 +803,8 @@ export interface HeaderCellLayout<T> {
 }
 /**
  * Describes a floating header cell layout, which remains fixed during scroll operations.
+ *
+ *   @group Grid View
  */
 export interface HeaderCellFloating<T> {
     /**
@@ -845,6 +859,8 @@ export interface HeaderCellFloating<T> {
 /**
  * Describes a group of columns within the header. Used by LyteNyte
  *   Grid to render grouped column headers with optional collapsibility and structural metadata.
+ *
+ *   @group Grid View
  */
 export interface HeaderGroupCellLayout {
     /**
@@ -925,6 +941,8 @@ export interface HeaderGroupCellLayout {
 /**
  * Defines the overall structure of header rows in the grid.
  *   This layout is recalculated based on viewport changes and virtualized rendering.
+ *
+ *   @group Grid View
  */
 export interface HeaderLayout<T> {
     /**
@@ -943,10 +961,14 @@ export interface HeaderLayout<T> {
 /**
  * Represents a union of all possible header layout cell types:
  *   normal header, floating header, or header group.
+ *
+ *   @group Grid View
  */
 export type HeaderLayoutCell<T> = HeaderCellLayout<T> | HeaderCellFloating<T> | HeaderGroupCellLayout;
 /**
  * Represents the layout metadata for a single cell within a row, including span and contextual info.
+ *
+ *   @group Grid View
  */
 export interface RowCellLayout<T> {
     /**
@@ -1013,6 +1035,8 @@ export interface RowCellLayout<T> {
 /**
  * Describes the layout of a full-width row which spans all columns.
  *   These are typically used for summary or group rows.
+ *
+ *   @group Grid View
  */
 export interface RowFullWidthRowLayout<T> {
     /**
@@ -1050,11 +1074,15 @@ export interface RowFullWidthRowLayout<T> {
 }
 /**
  * A row layout is either a standard row or a full-width row, depending on its content and configuration.
+ *
+ *   @group Grid View
  */
 export type RowLayout<T> = RowNormalRowLayout<T> | RowFullWidthRowLayout<T>;
 /**
  * Describes the layout of a standard row in LyteNyte Grid,
  *   including cell arrangement and row-level metadata.
+ *
+ *   @group Grid View
  */
 export interface RowNormalRowLayout<T> {
     /**
@@ -1097,6 +1125,8 @@ export interface RowNormalRowLayout<T> {
 /**
  * Organizes the rows into three separate sections: top (pinned), center (scrollable),
  *   and bottom (pinned). Used to optimize row virtualization and rendering.
+ *
+ *   @group Grid View
  */
 export interface RowSectionLayouts<T> {
     /**
@@ -1139,6 +1169,8 @@ export interface RowSectionLayouts<T> {
  *
  * This is called when autosize is triggered via the grid's API. Returning `null`
  * disables sizing behavior.
+ *
+ * @group Column
  */
 export type AutosizeCellFn<T> = (
 /**
@@ -1151,6 +1183,8 @@ params: AutosizeCellParams<T>) => number | null;
  *
  * These provide context about the cell and grid configuration so that the function
  * can determine the optimal column width based on cell content.
+ *
+ * @group Column
  */
 export interface AutosizeCellParams<T> {
     /**
@@ -1171,6 +1205,8 @@ export interface AutosizeCellParams<T> {
  * based on the header's rendered content.
  *
  * This is called as part of the grid's autosize process.
+ *
+ * @group Column
  */
 export type AutosizeHeaderFn<T> = (
 /**
@@ -1182,6 +1218,8 @@ params: AutosizeHeaderParams<T>) => number | null;
  *
  * These are used by LyteNyte Grid to calculate the ideal column width based on the
  * header content.
+ *
+ * @group Column
  */
 export interface AutosizeHeaderParams<T> {
     /**
@@ -1202,6 +1240,8 @@ export interface AutosizeHeaderParams<T> {
  *
  * This allows you to set column-wide defaults that apply retroactively to all applicable columns
  * without rewriting each one.
+ *
+ * @group Column
  */
 export interface ColumnBase<T> {
     /**
@@ -1233,7 +1273,7 @@ export interface ColumnBase<T> {
     /**
      * Function used to render a floating row cell. Only called when floating rows are enabled. Must return a React node.
      */
-    readonly floatingRenderer?: HeaderFloatingCellRenderer<T>;
+    readonly floatingCellRenderer?: HeaderFloatingCellRenderer<T>;
     /**
      * Defines how to render the cell content. Accepts a renderer function or a string referencing a registered renderer.
      */
@@ -1275,6 +1315,8 @@ export interface ColumnBase<T> {
  * Defines the structure of a marker column.
  *
  *   The marker column is a grid managed column used to support features like selection checkboxes or row drag handles.
+ *
+ *   @group Column
  */
 export interface ColumnMarker<T> {
     /**
@@ -1288,7 +1330,7 @@ export interface ColumnMarker<T> {
     /**
      * Function used to render a floating row cell. Only called when floating rows are enabled. Must return a React node.
      */
-    readonly floatingRenderer?: HeaderFloatingCellRenderer<T>;
+    readonly floatingCellRenderer?: HeaderFloatingCellRenderer<T>;
     /**
      * Specifies the preferred width of the column. This value is ignored if flex sizing is used, or if it violates the column's min/max bounds.
      */
@@ -1305,6 +1347,8 @@ export interface ColumnMarker<T> {
  * are derived from the grid's internal column state and may change depending on modes
  * like pivoting. For example, when pivot mode is enabled, `columnsVisible` refers to
  * visible pivot columns instead of the regular ones.
+ *
+ * @group Column
  */
 export interface ColumnMeta<T> {
     /**
@@ -1338,6 +1382,8 @@ export interface ColumnMeta<T> {
  * - In right-to-left (RTL) mode, this behavior is reversed.
  *
  * This approach aligns with CSS logical properties for layout direction.
+ *
+ * @group Column
  */
 export type ColumnPin = "start" | "end" | null;
 /**
@@ -1346,6 +1392,8 @@ export type ColumnPin = "start" | "end" | null;
  * These hints indicate whether a column is eligible to act as a value, row group, or
  * column pivot in a pivot table configuration. External components can use these values
  * to determine pivot-related capabilities.
+ *
+ * @group Column
  */
 export interface ColumnPivotUIHints {
     /**
@@ -1373,6 +1421,8 @@ export interface ColumnPivotUIHints {
  * - What each cell renders
  * - How rows are grouped and sorted
  * - How filters are evaluated
+ *
+ * @group Column
  */
 export interface Column<T> {
     /**
@@ -1442,7 +1492,7 @@ export interface Column<T> {
     /**
      * Function used to render a floating row cell. Only called when floating rows are enabled. Must return a React node.
      */
-    readonly floatingRenderer?: HeaderFloatingCellRenderer<T>;
+    readonly floatingCellRenderer?: HeaderFloatingCellRenderer<T>;
     /**
      * Defines how to render the cell content. Accepts a renderer function or a string referencing a registered renderer.
      */
@@ -1486,6 +1536,8 @@ export interface Column<T> {
  *
  * These columns are created behind the scenes to represent group headers and aggregations
  * and can be configured via this interface.
+ *
+ * @group Column
  */
 export interface RowGroupColumn<T> {
     /**
@@ -1533,7 +1585,7 @@ export interface RowGroupColumn<T> {
     /**
      * Function used to render a floating row cell. Only called when floating rows are enabled. Must return a React node.
      */
-    readonly floatingRenderer?: HeaderFloatingCellRenderer<T>;
+    readonly floatingCellRenderer?: HeaderFloatingCellRenderer<T>;
     /**
      * Describes the capabilities and intended UI behavior of the column. These hints are used by external UI components.
      */
@@ -1547,46 +1599,6 @@ export interface RowGroupColumn<T> {
      */
     readonly autosizeHeaderFn?: AutosizeHeaderFn<T>;
 }
-/**
- * A set of optional UI hints that external consumers and LyteNyte Grid itself can use
- * to determine a column's capabilities.
- *
- * These hints inform the rendering of column headers (e.g. showing resize handles,
- * drag handles, sort indicators), but are not enforced. Developers can still override
- * behaviors via the grid state API directly.
- */
-export interface ColumnUIHints {
-    /**
-     * UI hint indicating whether this column supports sorting. LyteNyte Grid may
-     * hide sort controls if this is set to `false`.
-     */
-    readonly sortable?: boolean;
-    /**
-     * UI hint indicating whether this column can be used for row grouping.
-     */
-    readonly rowGroupable?: boolean;
-    /**
-     * UI hint indicating whether the column can be resized by the user.
-     * When set to `false`, resize handles will be hidden.
-     */
-    readonly resizable?: boolean;
-    /**
-     * UI hint indicating whether the column can be repositioned by dragging.
-     * This only affects drag-and-drop behaviors; programmatic moves are still possible.
-     */
-    readonly movable?: boolean;
-    /**
-     * UI hint specifying the default aggregation function to apply to this column.
-     *
-     * This is especially relevant in pivot mode or when row grouping is active.
-     */
-    readonly aggDefault?: string;
-    /**
-     * UI hint specifying the list of valid aggregation functions that can be applied to this column.
-     * If unset, the column may not support aggregation.
-     */
-    readonly aggsAllowed?: string[];
-}
 /**
  * UI hints describing column capabilities in LyteNyte Grid.
  *
@@ -1595,6 +1607,8 @@ export interface ColumnUIHints {
  * and can be bypassed by modifying grid state directly.
  *
  * Includes support for pivot-specific behaviors via {@link ColumnPivotUIHints}.
+ *
+ * @group Column
  */
 export interface ColumnUIHints {
     /**
@@ -1639,6 +1653,8 @@ export interface ColumnUIHints {
  * This metadata is auto-generated by the grid based on the configured column definitions.
  * It is used internally to manage layout and grouping behavior, but is also exposed for
  * advanced use cases where programmatic interaction with group structures is needed.
+ *
+ * @group Column Groups
  */
 export interface ColumnGroupMeta {
     /**
@@ -1668,16 +1684,61 @@ export interface ColumnGroupMeta {
 }
 /**
  * Controls the visibility behavior of a column within a column group.
- *
- * - `"always"`: The column is always visible regardless of the group's state.
- * - `"close"`: The column is visible only when the group is **collapsed**.
- * - `"open"`: The column is visible only when the group is **expanded**.
+ *   - `"always"`: The column is always visible regardless of the group's state.
+ *   - `"close"`: The column is visible only when the group is **collapsed**.
+ *   - `"open"`: The column is visible only when the group is **expanded**.
  *
  * Used to build dynamic, collapsible column group layouts in LyteNyte Grid.
+ *
+ * @group Column Groups
  */
 export type ColumnGroupVisibility = "always" | "close" | "open";
+/**
+ * Parameters required to initialize a client-side row data source.
+ *
+ * @group Row Data Source
+ */
+export interface ClientRowDataSourcePaginatedParams<T> {
+    /**
+     * The primary dataset passed to LyteNyte Grid for display.
+     */
+    readonly data: T[];
+    /**
+     * Rows to pin to the top of the grid, rendered above all scrollable rows.
+     */
+    readonly topData?: T[];
+    /**
+     * Rows to pin to the bottom of the grid, rendered below all scrollable rows.
+     */
+    readonly bottomData?: T[];
+    /**
+     * If true, the data source will reflect external mutations to the original data array.
+     */
+    readonly reflectData?: boolean;
+    /**
+     * Callback to derive a unique id for grouped (branch) rows based on group value path.
+     */
+    readonly rowIdBranch?: (path: string[]) => string;
+    /**
+     * Callback to derive a unique id for each leaf row. Receives the row data and index.
+     */
+    readonly rowIdLeaf?: (d: RowLeaf<T>, i: number) => string;
+    /**
+     * Callback that transforms a set of values for a given column into the in filter items LyteNyte Grid should use.
+     */
+    readonly transformInFilterItem?: (params: {
+        column: Column<T>;
+        values: unknown[];
+    }) => FilterInFilterItem[];
+    /**
+     * The number of rows to have per page. This will impact the total page count.
+     */
+    readonly rowsPerPage?: number;
+}
 /**
  * Enhanced parameters for a client-side row data source with additional filtering support.
+ *
+ * @group Row Data Source
  */
 export interface ClientRowDataSourceParams<T> {
     /**
@@ -1705,15 +1766,17 @@ export interface ClientRowDataSourceParams<T> {
      */
     readonly rowIdLeaf?: (d: RowLeaf<T>, i: number) => string;
     /**
-     * Callback that transforms a column in-filter item before it's applied.
+     * Callback that transforms a set of values for a given column into the in filter items LyteNyte Grid should use.
      */
     readonly transformInFilterItem?: (params: {
-        field: unknown;
         column: Column<T>;
-    }) => FilterInFilterItem;
+        values: unknown[];
+    }) => FilterInFilterItem[];
 }
 /**
  * Parameters for initializing a tree-structured data source in LyteNyte Grid.
+ *
+ * @group Row Data Source
  */
 export interface ClientTreeDataSourceParams<T> {
     /**
@@ -1741,12 +1804,12 @@ export interface ClientTreeDataSourceParams<T> {
      */
     readonly rowIdLeaf?: (d: RowLeaf<T>, i: number) => string;
     /**
-     * Callback that transforms a column in-filter item before it's applied.
+     * Callback that transforms a set of values for a given column into the in filter items LyteNyte Grid should use.
      */
     readonly transformInFilterItem?: (params: {
-        field: unknown;
         column: Column<T>;
-    }) => FilterInFilterItem;
+        values: unknown[];
+    }) => FilterInFilterItem[];
     /**
      * Returns the hierarchical path to group a given data row in tree mode.
      */
@@ -1757,6 +1820,8 @@ export interface ClientTreeDataSourceParams<T> {
  *   It divides the full dataset into pages based on the configured page
  *   size, reducing the number of rows rendered at any one time to
  *   improve UI responsiveness and performance.
+ *
+ *   @group Row Data Source
  */
 export interface RowDataSourceClientPaginated<T> {
     /**
@@ -1807,6 +1872,10 @@ export interface RowDataSourceClientPaginated<T> {
      * Adds new rows to the grid optionally at a specific index, beginning, or end.
      */
     readonly rowAdd: (newRows: any[], atIndex?: number | "beginning" | "end") => void;
+    /**
+     * Sets the data for the center rows (scrollable rows) of the grid. Effectively replacing the current row data.
+     */
+    readonly rowSetCenterData: (newRows: any[]) => void;
     /**
      * Sets the data for rows pinned to the top section.
      */
@@ -1822,12 +1891,20 @@ export interface RowDataSourceClientPaginated<T> {
     /**
      * Returns the available in-filter items for the specified column.
      *   May return items synchronously or as a Promise.
+     *
+     *   @group Row Data Source
      */
     readonly inFilterItems: (column: Column<T>) => Promise<FilterInFilterItem[]> | FilterInFilterItem[];
+    /**
+     * A client data source method to retrieve the raw data passed to the data source.
+     */
+    readonly rowData: (section: RowSection) => T[];
 }
 /**
  * Represents pagination-related state for the client row data source in
  *   LyteNyte Grid. These values enable pagination logic within the grid's UI and interactions.
+ *
+ *   @group Row Data Source
  */
 export interface RowDataSourceClientPageState {
     /**
@@ -1850,6 +1927,8 @@ export interface RowDataSourceClientPageState {
  *   This implementation is suitable for small to moderately sized datasets. For large-scale datasets, such as those
  *   exceeding hundreds of thousands of rows, a server-based data source
  *   is recommended for performance and memory efficiency.
+ *
+ *   @group Row Data Source
  */
 export interface RowDataSourceClient<T> {
     /**
@@ -1900,6 +1979,10 @@ export interface RowDataSourceClient<T> {
      * Adds new rows to the grid optionally at a specific index, beginning, or end.
      */
     readonly rowAdd: (newRows: any[], atIndex?: number | "beginning" | "end") => void;
+    /**
+     * Sets the data for the center rows (scrollable rows) of the grid. Effectively replacing the current row data.
+     */
+    readonly rowSetCenterData: (newRows: any[]) => void;
     /**
      * Sets the data for rows pinned to the top section.
      */
@@ -1911,12 +1994,20 @@ export interface RowDataSourceClient<T> {
     /**
      * Returns the available in-filter items for the specified column.
      *   May return items synchronously or as a Promise.
+     *
+     *   @group Row Data Source
      */
     readonly inFilterItems: (column: Column<T>) => Promise<FilterInFilterItem[]> | FilterInFilterItem[];
+    /**
+     * A client data source method to retrieve the raw data passed to the data source.
+     */
+    readonly rowData: (section: RowSection) => T[];
 }
 /**
  * The row data source interface used by LyteNyte Grid to retrieve and manage row data.
  *   This includes functionality for row expansion, selection, and CRUD operations.
+ *
+ *   @group Row Data Source
  */
 export interface RowDataSource<T> {
     /**
@@ -1967,6 +2058,10 @@ export interface RowDataSource<T> {
      * Adds new rows to the grid optionally at a specific index, beginning, or end.
      */
     readonly rowAdd: (newRows: any[], atIndex?: number | "beginning" | "end") => void;
+    /**
+     * Sets the data for the center rows (scrollable rows) of the grid. Effectively replacing the current row data.
+     */
+    readonly rowSetCenterData: (newRows: any[]) => void;
     /**
      * Sets the data for rows pinned to the top section.
      */
@@ -1978,6 +2073,8 @@ export interface RowDataSource<T> {
     /**
      * Returns the available in-filter items for the specified column.
      *   May return items synchronously or as a Promise.
+     *
+     *   @group Row Data Source
      */
     readonly inFilterItems: (column: Column<T>) => Promise<FilterInFilterItem[]> | FilterInFilterItem[];
 }
@@ -1990,6 +2087,8 @@ export interface RowDataSource<T> {
  *   grouping, and pagination—must be handled on the server. This design provides
  *   maximum flexibility and scalability, including support for server-driven trees
  *   and pagination, but requires a more complex implementation on the backend.
+ *
+ *   @group Row Data Source
  */
 export interface RowDataSourceServer<T> {
     /**
@@ -2040,6 +2139,10 @@ export interface RowDataSourceServer<T> {
      * Adds new rows to the grid optionally at a specific index, beginning, or end.
      */
     readonly rowAdd: (newRows: any[], atIndex?: number | "beginning" | "end") => void;
+    /**
+     * Sets the data for the center rows (scrollable rows) of the grid. Effectively replacing the current row data.
+     */
+    readonly rowSetCenterData: (newRows: any[]) => void;
     /**
      * Sets the data for rows pinned to the top section.
      */
@@ -2051,6 +2154,8 @@ export interface RowDataSourceServer<T> {
     /**
      * Returns the available in-filter items for the specified column.
      *   May return items synchronously or as a Promise.
+     *
+     *   @group Row Data Source
      */
     readonly inFilterItems: (column: Column<T>) => Promise<FilterInFilterItem[]> | FilterInFilterItem[];
     /**
@@ -2084,6 +2189,8 @@ export interface RowDataSourceServer<T> {
 }
 /**
  * The internal row data store used by LyteNyte Grid to manage row metadata, counts, and access functions.
+ *
+ * @group Row Data Source
  */
 export interface RowDataStore<T> {
     /**
@@ -2117,6 +2224,8 @@ export interface RowDataStore<T> {
 }
 /**
  * Parameters passed to the row selection handler within the row data source.
+ *
+ * @group Row Data Source
  */
 export interface RdsRowSelectParams {
     /**
@@ -2143,69 +2252,95 @@ export interface RdsRowSelectParams {
 /**
  * Represents a mutable piece of reactive grid state. This atom allows reading,
  *   updating, watching, and consuming its value reactively within React components.
+ *
+ *   @group Grid Atom
  */
 export interface GridAtom<T> {
     /**
      * Retrieves the current value stored in the atom. This method provides read access
      *   to the state managed by the atom.
+     *
+     *   @group Grid Atom
      */
     readonly get: () => T;
     /**
      * Updates the atom's value. Accepts either a new value or a function that receives
      *   the current value and returns the updated value.
+     *
+     *   @group Grid Atom
      */
     readonly set: (v: T | ((p: T) => T)) => void;
     /**
      * Registers a listener function to be invoked whenever the atom's value changes.
      *   Returns a cleanup function to remove the listener.
+     *
+     *   @group Grid Atom
      */
     readonly watch: (fn: () => void) => () => void;
     /**
      * A React hook that subscribes to the atom's value and causes the component to re-render
      *   whenever the atom changes.
+     *
+     *   @group Grid Atom
      */
     readonly useValue: () => T;
 }
 /**
  * Represents an immutable version of a grid atom that supports read, watch, and reactive
  *   usage but does not allow updates.
+ *
+ *   @group Grid Atom
  */
 export interface GridAtomReadonly<T> {
     /**
      * Retrieves the current value stored in the atom. This method provides read access
      *   to the state managed by the atom.
+     *
+     *   @group Grid Atom
      */
     readonly get: () => T;
     /**
      * Registers a listener function to be invoked whenever the atom's value changes.
      *   Returns a cleanup function to remove the listener.
+     *
+     *   @group Grid Atom
      */
     readonly watch: (fn: () => void) => () => void;
     /**
      * A React hook that subscribes to the atom's value and causes the component to re-render
      *   whenever the atom changes.
+     *
+     *   @group Grid Atom
      */
     readonly useValue: () => T;
 }
 /**
  * Represents the most minimal read-only version of a grid atom. It supports value
  *   retrieval and reactive consumption, but not watching or updates.
+ *
+ *   @group Grid Atom
  */
 export interface GridAtomReadonlyUnwatchable<T> {
     /**
      * Retrieves the current value stored in the atom. This method provides read access
      *   to the state managed by the atom.
+     *
+     *   @group Grid Atom
      */
     readonly get: () => T;
     /**
      * A React hook that subscribes to the atom's value and causes the component to re-render
      *   whenever the atom changes.
+     *
+     *   @group Grid Atom
      */
     readonly useValue: () => T;
 }
 /**
  * Predicate function to determine if a row should render in full-width mode.
  * Commonly used for custom summary or grouped views.
+ *
+ * @group Row
  */
 export type RowFullWidthPredicate<T> = (
 /**
@@ -2215,6 +2350,8 @@ params: RowFullWidthPredicateParams<T>) => boolean;
 /**
  * Parameters provided to the {@link RowFullWidthPredicate} function to determine
  * if a row should span full width of the grid.
+ *
+ * @group Row
  */
 export interface RowFullWidthPredicateParams<T> {
     /**
@@ -2232,6 +2369,8 @@ export interface RowFullWidthPredicateParams<T> {
 }
 /**
  * Function to render the full-width row content. Returns a ReactNode to be rendered as the row.
+ *
+ * @group Row
  */
 export type RowFullWidthRendererFn<T> = (
 /**
@@ -2241,6 +2380,8 @@ params: RowFullWidthRendererParams<T>) => ReactNode;
 /**
  * Parameters provided to the full-width row renderer.
  * Includes row metadata and selection state.
+ *
+ * @group Row
  */
 export interface RowFullWidthRendererParams<T> {
     /**
@@ -2267,6 +2408,8 @@ export interface RowFullWidthRendererParams<T> {
 /**
  * Represents a group (branch) row which may contain children rows (leaf or other groups).
  * Group rows are used in hierarchical views and support expansion/collapse behavior.
+ *
+ * @group Row
  */
 export interface RowGroup {
     /**
@@ -2307,11 +2450,15 @@ export interface RowGroup {
  * - A fixed number (e.g. 30),
  * - A fill value (e.g. `fill:1`),
  * - A function that returns dynamic row height based on index.
+ *
+ * @group Row
  */
 export type RowHeight = number | `fill:${number}` | ((i: number) => number);
 /**
  * Represents a leaf row in the grid. A leaf row is a terminal node that has no children.
  * These rows typically represent the raw dataset and are used for aggregations and visual representation.
+ *
+ * @group Row
  */
 export interface RowLeaf<T = any> {
     /**
@@ -2342,6 +2489,8 @@ export interface RowLeaf<T = any> {
 /**
  * A union of {@link RowLeaf} and {@link RowGroup}. Represents any row that may appear in the grid view.
  * Used generically when the row type is not known ahead of time.
+ *
+ * @group Row
  */
 export type RowNode<T> = RowLeaf<T> | RowGroup;
 /**
@@ -2350,6 +2499,8 @@ export type RowNode<T> = RowLeaf<T> | RowGroup;
  * - "bottom": pinned to bottom,
  * - null: not pinned.
  * Pinned rows remain visible during scrolling.
+ *
+ * @group Row
  */
 export type RowPin = "top" | "bottom" | null;
 /**
@@ -2358,6 +2509,8 @@ export type RowPin = "top" | "bottom" | null;
  * - "bottom": pinned to the bottom area,
  * - "center": scrollable middle area,
  * - "flat": single flattened section.
+ *
+ * @group Row
  */
 export type RowSection = "top" | "bottom" | "center" | "flat";
 /**
@@ -2389,6 +2542,8 @@ export type RowSection = "top" | "bottom" | "center" | "flat";
  *
  * Cells that are spanned over (i.e. covered by another cell's span) will not be rendered and
  * are excluded from the layout and DOM. Ensure your span logic accounts for this behavior.
+ *
+ * @group Row And Column Spanning
  */
 export type CellSpanFn<T> = (
 /**
@@ -2406,6 +2561,8 @@ params: CellSpanFnParams<T>) => number;
  * - The row node representing the full row data
  *
  * Used to compute dynamic row or column spans for advanced layout use cases.
+ *
+ * @group Row And Column Spanning
  */
 export interface CellSpanFnParams<T> {
     /**
@@ -2433,6 +2590,8 @@ export interface CellSpanFnParams<T> {
  *   - A `branch` form, representing nested row structures with a key lookup
  *
  *   Note: These do not include attributes like `rowId` or `rowIndex` as those may not be available yet.
+ *
+ *   @group Field
  */
 export type FieldDataParam<T> = {
     kind: "leaf";
@@ -2446,6 +2605,8 @@ export type FieldDataParam<T> = {
  * A dynamic field function used to derive values for a column.
  *
  *   This function may be invoked repeatedly, once per cell per column, so it must be optimized for efficiency.
+ *
+ *   @group Field
  */
 export type FieldFn<T> = (
 /**
@@ -2457,6 +2618,8 @@ params: FieldFnParams<T>) => unknown;
  *
  *   LyteNyte Grid calls these functions dynamically during rendering or computation.
  *   These calls can occur frequently (e.g., for every cell in a column), so implementations should prioritize performance.
+ *
+ *   @group Field
  */
 export interface FieldFnParams<T> {
     /**
@@ -2469,6 +2632,8 @@ export interface FieldFnParams<T> {
     readonly column: Column<T>;
     /**
      * A representation of the row data, used in computing custom fields or sorting logic.
+     *
+     * @group Field
      */
     readonly data: FieldDataParam<T>;
 }
@@ -2476,6 +2641,8 @@ export interface FieldFnParams<T> {
  * Specifies a string-based path used to extract values from a nested data structure, similar to `lodash.get`.
  *
  *   Example: `"point.x"` will return `data.point.x`. Useful for deeply nested row data.
+ *
+ *   @group field
  */
 export interface FieldPath {
     /**
@@ -2491,6 +2658,8 @@ export interface FieldPath {
  * A function used to derive row grouping values distinct from cell display values.
  *
  *   Ideal for customizing how rows are grouped in the UI or logic layer.
+ *
+ *   @group Field
  */
 export type FieldRowGroupFn<T> = (
 /**
@@ -2501,6 +2670,8 @@ params: FieldRowGroupParamsFn<T>) => unknown;
  * Defines the parameters used for custom row group field functions.
  *
  *   Enables grouping logic to be decoupled from the data's displayed value.
+ *
+ *   @group Field
  */
 export interface FieldRowGroupParamsFn<T> {
     /**
@@ -2515,6 +2686,8 @@ export interface FieldRowGroupParamsFn<T> {
 /**
  * Defines the acceptable formats for row group fields.
  *   Includes primitives, path-based accessors, or a custom function for grouping behavior.
+ *
+ *   @group Field
  */
 export type FieldRowGroup<T> = number | string | FieldPath | FieldRowGroupFn<T>;
 /**
@@ -2523,6 +2696,8 @@ export type FieldRowGroup<T> = number | string | FieldPath | FieldRowGroupFn<T>;
  * - A primitive value (`string` or `number`)
  * - A path-based accessor
  * - A custom function for dynamic computation
+ *
+ * @group Field
  */
 export type Field<T> = number | string | FieldPath | FieldFn<T>;
 /**
@@ -2532,6 +2707,8 @@ export type Field<T> = number | string | FieldPath | FieldFn<T>;
  * optimized for performance, as slow renderers may degrade the overall responsiveness of the grid.
  *
  * Avoid unnecessary re-renders or expensive calculations inside this function.
+ *
+ * @group Cell Rendering
  */
 export type CellRendererFn<T> = (
 /**
@@ -2544,6 +2721,8 @@ params: CellRendererParams<T>) => ReactNode;
  *
  * Includes metadata and context such as the grid instance, row and column positions, selection state,
  * and the full row node data.
+ *
+ * @group Cell Rendering
  */
 export interface CellRendererParams<T> {
     /**
@@ -2574,9 +2753,15 @@ export interface CellRendererParams<T> {
      * Indicates whether the row is in an indeterminate selection state.
      */
     readonly rowIndeterminate: boolean;
+    /**
+     * The pinning state of a row, used to fix it to the top or bottom of the grid.
+     */
+    readonly rowPin: RowPin;
 }
 /**
  * The parameters the `columnAutosize` method accepts.
+ *
+ *   @group Grid API
  */
 export interface ColumnAutosizeParams<T> {
     /**
@@ -2594,6 +2779,8 @@ export interface ColumnAutosizeParams<T> {
 }
 /**
  * The parameters that may be provided to the `columnMove` API method.
+ *
+ *   @group Grid API
  */
 export interface ColumnMoveParams<T> {
     /**
@@ -2622,6 +2809,8 @@ export interface ColumnMoveParams<T> {
  * - A row/column pair to focus a specific cell.
  * - A header or group header cell position.
  * - A directional alias ("next", "prev", "up", "down") relative to the current focus (only when the grid is focused).
+ *
+ * @group Grid API
  */
 export type FocusCellParams<T> = {
     row: number;
@@ -2630,6 +2819,8 @@ export type FocusCellParams<T> = {
 /**
  * The LyteNyte Grid API provides a comprehensive set of methods that allow developers
  *   to programmatically query, update, and manipulate grid state and data.
+ *
+ *   @group Grid API
  */
 export interface GridApi<T> {
     /**
@@ -2642,7 +2833,7 @@ export interface GridApi<T> {
      * Returns the column at the specified visible index. If the index is out of bounds or
      *   the column is hidden (due to visibility rules or collapsed groups), this will return null.
      */
-    readonly columnFromIndex: (columnIndex: number) => Column<T> | null;
+    readonly columnByIndex: (columnIndex: number) => Column<T> | null;
     /**
      * Returns the index of a visible column based on its id or column object.
      *   Returns -1 if the column is not currently visible (e.g., hidden or inside a collapsed group).
@@ -2805,16 +2996,22 @@ export interface GridApi<T> {
     /**
      * Returns the raw cell data within a rectangular selection of the grid.
      *   This can be useful for custom data processing or exporting workflows.
+     *
+     *   @group Grid API
      */
-    readonly exportDataRect: (params?: ExportDataRectParams) => ExportDataRectResult<T>;
+    readonly exportDataRect: (params?: ExportDataRectParams) => Promise<ExportDataRectResult<T>>;
     /**
      * Exports the cell data for a given rectangle of the grid as a CSV-formatted string.
      *   The rectangle can be customized through parameters such as selected rows, columns, or cell ranges.
+     *
+     *   @group Grid API
      */
     readonly exportCsv: (params?: ExportCsvParams) => Promise<string>;
     /**
      * Generates a downloadable CSV `Blob` from the selected rectangular area of grid cell data.
      *   Can be used to trigger a file download in the browser.
+     *
+     *   @group Grid API
      */
     readonly exportCsvFile: (params?: ExportCsvParams) => Promise<Blob>;
     /**
@@ -2846,6 +3043,8 @@ export interface GridApi<T> {
 }
 /**
  * The parameters used for the `rowHandleSelect` API method of LyteNyte Grid.
+ *
+ *   @group Grid API
  */
 export interface RowHandleSelectParams {
     /**
@@ -2860,6 +3059,8 @@ export interface RowHandleSelectParams {
 /**
  * Options for the `scrollIntoView` API. Allows you to scroll a specific row and/or column into view,
  *     ensuring they are visible in the viewport.
+ *
+ *     @group Grid API
  */
 export interface ScrollIntoViewOptions<T> {
     /**
@@ -2879,6 +3080,8 @@ export interface ScrollIntoViewOptions<T> {
  * Represents a virtual DOM target with bounding information, used in situations
  *   where a physical DOM element does not exist. Commonly used for positioning popovers
  *   or overlays within LyteNyte Grid.
+ *
+ *   @group Frames
  */
 export interface VirtualTarget {
     /**
@@ -2899,6 +3102,8 @@ export interface VirtualTarget {
 }
 /**
  * Function signature for custom sort comparators.
+ *
+ * @group Sort
  */
 export type SortComparatorFn<T> = (
 /**
@@ -2915,14 +3120,20 @@ right: FieldDataParam<T>,
 options: any) => number;
 /**
  * Predefined sort comparator types supported by LyteNyte Grid.
+ *
+ * @group Sort
  */
 export type SortComparators = "string" | "number" | "date" | (string & {});
 /**
  * Definition for a user-defined custom sort comparator.
+ *
+ * @group Sort
  */
 export interface SortCustomSort<T> {
     /**
      * The column identifier associated with the sort. May be null if not defined.
+     *
+     * @group Sort
      */
     readonly columnId: string | null;
     /**
@@ -2940,6 +3151,8 @@ export interface SortCustomSort<T> {
 }
 /**
  * A built-in date sort model definition.
+ *
+ * @group Sort
  */
 export interface SortDateColumnSort {
     /**
@@ -2953,10 +3166,14 @@ export interface SortDateColumnSort {
 }
 /**
  * Options used for date-based sorting.
+ *
+ * @group Sort
  */
 export interface SortDateComparatorOptions {
     /**
      * A boolean indicating if null values should appear first in the sort order.
+     *
+     * @group Sort
      */
     readonly nullsFirst?: boolean;
     /**
@@ -2970,10 +3187,14 @@ export interface SortDateComparatorOptions {
 }
 /**
  * Union of all supported grid sort types.
+ *
+ * @group Sort
  */
 export type SortGridSorts<T> = SortCustomSort<T> | SortDateColumnSort | SortNumberColumnSort | SortStringColumnSort;
 /**
  * A model item representing an active sort applied to the grid.
+ *
+ * @group Sort
  */
 export interface SortModelItem<T> {
     /**
@@ -2982,6 +3203,8 @@ export interface SortModelItem<T> {
     readonly sort: SortGridSorts<T>;
     /**
      * The column identifier associated with the sort. May be null if not defined.
+     *
+     * @group Sort
      */
     readonly columnId: string | null;
     /**
@@ -2991,6 +3214,8 @@ export interface SortModelItem<T> {
 }
 /**
  * A built-in numeric sort model definition.
+ *
+ * @group Sort
  */
 export interface SortNumberColumnSort {
     /**
@@ -3004,10 +3229,14 @@ export interface SortNumberColumnSort {
 }
 /**
  * Options for number-based sorting.
+ *
+ * @group Sort
  */
 export interface SortNumberComparatorOptions {
     /**
      * A boolean indicating if null values should appear first in the sort order.
+     *
+     * @group Sort
      */
     readonly nullsFirst?: boolean;
     /**
@@ -3017,6 +3246,8 @@ export interface SortNumberComparatorOptions {
 }
 /**
  * A built-in string sort model definition.
+ *
+ * @group Sort
  */
 export interface SortStringColumnSort {
     /**
@@ -3030,6 +3261,8 @@ export interface SortStringColumnSort {
 }
 /**
  * Options used when sorting string values.
+ *
+ * @group Sort
  */
 export interface SortStringComparatorOptions {
     /**
@@ -3054,6 +3287,8 @@ export interface SortStringComparatorOptions {
     readonly collator?: Intl.Collator;
     /**
      * A boolean indicating if null values should appear first in the sort order.
+     *
+     * @group Sort
      */
     readonly nullsFirst?: boolean;
 }
@@ -3063,6 +3298,8 @@ export interface SortStringComparatorOptions {
  *
  * Combination filters enable complex conditional logic by nesting
  * different filters into a tree structure.
+ *
+ * @group Filters
  */
 export interface FilterCombination {
     /**
@@ -3085,6 +3322,8 @@ export interface FilterCombination {
 }
 /**
  * Logical operators used to join multiple filters inside a combination filter.
+ *
+ * @group Filters
  */
 export type FilterCombinationOperator = "AND" | "OR";
 /**
@@ -3096,6 +3335,8 @@ export type FilterCombinationOperator = "AND" | "OR";
  *
  * If filtering on timestamps or partial dates, be mindful of timezone offsets and whether
  * time components are relevant to your comparison.
+ *
+ * @group Filters
  */
 export interface FilterDate {
     /**
@@ -3136,6 +3377,8 @@ export interface FilterDate {
  * relative date expressions (e.g., "n_days_ago", "last_week", "is_weekend").
  *
  * The required type of the `value` field depends on the selected operator.
+ *
+ * @group Filters
  */
 export type FilterDateOperator = "equals" | "not_equals" | "before" | "before_or_equals" | "after" | "after_or_equals" | "year_to_date" | "this_week" | "this_month" | "this_year" | "last_week" | "last_month" | "last_year" | "next_week" | "next_month" | "next_year" | "today" | "tomorrow" | "yesterday" | "week_of_year" | "quarter_of_year" | "is_weekend" | "is_weekday" | "n_days_ago" | "n_days_ahead" | "n_weeks_ago" | "n_weeks_ahead" | "n_months_ago" | "n_months_ahead" | "n_years_ago" | "n_years_ahead";
 /**
@@ -3143,6 +3386,8 @@ export type FilterDateOperator = "equals" | "not_equals" | "before" | "before_or
  *
  * Includes options like null handling and whether time values should be considered
  * during comparisons.
+ *
+ * @group Filters
  */
 export interface FilterDateOptions {
     /**
@@ -3170,6 +3415,8 @@ export interface FilterDateOptions {
  * be represented using built-in filter types.
  *
  * The function should return `true` to keep a row or `false` to filter it out.
+ *
+ * @group Filters
  */
 export type FilterFn<T> = (
 /**
@@ -3181,6 +3428,8 @@ params: FilterFnParams<T>) => boolean;
  * The parameters passed to a custom function filter.
  *
  * Includes both the current row's data and the overall grid configuration.
+ *
+ * @group Filters
  */
 export interface FilterFnParams<T> {
     /**
@@ -3197,6 +3446,8 @@ export interface FilterFnParams<T> {
  * for filtering scenarios that don't conform to basic models.
  *
  * Should be used selectively and optimized for performance.
+ *
+ * @group Filters
  */
 export interface FilterFunc<T> {
     /**
@@ -3214,6 +3465,8 @@ export interface FilterFunc<T> {
  *
  * Often referred to as a "Set Filter", this is a PRO-only feature in
  * LyteNyte Grid and cannot be nested in combination filters.
+ *
+ * @group Filters
  */
 export interface FilterIn {
     /**
@@ -3238,6 +3491,8 @@ export interface FilterIn {
  * Represents a displayable filter option for use with the `in` filter UI component.
  *
  * Supports grouping and human-friendly labeling for raw filter values.
+ *
+ * @group Filters
  */
 export interface FilterInFilterItem {
     /**
@@ -3266,10 +3521,14 @@ export interface FilterInFilterItem {
  *
  * - `"in"`: Tests for inclusion in the set.
  * - `"not_in"`: Tests for exclusion from the set.
+ *
+ * @group Filters
  */
 export type FilterInOperator = "in" | "not_in";
 /**
  * The full set of filter types available in the LyteNyte Grid.
+ *
+ * @group Filters
  */
 export type FilterModelItem<T> = FilterNumber | FilterString | FilterDate | FilterCombination | FilterFunc<T>;
 /**
@@ -3277,8 +3536,7 @@ export type FilterModelItem<T> = FilterNumber | FilterString | FilterDate | Filt
  *
  * Applies common comparison logic to include or exclude rows based on numerical values in a specified column.
  *
- * See:
- * - [Filters](TODO): Overview of the filters
+ * @group Filters
  */
 export interface FilterNumber {
     /**
@@ -3295,8 +3553,7 @@ export interface FilterNumber {
     /**
      * Target value for the filter.
      *
-     * This will be used as the right-hand operand when applying the operator to each row's value.
-     * May be `null` if specifically filtering for nulls.
+     * This will be used as the right-hand operand when applying the operator to each row's value. May be `null` if specifically filtering for nulls.
      */
     readonly value: number | null;
     /**
@@ -3308,16 +3565,17 @@ export interface FilterNumber {
 }
 /**
  * Logical operators available for number-based filtering.
+ * These correspond to the traditional comparison operators, `>, <=`, etc.
+ *
  *
- * These correspond to traditional comparison operators:
- * - `greater_than` → `>`
- * - `less_than_or_equals` → `<=`
- * etc.
+ * @group Filters
  */
 export type FilterNumberOperator = "greater_than" | "greater_than_or_equals" | "less_than" | "less_than_or_equals" | "equals" | "not_equals";
 /**
  * Optional configuration values for number filters. These options allow fine-tuning of filter behavior,
  * especially in cases involving precision or null handling.
+ *
+ * @group Filters
  */
 export interface FilterNumberOptions {
     /**
@@ -3351,12 +3609,16 @@ export interface FilterNumberOptions {
  *
  * - `"case-sensitive"`: Exact matches required.
  * - `"case-insensitive"`: Case differences are ignored.
+ *
+ * @group Filters
  */
 export type FilterQuickSearchSensitivity = "case-sensitive" | "case-insensitive";
 /**
  * Filter configuration for string-based column data.
  *
  * Supports a wide range of operators such as exact match, substring containment, regex matching, and string length comparisons.
+ *
+ * @group Filters
  */
 export interface FilterString {
     /**
@@ -3387,6 +3649,8 @@ export interface FilterString {
  * Collation configuration for locale-sensitive string comparisons.
  *
  * Used to construct an `Intl.Collator` instance, which enables proper handling of language and region-specific rules.
+ *
+ * @group Filters
  */
 export interface FilterStringCollation {
     /**
@@ -3408,6 +3672,8 @@ export interface FilterStringCollation {
  * These include comparison operators (e.g., "equals"), substring checks (e.g., "contains"), and
  * length-based checks (e.g., "length_less_than"). Some operators require a numeric `value`
  * (e.g., those dealing with string length).
+ *
+ * @group Filters
  */
 export type FilterStringOperator = "equals" | "not_equals" | "less_than" | "less_than_or_equals" | "greater_than" | "greater_than_or_equals" | "begins_with" | "not_begins_with" | "ends_with" | "not_ends_with" | "contains" | "not_contains" | "length" | "not_length" | "matches" | "length_less_than" | "length_less_than_or_equals" | "length_greater_than" | "length_greater_than_or_equals";
 /**
@@ -3415,6 +3681,8 @@ export type FilterStringOperator = "equals" | "not_equals" | "less_than" | "less
  *
  * These provide control over how string values are matched, such as case sensitivity, whitespace trimming,
  * regular expression flags, and locale-based collation.
+ *
+ * @group Filters
  */
 export interface FilterStringOptions {
     /**
@@ -3459,11 +3727,15 @@ export interface FilterStringOptions {
  * The supported locale identifiers for string filtering and collation.
  *
  * Used to configure internationalized string comparison behavior.
+ *
+ * @group Filters
  */
 export type Locale = "en-US" | "en-GB" | "en-CA" | "en-AU" | "en-IN" | "fr-FR" | "fr-CA" | "fr-BE" | "fr-CH" | "es-ES" | "es-MX" | "es-AR" | "es-CO" | "zh-CN" | "zh-TW" | "zh-HK" | "zh-Hant" | "zh-Hans" | "ar-SA" | "ar-EG" | "ar-AE" | "de-DE" | "de-AT" | "de-CH" | "ja-JP" | "ko-KR" | "hi-IN" | "pt-BR" | "pt-PT" | "ru-RU" | "uk-UA" | "pl-PL" | "it-IT" | "nl-NL" | "sv-SE" | "tr-TR" | "th-TH" | "vi-VN" | "he-IL" | "fa-IR" | "el-GR";
 /**
  * Defines the function signature for custom
  *   aggregation logic that computes a result based on grid data.
+ *
+ *   @group Row Grouping
  */
 export type AggFn<T> = (
 /**
@@ -3478,15 +3750,21 @@ grid: Grid<T>) => unknown;
  * Describes the aggregation model configuration.
  *   This can be either a string referencing a built-in
  *   aggregation or a custom function.
+ *
+ *   @group Row Grouping
  */
 export type AggModelFn<T> = string | AggFn<T>;
 /**
  * Enumerates the display modes available for
  *   row groups in LyteNyte Grid.
+ *
+ *   @group Row Grouping
  */
 export type RowGroupDisplayMode = "single-column" | "multi-column" | "custom";
 /**
  * Defines a field-based grouping configuration used to compute row group keys in the grid.
+ *
+ *   @group Row Grouping
  */
 export interface RowGroupField<T> {
     /**
@@ -3508,10 +3786,14 @@ export interface RowGroupField<T> {
 }
 /**
  * An item in the row group model. This can either be a column identifier (string) or a row group field definition.
+ *
+ *   @group Row Grouping
  */
 export type RowGroupModelItem<T> = string | RowGroupField<T>;
 /**
  * A callback function type for the columnMoveBegin event, fired when a column move starts.
+ *
+ * @group Events
  */
 export type ColumnMoveBeginFn<T> = (
 /**
@@ -3520,6 +3802,8 @@ export type ColumnMoveBeginFn<T> = (
 params: ColumnMoveBeginParams<T>) => void;
 /**
  * The parameters provided when a column move operation begins. This event allows the move action to be canceled.
+ *
+ * @group Events
  */
 export interface ColumnMoveBeginParams<T> {
     /**
@@ -3549,6 +3833,8 @@ export interface ColumnMoveBeginParams<T> {
 }
 /**
  * A callback function type for the columnMoveEnd event, fired when a column move completes.
+ *
+ * @group Events
  */
 export type ColumnMoveEndFn<T> = (
 /**
@@ -3557,6 +3843,8 @@ export type ColumnMoveEndFn<T> = (
 params: ColumnMoveEndParams<T>) => void;
 /**
  * The parameters emitted when a column move operation has completed.
+ *
+ * @group Events
  */
 export interface ColumnMoveEndParams<T> {
     /**
@@ -3582,6 +3870,8 @@ export interface ColumnMoveEndParams<T> {
 }
 /**
  * An event fired when a cell begins editing. This provides an opportunity to cancel the edit before any changes are made.
+ *
+ *   @group Events
  */
 export type EditBegin<T> = (
 /**
@@ -3590,6 +3880,8 @@ export type EditBegin<T> = (
 params: OnEditBeginParams<T>) => void;
 /**
  * An event fired when an in-progress cell edit is canceled. Most commonly triggered by user interaction, such as pressing the Escape key.
+ *
+ *   @group Events
  */
 export type EditCancel<T> = (
 /**
@@ -3598,6 +3890,8 @@ export type EditCancel<T> = (
 params: OnEditCancelParams<T>) => void;
 /**
  * An event fired when a cell finishes editing successfully (i.e., without error or cancellation).
+ *
+ *   @group Events
  */
 export type EditEnd<T> = (
 /**
@@ -3606,6 +3900,8 @@ export type EditEnd<T> = (
 params: OnEditEndParams<T>) => void;
 /**
  * An event fired when an error occurs during cell editing—either due to validation failure or runtime exception.
+ *
+ *   @group Events
  */
 export type EditError<T> = (
 /**
@@ -3614,6 +3910,8 @@ export type EditError<T> = (
 params: OnEditErrorParams<T>) => void;
 /**
  * A comprehensive map of all possible events that LyteNyte Grid may emit during its lifecycle.
+ *
+ * @group Events
  */
 export interface GridEvents<T> {
     /**
@@ -3687,6 +3985,8 @@ export interface GridEvents<T> {
 }
 /**
  * An event fired when the row detail expansion process begins. This provides an opportunity to cancel expansion before it takes effect.
+ *
+ *   @group Events
  */
 export type RowDetailExpansionBegin<T> = (
 /**
@@ -3695,6 +3995,9 @@ export type RowDetailExpansionBegin<T> = (
 params: RowDetailExpansionBeginParams<T>) => void;
 /**
  * The parameters for the `rowDetailExpansionBegin` event. This event allows preventing expansion of row detail sections by calling `preventDefault()`.
+ *
+ *
+ *   @group Events
  */
 export interface RowDetailExpansionBeginParams<T> {
     /**
@@ -3712,6 +4015,8 @@ export interface RowDetailExpansionBeginParams<T> {
 }
 /**
  * An event fired after the row detail expansion completes successfully.
+ *
+ *   @group Events
  */
 export type RowDetailExpansionEnd<T> = (
 /**
@@ -3720,6 +4025,9 @@ export type RowDetailExpansionEnd<T> = (
 params: RowDetailExpansionEndParams<T>) => void;
 /**
  * The parameters for the `rowDetailExpansionEnd` event, fired once a row detail expansion operation is complete.
+ *
+ *
+ *   @group Events
  */
 export interface RowDetailExpansionEndParams<T> {
     /**
@@ -3733,6 +4041,8 @@ export interface RowDetailExpansionEndParams<T> {
 }
 /**
  * Event handler function type for the `rowExpand` event. Called when row group expansion is successfully completed.
+ *
+ *   @group Events
  */
 export type RowExpandFn<T> = (
 /**
@@ -3741,6 +4051,8 @@ export type RowExpandFn<T> = (
 params: RowExpandParams<T>) => void;
 /**
  * Event handler function type for the `rowExpandBegin` event. Triggered before row group expansion, allowing you to cancel the operation.
+ *
+ *   @group Events
  */
 export type RowExpandBeginFn<T> = (
 /**
@@ -3749,6 +4061,8 @@ export type RowExpandBeginFn<T> = (
 params: RowExpandBeginParams<T>) => void;
 /**
  * Describes the parameters passed to the `rowExpandBegin` event. This event is triggered before row group expansion occurs and provides a way to cancel the action.
+ *
+ * @group Events
  */
 export interface RowExpandBeginParams<T> {
     /**
@@ -3768,6 +4082,8 @@ export interface RowExpandBeginParams<T> {
 }
 /**
  * Event handler function type for the `rowExpandError` event. Called when row group expansion fails due to an error.
+ *
+ *   @group Events
  */
 export type RowExpandErrorFn<T> = (
 /**
@@ -3776,6 +4092,8 @@ export type RowExpandErrorFn<T> = (
 params: RowExpandErrorParams<T>) => void;
 /**
  * Describes the parameters passed to the `rowExpandError` event. This event is emitted when an error occurs during row group expansion.
+ *
+ *   @group Events
  */
 export interface RowExpandErrorParams<T> {
     /**
@@ -3795,6 +4113,8 @@ export interface RowExpandErrorParams<T> {
 }
 /**
  * Describes the parameters passed to the `rowExpand` event. This event is emitted after a row group has been successfully expanded.
+ *
+ *   @group Events
  */
 export interface RowExpandParams<T> {
     /**
@@ -3810,6 +4130,8 @@ export interface RowExpandParams<T> {
 }
 /**
  * An event triggered when the "select all" operation begins. It provides an opportunity to cancel the selection.
+ *
+ * @group Events
  */
 export type RowSelectAllBegin<T> = (
 /**
@@ -3818,6 +4140,8 @@ export type RowSelectAllBegin<T> = (
 params: RowSelectAllBeginParams<T>) => void;
 /**
  * The parameters provided when a "select all" operation starts. This event allows the operation to be canceled.
+ *
+ * @group Events
  */
 export interface RowSelectAllBeginParams<T> {
     /**
@@ -3836,6 +4160,8 @@ export interface RowSelectAllBeginParams<T> {
 }
 /**
  * An event triggered once the "select all" operation is complete.
+ *
+ * @group Events
  */
 export type RowSelectAllEnd<T> = (
 /**
@@ -3844,6 +4170,8 @@ export type RowSelectAllEnd<T> = (
 params: RowSelectAllEndParams<T>) => void;
 /**
  * The parameters passed when a "select all" operation completes.
+ *
+ * @group Events
  */
 export interface RowSelectAllEndParams<T> {
     /**
@@ -3858,6 +4186,8 @@ export interface RowSelectAllEndParams<T> {
 }
 /**
  * An event triggered when a row selection starts. This event allows cancellation before the selection is finalized.
+ *
+ * @group Events
  */
 export type RowSelectBegin<T> = (
 /**
@@ -3867,6 +4197,8 @@ params: RowSelectBeginParams<T>) => void;
 /**
  * The parameters provided when a row selection begins. This event occurs before the selection change takes effect,
  * giving the caller an opportunity to prevent it.
+ *
+ * @group Events
  */
 export interface RowSelectBeginParams<T> {
     /**
@@ -3889,6 +4221,8 @@ export interface RowSelectBeginParams<T> {
 }
 /**
  * An event triggered once the row selection is finalized.
+ *
+ * @group Events
  */
 export type RowSelectEnd<T> = (
 /**
@@ -3897,6 +4231,8 @@ export type RowSelectEnd<T> = (
 params: RowSelectEndParams<T>) => void;
 /**
  * The parameters passed when a row selection has completed.
+ *
+ * @group Events
  */
 export interface RowSelectEndParams<T> {
     /**
@@ -3916,6 +4252,8 @@ export interface RowSelectEndParams<T> {
 /**
  * A function used to render the content of a header cell.
  *   It receives renderer parameters and returns a ReactNode to render.
+ *
+ *   @group Column Header
  */
 export type HeaderCellRendererFn<T> = (
 /**
@@ -3925,6 +4263,8 @@ params: HeaderCellRendererParams<T>) => ReactNode;
 /**
  * Parameters passed to the header cell renderer function. This
  *   provides access to the grid and column for rendering context.
+ *
+ *   @group Column Header
  */
 export interface HeaderCellRendererParams<T> {
     /**
@@ -3939,6 +4279,8 @@ export interface HeaderCellRendererParams<T> {
 /**
  * Renderer function for floating header cells. Returns the visual
  *   contents for floating headers using provided parameters.
+ *
+ *   @group Column Header
  */
 export type HeaderFloatingCellRendererFn<T> = (
 /**
@@ -3948,6 +4290,8 @@ params: HeaderFloatingCellRendererParams<T>) => ReactNode;
 /**
  * Parameters passed to the floating cell renderer. Provides grid
  *   and column context to determine what should be rendered.
+ *
+ *   @group Column Header
  */
 export interface HeaderFloatingCellRendererParams<T> {
     /**
@@ -3962,17 +4306,23 @@ export interface HeaderFloatingCellRendererParams<T> {
 /**
  * Floating header cell renderer reference. Can be a string
  *   referencing a registered floating renderer or a function used directly by the column.
+ *
+ *   @group Column Header
  */
 export type HeaderFloatingCellRenderer<T> = string | HeaderFloatingCellRendererFn<T>;
 /**
  * Header cell renderer reference. This may be a registered renderer
  *   name (string) or a renderer function. If a string is used, it should match a renderer registered in the grid state.
+ *
+ *   @group Column Header
  */
 export type HeaderCellRenderer<T> = string | HeaderCellRendererFn<T>;
 /**
  * Describes the currently active cell position if editing is in progress.
  *
  * When no edit is active, this will be `undefined`.
+ *
+ * @group Cell Edit
  */
 export interface EditActivePosition<T> {
     /**
@@ -3986,6 +4336,8 @@ export interface EditActivePosition<T> {
 }
 /**
  * Parameters accepted by the `editBegin` method to start editing a specific cell.
+ *
+ * @group Cell Edit
  */
 export interface EditBeginParams<T> {
     /**
@@ -4007,6 +4359,8 @@ export interface EditBeginParams<T> {
  *
  * - `"cell"`: Editing is active and inline
  * - `"readonly"`: Editing is disabled entirely
+ *
+ * @group Cell Edit
  */
 export type EditCellMode = "cell" | "readonly";
 /**
@@ -4015,6 +4369,9 @@ export type EditCellMode = "cell" | "readonly";
  * - `"single"`: Single click
  * - `"double-click"`: Double click
  * - `"none"`: Editing must be started via API or programmatically
+ *
+ *
+ * @group Cell Edit
  */
 export type EditClickActivator = "single" | "double-click" | "none";
 /**
@@ -4023,12 +4380,16 @@ export type EditClickActivator = "single" | "double-click" | "none";
  * Can be either:
  * - A string key referencing a registered editor component
  * - A function of type {@link EditRendererFn} for custom rendering logic
+ *
+ * @group Cell Edit
  */
 export type EditRenderer<T> = string | EditRendererFn<T>;
 /**
  * A function that returns a React component to be rendered in edit mode for a given cell.
  *
  * Used for customizing editing UI. If omitted, a default HTML input will be used.
+ *
+ * @group Cell Edit
  */
 export type EditRendererFn<T> = (
 /**
@@ -4040,6 +4401,8 @@ params: EditRendererFnParams<T>) => ReactNode;
  *
  * These include positional and contextual data such as row, column, value, and grid
  * instance, along with row validation status and change handlers.
+ *
+ * @group Cell Edit
  */
 export interface EditRendererFnParams<T> {
     /**
@@ -4064,6 +4427,8 @@ export interface EditRendererFnParams<T> {
      * - `false`: validation failed
      * - `true` or `null`: validation passed or hasn't run
      * - `Record<string, any>`: failed with details per column
+     *
+     * @group Cell Edit
      */
     readonly rowValidationState: Record<string, any> | boolean | null;
     /**
@@ -4071,6 +4436,8 @@ export interface EditRendererFnParams<T> {
      *
      * Managed internally by the grid, but should be aligned with the expected shape of your
      * application's data model.
+     *
+     * @group Cell Edit
      */
     readonly value: any;
     /**
@@ -4087,6 +4454,8 @@ export interface EditRendererFnParams<T> {
  *
  * - `true` or `null` if the row is valid
  * - `false` or a `Record<string, any>` describing errors if invalid
+ *
+ * @group Cell Edit
  */
 export type EditRowValidatorFn<T> = (
 /**
@@ -4097,6 +4466,8 @@ params: EditRowValidatorFnParams<T>) => Record<string, any> | boolean;
  * Input arguments passed to {@link EditRowValidatorFn}.
  *
  * Used to perform validation on the entire row during or after edit submission.
+ *
+ * @group Cell Edit
  */
 export interface EditRowValidatorFnParams<T> {
     /**
@@ -4121,6 +4492,8 @@ export interface EditRowValidatorFnParams<T> {
  *
  * Required when dealing with nested, computed, or non-primitive values that the grid
  * cannot update automatically.
+ *
+ * @group Cell Edit
  */
 export type EditSetterFn<T> = (
 /**
@@ -4131,6 +4504,8 @@ params: EditSetterParams<T>) => any;
  * Input parameters passed to an {@link EditSetterFn}.
  *
  * Provides the context needed to compute and apply new row data based on edit input.
+ *
+ * @group Cell Edit
  */
 export interface EditSetterParams<T> {
     /**
@@ -4149,6 +4524,11 @@ export interface EditSetterParams<T> {
      * A reference to a column definition in LyteNyte Grid.
      */
     readonly column: Column<T>;
+    /**
+     * The current edit value of the cell being edited. Useful when the cell is derived from data and not
+     * actually present in the row data.
+     */
+    readonly value: any;
     /**
      * The new row data after applying edits. This is an intermediate representation,
      * not yet committed to the grid.
@@ -4157,6 +4537,8 @@ export interface EditSetterParams<T> {
 }
 /**
  * Parameters passed to the `editUpdate` method, used to submit a value change.
+ *
+ * @group Cell Edit
  */
 export interface EditUpdateParams<T> {
     /**
@@ -4178,6 +4560,8 @@ export interface EditUpdateParams<T> {
  *
  * - Use `true` to enable editing for all rows.
  * - Use {@link EditableFn} for conditional, row-specific editability.
+ *
+ * @group Cell Edit
  */
 export type Editable<T> = boolean | EditableFn<T>;
 /**
@@ -4185,6 +4569,8 @@ export type Editable<T> = boolean | EditableFn<T>;
  *
  * If cell editing is enabled in LyteNyte Grid, this function is evaluated per cell. Use
  * `true` for globally editable columns or {@link EditableFn} for row-specific logic.
+ *
+ * @group Cell Edit
  */
 export type EditableFn<T> = (
 /**
@@ -4197,6 +4583,8 @@ params: EditableFnParams<T>) => boolean;
  *
  * These include the row index, the row node object, the grid instance, and the column
  * definition.
+ *
+ * @group Cell Edit
  */
 export interface EditableFnParams<T> {
     /**
@@ -4218,6 +4606,8 @@ export interface EditableFnParams<T> {
 }
 /**
  * Parameters dispatched with the `onEditBegin` event, triggered when editing starts.
+ *
+ * @group Events
  */
 export interface OnEditBeginParams<T> {
     /**
@@ -4235,6 +4625,8 @@ export interface OnEditBeginParams<T> {
 }
 /**
  * Parameters passed to the `onEditCancel` event, triggered when editing is aborted (e.g., Escape key).
+ *
+ * @group Events
  */
 export interface OnEditCancelParams<T> {
     /**
@@ -4247,11 +4639,15 @@ export interface OnEditCancelParams<T> {
     readonly rowIndex: number;
     /**
      * The current value of the cell during an edit interaction.
+     *
+     * @group Events
      */
     readonly data: any;
 }
 /**
  * Parameters passed to the `onEditEnd` event, triggered when editing successfully completes.
+ *
+ * @group Events
  */
 export interface OnEditEndParams<T> {
     /**
@@ -4264,11 +4660,15 @@ export interface OnEditEndParams<T> {
     readonly rowIndex: number;
     /**
      * The current value of the cell during an edit interaction.
+     *
+     * @group Events
      */
     readonly data: any;
 }
 /**
  * Parameters passed to the `onEditError` event, triggered when validation or logic errors occur during editing.
+ *
+ * @group Events
  */
 export interface OnEditErrorParams<T> {
     /**
@@ -4281,6 +4681,8 @@ export interface OnEditErrorParams<T> {
     readonly rowIndex: number;
     /**
      * The current value of the cell during an edit interaction.
+     *
+     * @group Events
      */
     readonly data: any;
     /**
@@ -4295,6 +4697,8 @@ export interface OnEditErrorParams<T> {
 }
 /**
  * Describes the focus position of a floating header cell.
+ *
+ *   @group Navigation
  */
 export interface PositionFloatingCell {
     /**
@@ -4308,6 +4712,8 @@ export interface PositionFloatingCell {
 }
 /**
  * Describes the focus position when a full width row is active.
+ *
+ *   @group Navigation
  */
 export interface PositionFullWidthRow {
     /**
@@ -4325,6 +4731,8 @@ export interface PositionFullWidthRow {
 }
 /**
  * Represents the current focus position of a regular cell in the grid.
+ *
+ *   @group Navigation
  */
 export interface PositionGridCell {
     /**
@@ -4347,6 +4755,8 @@ export interface PositionGridCell {
 /**
  * The root reference of a grid cell. If a cell is obscured by a rowspan
  *   or colspan, it points to the actual root cell containing the data.
+ *
+ *   @group Navigation
  */
 export interface PositionGridCellRoot {
     /**
@@ -4368,6 +4778,8 @@ export interface PositionGridCellRoot {
 }
 /**
  * Describes the focus position of a standard header cell.
+ *
+ *   @group Navigation
  */
 export interface PositionHeaderCell {
     /**
@@ -4381,6 +4793,8 @@ export interface PositionHeaderCell {
 }
 /**
  * Describes the focus position of a header group cell in the column hierarchy.
+ *
+ *   @group Navigation
  */
 export interface PositionHeaderGroupCell {
     /**
@@ -4406,17 +4820,23 @@ export interface PositionHeaderGroupCell {
 }
 /**
  * Union of all valid focusable positions in the grid: cells, headers, full width rows, etc.
+ *
+ *   @group Navigation
  */
 export type PositionUnion = PositionGridCell | PositionFloatingCell | PositionHeaderCell | PositionFullWidthRow | PositionHeaderGroupCell;
 /**
  * Specifies the height of the row detail section.
  *   Can be a fixed number of pixels or "auto" to size based on content.
+ *
+ *   @group Row Data Source
  */
 export type RowDetailHeight = number | "auto";
 /**
  * A function used to render custom row detail content.
  *   It should return a ReactNode to be displayed in the row's
  *   expanded detail area.
+ *
+ *   @group Row Data Source
  */
 export type RowDetailRendererFn<T> = (
 /**
@@ -4427,6 +4847,8 @@ params: RowDetailRendererParams<T>) => ReactNode;
  * Defines the parameters passed to a row detail renderer. These parameters
  *   include the row index, the row node metadata,
  *   and a reference to the grid instance.
+ *
+ *   @group Row Data Source
  */
 export interface RowDetailRendererParams<T> {
     /**
@@ -4444,6 +4866,8 @@ export interface RowDetailRendererParams<T> {
 }
 /**
  * Options for performing bulk selection or deselection of all rows.
+ *
+ * @group Row Selection
  */
 export interface RowSelectAllOptions {
     /**
@@ -4453,6 +4877,8 @@ export interface RowSelectAllOptions {
 }
 /**
  * Configuration options used when performing row selection operations.
+ *
+ * @group Row Selection
  */
 export interface RowSelectOptions {
     /**
@@ -4481,6 +4907,8 @@ export interface RowSelectOptions {
  *   - "single-click" selects a row with a single mouse click.
  *   - "double-click" requires a double-click to select.
  *   - "none" disables interaction-based row selection.
+ *
+ *   @group Row Selection
  */
 export type RowSelectionActivator = "single-click" | "double-click" | "none";
 /**
@@ -4488,11 +4916,15 @@ export type RowSelectionActivator = "single-click" | "double-click" | "none";
  *   - "single" allows only one row to be selected at a time.
  *   - "multiple" allows multiple row selections.
  *   - "none" disables row selection entirely.
+ *
+ *   @group Row Selection
  */
 export type RowSelectionMode = "single" | "multiple" | "none";
 /**
  * Contains data associated with a drag operation,
  *   including transferable and site-local information.
+ *
+ *   @group Row Drag
  */
 export interface DragData {
     /**
@@ -4507,6 +4939,8 @@ export interface DragData {
 }
 /**
  * Callback function executed during a drag event.
+ *
+ *   @group Row Drag
  */
 export type DragEventFn = (
 /**
@@ -4515,6 +4949,8 @@ export type DragEventFn = (
 params: DragEventParams) => void;
 /**
  * Arguments passed during a drag event lifecycle.
+ *
+ *   @group Row Drag
  */
 export interface DragEventParams {
     /**
@@ -4533,6 +4969,8 @@ export interface DragEventParams {
 /**
  * Function to render the drag placeholder UI. This UI
  *   is rendered in isolation and does not respond to app state changes.
+ *
+ *   @group Row Drag
  */
 export type DragPlaceholderFn<T> = (
 /**
@@ -4541,6 +4979,8 @@ export type DragPlaceholderFn<T> = (
 params: DragPlaceholderParams<T>) => ReactNode;
 /**
  * Parameters passed when rendering the drag placeholder content.
+ *
+ * @group Row Drag
  */
 export interface DragPlaceholderParams<T> {
     /**
@@ -4554,6 +4994,8 @@ export interface DragPlaceholderParams<T> {
 }
 /**
  * Represents the current pointer position during a drag operation.
+ *
+ *   @group Row Drag
  */
 export interface DragPosition {
     /**
@@ -4567,6 +5009,8 @@ export interface DragPosition {
 }
 /**
  * Fired when a drop action is finalized and the dragged element is released over a drop zone.
+ *
+ * @group Row Drag
  */
 export type DropEventFn = (
 /**
@@ -4575,6 +5019,8 @@ export type DropEventFn = (
 params: DropEventParams) => void;
 /**
  * Represents the full context passed to the drop event handler.
+ *
+ * @group Row Drag
  */
 export interface DropEventParams {
     /**
@@ -4596,6 +5042,8 @@ export interface DropEventParams {
 }
 /**
  * Describes the final state of a drag-and-drop move operation.
+ *
+ *   @group Row Drag
  */
 export interface DragMoveState {
     /**
@@ -4633,6 +5081,8 @@ export interface DragMoveState {
 }
 /**
  * Function used to provide the data that will be associated with a drag operation.
+ *
+ *   @group Row Drag
  */
 export type GetDragDataFn<T> = (
 /**
@@ -4642,6 +5092,8 @@ params: GetDragDataParams<T>) => DragData;
 /**
  * Defines the input parameters for the function
  *   that provides data during a drag operation.
+ *
+ *   @group Row Drag
  */
 export interface GetDragDataParams<T> {
     /**
@@ -4655,6 +5107,8 @@ export interface GetDragDataParams<T> {
 }
 /**
  * Parameters for configuring drag behavior using a React hook.
+ *
+ * @group Row Drag
  */
 export interface UseRowDragParams<T> {
     /**
@@ -4721,6 +5175,8 @@ export interface UseRowDragParams<T> {
  * or operate on a subset of the grid's data regardless of row or column reordering. However,
  * if the number of rows or columns changes, the rect may be invalidated if it extends
  * beyond the new bounds.
+ *
+ * @group Export
  */
 export interface DataRect {
     /**
@@ -4742,6 +5198,8 @@ export interface DataRect {
 }
 /**
  * Parameters for exporting a CSV file from LyteNyte Grid.
+ *
+ * @group Export
  */
 export interface ExportCsvParams {
     /**
@@ -4771,14 +5229,18 @@ export interface ExportCsvParams {
  * Signature for the function that exports a DataRect from the grid.
  *
  * Called via the LyteNyte Grid API when exporting a selection of cells.
+ *
+ * @group Export
  */
 export type ExportDataRectFn<T> = (
 /**
  * Optional parameters for exporting a DataRect.
  */
-params: ExportDataRectParams) => ExportDataRectResult<T>;
+params: ExportDataRectParams) => Promise<ExportDataRectResult<T>>;
 /**
  * Parameters for exporting a specific rectangular region of the grid using a DataRect.
+ *
+ * @group Export
  */
 export interface ExportDataRectParams {
     /**
@@ -4794,6 +5256,8 @@ export interface ExportDataRectParams {
 }
 /**
  * The result structure returned after exporting a DataRect from LyteNyte Grid.
+ *
+ * @group Export
  */
 export interface ExportDataRectResult<T> {
     /**
@@ -4817,6 +5281,8 @@ export interface ExportDataRectResult<T> {
  * Configuration for the column dimension of a pivot.
  *
  * Each item defines a field whose values will be used to generate dynamic columns in the pivot view.
+ *
+ * @group Column Pivots
  */
 export interface ColumnPivotColumnItem {
     /**
@@ -4835,6 +5301,8 @@ export interface ColumnPivotColumnItem {
  *
  * This includes row grouping, column generation, value aggregation, and sort/filter
  * configuration for the pivoted result.
+ *
+ * @group Column Pivots
  */
 export interface ColumnPivotModel<T> {
     /**
@@ -4875,6 +5343,8 @@ export interface ColumnPivotModel<T> {
  * Configuration for row-level grouping in a column pivot model.
  *
  * These items define which fields should be used to group rows before creating pivot columns.
+ *
+ * @group Column Pivots
  */
 export interface ColumnPivotRowItem {
     /**
@@ -4892,6 +5362,8 @@ export interface ColumnPivotRowItem {
  * Configuration for value fields in a pivot (also known as measures).
  *
  * These values define what numeric or aggregate data should be shown for each cell in the pivot result.
+ *
+ * @group Column Pivots
  */
 export interface ColumnPivotValueItem<T> {
     /**
@@ -4914,6 +5386,8 @@ export interface ColumnPivotValueItem<T> {
  *
  *   This structure is passed to grid internals to associate a rendering component
  *   for dialogs triggered by grid interactions.
+ *
+ *   @group Frames
  */
 export interface DialogFrame<T> {
     /**
@@ -4929,6 +5403,8 @@ export interface DialogFrame<T> {
  *   control parameters and should return a valid ReactNode to render as a dialog.
  *
  *   Note: The dialog component used should support controlled open/close behavior.
+ *
+ *   @group Frames
  */
 export type DialogFrameRenderer<T> = (
 /**
@@ -4940,6 +5416,8 @@ params: DialogFrameRendererParams<T>) => ReactNode;
  *
  *   These include the grid context, the frame being rendered, and any additional
  *   user-provided context.
+ *
+ *   @group Frames
  */
 export interface DialogFrameRendererParams<T> {
     /**
@@ -4951,6 +5429,8 @@ export interface DialogFrameRendererParams<T> {
      *
      *   This context is supplied programmatically at the point of invoking the frame.
      *   It can contain any arbitrary information required for rendering behavior.
+     *
+     *   @group Frames
      */
     readonly context?: any;
     /**
@@ -4963,6 +5443,8 @@ export interface DialogFrameRendererParams<T> {
  *
  *   The popover frame is triggered by LyteNyte Grid interactions and used to display
  *   contextual information, editors, or auxiliary UI near a cell or element.
+ *
+ *   @group Frames
  */
 export interface PopoverFrame<T> {
     /**
@@ -4975,6 +5457,8 @@ export interface PopoverFrame<T> {
  *
  *   LyteNyte Grid does not include a built-in popover renderer. Developers must use their
  *   own popover UI libraries and integrate them by implementing this renderer interface.
+ *
+ *   @group Frames
  */
 export type PopoverFrameRenderer<T> = (
 /**
@@ -4986,6 +5470,8 @@ params: PopoverFrameRendererParams<T>) => ReactNode;
  *
  *   Includes information about the grid, the target HTML element or virtual
  *   target to anchor the popover, and the frame being rendered.
+ *
+ *   @group Frames
  */
 export interface PopoverFrameRendererParams<T> {
     /**
@@ -4997,6 +5483,8 @@ export interface PopoverFrameRendererParams<T> {
      *
      *   This context is supplied programmatically at the point of invoking the frame.
      *   It can contain any arbitrary information required for rendering behavior.
+     *
+     *   @group Frames
      */
     readonly context?: any;
     /**
@@ -5018,10 +5506,14 @@ export interface PopoverFrameRendererParams<T> {
  * - `"none"`: Disables all cell selection interactions.
  *
  * Useful for enabling features like copy-paste, cell highlighting, and keyboard navigation.
+ *
+ * @group Cell Selection
  */
 export type CellSelectionMode = "range" | "multi-range" | "none";
 /**
  * Fetches pivoted columns for the grid's current pivot configuration.
+ *
+ * @group Row Data Source
  */
 export type DataColumnPivotFetcherFn<T> = (
 /**
@@ -5030,6 +5522,8 @@ export type DataColumnPivotFetcherFn<T> = (
 params: DataColumnPivotFetcherParams<T>) => Promise<Column<T>[]>;
 /**
  * Parameters passed to the column pivot fetcher function.
+ *
+ * @group Row Data Source
  */
 export interface DataColumnPivotFetcherParams<T> {
     /**
@@ -5047,6 +5541,8 @@ export interface DataColumnPivotFetcherParams<T> {
 }
 /**
  * Fetches grid row data asynchronously for the LyteNyte Server Data Source.
+ *
+ * @group Row Data Source
  */
 export type DataFetcherFn<T> = (
 /**
@@ -5055,6 +5551,8 @@ export type DataFetcherFn<T> = (
 params: DataFetcherParams<T>) => Promise<(DataResponse | DataResponsePinned)[]>;
 /**
  * Input parameters provided to a grid data fetcher function.
+ *
+ * @group Row Data Source
  */
 export interface DataFetcherParams<T> {
     /**
@@ -5076,6 +5574,8 @@ export interface DataFetcherParams<T> {
 }
 /**
  * Fetches items used in "in" filters from a server-side source.
+ *
+ * @group Row Data Source
  */
 export type DataInFilterItemFetcherFn<T> = (
 /**
@@ -5084,6 +5584,8 @@ export type DataInFilterItemFetcherFn<T> = (
 params: DataInFilterItemFetcherParams<T>) => Promise<FilterInFilterItem[]> | FilterInFilterItem[];
 /**
  * Parameters passed to the in-filter fetcher function.
+ *
+ * @group Row Data Source
  */
 export interface DataInFilterItemFetcherParams<T> {
     /**
@@ -5101,6 +5603,8 @@ export interface DataInFilterItemFetcherParams<T> {
 }
 /**
  * Represents a specific request for data to an external data source.
+ *
+ * @group Row Data Source
  */
 export interface DataRequest {
     /**
@@ -5130,6 +5634,8 @@ export interface DataRequest {
 }
 /**
  * Describes the current grid state used to construct a request for external data.
+ *
+ * @group Row Data Source
  */
 export interface DataRequestModel<T> {
     /**
@@ -5179,6 +5685,8 @@ export interface DataRequestModel<T> {
 }
 /**
  * Response object for row data from a center section request.
+ *
+ * @group Row Data Source
  */
 export interface DataResponse {
     /**
@@ -5212,6 +5720,8 @@ export interface DataResponse {
 }
 /**
  * Represents a group (branch) row returned from a data request.
+ *
+ * @group Row Data Source
  */
 export interface DataResponseBranchItem {
     /**
@@ -5237,6 +5747,8 @@ export interface DataResponseBranchItem {
 }
 /**
  * Represents a row of data (a leaf node) returned in a server response.
+ *
+ * @group Row Data Source
  */
 export interface DataResponseLeafItem {
     /**
@@ -5254,6 +5766,8 @@ export interface DataResponseLeafItem {
 }
 /**
  * Response object for setting pinned row data (top or bottom).
+ *
+ * @group Row Data Source
  */
 export interface DataResponsePinned {
     /**
@@ -5271,6 +5785,8 @@ export interface DataResponsePinned {
 }
 /**
  * Parameters for configuring the server row data source.
+ *
+ * @group Row Data Source
  */
 export interface RowDataSourceServerParams<T> {
     /**