@genesislcap/grid-tabulator 14.262.1 → 14.262.2

package/dist/grid-tabulator.d.ts

@@ -1,9 +1,9 @@
 import { Auth } from '@genesislcap/foundation-comms';
 import { CellComponent } from 'tabulator-tables';
+import { ColumnDefinition as ColumnDefinition_2 } from 'tabulator-tables';
 import { Connect } from '@genesislcap/foundation-comms';
 import type { Container } from '@microsoft/fast-foundation';
 import { Controller } from '@microsoft/fast-element';
-import { CSSDesignToken } from '@microsoft/fast-foundation';
 import { CSSVarTokenMap } from '@genesislcap/foundation-ui';
 import { Datasource } from '@genesislcap/foundation-comms';
 import { DatasourceStatus } from '@genesislcap/foundation-comms';
@@ -12,79 +12,253 @@ import { DOMContainer } from '@genesislcap/foundation-utils';
 import { DownloadOptions } from 'tabulator-tables';
 import { ElementStyles } from '@microsoft/fast-element';
 import { FilterParams } from 'tabulator-tables';
+import type { Formatter } from 'tabulator-tables';
 import { FormatterParams } from 'tabulator-tables';
 import { FoundationElement } from '@microsoft/fast-foundation';
 import { FoundationElementRegistry } from '@microsoft/fast-foundation';
 import { FoundationLayoutContainer } from '@genesislcap/foundation-utils';
 import { LayoutCacheContainer } from '@genesislcap/foundation-utils';
 import { Logger } from '@genesislcap/foundation-logger';
-import { Options } from 'tabulator-tables';
+import { Options as Options_2 } from 'tabulator-tables';
 import { OverrideFoundationElementDefinition } from '@microsoft/fast-foundation';
 import { RowRangeLookup } from 'tabulator-tables';
 import { TabulatorFull } from 'tabulator-tables';
 import { ViewTemplate } from '@microsoft/fast-element';
 
 /**
- * The base height multiplier for the action renderer.
- * @remarks Results in `--action-height-multiplier`. This is a DesignToken {@link https://www.fast.design/docs/design-systems/design-tokens/#what-is-a-design-token} value. Defaults to `0.6px`. May have other values depending on the design system or can be set to a different value.
+ * Formatter that displays an action button in the cell.
+ * Styled to match grid-pro action renderer.
+ *
+ * @param cell - The cell component provided by Tabulator
+ * @param formatterParams - Action formatter parameters
+ * @returns HTML content for the action button
+ * @public
+ */
+export declare function actionFormatter(cell: any, formatterParams?: ActionFormatterParams): string;
+
+/**
+ * Parameters for the action formatter.
+ *
+ * `actionClick`: Callback function triggered when the action button is clicked.
+ *
+ * `actionName`: The name or label of the action button.
+ *
+ * `appearance`: The appearance style of the action button.
+ *
+ * `dataTestId`: The data-test-id attribute value to be used for E2E testing.
+ *
+ * `isDisabled`: Function to determine whether the action button should be disabled for a specific row.
+ *
+ * `uniqueFieldName`: A unique field name used to identify the action button for E2E testing.
+ *
+ * `prefix`: The prefix to use for the button element, e.g., 'foundation', 'zero', 'rapid'. Defaults to 'foundation' if not specified.
+ *
+ * `actionButtonStyle`: Optional styling for the action button.
+ *
+ * `contentTemplate`: Used to render some arbitrary content inside the action button.
+ *
+ * @alpha
+ */
+export declare interface ActionFormatterParams {
+    actionClick?: (rowData: any) => void;
+    actionName?: string;
+    appearance?: string;
+    dataTestId?: string;
+    isDisabled?: (rowData: any) => boolean;
+    uniqueFieldName?: string;
+    prefix?: string;
+    actionButtonStyle?: string;
+    contentTemplate?: string;
+}
+
+/**
+ * Formatter that displays a dropdown menu of actions in the cell.
+ * Styled to match grid-pro actions-menu renderer.
+ *
+ * @param cell - The cell component provided by Tabulator
+ * @param formatterParams - Actions menu formatter parameters
+ * @returns HTML content for the actions menu
  * @public
  */
-export declare const actionHeightMultiplier: CSSDesignToken<string>;
+export declare function actionsMenuFormatter(cell: any, formatterParams?: ActionsMenuFormatterParams): string;
+
+/**
+ * Parameters for the actions menu formatter
+ *
+ * `actions`: The array of actions to display in the menu.
+ *
+ * `prefix`: The prefix to use for the actions-menu element, e.g., 'foundation', 'zero', 'rapid'.
+ *
+ * `menuName`: Custom name for the menu button (if not set, will use foundation: '⋮' or other: '+')
+ *
+ * `isVertical`: Optional flag to display the menu vertically. Default is false.
+ *
+ * `buttonAppearance`: Optional appearance for the button that opens the menu.
+ *
+ * @alpha
+ */
+export declare interface ActionsMenuFormatterParams {
+    actions?: Array<{
+        name: string;
+        callback: (rowData: any) => void;
+        isDisabled?: (rowData: any) => boolean;
+    }>;
+    prefix?: string;
+    menuName?: string;
+    isVertical?: boolean;
+    buttonAppearance?: string;
+}
 
 /**
- * The Tabulator Action Renderer element.
+ * Formatter that displays boolean values using a checkbox component.
+ * Styled to match grid-pro boolean renderer.
+ *
+ * @param cell - The cell component provided by Tabulator
+ * @param formatterParams - Boolean formatter parameters
+ * @returns HTML content for the boolean value
  * @public
- * @tagname %%prefix%%-grid-tabulator-action-renderer
- */
-export declare class ActionRenderer extends FoundationElement {
-    params: ActionRendererParams;
-    pendingAction: boolean;
-    init(params: ActionRendererParams): void;
-    clickHandler(): Promise<void>;
-    get dataTestId(): any;
+ */
+export declare function booleanFormatter(cell: any, formatterParams?: BooleanFormatterParams): string;
+
+/**
+ * Parameters for the boolean formatter
+ *
+ * `isDisabled`: Function to determine whether the checkbox should be disabled for a specific row
+ *
+ * `dataTestId`: Data test ID for testing
+ *
+ * `prefix`: The prefix to use for the checkbox element, e.g., 'foundation', 'zero', 'rapid'. Defaults to 'foundation' if not specified.
+ *
+ * @alpha
+ */
+export declare interface BooleanFormatterParams {
+    isDisabled?: (rowData: any) => boolean;
+    dataTestId?: string;
+    prefix?: string;
 }
 
+export { CellComponent }
+
+/**
+ * Function type for cell renderer
+ * @public
+ */
+export declare type CellRendererFunc = (params: CellRendererParams) => HTMLElement | string;
+
 /**
- * Parameters for the `grid-tabulator` action renderer.
- * @remarks For single action button scenarios.
+ * Parameters for custom cell renderers
  * @public
  */
-export declare type ActionRendererParams = {
+export declare interface CellRendererParams {
     /**
-     * Callback function triggered when the action button is clicked.
-     * @param rowData - The data associated with the row.
+     * The cell component
      */
-    actionClick?: (rowData: any) => void;
+    cell?: CellComponent;
     /**
-     * The name or label of the action button.
+     * The cell value
      */
-    actionName?: string;
+    value?: any;
     /**
-     * The appearance style of the action button.
-     * @remarks This is a {@link @microsoft/fast-foundation#Button.appearance | Button appearance} value. Defaults to `neutral`. May have other values depending on the design system.
+     * The row data
      */
-    appearance?: string;
+    data?: any;
     /**
-     * The data-test-id attribute value to be used for E2E testing.
+     * Additional formatter parameters
      */
-    dataTestId?: string;
+    formatterParams?: FormatterParams;
     /**
-     * Function to determine whether the action button should be disabled for a specific row.
-     * @param rowData - The data associated with the row.
-     * @returns A boolean indicating whether the button should be disabled.
+     * Allow indexing by string
      */
-    isDisabled?: (rowData: any) => boolean;
+    [key: string]: any;
+}
+
+/**
+ * Extended Tabulator Column Definition with tweaked formatter type and formatterParams
+ * @alpha
+ */
+export declare type ColumnDefinition = {
+    formatter?: Formatter | FormatterTypes;
+    formatterParams?: CustomFormatterParams;
+} & Omit<ColumnDefinition_2, 'formatter' | 'formatterParams'>;
+
+/**
+ * Convert a string to kebab case
+ * Example: convertToKebabCase('helloWorld') // 'hello-world'
+ * @param str - The string to convert
+ * @returns The converted string
+ * @alpha
+ */
+export declare function convertToKebabCase(str: string): string;
+
+/**
+ * Delimiter for criteria in the datasource
+ * @alpha
+ */
+export declare const criteriaDelimiter = ";";
+
+/**
+ * Join operator for criteria in the datasource
+ * @alpha
+ */
+export declare const criteriaJoin = " && ";
+
+/**
+ * Extended FormatterParams type that includes all of our custom formatter parameter interfaces
+ * @alpha
+ */
+export declare type CustomFormatterParams = FormatterParams | ActionFormatterParams | ActionsMenuFormatterParams | BooleanFormatterParams | EditableFormatterParams | SelectFormatterParams | TextFormatterParams;
+
+/**
+ * The date editor class for grid-tabulator
+ * @public
+ */
+declare class DateEditor extends FoundationElement {
+    params: DateEditorParams;
+    dateField: any;
     /**
-     * A unique field name used to identify the action button used for E2E testing, so that the data-testid attribute value can be unique.
+     * Initialize the editor with parameters
      */
-    uniqueFieldName?: string;
+    init(params: DateEditorParams): void;
     /**
-     * Used to render some arbitrary content inside the action renderer button.
+     * Get current value
      */
-    contentTemplate?: string;
-};
+    getValue(): any;
+    /**
+     * Format value for display
+     */
+    getFormattedValue(): string;
+    /**
+     * Set focus to the input
+     */
+    focus(): void;
+    /**
+     * Process key down events
+     */
+    handleKeyDown(event: KeyboardEvent): void;
+}
 
-export { CellComponent }
+/**
+ * Date Editor interface for grid-tabulator
+ *
+ * `value`: The current cell value as timestamp or date string
+ *
+ * `min`: Min date
+ *
+ * `max`: Max date
+ *
+ * `success`: Cell changed callback
+ *
+ * `cancel`: Cancel edit callback
+ *
+ * @alpha
+ */
+declare interface DateEditorParams {
+    value?: number | string;
+    min?: string;
+    max?: string;
+    success?: (value: string) => void;
+    cancel?: () => void;
+}
 
 /**
  * Format a date time value to a readable string.
@@ -104,6 +278,12 @@ export declare function dateTimeValueFormatter({ value }: any): string;
  */
 export declare function dateValueFormatter({ value }: any): string;
 
+/**
+ * Time in milliseconds to debounce resize events
+ * @alpha
+ */
+export declare const DEBOUNCED_RESIZE_TIME = 400;
+
 /**
  * The default grid-tabulator configuration.
  * @public
@@ -112,6 +292,59 @@ export declare const defaultGridTabulatorConfig: {
     shadowOptions: any;
 };
 
+/**
+ * Formatter that displays an editable cell with validation state
+ * @param cell - The cell component provided by Tabulator
+ * @param formatterParams - Editable formatter parameters
+ * @returns HTML content for the editable cell
+ * @public
+ */
+export declare function editableFormatter(cell: any, formatterParams?: EditableFormatterParams): string;
+
+/**
+ * Parameters for the editable formatter
+ *
+ * `value`: The raw value to be displayed
+ *
+ * `data`: The row data containing the current cell
+ *
+ * `field`: The field name in the data object
+ *
+ * `cssClass`: Optional CSS class to apply to the text
+ *
+ * `nullText`: Text to display for null/undefined values
+ *
+ * `dataTestId`: Data test ID for testing
+ *
+ * `icon`: Icon to display for edit action
+ *
+ * `prefix`: The prefix to use for element classes and components, e.g., 'foundation', 'zero', 'rapid'.
+ *
+ * @alpha
+ */
+export declare interface EditableFormatterParams {
+    value?: any;
+    data?: any;
+    field?: string;
+    cssClass?: string;
+    nullText?: string;
+    dataTestId?: string;
+    icon?: string;
+    prefix?: string;
+}
+
+/**
+ * The special column field name for marking a cell as edited
+ * @alpha
+ */
+export declare const EDITED_COLUMN_FIELD = "__EDITED_FIELD__";
+
+/**
+ * The special column field name for marking a cell as having an error
+ * @alpha
+ */
+export declare const ERROR_COLUMN_FIELD = "__ERROR_FIELD__";
+
 /**
  * Format am epoch value to a readable ISO date string.
  * @param epoch - The epoch number.
@@ -120,7 +353,49 @@ export declare const defaultGridTabulatorConfig: {
  */
 export declare function formatDateExtra(epoch: number): string;
 
-export { FormatterParams }
+/**
+ * Zero formatters for Tabulator grid
+ * @alpha
+ */
+export declare const formatters: {
+    action: typeof actionFormatter;
+    actionsMenu: typeof actionsMenuFormatter;
+    boolean: typeof booleanFormatter;
+    editable: typeof editableFormatter;
+    select: typeof selectFormatter;
+    text: typeof textFormatter;
+};
+
+/**
+ * Enumeration of formatter types for grid-tabulator.
+ * @alpha
+ */
+export declare enum FormatterTypes {
+    /**
+     * Action button formatter
+     */
+    action = "action",
+    /**
+     * Actions menu formatter with dropdown options
+     */
+    actionsMenu = "actionsMenu",
+    /**
+     * Boolean formatter for true/false values
+     */
+    boolean = "boolean",
+    /**
+     * Editable formatter for cells that can be edited
+     */
+    editable = "editable",
+    /**
+     * Select formatter for displaying option values
+     */
+    select = "select",
+    /**
+     * Text formatter for basic text display with optional formatting
+     */
+    text = "text"
+}
 
 /**
  * The Foundation grid-tabulator
@@ -141,37 +416,66 @@ styles: ElementStyles;
 template: ViewTemplate<any, any>;
 }, typeof GridTabulator>;
 
-/**
- * A function that returns a Foundation Action Renderer for configuring the component with a DesignSystem.
- *
- * @public
- * @remarks
- * HTML Element: \<foundation-grid-tabulator-action-renderer\>
- */
-export declare const foundationGridTabulatorActionRenderer: (overrideDefinition?: OverrideFoundationElementDefinition<    {
-baseName: string;
-styles: ElementStyles;
-template: ViewTemplate<ActionRenderer, any>;
-}>) => FoundationElementRegistry<    {
-baseName: string;
-styles: ElementStyles;
-template: ViewTemplate<ActionRenderer, any>;
-}, typeof ActionRenderer>;
-
 /**
  * All `grid-tabulator` components.
  * @public
  */
 export declare const foundationGridTabulatorComponents: {
-    foundationGridTabulatorActionRenderer: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+    foundationDateEditor: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+    baseName: string;
+    styles: ElementStyles;
+    template: ViewTemplate<DateEditor, any>;
+    }>) => FoundationElementRegistry<    {
+    baseName: string;
+    styles: ElementStyles;
+    template: ViewTemplate<DateEditor, any>;
+    }, DateEditor>;
+    foundationNumberEditor: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+    baseName: string;
+    styles: ElementStyles;
+    template: ViewTemplate<NumberEditor, any>;
+    }>) => FoundationElementRegistry<    {
+    baseName: string;
+    styles: ElementStyles;
+    template: ViewTemplate<NumberEditor, any>;
+    }, NumberEditor>;
+    foundationSelectEditor: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+    baseName: string;
+    styles: ElementStyles;
+    template: ViewTemplate<SelectEditor, any>;
+    }>) => FoundationElementRegistry<    {
+    baseName: string;
+    styles: ElementStyles;
+    template: ViewTemplate<SelectEditor, any>;
+    }, SelectEditor>;
+    foundationStringEditor: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+    baseName: string;
+    styles: ElementStyles;
+    template: ViewTemplate<StringEditor, any>;
+    }>) => FoundationElementRegistry<    {
     baseName: string;
     styles: ElementStyles;
-    template: ViewTemplate<ActionRenderer, any>;
+    template: ViewTemplate<StringEditor, any>;
+    }, StringEditor>;
+    foundationMultiselectEditor: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+    baseName: string;
+    styles: ElementStyles;
+    template: ViewTemplate<MultiselectEditor, any>;
     }>) => FoundationElementRegistry<    {
     baseName: string;
     styles: ElementStyles;
-    template: ViewTemplate<ActionRenderer, any>;
-    }, ActionRenderer>;
+    template: ViewTemplate<MultiselectEditor, any>;
+    }, MultiselectEditor>;
+    foundationGridTabulatorColumn: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+    baseName: string;
+    }>) => FoundationElementRegistry<    {
+    baseName: string;
+    }, typeof GridTabulatorColumn>;
+    foundationGridTabulatorCell: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+    baseName: string;
+    }>) => FoundationElementRegistry<    {
+    baseName: string;
+    }, typeof GridTabulatorCell>;
     foundationGridTabulator: (overrideDefinition?: OverrideFoundationElementDefinition<    {
     shadowOptions: any;
     baseName: string;
@@ -231,10 +535,54 @@ export declare class GridTabulator extends GridTabulator_base {
     autoCellRendererByType: boolean;
     onlyTemplateColDefs: boolean;
     persistColumnStateKey: string;
+    /**
+     * The key to use for persisting the filter model in local browser or KV storage.
+     */
+    persistFilterModelKey: string;
     rowHeight: number;
     theme: string;
     themeChanged(oldValue: string, newValue: string): void;
+    /**
+     * The case type to use for the header names. If not set, the default CONSTANT_CASE will be used.
+     * @remarks Can be one of the following: camelCase, capitalCase, dotCase, headerCase, noCase, paramCase, pascalCase, pathCase, sentenceCase, snakeCase.
+     * @public
+     */
+    headerCaseType: GridTabulatorCaseType;
+    /**
+     * Boolean attribute to control whether the grid autosizes the columns upon interaction.
+     * This will disable the column widths from being manually set, and doesn't save the widths
+     * in local storage if you are using `persist-column-state-key`.
+     */
+    gridAutosizingEnabled: boolean;
+    /**
+     * If false, will disable cell flashing for all cells by default, unless otherwise defined in custom colDef
+     * @remarks Defaults to true
+     */
+    enableCellFlashing: boolean;
+    /**
+     * If true, will enable row flashing for all rows
+     */
+    enableRowFlashing: boolean;
+    /**
+     * If true, will show header filters on columns by default
+     * @remarks Defaults to false
+     */
+    showHeaderFilters: boolean;
+    /**
+     * The column component name used for querying child column elements
+     * @public
+     */
+    columnComponentName: string;
     private rehydrationAttempted;
+    /**
+     * Timeout function used to debounce resize calls
+     * @internal
+     */
+    private debounced;
+    /**
+     * Map of the available cell renderers
+     */
+    private gridComponents;
     connectedCallback(): void;
     disconnectedCallback(): void;
     /**
@@ -252,6 +600,38 @@ export declare class GridTabulator extends GridTabulator_base {
      */
     get gridOptions(): Options;
     set gridOptions(options: Options);
+    /**
+     * Register custom cell formatters in the top-level formatters registry
+     */
+    private registerCellFormatters;
+    /**
+     * Process column formatters - convert string formatter names to function references
+     * @param columns - Array of column definitions
+     * @param formatters - Available formatter functions
+     */
+    private processColumnFormatters;
+    /**
+     * Register our custom cell editors with Tabulator
+     */
+    private registerCellEditors;
+    /**
+     * Format column headers based on headerCaseType setting
+     */
+    private formatColumnHeaders;
+    /**
+     * Apply cell flashing to columns if enableCellFlashing is true
+     */
+    private applyCellFlashing;
+    /**
+     * Bind events to handle responsive grid resizing
+     */
+    private bindResizeEvents;
+    /**
+     * Because we try and resize the grid to fit using callbacks on events, this will cause
+     * a stack overflow of calls to resize, so we need to debounce it.
+     * @internal
+     */
+    private debouncedColumnAutosize;
     get statePersistanceEnabled(): boolean;
     saveGridState(): void;
     restoreGridState(): void;
@@ -275,9 +655,39 @@ export declare class GridTabulator extends GridTabulator_base {
      * @param filter - optional row range lookup filter
      */
     downloadDataAs(type: 'csv' | 'json' | 'html', fileName: string, params?: DownloadOptions, filter?: RowRangeLookup): void;
+    /**
+     * Refresh the grid cells
+     * @public
+     */
+    refreshCells(): void;
+    /**
+     * Clear all filters
+     * @public
+     */
+    clearFilters(): void;
+    /**
+     * Redraw the table
+     * @public
+     */
+    redraw(): void;
     private fontFaceDestroy;
     private insertFontFace;
     private destroyFontFace;
+    /**
+     * Merges columnd definitions from child elements and options
+     * @param options - The Tabulator options object
+     * @returns The merged options with columns from child elements
+     */
+    private mergeColumnDefsFromTemplate;
+    /**
+     * Gets column definitions from child column elements
+     * @returns Array of column definitions
+     */
+    private getTemplateColumnDefs;
+    /**
+     * Register our formatters with Tabulator's formatter registry, if available
+     */
+    private registerFormattersWithTabulator;
 }
 
 declare const GridTabulator_base: (new (...args: any[]) => {
@@ -303,14 +713,7 @@ declare const GridTabulator_base: (new (...args: any[]) => {
     dir: string;
     draggable: boolean;
     hidden: boolean;
-    inert: boolean; /**
-    * Set the Grid client-side filters.
-    * @public
-    * @param column - column name
-    * @param operator - filter operator
-    * @param value - filter value
-    * @param filterParams - optional filter params
-    */
+    inert: boolean;
     innerText: string;
     lang: string;
     readonly offsetHeight: number;
@@ -483,7 +886,7 @@ declare const GridTabulator_base: (new (...args: any[]) => {
     ariaValueNow: string;
     ariaValueText: string;
     role: string;
-    animate(keyframes: Keyframe[] | PropertyIndexedKeyframes, options?: number | KeyframeAnimationOptions): Animation;
+    animate(keyframes: PropertyIndexedKeyframes | Keyframe[], options?: number | KeyframeAnimationOptions): Animation;
     getAnimations(options?: GetAnimationsOptions): Animation[];
     after(...nodes: (string | Node)[]): void;
     before(...nodes: (string | Node)[]): void;
@@ -605,6 +1008,11 @@ declare const GridTabulator_base: (new (...args: any[]) => {
     onwebkitanimationstart: (this: GlobalEventHandlers, ev: Event) => any;
     onwebkittransitionend: (this: GlobalEventHandlers, ev: Event) => any;
     onwheel: (this: GlobalEventHandlers, ev: WheelEvent) => any;
+    /**
+     * The grid-tabulator component registration.
+     * @public
+     * @privateRemarks explicitly declaring for extensibility
+     */
     autofocus: boolean;
     readonly dataset: DOMStringMap;
     nonce?: string;
@@ -613,6 +1021,41 @@ declare const GridTabulator_base: (new (...args: any[]) => {
     focus(options?: FocusOptions): void;
 }) & typeof FoundationElement;
 
+/**
+ * The case types supported for header formatting
+ * @alpha
+ */
+export declare type GridTabulatorCaseType = 'camelCase' | 'capitalCase' | 'constantCase' | 'dotCase' | 'headerCase' | 'noCase' | 'paramCase' | 'pascalCase' | 'pathCase' | 'sentenceCase' | 'snakeCase';
+
+/**
+ * The GridTabulator Cell element.
+ * @remarks Used inside the GridTabulator Column element to define a cell renderer from the template.
+ * @public
+ */
+export declare class GridTabulatorCell extends FoundationElement {
+    renderer: CellRendererFunc;
+    rendererParams: CellRendererParams;
+    slottedRenderer: HTMLElement[];
+    connectedCallback(): void;
+    init(params: CellRendererParams): void;
+    getElement(): HTMLElement;
+    destroy(): void;
+    refresh(params: CellRendererParams): boolean;
+    slottedRendererChanged(): void;
+}
+
+/**
+ * The available `grid-tabulator` Editor Types
+ * @public
+ */
+export declare enum GridTabulatorCellEditorTypes {
+    string = "string",
+    number = "number",
+    date = "date",
+    select = "select",
+    multiselect = "multiselect"
+}
+
 /**
  * The available `grid-tabulator` Renderer Types
  * @public
@@ -622,7 +1065,8 @@ export declare enum GridTabulatorCellRendererTypes {
     actionsMenu = "actionsMenu",
     boolean = "boolean",
     text = "text",
-    select = "select"
+    select = "select",
+    editable = "editable"
 }
 
 /**
@@ -633,7 +1077,11 @@ export declare class GridTabulatorClientSideDatasource extends GridTabulatorClie
     auth: Auth;
     connect: Connect;
     datasource: Datasource;
-    deferredGridOptions: Options;
+    deferredGridOptions: Options_2;
+    /**
+     * Allows storing column layouts between datasource initializations
+     */
+    deferredColumnStates: any[];
     criteria: string;
     criteriaChanged(oldCriteria: string, newCriteria: string): void;
     fields: string;
@@ -655,6 +1103,10 @@ export declare class GridTabulatorClientSideDatasource extends GridTabulatorClie
      */
     rowIdAttr: any;
     restartOnReconnection: boolean;
+    /**
+     * Whether to keep column definitions when clearing row data
+     */
+    keepColDefsOnClearRowData: boolean;
     /**
      * Allows grid data updates to be processed via and external function before applying in grid
      */
@@ -663,7 +1115,6 @@ export declare class GridTabulatorClientSideDatasource extends GridTabulatorClie
     private updateSub;
     private connectionSub;
     private isRequestServer;
-    datasourceStatusChanged(prev: DatasourceStatus, next: DatasourceStatus): void;
     private requiresFullRowDataAndColDefs;
     private dataSubWasLoggedOff;
     private rows;
@@ -686,6 +1137,10 @@ export declare class GridTabulatorClientSideDatasource extends GridTabulatorClie
      * @internal
      */
     private get hasDefaultRowId();
+    /**
+     * Returns the default row ID based on the resource type
+     * @internal
+     */
     private get defaultRowIdByResourceType();
     /**
      * Initializes the datasource.
@@ -714,12 +1169,21 @@ export declare class GridTabulatorClientSideDatasource extends GridTabulatorClie
      * @internal
      */
     private clearRowData;
+    /**
+     * Handles errors by emitting an error event
+     */
+    handleErrors(errors: string | any[]): void;
     /**
      * Sets the columnDefs and rowData for the grid.
      * @remarks This should only happen once, when the grid is first initialized. Follow up updates will use the agTransaction.
      * @internal
      */
     private setRowData;
+    /**
+     * Generate column definitions from the field metadata
+     * @param fieldsMetadata - The field metadata to generate column definitions from
+     */
+    private getColumnDefs;
     /**
      * Resets the grid data while keeping columnDefs and sends a DATA_LOGOFF message if it's a stream.
      * Proxies to {@link @genesislcap/grid-tabulator#GridTabulatorClientSideDatasource.loadResourceData} but without the full init (no metadata fetch).
@@ -745,9 +1209,14 @@ export declare class GridTabulatorClientSideDatasource extends GridTabulatorClie
     private handleStreamInserts;
     private handleStreamDeletes;
     private handleStreamUpdates;
+    /**
+     * Emit event when the number of rows changes
+     */
+    private handleSizeChanged;
     private buildCriteria;
     setFilter(fieldName: string, newFilter: string): void;
     removeFilter(fieldName: string): void;
+    datasourceStatusChanged(prev: DatasourceStatus, next: DatasourceStatus): void;
 }
 
 declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
@@ -872,27 +1341,338 @@ declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
     readonly parentElement: HTMLElement;
     readonly parentNode: ParentNode;
     readonly previousSibling: ChildNode;
-    textContent: string; /**
-    * Initializes the datasource and loads the data for the grid.
-    * Handles both snapshot and stream data (for both REQUEST_SERVER and DATASERVER resource types).
-    *
-    * @param withFullInit - if true, will call datasource.init() with requiresMetadataFetch = true, fetching fresh metadata
-    * @internal
-    */
+    textContent: string;
     appendChild<T_1 extends Node>(node: T_1): T_1;
     compareDocumentPosition(other: Node): number;
     contains(other: Node): boolean;
     getRootNode(options?: GetRootNodeOptions): Node;
     hasChildNodes(): boolean;
-    insertBefore<T_2 extends Node>(node: T_2, child: Node): T_2;
+    insertBefore<T_2 extends Node>(node: T_2, child: Node): T_2;
+    isDefaultNamespace(namespace: string): boolean;
+    isEqualNode(otherNode: Node): boolean;
+    isSameNode(otherNode: Node): boolean;
+    lookupNamespaceURI(prefix: string): string;
+    lookupPrefix(namespace: string): string;
+    normalize(): void;
+    removeChild<T_3 extends Node>(child: T_3): T_3;
+    replaceChild<T_4 extends Node>(node: Node, child: T_4): T_4;
+    readonly ATTRIBUTE_NODE: number;
+    readonly CDATA_SECTION_NODE: number;
+    readonly COMMENT_NODE: number;
+    readonly DOCUMENT_FRAGMENT_NODE: number;
+    readonly DOCUMENT_NODE: number;
+    readonly DOCUMENT_POSITION_CONTAINED_BY: number;
+    readonly DOCUMENT_POSITION_CONTAINS: number;
+    readonly DOCUMENT_POSITION_DISCONNECTED: number;
+    readonly DOCUMENT_POSITION_FOLLOWING: number;
+    readonly DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: number;
+    readonly DOCUMENT_POSITION_PRECEDING: number;
+    readonly DOCUMENT_TYPE_NODE: number;
+    readonly ELEMENT_NODE: number;
+    readonly ENTITY_NODE: number;
+    readonly ENTITY_REFERENCE_NODE: number;
+    readonly NOTATION_NODE: number;
+    readonly PROCESSING_INSTRUCTION_NODE: number;
+    readonly TEXT_NODE: number;
+    dispatchEvent(event: Event): boolean;
+    ariaAtomic: string;
+    ariaAutoComplete: string;
+    ariaBusy: string;
+    ariaChecked: string;
+    ariaColCount: string;
+    ariaColIndex: string;
+    ariaColIndexText: string;
+    ariaColSpan: string;
+    ariaCurrent: string;
+    ariaDisabled: string;
+    ariaExpanded: string;
+    ariaHasPopup: string;
+    ariaHidden: string;
+    ariaInvalid: string;
+    ariaKeyShortcuts: string;
+    ariaLabel: string;
+    ariaLevel: string;
+    ariaLive: string;
+    ariaModal: string;
+    ariaMultiLine: string;
+    ariaMultiSelectable: string;
+    ariaOrientation: string;
+    ariaPlaceholder: string;
+    ariaPosInSet: string;
+    ariaPressed: string;
+    ariaReadOnly: string;
+    ariaRequired: string;
+    ariaRoleDescription: string;
+    ariaRowCount: string;
+    ariaRowIndex: string;
+    ariaRowIndexText: string;
+    ariaRowSpan: string;
+    ariaSelected: string;
+    ariaSetSize: string;
+    ariaSort: string;
+    ariaValueMax: string;
+    ariaValueMin: string;
+    ariaValueNow: string;
+    ariaValueText: string;
+    role: string;
+    animate(keyframes: PropertyIndexedKeyframes | Keyframe[], options?: number | KeyframeAnimationOptions): Animation;
+    getAnimations(options?: GetAnimationsOptions): Animation[];
+    after(...nodes: (string | Node)[]): void;
+    before(...nodes: (string | Node)[]): void;
+    remove(): void;
+    replaceWith(...nodes: (string | Node)[]): void;
+    innerHTML: string;
+    readonly nextElementSibling: Element;
+    readonly previousElementSibling: Element;
+    readonly childElementCount: number;
+    readonly children: HTMLCollection;
+    readonly firstElementChild: Element;
+    readonly lastElementChild: Element;
+    append(...nodes: (string | Node)[]): void;
+    prepend(...nodes: (string | Node)[]): void;
+    querySelector<K_6 extends keyof HTMLElementTagNameMap>(selectors: K_6): HTMLElementTagNameMap[K_6];
+    querySelector<K_7 extends keyof SVGElementTagNameMap>(selectors: K_7): SVGElementTagNameMap[K_7];
+    querySelector<E_1 extends Element = Element>(selectors: string): E_1;
+    querySelectorAll<K_8 extends keyof HTMLElementTagNameMap>(selectors: K_8): NodeListOf<HTMLElementTagNameMap[K_8]>;
+    querySelectorAll<K_9 extends keyof SVGElementTagNameMap>(selectors: K_9): NodeListOf<SVGElementTagNameMap[K_9]>;
+    querySelectorAll<E_2 extends Element = Element>(selectors: string): NodeListOf<E_2>;
+    replaceChildren(...nodes: (string | Node)[]): void;
+    readonly assignedSlot: HTMLSlotElement;
+    oncopy: (this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any;
+    oncut: (this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any;
+    onpaste: (this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any;
+    readonly style: CSSStyleDeclaration;
+    contentEditable: string;
+    enterKeyHint: string;
+    inputMode: string;
+    readonly isContentEditable: boolean;
+    onabort: (this: GlobalEventHandlers, ev: UIEvent) => any;
+    onanimationcancel: (this: GlobalEventHandlers, ev: AnimationEvent) => any;
+    onanimationend: (this: GlobalEventHandlers, ev: AnimationEvent) => any;
+    onanimationiteration: (this: GlobalEventHandlers, ev: AnimationEvent) => any;
+    onanimationstart: (this: GlobalEventHandlers, ev: AnimationEvent) => any;
+    onauxclick: (this: GlobalEventHandlers, ev: MouseEvent) => any;
+    onbeforeinput: (this: GlobalEventHandlers, ev: InputEvent) => any;
+    onblur: (this: GlobalEventHandlers, ev: FocusEvent) => any;
+    oncancel: (this: GlobalEventHandlers, ev: Event) => any;
+    oncanplay: (this: GlobalEventHandlers, ev: Event) => any;
+    oncanplaythrough: (this: GlobalEventHandlers, ev: Event) => any;
+    onchange: (this: GlobalEventHandlers, ev: Event) => any;
+    onclick: (this: GlobalEventHandlers, ev: MouseEvent) => any;
+    onclose: (this: GlobalEventHandlers, ev: Event) => any;
+    oncontextmenu: (this: GlobalEventHandlers, ev: MouseEvent) => any;
+    oncuechange: (this: GlobalEventHandlers, ev: Event) => any;
+    ondblclick: (this: GlobalEventHandlers, ev: MouseEvent) => any;
+    ondrag: (this: GlobalEventHandlers, ev: DragEvent) => any;
+    ondragend: (this: GlobalEventHandlers, ev: DragEvent) => any;
+    ondragenter: (this: GlobalEventHandlers, ev: DragEvent) => any;
+    ondragleave: (this: GlobalEventHandlers, ev: DragEvent) => any;
+    ondragover: (this: GlobalEventHandlers, ev: DragEvent) => any;
+    ondragstart: (this: GlobalEventHandlers, ev: DragEvent) => any;
+    ondrop: (this: GlobalEventHandlers, ev: DragEvent) => any;
+    ondurationchange: (this: GlobalEventHandlers, ev: Event) => any;
+    onemptied: (this: GlobalEventHandlers, ev: Event) => any;
+    onended: (this: GlobalEventHandlers, ev: Event) => any;
+    onerror: OnErrorEventHandlerNonNull;
+    onfocus: (this: GlobalEventHandlers, ev: FocusEvent) => any;
+    onformdata: (this: GlobalEventHandlers, ev: FormDataEvent) => any;
+    ongotpointercapture: (this: GlobalEventHandlers, ev: PointerEvent) => any;
+    oninput: (this: GlobalEventHandlers, ev: Event) => any;
+    oninvalid: (this: GlobalEventHandlers, ev: Event) => any;
+    onkeydown: (this: GlobalEventHandlers, ev: KeyboardEvent) => any;
+    onkeypress: (this: GlobalEventHandlers, ev: KeyboardEvent) => any;
+    onkeyup: (this: GlobalEventHandlers, ev: KeyboardEvent) => any;
+    onload: (this: GlobalEventHandlers, ev: Event) => any;
+    onloadeddata: (this: GlobalEventHandlers, ev: Event) => any;
+    onloadedmetadata: (this: GlobalEventHandlers, ev: Event) => any;
+    onloadstart: (this: GlobalEventHandlers, ev: Event) => any;
+    onlostpointercapture: (this: GlobalEventHandlers, ev: PointerEvent) => any;
+    onmousedown: (this: GlobalEventHandlers, ev: MouseEvent) => any;
+    onmouseenter: (this: GlobalEventHandlers, ev: MouseEvent) => any;
+    onmouseleave: (this: GlobalEventHandlers, ev: MouseEvent) => any;
+    onmousemove: (this: GlobalEventHandlers, ev: MouseEvent) => any;
+    onmouseout: (this: GlobalEventHandlers, ev: MouseEvent) => any;
+    onmouseover: (this: GlobalEventHandlers, ev: MouseEvent) => any;
+    onmouseup: (this: GlobalEventHandlers, ev: MouseEvent) => any;
+    onpause: (this: GlobalEventHandlers, ev: Event) => any;
+    onplay: (this: GlobalEventHandlers, ev: Event) => any;
+    onplaying: (this: GlobalEventHandlers, ev: Event) => any;
+    onpointercancel: (this: GlobalEventHandlers, ev: PointerEvent) => any;
+    onpointerdown: (this: GlobalEventHandlers, ev: PointerEvent) => any;
+    onpointerenter: (this: GlobalEventHandlers, ev: PointerEvent) => any;
+    onpointerleave: (this: GlobalEventHandlers, ev: PointerEvent) => any;
+    onpointermove: (this: GlobalEventHandlers, ev: PointerEvent) => any;
+    onpointerout: (this: GlobalEventHandlers, ev: PointerEvent) => any;
+    onpointerover: (this: GlobalEventHandlers, ev: PointerEvent) => any;
+    onpointerup: (this: GlobalEventHandlers, ev: PointerEvent) => any;
+    onprogress: (this: GlobalEventHandlers, ev: ProgressEvent<EventTarget>) => any;
+    onratechange: (this: GlobalEventHandlers, ev: Event) => any;
+    onreset: (this: GlobalEventHandlers, ev: Event) => any;
+    onresize: (this: GlobalEventHandlers, ev: UIEvent) => any;
+    onscroll: (this: GlobalEventHandlers, ev: Event) => any;
+    onsecuritypolicyviolation: (this: GlobalEventHandlers, ev: SecurityPolicyViolationEvent) => any;
+    onseeked: (this: GlobalEventHandlers, ev: Event) => any;
+    onseeking: (this: GlobalEventHandlers, ev: Event) => any;
+    onselect: (this: GlobalEventHandlers, ev: Event) => any;
+    onselectionchange: (this: GlobalEventHandlers, ev: Event) => any;
+    onselectstart: (this: GlobalEventHandlers, ev: Event) => any;
+    onslotchange: (this: GlobalEventHandlers, ev: Event) => any;
+    onstalled: (this: GlobalEventHandlers, ev: Event) => any;
+    onsubmit: (this: GlobalEventHandlers, ev: SubmitEvent) => any;
+    onsuspend: (this: GlobalEventHandlers, ev: Event) => any;
+    ontimeupdate: (this: GlobalEventHandlers, ev: Event) => any;
+    ontoggle: (this: GlobalEventHandlers, ev: Event) => any;
+    ontouchcancel?: (this: GlobalEventHandlers, ev: TouchEvent) => any;
+    ontouchend?: (this: GlobalEventHandlers, ev: TouchEvent) => any;
+    ontouchmove?: (this: GlobalEventHandlers, ev: TouchEvent) => any;
+    ontouchstart?: (this: GlobalEventHandlers, ev: TouchEvent) => any;
+    ontransitioncancel: (this: GlobalEventHandlers, ev: TransitionEvent) => any;
+    ontransitionend: (this: GlobalEventHandlers, ev: TransitionEvent) => any;
+    ontransitionrun: (this: GlobalEventHandlers, ev: TransitionEvent) => any;
+    ontransitionstart: (this: GlobalEventHandlers, ev: TransitionEvent) => any;
+    onvolumechange: (this: GlobalEventHandlers, ev: Event) => any;
+    onwaiting: (this: GlobalEventHandlers, ev: Event) => any;
+    onwebkitanimationend: (this: GlobalEventHandlers, ev: Event) => any;
+    onwebkitanimationiteration: (this: GlobalEventHandlers, ev: Event) => any;
+    onwebkitanimationstart: (this: GlobalEventHandlers, ev: Event) => any;
+    onwebkittransitionend: (this: GlobalEventHandlers, ev: Event) => any;
+    onwheel: (this: GlobalEventHandlers, ev: WheelEvent) => any;
+    autofocus: boolean;
+    readonly dataset: DOMStringMap;
+    nonce?: string;
+    tabIndex: number;
+    blur(): void;
+    focus(options?: FocusOptions): void;
+}) & (new () => {
+    datasourceStatus: DatasourceStatus;
+    resourceName: string;
+    onDatasourceStatusChanged: (event: DatasourceStatusChangedEvent) => void;
+    datasourceStatusChanged(prev: DatasourceStatus, next: DatasourceStatus): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    accessKey: string;
+    readonly accessKeyLabel: string;
+    autocapitalize: string;
+    dir: string;
+    draggable: boolean;
+    hidden: boolean;
+    inert: boolean;
+    innerText: string;
+    lang: string;
+    readonly offsetHeight: number;
+    readonly offsetLeft: number;
+    readonly offsetParent: Element;
+    readonly offsetTop: number;
+    readonly offsetWidth: number;
+    outerText: string;
+    spellcheck: boolean;
+    title: string;
+    translate: boolean;
+    attachInternals(): ElementInternals;
+    click(): void;
+    addEventListener<K_10 extends keyof HTMLElementEventMap>(type: K_10, listener: (this: HTMLElement, ev: HTMLElementEventMap[K_10]) => any, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K_1_1 extends keyof HTMLElementEventMap>(type: K_1_1, listener: (this: HTMLElement, ev: HTMLElementEventMap[K_1_1]) => any, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    readonly attributes: NamedNodeMap;
+    readonly classList: DOMTokenList;
+    className: string;
+    readonly clientHeight: number;
+    readonly clientLeft: number;
+    readonly clientTop: number;
+    readonly clientWidth: number;
+    id: string; /**
+    * Allows grid data updates to be processed via and external function before applying in grid
+    */
+    readonly localName: string;
+    readonly namespaceURI: string;
+    onfullscreenchange: (this: Element, ev: Event) => any;
+    onfullscreenerror: (this: Element, ev: Event) => any;
+    outerHTML: string;
+    readonly ownerDocument: Document;
+    readonly part: DOMTokenList;
+    readonly prefix: string;
+    readonly scrollHeight: number;
+    scrollLeft: number;
+    scrollTop: number;
+    readonly scrollWidth: number;
+    readonly shadowRoot: ShadowRoot;
+    slot: string;
+    readonly tagName: string;
+    attachShadow(init: ShadowRootInit): ShadowRoot;
+    closest<K_2_1 extends keyof HTMLElementTagNameMap>(selector: K_2_1): HTMLElementTagNameMap[K_2_1];
+    closest<K_3_1 extends keyof SVGElementTagNameMap>(selector: K_3_1): SVGElementTagNameMap[K_3_1];
+    closest<E_3 extends Element = Element>(selectors: string): E_3;
+    getAttribute(qualifiedName: string): string;
+    getAttributeNS(namespace: string, localName: string): string;
+    getAttributeNames(): string[];
+    getAttributeNode(qualifiedName: string): Attr;
+    getAttributeNodeNS(namespace: string, localName: string): Attr;
+    getBoundingClientRect(): DOMRect;
+    getClientRects(): DOMRectList;
+    getElementsByClassName(classNames: string): HTMLCollectionOf<Element>;
+    getElementsByTagName<K_4_1 extends keyof HTMLElementTagNameMap>(qualifiedName: K_4_1): HTMLCollectionOf<HTMLElementTagNameMap[K_4_1]>;
+    getElementsByTagName<K_5_1 extends keyof SVGElementTagNameMap>(qualifiedName: K_5_1): HTMLCollectionOf<SVGElementTagNameMap[K_5_1]>;
+    getElementsByTagName(qualifiedName: string): HTMLCollectionOf<Element>;
+    getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf<HTMLElement>;
+    getElementsByTagNameNS(namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf<SVGElement>;
+    getElementsByTagNameNS(namespace: string, localName: string): HTMLCollectionOf<Element>;
+    hasAttribute(qualifiedName: string): boolean;
+    hasAttributeNS(namespace: string, localName: string): boolean;
+    hasAttributes(): boolean;
+    hasPointerCapture(pointerId: number): boolean;
+    insertAdjacentElement(where: InsertPosition, element: Element): Element;
+    insertAdjacentHTML(position: InsertPosition, text: string): void;
+    insertAdjacentText(where: InsertPosition, data: string): void;
+    matches(selectors: string): boolean;
+    releasePointerCapture(pointerId: number): void;
+    removeAttribute(qualifiedName: string): void;
+    removeAttributeNS(namespace: string, localName: string): void;
+    removeAttributeNode(attr: Attr): Attr;
+    requestFullscreen(options?: FullscreenOptions): Promise<void>;
+    requestPointerLock(): void;
+    scroll(options?: ScrollToOptions): void;
+    scroll(x: number, y: number): void;
+    scrollBy(options?: ScrollToOptions): void;
+    scrollBy(x: number, y: number): void;
+    scrollIntoView(arg?: boolean | ScrollIntoViewOptions): void;
+    scrollTo(options?: ScrollToOptions): void;
+    scrollTo(x: number, y: number): void;
+    setAttribute(qualifiedName: string, value: string): void;
+    setAttributeNS(namespace: string, qualifiedName: string, value: string): void;
+    setAttributeNode(attr: Attr): Attr;
+    setAttributeNodeNS(attr: Attr): Attr;
+    setPointerCapture(pointerId: number): void;
+    toggleAttribute(qualifiedName: string, force?: boolean): boolean;
+    webkitMatchesSelector(selectors: string): boolean;
+    readonly baseURI: string;
+    readonly childNodes: NodeListOf<ChildNode>;
+    readonly firstChild: ChildNode;
+    readonly isConnected: boolean;
+    readonly lastChild: ChildNode;
+    readonly nextSibling: ChildNode;
+    readonly nodeName: string;
+    readonly nodeType: number;
+    nodeValue: string;
+    readonly parentElement: HTMLElement;
+    readonly parentNode: ParentNode;
+    readonly previousSibling: ChildNode;
+    textContent: string;
+    appendChild<T extends Node>(node: T): T;
+    cloneNode(deep?: boolean): Node;
+    compareDocumentPosition(other: Node): number;
+    contains(other: Node): boolean;
+    getRootNode(options?: GetRootNodeOptions): Node;
+    hasChildNodes(): boolean;
+    insertBefore<T_1_1 extends Node>(node: T_1_1, child: Node): T_1_1;
     isDefaultNamespace(namespace: string): boolean;
     isEqualNode(otherNode: Node): boolean;
     isSameNode(otherNode: Node): boolean;
     lookupNamespaceURI(prefix: string): string;
     lookupPrefix(namespace: string): string;
     normalize(): void;
-    removeChild<T_3 extends Node>(child: T_3): T_3;
-    replaceChild<T_4 extends Node>(node: Node, child: T_4): T_4;
+    removeChild<T_2_1 extends Node>(child: T_2_1): T_2_1;
+    replaceChild<T_3_1 extends Node>(node: Node, child: T_3_1): T_3_1;
     readonly ATTRIBUTE_NODE: number;
     readonly CDATA_SECTION_NODE: number;
     readonly COMMENT_NODE: number;
@@ -952,7 +1732,7 @@ declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
     ariaValueNow: string;
     ariaValueText: string;
     role: string;
-    animate(keyframes: Keyframe[] | PropertyIndexedKeyframes, options?: number | KeyframeAnimationOptions): Animation;
+    animate(keyframes: PropertyIndexedKeyframes | Keyframe[], options?: number | KeyframeAnimationOptions): Animation;
     getAnimations(options?: GetAnimationsOptions): Animation[];
     after(...nodes: (string | Node)[]): void;
     before(...nodes: (string | Node)[]): void;
@@ -967,12 +1747,12 @@ declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
     readonly lastElementChild: Element;
     append(...nodes: (string | Node)[]): void;
     prepend(...nodes: (string | Node)[]): void;
-    querySelector<K_6 extends keyof HTMLElementTagNameMap>(selectors: K_6): HTMLElementTagNameMap[K_6];
-    querySelector<K_7 extends keyof SVGElementTagNameMap>(selectors: K_7): SVGElementTagNameMap[K_7];
-    querySelector<E_1 extends Element = Element>(selectors: string): E_1;
-    querySelectorAll<K_8 extends keyof HTMLElementTagNameMap>(selectors: K_8): NodeListOf<HTMLElementTagNameMap[K_8]>;
-    querySelectorAll<K_9 extends keyof SVGElementTagNameMap>(selectors: K_9): NodeListOf<SVGElementTagNameMap[K_9]>;
-    querySelectorAll<E_2 extends Element = Element>(selectors: string): NodeListOf<E_2>;
+    querySelector<K_6_1 extends keyof HTMLElementTagNameMap>(selectors: K_6_1): HTMLElementTagNameMap[K_6_1];
+    querySelector<K_7_1 extends keyof SVGElementTagNameMap>(selectors: K_7_1): SVGElementTagNameMap[K_7_1];
+    querySelector<E_1_1 extends Element = Element>(selectors: string): E_1_1;
+    querySelectorAll<K_8_1 extends keyof HTMLElementTagNameMap>(selectors: K_8_1): NodeListOf<HTMLElementTagNameMap[K_8_1]>;
+    querySelectorAll<K_9_1 extends keyof SVGElementTagNameMap>(selectors: K_9_1): NodeListOf<SVGElementTagNameMap[K_9_1]>;
+    querySelectorAll<E_2_1 extends Element = Element>(selectors: string): NodeListOf<E_2_1>;
     replaceChildren(...nodes: (string | Node)[]): void;
     readonly assignedSlot: HTMLSlotElement;
     oncopy: (this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any;
@@ -1080,13 +1860,40 @@ declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
     tabIndex: number;
     blur(): void;
     focus(options?: FocusOptions): void;
-}) & (new () => {
-    datasourceStatus: DatasourceStatus;
-    resourceName: string;
-    onDatasourceStatusChanged: (event: DatasourceStatusChangedEvent) => void;
-    datasourceStatusChanged(prev: DatasourceStatus, next: DatasourceStatus): void;
+    readonly $fastController: Controller;
+    $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail">): boolean | void;
+    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+});
+
+/**
+ * The GridTabulator Column element.
+ * @remarks Used inside the GridTabulator element to specify column definitions for a given column.
+ * @public
+ */
+export declare class GridTabulatorColumn extends GridTabulatorColumn_base {
+    slottedCell: HTMLElement[];
+    definition: Partial<ColumnDefinition_2>;
+    slottedCellChanged(): void;
+    deepClone(): Node;
+}
+
+declare const GridTabulatorColumn_base: (new (...args: any[]) => {
+    "__#1@#_container": FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
+    "__#1@#_latestTokenCode": string;
+    "__#1@#_hasFirstLoaded": boolean;
+    "__#1@#_cleanupTimeout": NodeJS.Timeout;
+    "__#1@#_shouldForceLifecycle": boolean;
+    cloneNode(deep?: boolean): Node;
+    deepClone(): Node;
+    readonly shouldRunDisconnect: boolean;
+    readonly shouldRunConnect: boolean;
+    "__#1@#_blockLifecycleDueToTokenChange"(lifecycleType: "connect" | "disconnect" | "reconnect"): boolean;
+    "__#1@#_tryFindContainingLayout"(e: Element): FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
     connectedCallback(): void;
+    readonly $fastController: Controller;
+    $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail">): boolean | void;
     disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
     accessKey: string;
     readonly accessKeyLabel: string;
     autocapitalize: string;
@@ -1107,9 +1914,9 @@ declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
     translate: boolean;
     attachInternals(): ElementInternals;
     click(): void;
-    addEventListener<K_10 extends keyof HTMLElementEventMap>(type: K_10, listener: (this: HTMLElement, ev: HTMLElementEventMap[K_10]) => any, options?: boolean | AddEventListenerOptions): void;
+    addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
     addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
-    removeEventListener<K_1_1 extends keyof HTMLElementEventMap>(type: K_1_1, listener: (this: HTMLElement, ev: HTMLElementEventMap[K_1_1]) => any, options?: boolean | EventListenerOptions): void;
+    removeEventListener<K_1 extends keyof HTMLElementEventMap>(type: K_1, listener: (this: HTMLElement, ev: HTMLElementEventMap[K_1]) => any, options?: boolean | EventListenerOptions): void;
     removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
     readonly attributes: NamedNodeMap;
     readonly classList: DOMTokenList;
@@ -1135,9 +1942,9 @@ declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
     slot: string;
     readonly tagName: string;
     attachShadow(init: ShadowRootInit): ShadowRoot;
-    closest<K_2_1 extends keyof HTMLElementTagNameMap>(selector: K_2_1): HTMLElementTagNameMap[K_2_1];
-    closest<K_3_1 extends keyof SVGElementTagNameMap>(selector: K_3_1): SVGElementTagNameMap[K_3_1];
-    closest<E_3 extends Element = Element>(selectors: string): E_3;
+    closest<K_2 extends keyof HTMLElementTagNameMap>(selector: K_2): HTMLElementTagNameMap[K_2];
+    closest<K_3 extends keyof SVGElementTagNameMap>(selector: K_3): SVGElementTagNameMap[K_3];
+    closest<E extends Element = Element>(selectors: string): E;
     getAttribute(qualifiedName: string): string;
     getAttributeNS(namespace: string, localName: string): string;
     getAttributeNames(): string[];
@@ -1145,14 +1952,9 @@ declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
     getAttributeNodeNS(namespace: string, localName: string): Attr;
     getBoundingClientRect(): DOMRect;
     getClientRects(): DOMRectList;
-    /**
-     * Returns the `row-id` attribute, depending on the resource type.
-     * @remarks Will favour the `row-id` attribute if set.
-     * @internal
-     */
     getElementsByClassName(classNames: string): HTMLCollectionOf<Element>;
-    getElementsByTagName<K_4_1 extends keyof HTMLElementTagNameMap>(qualifiedName: K_4_1): HTMLCollectionOf<HTMLElementTagNameMap[K_4_1]>;
-    getElementsByTagName<K_5_1 extends keyof SVGElementTagNameMap>(qualifiedName: K_5_1): HTMLCollectionOf<SVGElementTagNameMap[K_5_1]>;
+    getElementsByTagName<K_4 extends keyof HTMLElementTagNameMap>(qualifiedName: K_4): HTMLCollectionOf<HTMLElementTagNameMap[K_4]>;
+    getElementsByTagName<K_5 extends keyof SVGElementTagNameMap>(qualifiedName: K_5): HTMLCollectionOf<SVGElementTagNameMap[K_5]>;
     getElementsByTagName(qualifiedName: string): HTMLCollectionOf<Element>;
     getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf<HTMLElement>;
     getElementsByTagNameNS(namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf<SVGElement>;
@@ -1198,21 +2000,20 @@ declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
     readonly parentNode: ParentNode;
     readonly previousSibling: ChildNode;
     textContent: string;
-    appendChild<T extends Node>(node: T): T;
-    cloneNode(deep?: boolean): Node;
+    appendChild<T_1 extends Node>(node: T_1): T_1;
     compareDocumentPosition(other: Node): number;
     contains(other: Node): boolean;
     getRootNode(options?: GetRootNodeOptions): Node;
     hasChildNodes(): boolean;
-    insertBefore<T_1_1 extends Node>(node: T_1_1, child: Node): T_1_1;
+    insertBefore<T_2 extends Node>(node: T_2, child: Node): T_2;
     isDefaultNamespace(namespace: string): boolean;
     isEqualNode(otherNode: Node): boolean;
     isSameNode(otherNode: Node): boolean;
     lookupNamespaceURI(prefix: string): string;
     lookupPrefix(namespace: string): string;
     normalize(): void;
-    removeChild<T_2_1 extends Node>(child: T_2_1): T_2_1;
-    replaceChild<T_3_1 extends Node>(node: Node, child: T_3_1): T_3_1;
+    removeChild<T_3 extends Node>(child: T_3): T_3;
+    replaceChild<T_4 extends Node>(node: Node, child: T_4): T_4;
     readonly ATTRIBUTE_NODE: number;
     readonly CDATA_SECTION_NODE: number;
     readonly COMMENT_NODE: number;
@@ -1272,7 +2073,7 @@ declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
     ariaValueNow: string;
     ariaValueText: string;
     role: string;
-    animate(keyframes: Keyframe[] | PropertyIndexedKeyframes, options?: number | KeyframeAnimationOptions): Animation;
+    animate(keyframes: PropertyIndexedKeyframes | Keyframe[], options?: number | KeyframeAnimationOptions): Animation;
     getAnimations(options?: GetAnimationsOptions): Animation[];
     after(...nodes: (string | Node)[]): void;
     before(...nodes: (string | Node)[]): void;
@@ -1287,12 +2088,12 @@ declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
     readonly lastElementChild: Element;
     append(...nodes: (string | Node)[]): void;
     prepend(...nodes: (string | Node)[]): void;
-    querySelector<K_6_1 extends keyof HTMLElementTagNameMap>(selectors: K_6_1): HTMLElementTagNameMap[K_6_1];
-    querySelector<K_7_1 extends keyof SVGElementTagNameMap>(selectors: K_7_1): SVGElementTagNameMap[K_7_1];
-    querySelector<E_1_1 extends Element = Element>(selectors: string): E_1_1;
-    querySelectorAll<K_8_1 extends keyof HTMLElementTagNameMap>(selectors: K_8_1): NodeListOf<HTMLElementTagNameMap[K_8_1]>;
-    querySelectorAll<K_9_1 extends keyof SVGElementTagNameMap>(selectors: K_9_1): NodeListOf<SVGElementTagNameMap[K_9_1]>;
-    querySelectorAll<E_2_1 extends Element = Element>(selectors: string): NodeListOf<E_2_1>;
+    querySelector<K_6 extends keyof HTMLElementTagNameMap>(selectors: K_6): HTMLElementTagNameMap[K_6];
+    querySelector<K_7 extends keyof SVGElementTagNameMap>(selectors: K_7): SVGElementTagNameMap[K_7];
+    querySelector<E_1 extends Element = Element>(selectors: string): E_1;
+    querySelectorAll<K_8 extends keyof HTMLElementTagNameMap>(selectors: K_8): NodeListOf<HTMLElementTagNameMap[K_8]>;
+    querySelectorAll<K_9 extends keyof SVGElementTagNameMap>(selectors: K_9): NodeListOf<SVGElementTagNameMap[K_9]>;
+    querySelectorAll<E_2 extends Element = Element>(selectors: string): NodeListOf<E_2>;
     replaceChildren(...nodes: (string | Node)[]): void;
     readonly assignedSlot: HTMLSlotElement;
     oncopy: (this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any;
@@ -1400,10 +2201,24 @@ declare const GridTabulatorClientSideDatasource_base: (new (...args: any[]) => {
     tabIndex: number;
     blur(): void;
     focus(options?: FocusOptions): void;
-    readonly $fastController: Controller;
-    $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail">): boolean | void;
-    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
-});
+}) & typeof FoundationElement;
+
+/**
+ * Error types for grid-tabulator
+ * @alpha
+ */
+export declare const gridTabulatorErrorNames: {
+    datasource: string;
+};
+
+/**
+ * Event names for grid-tabulator
+ * @alpha
+ */
+export declare const gridTabulatorEventNames: {
+    error: string;
+    datasourceErrorClose: string;
+};
 
 /**
  * The grid-tabulator component registration.
@@ -1439,7 +2254,126 @@ export declare enum GridTabulatorTheme {
  */
 export declare const logger: Logger;
 
-export { Options }
+/**
+ * Merges and dedupes column definitions with column state
+ * @param colDefs - The column definitions
+ * @param columnState - The column state
+ * @returns The merged column definitions
+ * @alpha
+ */
+export declare function mergeAndDedupColDefWithColumnState(colDefs: any[], columnState: any[]): any[];
+
+/**
+ * The multiselect editor class for grid-tabulator
+ * @alpha
+ */
+declare class MultiselectEditor extends FoundationElement {
+    params: MultiselectEditorParams;
+    select: any;
+    /**
+     * Initialize the editor with parameters
+     */
+    init(params: MultiselectEditorParams): void;
+    /**
+     * Get current values
+     */
+    getValues(): (string | number)[];
+    /**
+     * Set focus to the select
+     */
+    focus(): void;
+    /**
+     * Check if a value is selected
+     */
+    isSelected(value: string | number): boolean;
+    /**
+     * Process key down events
+     */
+    handleKeyDown(event: KeyboardEvent): void;
+    /**
+     * Handle change event to save when selection changes
+     */
+    handleChange(): void;
+}
+
+/**
+ * Multiselect Editor interface for grid-tabulator
+ *
+ * `value`: The current cell values as array
+ *
+ * `options`: Select options
+ *
+ * `success`: Cell changed callback
+ *
+ * `cancel`: Cancel edit callback
+ *
+ * @alpha
+ */
+declare interface MultiselectEditorParams {
+    value?: (string | number)[];
+    options?: SelectOption_2[];
+    success?: (values: (string | number)[]) => void;
+    cancel?: () => void;
+}
+
+/**
+ * The number editor class for grid-tabulator
+ * @alpha
+ */
+declare class NumberEditor extends FoundationElement {
+    params: NumberEditorParams;
+    numberField: any;
+    /**
+     * Initialize the editor with parameters
+     */
+    init(params: NumberEditorParams): void;
+    /**
+     * Get current value
+     */
+    getValue(): number;
+    /**
+     * Set focus to the input
+     */
+    focus(): void;
+    /**
+     * Process key down events
+     */
+    handleKeyDown(event: KeyboardEvent): void;
+}
+
+/**
+ * Number Editor interface for grid-tabulator
+ *
+ * `value`: The current cell value
+ *
+ * `min`: Min value
+ *
+ * `max`: Max value
+ *
+ * `step`: Step value
+ *
+ * `success`: Cell changed callback
+ *
+ * `cancel`: Cancel edit callback
+ *
+ * @alpha
+ */
+declare interface NumberEditorParams {
+    value?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    success?: (value: number) => void;
+    cancel?: () => void;
+}
+
+/**
+ * Extended Tabulator Options with custom formatters
+ * @alpha
+ */
+export declare type Options = {
+    formatters?: Record<string, Formatter>;
+} & Omit<Options_2, 'formatters'>;
 
 /**
  * Transaction object to handle row data updates.
@@ -1457,10 +2391,152 @@ export declare interface RowDataTransaction<TData = any> {
 }
 
 /**
- * The Tabulator Action Renderer Styles.
+ * The select editor class for grid-tabulator
+ * @public
+ */
+declare class SelectEditor extends FoundationElement {
+    params: SelectEditorParams;
+    select: any;
+    /**
+     * Initialize the editor with parameters
+     */
+    init(params: SelectEditorParams): void;
+    /**
+     * Get current value
+     */
+    getValue(): any;
+    /**
+     * Set focus to the select
+     */
+    focus(): void;
+    /**
+     * Process key down events
+     */
+    handleKeyDown(event: KeyboardEvent): void;
+    /**
+     * Handle change event
+     */
+    handleChange(): void;
+}
+
+/**
+ * Select Editor interface for grid-tabulator
+ *
+ * `value`: The current cell value
+ *
+ * `options`: Select options
+ *
+ * `success`: Cell changed callback
+ *
+ * `cancel`: Cancel edit callback
+ *
+ * @alpha
+ */
+declare interface SelectEditorParams {
+    value?: string | number;
+    options?: SelectOption_2[];
+    success?: (value: string | number) => void;
+    cancel?: () => void;
+}
+
+/**
+ * Formatter that displays a value from a select list of options
+ * Styled to match grid-pro select renderer.
+ *
+ * @param cell - The cell component provided by Tabulator
+ * @param formatterParams - Select formatter parameters
+ * @returns Text content for the selected option
  * @public
  */
-export declare const tabulatorActionRendererStyles: ElementStyles;
+export declare function selectFormatter(cell: any, formatterParams: SelectFormatterParams): string;
+
+/**
+ * Parameters for the select formatter
+ *
+ * `options`: Array of options for the select
+ *
+ * `nullText`: Text to display for null/undefined values
+ *
+ * `dataTestId`: Data test ID for testing
+ *
+ * `prefix`: The prefix to use for element classes, e.g., 'foundation', 'zero', 'rapid'. Defaults to 'foundation' if not specified.
+ *
+ * @alpha
+ */
+export declare interface SelectFormatterParams {
+    options: SelectOption[];
+    nullText?: string;
+    dataTestId?: string;
+    prefix?: string;
+}
+
+/**
+ * Option for select formatter
+ *
+ * `value`: The value to use internally
+ *
+ * `label`: The text to display
+ *
+ * @alpha
+ */
+declare interface SelectOption {
+    value: string | number;
+    label: string;
+}
+
+/** @beta
+ * Select option interface
+ *
+ * `value`: Option value
+ *
+ * `label`: Option label
+ */
+declare interface SelectOption_2 {
+    value: string | number;
+    label: string;
+}
+
+/**
+ * The string editor class for grid-tabulator
+ * @alpha
+ */
+declare class StringEditor extends FoundationElement {
+    params: StringEditorParams;
+    textField: any;
+    /**
+     * Initialize the editor with parameters
+     */
+    init(params: StringEditorParams): void;
+    /**
+     * Get current value
+     */
+    getValue(): any;
+    /**
+     * Set focus to the input
+     */
+    focus(): void;
+    /**
+     * Process key down events
+     */
+    handleKeyDown(event: KeyboardEvent): void;
+}
+
+/**
+ * String Editor interface for grid-tabulator
+ *
+ * `value`: The current cell value
+ *
+ * `success`: Cell changed callback
+ *
+ * `cancel`: Cancel edit callback
+ *
+ * @alpha
+ */
+declare interface StringEditorParams {
+    value?: string;
+    success?: (value: string) => void;
+    cancel?: () => void;
+}
 
 /**
  * External styles for the Tabulator grid.
@@ -1474,6 +2550,43 @@ export declare const tabulatorExternalStockStyles: ElementStyles;
  */
 export declare const tabulatorThemeSimpleCSS: ElementStyles;
 
+/**
+ * Text formatter for customized display of values.
+ * Styled to match grid-pro text renderer.
+ *
+ * @param cell - The cell component provided by Tabulator
+ * @param formatterParams - Text formatter parameters
+ * @returns Text content for the cell
+ * @public
+ */
+export declare function textFormatter(cell: any, formatterParams?: TextFormatterParams): string;
+
+/**
+ * Parameters for the text formatter
+ *
+ * `specialValue`: Optional special value that should be highlighted (like 2012 in the Year example)
+ *
+ * `specialColor`: Optional color for the highlighted special value
+ *
+ * `specialFontWeight`: Optional font weight for the highlighted special value
+ *
+ * `prefix`: Optional prefix for any custom elements used in formatting
+ *
+ * `dataTestId`: Optional data-test-id for testing purposes
+ *
+ * `nullText`: Optional text to display when the value is null or undefined
+ *
+ * @alpha
+ */
+export declare interface TextFormatterParams {
+    specialValue?: any;
+    specialColor?: string;
+    specialFontWeight?: string;
+    prefix?: string;
+    dataTestId?: string;
+    nullText?: string;
+}
+
 /**
  * Get the Fonts ID for the theme's name
  * @param themeName - The theme name