@keenmate/web-grid 1.0.0-rc09 → 1.0.0-rc11

package/dist/web-component.d.ts

@@ -1,5 +1,7 @@
 import { WebGrid } from './grid.js';
 import type { Column, CellValidationState, RowToolbarConfig, ContextMenuItem, RowShortcut, RowChangeDetail, ToolbarClickDetail, RowActionClickDetail, ContextMenuContext, HeaderMenuConfig, HeaderMenuContext, EditTrigger, EditStartSelection, EditorOption, EditorOptions, GridMode, ToggleVisibility, DataRequestDetail, SortState, SortMode, PaginationLabelsCallback, SummaryContentCallback, ValidationTooltipContext, ToolbarPosition, GridLabels, RowLockInfo, RowLockingOptions, RowLockChangeDetail, ColumnResizeDetail, ColumnWidthState, ColumnReorderDetail, ColumnOrderState, FillDragDetail, RangeShortcut } from './types.js';
+import { type ScrollEventManager } from './modules/scroll-events/index.js';
+import { type FocusEventManager } from './modules/focus-events/index.js';
 import type { GridContext } from './modules/types.js';
 /**
  * GridElement - Custom HTML Element for WebGrid
@@ -25,9 +27,7 @@ export declare class GridElement<T = unknown> extends HTMLElement implements Gri
     private updatePending;
     isCommittingFromKeyboard: boolean;
     private isTransitioningCells;
-    private wheelListenerAdded;
     private toolbarOutsideClickAdded;
-    private toolbarScrollListenerAdded;
     private toolbarMoveInProgress;
     private toolbarHideTimeout;
     private toolbarHovered;
@@ -40,6 +40,7 @@ export declare class GridElement<T = unknown> extends HTMLElement implements Gri
     isUserFiltering: boolean;
     justSelected: boolean;
     isOpeningDropdown: boolean;
+    isClosingViaToggle: boolean;
     private isProgrammaticScroll;
     searchDebounceTimer: ReturnType<typeof setTimeout> | null;
     searchAbortController: AbortController | null;
@@ -60,8 +61,9 @@ export declare class GridElement<T = unknown> extends HTMLElement implements Gri
     private headerContextMenuElement;
     private virtualScrollStart;
     private virtualScrollEnd;
-    private scrollListenerAdded;
     private isLoadingMoreItems;
+    readonly scrollEvents: ScrollEventManager;
+    readonly focusEvents: FocusEventManager;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -69,20 +71,20 @@ export declare class GridElement<T = unknown> extends HTMLElement implements Gri
     set items(value: T[]);
     get columns(): Column<T>[];
     set columns(value: Column<T>[]);
-    get filterable(): boolean;
-    set filterable(value: boolean);
-    get pageable(): boolean;
-    set pageable(value: boolean);
+    get isFilterable(): boolean;
+    set isFilterable(value: boolean);
+    get isPageable(): boolean;
+    set isPageable(value: boolean);
     get pageSize(): number;
     set pageSize(value: number);
     get pageSizes(): number[];
     set pageSizes(value: number[]);
-    get striped(): boolean;
-    set striped(value: boolean);
-    get hoverable(): boolean;
-    set hoverable(value: boolean);
-    get editable(): boolean;
-    set editable(value: boolean);
+    get isStriped(): boolean;
+    set isStriped(value: boolean);
+    get isHoverable(): boolean;
+    set isHoverable(value: boolean);
+    get isEditable(): boolean;
+    set isEditable(value: boolean);
     get editTrigger(): EditTrigger;
     set editTrigger(value: EditTrigger);
     get editStartSelection(): EditStartSelection;
@@ -91,22 +93,22 @@ export declare class GridElement<T = unknown> extends HTMLElement implements Gri
     set mode(value: GridMode);
     get dropdownToggleVisibility(): ToggleVisibility;
     set dropdownToggleVisibility(value: ToggleVisibility);
-    get dropdownShowOnFocus(): boolean;
-    set dropdownShowOnFocus(value: boolean);
-    get openDropdownOnEnter(): boolean;
-    set openDropdownOnEnter(value: boolean);
-    get checkboxAlwaysEditable(): boolean;
-    set checkboxAlwaysEditable(value: boolean);
-    get showRowNumbers(): boolean;
-    set showRowNumbers(value: boolean);
-    get stickyRowNumbers(): boolean;
-    set stickyRowNumbers(value: boolean);
+    get shouldShowDropdownOnFocus(): boolean;
+    set shouldShowDropdownOnFocus(value: boolean);
+    get shouldOpenDropdownOnEnter(): boolean;
+    set shouldOpenDropdownOnEnter(value: boolean);
+    get isCheckboxAlwaysEditable(): boolean;
+    set isCheckboxAlwaysEditable(value: boolean);
+    get isRowNumbersVisible(): boolean;
+    set isRowNumbersVisible(value: boolean);
+    get isStickyRowNumbers(): boolean;
+    set isStickyRowNumbers(value: boolean);
     get freezeColumns(): number;
     set freezeColumns(value: number);
     get invalidCells(): CellValidationState[];
     set invalidCells(value: CellValidationState[]);
-    get showRowToolbar(): boolean;
-    set showRowToolbar(value: boolean);
+    get isRowToolbarVisible(): boolean;
+    set isRowToolbarVisible(value: boolean);
     get rowToolbar(): RowToolbarConfig<T>[];
     set rowToolbar(value: RowToolbarConfig<T>[]);
     get toolbarVerticalAlign(): 'top' | 'center' | 'bottom';
@@ -142,16 +144,30 @@ export declare class GridElement<T = unknown> extends HTMLElement implements Gri
     clearSelection(): void;
     isRowSelected(rowIndex: number): boolean;
     getSelectedRowsData(): T[];
-    get showShortcutsHelp(): boolean;
-    set showShortcutsHelp(value: boolean);
+    copySelectedRowsToClipboard(): Promise<boolean>;
+    get cellSelectionMode(): import("./types.js").CellSelectionMode;
+    set cellSelectionMode(value: import("./types.js").CellSelectionMode);
+    get selectedCellRange(): import("./types.js").CellRange;
+    selectCellRange(range: any): void;
+    clearCellSelection(): void;
+    getSelectedCells(): {
+        row: T;
+        rowIndex: number;
+        colIndex: number;
+        field: string;
+        value: unknown;
+    }[];
+    copyCellSelectionToClipboard(): Promise<boolean>;
+    get shouldCopyWithHeaders(): boolean;
+    set shouldCopyWithHeaders(value: boolean);
+    get oncellselectionchange(): (detail: import("./types.js").CellSelectionChangeDetail) => void;
+    set oncellselectionchange(value: (detail: import("./types.js").CellSelectionChangeDetail) => void);
+    get isShortcutsHelpVisible(): boolean;
+    set isShortcutsHelpVisible(value: boolean);
     get shortcutsHelpPosition(): 'top-right' | 'top-left';
     set shortcutsHelpPosition(value: 'top-right' | 'top-left');
     get shortcutsHelpContentCallback(): (() => string) | undefined;
     set shortcutsHelpContentCallback(value: (() => string) | undefined);
-    get showRowActions(): boolean;
-    set showRowActions(value: boolean);
-    get rowActions(): RowToolbarConfig<T>[];
-    set rowActions(value: RowToolbarConfig<T>[]);
     set onrowchange(value: ((detail: RowChangeDetail<T>) => void) | undefined);
     set onroweditstart(value: ((detail: {
         row: T;
@@ -212,8 +228,8 @@ export declare class GridElement<T = unknown> extends HTMLElement implements Gri
     set labels(value: Partial<GridLabels>);
     get summaryMetadata(): unknown;
     set summaryMetadata(value: unknown);
-    get summaryInline(): boolean;
-    set summaryInline(value: boolean);
+    get isSummaryInline(): boolean;
+    set isSummaryInline(value: boolean);
     get idValueMember(): keyof T | undefined;
     set idValueMember(value: keyof T | undefined);
     get idValueCallback(): ((row: T) => unknown) | undefined;
@@ -224,12 +240,12 @@ export declare class GridElement<T = unknown> extends HTMLElement implements Gri
     set onrowlockchange(value: ((detail: RowLockChangeDetail<T>) => void) | undefined);
     get gridName(): string | null;
     set gridName(value: string | null);
-    get persistColumnWidths(): boolean;
-    set persistColumnWidths(value: boolean);
-    get allowColumnReorder(): boolean;
-    set allowColumnReorder(value: boolean);
-    get persistColumnOrder(): boolean;
-    set persistColumnOrder(value: boolean);
+    get shouldPersistColumnWidths(): boolean;
+    set shouldPersistColumnWidths(value: boolean);
+    get isColumnReorderAllowed(): boolean;
+    set isColumnReorderAllowed(value: boolean);
+    get shouldPersistColumnOrder(): boolean;
+    set shouldPersistColumnOrder(value: boolean);
     /**
      * Try to load persisted state (widths/order) if conditions are met
      */
@@ -239,18 +255,18 @@ export declare class GridElement<T = unknown> extends HTMLElement implements Gri
     set oncolumnresize(value: ((detail: ColumnResizeDetail) => void) | undefined);
     get oncolumnreorder(): ((detail: ColumnReorderDetail) => void) | undefined;
     set oncolumnreorder(value: ((detail: ColumnReorderDetail) => void) | undefined);
-    get onfilldrag(): ((detail: FillDragDetail) => boolean | void) | undefined;
-    set onfilldrag(value: ((detail: FillDragDetail) => boolean | void) | undefined);
-    get virtualScroll(): boolean;
-    set virtualScroll(value: boolean);
+    get fillDragCallback(): ((detail: FillDragDetail) => boolean | void) | undefined;
+    set fillDragCallback(value: ((detail: FillDragDetail) => boolean | void) | undefined);
+    get isVirtualScrollEnabled(): boolean;
+    set isVirtualScrollEnabled(value: boolean);
     get virtualScrollThreshold(): number;
     set virtualScrollThreshold(value: number);
     get virtualScrollRowHeight(): number;
     set virtualScrollRowHeight(value: number);
     get virtualScrollBuffer(): number;
     set virtualScrollBuffer(value: number);
-    get infiniteScroll(): boolean;
-    set infiniteScroll(value: boolean);
+    get isInfiniteScrollEnabled(): boolean;
+    set isInfiniteScrollEnabled(value: boolean);
     get infiniteScrollThreshold(): number;
     set infiniteScrollThreshold(value: number);
     get hasMoreItems(): boolean;
@@ -404,6 +420,18 @@ export declare class GridElement<T = unknown> extends HTMLElement implements Gri
      * Close toolbar and reset move flag
      */
     private closeToolbarAndReset;
+    /**
+     * Close dropdown on scroll - shared logic for container and window scroll
+     */
+    private handleScrollCloseDropdown;
+    /**
+     * Handle select trigger blur - cancel edit and restore display mode
+     */
+    private handleSelectBlur;
+    /**
+     * Handle combobox/autocomplete blur - commit matched option or raw text
+     */
+    private handleComboboxBlur;
     /**
      * Handle toolbar item click
      */