@1771technologies/lytenyte-pro 1.0.0-beta.34 → 1.0.0-beta.37

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> {
     /**
@@ -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> {
     /**
@@ -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> {
     /**
@@ -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> {
     /**
@@ -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 {
     /**
@@ -1674,10 +1690,14 @@ export interface ColumnGroupMeta {
  * - `"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> {
     /**
@@ -1718,6 +1738,8 @@ export interface ClientRowDataSourcePaginatedParams<T> {
 }
 /**
  * Enhanced parameters for a client-side row data source with additional filtering support.
+ *
+ * @group Row Data Source
  */
 export interface ClientRowDataSourceParams<T> {
     /**
@@ -1754,6 +1776,8 @@ export interface ClientRowDataSourceParams<T> {
 }
 /**
  * Parameters for initializing a tree-structured data source in LyteNyte Grid.
+ *
+ * @group Row Data Source
  */
 export interface ClientTreeDataSourceParams<T> {
     /**
@@ -1797,6 +1821,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> {
     /**
@@ -1866,6 +1892,8 @@ 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[];
     /**
@@ -1876,6 +1904,8 @@ export interface RowDataSourceClientPaginated<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 {
     /**
@@ -1898,6 +1928,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> {
     /**
@@ -1963,6 +1995,8 @@ 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[];
     /**
@@ -1973,6 +2007,8 @@ export interface RowDataSourceClient<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> {
     /**
@@ -2038,6 +2074,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[];
 }
@@ -2050,6 +2088,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> {
     /**
@@ -2115,6 +2155,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[];
     /**
@@ -2148,6 +2190,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> {
     /**
@@ -2181,6 +2225,8 @@ export interface RowDataStore<T> {
 }
 /**
  * Parameters passed to the row selection handler within the row data source.
+ *
+ * @group Row Data Source
  */
 export interface RdsRowSelectParams {
     /**
@@ -2207,69 +2253,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> = (
 /**
@@ -2279,6 +2351,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> {
     /**
@@ -2296,6 +2370,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> = (
 /**
@@ -2305,6 +2381,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> {
     /**
@@ -2331,6 +2409,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 {
     /**
@@ -2371,11 +2451,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> {
     /**
@@ -2406,6 +2490,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;
 /**
@@ -2414,6 +2500,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;
 /**
@@ -2422,6 +2510,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";
 /**
@@ -2453,6 +2543,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> = (
 /**
@@ -2470,6 +2562,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> {
     /**
@@ -2497,6 +2591,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";
@@ -2510,6 +2606,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> = (
 /**
@@ -2521,6 +2619,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> {
     /**
@@ -2533,6 +2633,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>;
 }
@@ -2540,6 +2642,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 {
     /**
@@ -2555,6 +2659,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> = (
 /**
@@ -2565,6 +2671,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> {
     /**
@@ -2579,6 +2687,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>;
 /**
@@ -2587,6 +2697,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>;
 /**
@@ -2596,6 +2708,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> = (
 /**
@@ -2608,6 +2722,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> {
     /**
@@ -2645,6 +2761,8 @@ export interface CellRendererParams<T> {
 }
 /**
  * The parameters the `columnAutosize` method accepts.
+ *
+ *   @group Grid API
  */
 export interface ColumnAutosizeParams<T> {
     /**
@@ -2662,6 +2780,8 @@ export interface ColumnAutosizeParams<T> {
 }
 /**
  * The parameters that may be provided to the `columnMove` API method.
+ *
+ *   @group Grid API
  */
 export interface ColumnMoveParams<T> {
     /**
@@ -2690,6 +2810,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;
@@ -2698,6 +2820,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> {
     /**
@@ -2873,16 +2997,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) => 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>;
     /**
@@ -2914,6 +3044,8 @@ export interface GridApi<T> {
 }
 /**
  * The parameters used for the `rowHandleSelect` API method of LyteNyte Grid.
+ *
+ *   @group Grid API
  */
 export interface RowHandleSelectParams {
     /**
@@ -2928,6 +3060,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> {
     /**
@@ -2947,6 +3081,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 {
     /**
@@ -2967,6 +3103,8 @@ export interface VirtualTarget {
 }
 /**
  * Function signature for custom sort comparators.
+ *
+ * @group Sort
  */
 export type SortComparatorFn<T> = (
 /**
@@ -2983,14 +3121,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;
     /**
@@ -3008,6 +3152,8 @@ export interface SortCustomSort<T> {
 }
 /**
  * A built-in date sort model definition.
+ *
+ * @group Sort
  */
 export interface SortDateColumnSort {
     /**
@@ -3021,10 +3167,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;
     /**
@@ -3038,10 +3188,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> {
     /**
@@ -3050,6 +3204,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;
     /**
@@ -3059,6 +3215,8 @@ export interface SortModelItem<T> {
 }
 /**
  * A built-in numeric sort model definition.
+ *
+ * @group Sort
  */
 export interface SortNumberColumnSort {
     /**
@@ -3072,10 +3230,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;
     /**
@@ -3085,6 +3247,8 @@ export interface SortNumberComparatorOptions {
 }
 /**
  * A built-in string sort model definition.
+ *
+ * @group Sort
  */
 export interface SortStringColumnSort {
     /**
@@ -3098,6 +3262,8 @@ export interface SortStringColumnSort {
 }
 /**
  * Options used when sorting string values.
+ *
+ * @group Sort
  */
 export interface SortStringComparatorOptions {
     /**
@@ -3122,6 +3288,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;
 }
@@ -3131,6 +3299,8 @@ export interface SortStringComparatorOptions {
  *
  * Combination filters enable complex conditional logic by nesting
  * different filters into a tree structure.
+ *
+ * @group Filters
  */
 export interface FilterCombination {
     /**
@@ -3153,6 +3323,8 @@ export interface FilterCombination {
 }
 /**
  * Logical operators used to join multiple filters inside a combination filter.
+ *
+ * @group Filters
  */
 export type FilterCombinationOperator = "AND" | "OR";
 /**
@@ -3164,6 +3336,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 {
     /**
@@ -3204,6 +3378,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";
 /**
@@ -3211,6 +3387,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 {
     /**
@@ -3238,6 +3416,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> = (
 /**
@@ -3249,6 +3429,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> {
     /**
@@ -3265,6 +3447,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> {
     /**
@@ -3282,6 +3466,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 {
     /**
@@ -3306,6 +3492,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 {
     /**
@@ -3334,10 +3522,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>;
 /**
@@ -3345,8 +3537,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 {
     /**
@@ -3363,8 +3554,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;
     /**
@@ -3376,16 +3566,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 {
     /**
@@ -3419,12 +3610,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 {
     /**
@@ -3455,6 +3650,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 {
     /**
@@ -3476,6 +3673,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";
 /**
@@ -3483,6 +3682,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 {
     /**
@@ -3527,11 +3728,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> = (
 /**
@@ -3546,15 +3751,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> {
     /**
@@ -3576,10 +3787,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> = (
 /**
@@ -3588,6 +3803,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> {
     /**
@@ -3617,6 +3834,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> = (
 /**
@@ -3625,6 +3844,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> {
     /**
@@ -3650,6 +3871,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> = (
 /**
@@ -3658,6 +3881,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> = (
 /**
@@ -3666,6 +3891,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> = (
 /**
@@ -3674,6 +3901,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> = (
 /**
@@ -3682,6 +3911,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> {
     /**
@@ -3755,6 +3986,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> = (
 /**
@@ -3763,6 +3996,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> {
     /**
@@ -3780,6 +4016,8 @@ export interface RowDetailExpansionBeginParams<T> {
 }
 /**
  * An event fired after the row detail expansion completes successfully.
+ *
+ *   @group Events
  */
 export type RowDetailExpansionEnd<T> = (
 /**
@@ -3788,6 +4026,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> {
     /**
@@ -3801,6 +4042,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> = (
 /**
@@ -3809,6 +4052,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> = (
 /**
@@ -3817,6 +4062,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> {
     /**
@@ -3836,6 +4083,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> = (
 /**
@@ -3844,6 +4093,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> {
     /**
@@ -3863,6 +4114,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> {
     /**
@@ -3878,6 +4131,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> = (
 /**
@@ -3886,6 +4141,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> {
     /**
@@ -3904,6 +4161,8 @@ export interface RowSelectAllBeginParams<T> {
 }
 /**
  * An event triggered once the "select all" operation is complete.
+ *
+ * @group Events
  */
 export type RowSelectAllEnd<T> = (
 /**
@@ -3912,6 +4171,8 @@ export type RowSelectAllEnd<T> = (
 params: RowSelectAllEndParams<T>) => void;
 /**
  * The parameters passed when a "select all" operation completes.
+ *
+ * @group Events
  */
 export interface RowSelectAllEndParams<T> {
     /**
@@ -3926,6 +4187,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> = (
 /**
@@ -3935,6 +4198,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> {
     /**
@@ -3957,6 +4222,8 @@ export interface RowSelectBeginParams<T> {
 }
 /**
  * An event triggered once the row selection is finalized.
+ *
+ * @group Events
  */
 export type RowSelectEnd<T> = (
 /**
@@ -3965,6 +4232,8 @@ export type RowSelectEnd<T> = (
 params: RowSelectEndParams<T>) => void;
 /**
  * The parameters passed when a row selection has completed.
+ *
+ * @group Events
  */
 export interface RowSelectEndParams<T> {
     /**
@@ -3984,6 +4253,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> = (
 /**
@@ -3993,6 +4264,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> {
     /**
@@ -4007,6 +4280,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> = (
 /**
@@ -4016,6 +4291,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> {
     /**
@@ -4030,17 +4307,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> {
     /**
@@ -4054,6 +4337,8 @@ export interface EditActivePosition<T> {
 }
 /**
  * Parameters accepted by the `editBegin` method to start editing a specific cell.
+ *
+ * @group Cell Edit
  */
 export interface EditBeginParams<T> {
     /**
@@ -4075,6 +4360,8 @@ export interface EditBeginParams<T> {
  *
  * - `"cell"`: Editing is active and inline
  * - `"readonly"`: Editing is disabled entirely
+ *
+ * @group Cell Edit
  */
 export type EditCellMode = "cell" | "readonly";
 /**
@@ -4083,6 +4370,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";
 /**
@@ -4091,12 +4381,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> = (
 /**
@@ -4108,6 +4402,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> {
     /**
@@ -4132,6 +4428,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;
     /**
@@ -4139,6 +4437,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;
     /**
@@ -4155,6 +4455,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> = (
 /**
@@ -4165,6 +4467,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> {
     /**
@@ -4189,6 +4493,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> = (
 /**
@@ -4199,6 +4505,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> {
     /**
@@ -4230,6 +4538,8 @@ export interface EditSetterParams<T> {
 }
 /**
  * Parameters passed to the `editUpdate` method, used to submit a value change.
+ *
+ * @group Cell Edit
  */
 export interface EditUpdateParams<T> {
     /**
@@ -4251,6 +4561,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>;
 /**
@@ -4258,6 +4570,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> = (
 /**
@@ -4270,6 +4584,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> {
     /**
@@ -4291,6 +4607,8 @@ export interface EditableFnParams<T> {
 }
 /**
  * Parameters dispatched with the `onEditBegin` event, triggered when editing starts.
+ *
+ * @group Events
  */
 export interface OnEditBeginParams<T> {
     /**
@@ -4308,6 +4626,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> {
     /**
@@ -4320,11 +4640,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> {
     /**
@@ -4337,11 +4661,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> {
     /**
@@ -4354,6 +4682,8 @@ export interface OnEditErrorParams<T> {
     readonly rowIndex: number;
     /**
      * The current value of the cell during an edit interaction.
+     *
+     * @group Events
      */
     readonly data: any;
     /**
@@ -4368,6 +4698,8 @@ export interface OnEditErrorParams<T> {
 }
 /**
  * Describes the focus position of a floating header cell.
+ *
+ *   @group Navigation
  */
 export interface PositionFloatingCell {
     /**
@@ -4381,6 +4713,8 @@ export interface PositionFloatingCell {
 }
 /**
  * Describes the focus position when a full width row is active.
+ *
+ *   @group Navigation
  */
 export interface PositionFullWidthRow {
     /**
@@ -4398,6 +4732,8 @@ export interface PositionFullWidthRow {
 }
 /**
  * Represents the current focus position of a regular cell in the grid.
+ *
+ *   @group Navigation
  */
 export interface PositionGridCell {
     /**
@@ -4420,6 +4756,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 {
     /**
@@ -4441,6 +4779,8 @@ export interface PositionGridCellRoot {
 }
 /**
  * Describes the focus position of a standard header cell.
+ *
+ *   @group Navigation
  */
 export interface PositionHeaderCell {
     /**
@@ -4454,6 +4794,8 @@ export interface PositionHeaderCell {
 }
 /**
  * Describes the focus position of a header group cell in the column hierarchy.
+ *
+ *   @group Navigation
  */
 export interface PositionHeaderGroupCell {
     /**
@@ -4479,17 +4821,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> = (
 /**
@@ -4500,6 +4848,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> {
     /**
@@ -4517,6 +4867,8 @@ export interface RowDetailRendererParams<T> {
 }
 /**
  * Options for performing bulk selection or deselection of all rows.
+ *
+ * @group Row Selection
  */
 export interface RowSelectAllOptions {
     /**
@@ -4526,6 +4878,8 @@ export interface RowSelectAllOptions {
 }
 /**
  * Configuration options used when performing row selection operations.
+ *
+ * @group Row Selection
  */
 export interface RowSelectOptions {
     /**
@@ -4554,6 +4908,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";
 /**
@@ -4561,11 +4917,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 {
     /**
@@ -4580,6 +4940,8 @@ export interface DragData {
 }
 /**
  * Callback function executed during a drag event.
+ *
+ *   @group Row Drag
  */
 export type DragEventFn = (
 /**
@@ -4588,6 +4950,8 @@ export type DragEventFn = (
 params: DragEventParams) => void;
 /**
  * Arguments passed during a drag event lifecycle.
+ *
+ *   @group Row Drag
  */
 export interface DragEventParams {
     /**
@@ -4606,6 +4970,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> = (
 /**
@@ -4614,6 +4980,8 @@ export type DragPlaceholderFn<T> = (
 params: DragPlaceholderParams<T>) => ReactNode;
 /**
  * Parameters passed when rendering the drag placeholder content.
+ *
+ * @group Row Drag
  */
 export interface DragPlaceholderParams<T> {
     /**
@@ -4627,6 +4995,8 @@ export interface DragPlaceholderParams<T> {
 }
 /**
  * Represents the current pointer position during a drag operation.
+ *
+ *   @group Row Drag
  */
 export interface DragPosition {
     /**
@@ -4640,6 +5010,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 = (
 /**
@@ -4648,6 +5020,8 @@ export type DropEventFn = (
 params: DropEventParams) => void;
 /**
  * Represents the full context passed to the drop event handler.
+ *
+ * @group Row Drag
  */
 export interface DropEventParams {
     /**
@@ -4669,6 +5043,8 @@ export interface DropEventParams {
 }
 /**
  * Describes the final state of a drag-and-drop move operation.
+ *
+ *   @group Row Drag
  */
 export interface DragMoveState {
     /**
@@ -4706,6 +5082,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> = (
 /**
@@ -4715,6 +5093,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> {
     /**
@@ -4728,6 +5108,8 @@ export interface GetDragDataParams<T> {
 }
 /**
  * Parameters for configuring drag behavior using a React hook.
+ *
+ * @group Row Drag
  */
 export interface UseRowDragParams<T> {
     /**
@@ -4794,6 +5176,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 {
     /**
@@ -4815,6 +5199,8 @@ export interface DataRect {
 }
 /**
  * Parameters for exporting a CSV file from LyteNyte Grid.
+ *
+ * @group Export
  */
 export interface ExportCsvParams {
     /**
@@ -4844,6 +5230,8 @@ 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> = (
 /**
@@ -4852,6 +5240,8 @@ export type ExportDataRectFn<T> = (
 params: ExportDataRectParams) => Promise<ExportDataRectResult<T>>;
 /**
  * Parameters for exporting a specific rectangular region of the grid using a DataRect.
+ *
+ * @group Export
  */
 export interface ExportDataRectParams {
     /**
@@ -4867,6 +5257,8 @@ export interface ExportDataRectParams {
 }
 /**
  * The result structure returned after exporting a DataRect from LyteNyte Grid.
+ *
+ * @group Export
  */
 export interface ExportDataRectResult<T> {
     /**
@@ -4890,6 +5282,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 {
     /**
@@ -4908,6 +5302,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> {
     /**
@@ -4948,6 +5344,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 {
     /**
@@ -4965,6 +5363,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> {
     /**
@@ -4987,6 +5387,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> {
     /**
@@ -5002,6 +5404,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> = (
 /**
@@ -5013,6 +5417,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> {
     /**
@@ -5024,6 +5430,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;
     /**
@@ -5036,6 +5444,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> {
     /**
@@ -5048,6 +5458,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> = (
 /**
@@ -5059,6 +5471,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> {
     /**
@@ -5070,6 +5484,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;
     /**
@@ -5091,10 +5507,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> = (
 /**
@@ -5103,6 +5523,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> {
     /**
@@ -5120,6 +5542,8 @@ export interface DataColumnPivotFetcherParams<T> {
 }
 /**
  * Fetches grid row data asynchronously for the LyteNyte Server Data Source.
+ *
+ * @group Row Data Source
  */
 export type DataFetcherFn<T> = (
 /**
@@ -5128,6 +5552,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> {
     /**
@@ -5149,6 +5575,8 @@ export interface DataFetcherParams<T> {
 }
 /**
  * Fetches items used in "in" filters from a server-side source.
+ *
+ * @group Row Data Source
  */
 export type DataInFilterItemFetcherFn<T> = (
 /**
@@ -5157,6 +5585,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> {
     /**
@@ -5174,6 +5604,8 @@ export interface DataInFilterItemFetcherParams<T> {
 }
 /**
  * Represents a specific request for data to an external data source.
+ *
+ * @group Row Data Source
  */
 export interface DataRequest {
     /**
@@ -5203,6 +5635,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> {
     /**
@@ -5252,6 +5686,8 @@ export interface DataRequestModel<T> {
 }
 /**
  * Response object for row data from a center section request.
+ *
+ * @group Row Data Source
  */
 export interface DataResponse {
     /**
@@ -5285,6 +5721,8 @@ export interface DataResponse {
 }
 /**
  * Represents a group (branch) row returned from a data request.
+ *
+ * @group Row Data Source
  */
 export interface DataResponseBranchItem {
     /**
@@ -5310,6 +5748,8 @@ export interface DataResponseBranchItem {
 }
 /**
  * Represents a row of data (a leaf node) returned in a server response.
+ *
+ * @group Row Data Source
  */
 export interface DataResponseLeafItem {
     /**
@@ -5327,6 +5767,8 @@ export interface DataResponseLeafItem {
 }
 /**
  * Response object for setting pinned row data (top or bottom).
+ *
+ * @group Row Data Source
  */
 export interface DataResponsePinned {
     /**
@@ -5344,6 +5786,8 @@ export interface DataResponsePinned {
 }
 /**
  * Parameters for configuring the server row data source.
+ *
+ * @group Row Data Source
  */
 export interface RowDataSourceServerParams<T> {
     /**