@open-grid/primitives 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -3,6 +3,64 @@ import { CellCoordinate, ColumnPinningPosition, ColumnId, Grid, ColumnLayout, Ro
 type PrimitiveProps = Record<string, string | number | boolean | undefined>;
 declare const GRID_DENSITIES: readonly ["compact", "standard", "comfortable"];
 type GridDensity = (typeof GRID_DENSITIES)[number];
+interface GridLocalization {
+    dataGridLabel: string;
+    noRows: string;
+    loadingRowsLabel: string;
+    loadingRows: string;
+    gridErrorLabel: string;
+    gridError: string;
+    retryLoadingRowsLabel: string;
+    retry: string;
+    filterPlaceholder: string;
+    filterColumnLabel: (label: string) => string;
+    searchGridRowsLabel: string;
+    searchRowsPlaceholder: string;
+    searchAllRowsLabel: string;
+    clearRowSearchLabel: string;
+    clear: string;
+    rowSelectionLabel: string;
+    selectAllRowsOnCurrentPageLabel: string;
+    selectPage: string;
+    selectedRows: (count: number) => string;
+    clearRowSelectionLabel: string;
+    clearSelection: string;
+    gridColumnsLabel: string;
+    manageColumnsLabel: (visibleCount: number, totalCount: number) => string;
+    columnsSummary: (visibleCount: number, totalCount: number) => string;
+    findColumns: string;
+    columnVisibilityLabel: string;
+    columnsVisible: (visibleCount: number, totalCount: number) => string;
+    noColumnsFound: string;
+    showAllColumnsLabel: string;
+    showAll: string;
+    rowDensityLabel: string;
+    useDensityLabel: (density: GridDensity) => string;
+    densityLabel: (density: GridDensity) => string;
+    paginationLabel: string;
+    paginationActionLabel: (action: PaginationAction) => string;
+    pageStatus: (page: number, pageCount: number) => string;
+    rowsPerPageLabel: string;
+    pageSizeOption: (pageSize: number) => string;
+    resizeColumnLabel: (columnId: string) => string;
+    columnPinningLabel: (columnId: string) => string;
+    pinColumnLabel: (columnId: string, position: ColumnPinningPosition) => string;
+    openColumnMenuLabel: (columnId: string) => string;
+    columnMenuLabel: (columnId: string) => string;
+    headerActionMenuTrigger: string;
+    headerActionMenuItemLabel: (itemId: HeaderActionMenuDefaultItemId, grouped: boolean) => string;
+    columnGroupingLabel: string;
+    groupingPanelEmpty: string;
+    moveColumnGroupingLabel: (columnId: string, direction: "left" | "right") => string;
+    removeColumnGroupingLabel: (columnId: string) => string;
+    toggleRowExpandedLabel: (expanded: boolean, label: string) => string;
+    blankGroupValue: string;
+    groupFooterTotal: string;
+    editColumnLabel: (columnId: string) => string;
+}
+type GridLocalizationOverrides = Partial<GridLocalization>;
+declare const DEFAULT_GRID_LOCALIZATION: Readonly<GridLocalization>;
+declare function createGridLocalization(overrides?: GridLocalizationOverrides): Readonly<GridLocalization>;
 declare const GRID_PREFERENCES_VERSION: 1;
 interface GridPreferencesState {
     columnVisibility: GridState["columnVisibility"];
@@ -18,6 +76,14 @@ interface GridPreferences {
 interface GridPreferencesOptions {
     validColumnIds?: readonly string[] | undefined;
 }
+interface GridPreferencesMigration {
+    fromVersion: number;
+    toVersion: number;
+    migrate: (preferences: Readonly<Record<string, unknown>>) => unknown;
+}
+interface GridPreferencesParseOptions extends GridPreferencesOptions {
+    migrations?: readonly GridPreferencesMigration[] | undefined;
+}
 interface GridPreferencesStorageLike {
     getItem: (key: string) => string | null;
     setItem: (key: string, value: string) => void;
@@ -641,70 +707,71 @@ interface MeasuredSizeCacheLike {
     set: (key: string, size: number) => boolean;
 }
 declare const HEADER_ACTION_MENU_ENABLED_ITEM_SELECTOR = "[role=\"menuitem\"]:not(:disabled):not([aria-disabled=\"true\"])";
-declare const HEADER_ACTION_MENU_TRIGGER_TEXT = "...";
-declare const GROUPING_PANEL_EMPTY_MESSAGE = "Drag column headers here to group";
+declare const HEADER_ACTION_MENU_TRIGGER_TEXT: string;
+declare const GROUPING_PANEL_EMPTY_MESSAGE: string;
 declare const GRID_FOCUSED_CELL_SELECTOR = "[role=\"gridcell\"][data-focused=\"true\"]";
 declare const GRID_INTERACTIVE_KEYBOARD_TARGET_SELECTOR = "button, input, select, textarea, a[href], [contenteditable]:not([contenteditable='false']), [role='button'], [role='menuitem'], [role='separator'], [role='slider'], [role='textbox'], [role='combobox'], [role='searchbox'], [role='spinbutton']";
 declare function getGridProps<TData>(grid: Grid<TData>, options?: GridRowCoordinateOptions): PrimitiveProps;
 declare function getGridHeaderProps(): PrimitiveProps;
-declare function getGridLoadingOverlayProps(): PrimitiveProps;
-declare function getGridLoadingText(): string;
-declare function getGridErrorOverlayProps(): PrimitiveProps;
-declare function getGridErrorText(): string;
-declare function getGridErrorRetryButtonProps(): PrimitiveProps;
-declare function getGridErrorRetryButtonText(): string;
+declare function getGridLoadingOverlayProps(localization?: GridLocalization): PrimitiveProps;
+declare function getGridLoadingText(localization?: GridLocalization): string;
+declare function getGridErrorOverlayProps(localization?: GridLocalization): PrimitiveProps;
+declare function getGridErrorText(localization?: GridLocalization): string;
+declare function getGridErrorRetryButtonProps(localization?: GridLocalization): PrimitiveProps;
+declare function getGridErrorRetryButtonText(localization?: GridLocalization): string;
 declare function getGridHeaderRowProps(options?: GridHeaderRowPrimitiveOptions): PrimitiveProps;
 declare function getGridHeaderRowCount<TData>(grid: Grid<TData>, options?: GridRowCoordinateOptions): number;
 declare function getGridBodyRowIndexOffset<TData>(grid: Grid<TData>, options?: GridRowCoordinateOptions): number;
 declare function getColumnFilterCellProps<TData>(column: Column<TData, unknown>, options: ColumnFilterCellPrimitiveOptions): PrimitiveProps;
-declare function getColumnFilterInputProps<TData>(column: Column<TData, unknown>, options: ColumnFilterInputPrimitiveOptions): PrimitiveProps;
+declare function getColumnFilterInputProps<TData>(column: Column<TData, unknown>, options: ColumnFilterInputPrimitiveOptions, localization?: GridLocalization): PrimitiveProps;
 declare function getColumnFilterText(filters: ColumnFiltersState, columnId: ColumnId): string;
-declare function getQuickFilterProps(): PrimitiveProps;
-declare function getQuickFilterInputProps(options: QuickFilterInputPrimitiveOptions): PrimitiveProps;
-declare function getQuickFilterClearButtonProps(value: string): PrimitiveProps;
-declare function getQuickFilterClearButtonText(): string;
-declare function getRowSelectionControlsProps(): PrimitiveProps;
-declare function getRowSelectionCheckboxProps(options?: RowSelectionCheckboxPrimitiveOptions): PrimitiveProps;
-declare function getRowSelectionCheckboxText(): string;
+declare function getQuickFilterProps(localization?: GridLocalization): PrimitiveProps;
+declare function getQuickFilterInputProps(options: QuickFilterInputPrimitiveOptions, localization?: GridLocalization): PrimitiveProps;
+declare function getQuickFilterClearButtonProps(value: string, localization?: GridLocalization): PrimitiveProps;
+declare function getQuickFilterClearButtonText(localization?: GridLocalization): string;
+declare function getRowSelectionControlsProps(localization?: GridLocalization): PrimitiveProps;
+declare function getRowSelectionCheckboxProps(options?: RowSelectionCheckboxPrimitiveOptions, localization?: GridLocalization): PrimitiveProps;
+declare function getRowSelectionCheckboxText(localization?: GridLocalization): string;
 declare function getRowSelectionStatusProps(): PrimitiveProps;
-declare function getRowSelectionStatusText(selectedCount: number): string;
-declare function getRowSelectionClearButtonProps(disabled?: boolean): PrimitiveProps;
-declare function getRowSelectionClearButtonText(): string;
+declare function getRowSelectionStatusText(selectedCount: number, localization?: GridLocalization): string;
+declare function getRowSelectionClearButtonProps(disabled?: boolean, localization?: GridLocalization): PrimitiveProps;
+declare function getRowSelectionClearButtonText(localization?: GridLocalization): string;
 declare function setCheckboxIndeterminate(target: unknown, indeterminate: boolean): boolean;
-declare function getColumnVisibilityControlsProps(): PrimitiveProps;
-declare function getColumnVisibilitySummaryProps(visibleCount: number, totalCount: number): PrimitiveProps;
-declare function getColumnVisibilitySummaryText(visibleCount: number, totalCount: number): string;
-declare function getColumnVisibilitySearchInputProps(value: string): PrimitiveProps;
-declare function getColumnVisibilityListProps(): PrimitiveProps;
+declare function getColumnVisibilityControlsProps(localization?: GridLocalization): PrimitiveProps;
+declare function getColumnVisibilitySummaryProps(visibleCount: number, totalCount: number, localization?: GridLocalization): PrimitiveProps;
+declare function getColumnVisibilitySummaryText(visibleCount: number, totalCount: number, localization?: GridLocalization): string;
+declare function getColumnVisibilitySearchInputProps(value: string, localization?: GridLocalization): PrimitiveProps;
+declare function getColumnVisibilityListProps(localization?: GridLocalization): PrimitiveProps;
 declare function getColumnVisibilityCheckboxProps(options: ColumnVisibilityCheckboxPrimitiveOptions): PrimitiveProps;
 declare function getColumnVisibilityStatusProps(): PrimitiveProps;
-declare function getColumnVisibilityStatusText(visibleCount: number, totalCount: number): string;
-declare function getColumnVisibilityEmptyText(): string;
-declare function getColumnVisibilityResetButtonProps(hiddenCount: number): PrimitiveProps;
-declare function getColumnVisibilityResetButtonText(): string;
+declare function getColumnVisibilityStatusText(visibleCount: number, totalCount: number, localization?: GridLocalization): string;
+declare function getColumnVisibilityEmptyText(localization?: GridLocalization): string;
+declare function getColumnVisibilityResetButtonProps(hiddenCount: number, localization?: GridLocalization): PrimitiveProps;
+declare function getColumnVisibilityResetButtonText(localization?: GridLocalization): string;
 declare function normalizeGridDensity(value: unknown, fallback?: GridDensity): GridDensity;
+declare function migrateGridPreferences(value: unknown, migrations?: readonly GridPreferencesMigration[]): Record<string, unknown> | null;
 declare function createGridPreferences(state?: Partial<GridState>, density?: GridDensity, options?: GridPreferencesOptions): GridPreferences;
 declare function serializeGridPreferences(preferences: GridPreferences, options?: GridPreferencesOptions): string;
-declare function parseGridPreferences(value: string, options?: GridPreferencesOptions): GridPreferences | null;
+declare function parseGridPreferences(value: string, options?: GridPreferencesParseOptions): GridPreferences | null;
 declare function getBrowserGridPreferencesStorage(environment?: GridPreferencesStorageEnvironmentLike | null | undefined): GridPreferencesStorageLike | null;
-declare function readGridPreferences(storage: GridPreferencesStorageLike | null | undefined, key: string, options?: GridPreferencesOptions): GridPreferences | null;
+declare function readGridPreferences(storage: GridPreferencesStorageLike | null | undefined, key: string, options?: GridPreferencesParseOptions): GridPreferences | null;
 declare function writeGridPreferences(storage: GridPreferencesStorageLike | null | undefined, key: string, state: Partial<GridState>, density: GridDensity, options?: GridPreferencesOptions): boolean;
 declare function removeGridPreferences(storage: GridPreferencesStorageLike | null | undefined, key: string): boolean;
 declare function getGridDensityProps(density: GridDensity): PrimitiveProps;
 declare function getGridDensityRowHeight(density: GridDensity): number;
-declare function getDensityControlsProps(): PrimitiveProps;
-declare function getDensityButtonProps(density: GridDensity, currentDensity: GridDensity): PrimitiveProps;
-declare function getDensityButtonText(density: GridDensity): string;
+declare function getDensityControlsProps(localization?: GridLocalization): PrimitiveProps;
+declare function getDensityButtonProps(density: GridDensity, currentDensity: GridDensity, localization?: GridLocalization): PrimitiveProps;
+declare function getDensityButtonText(density: GridDensity, localization?: GridLocalization): string;
 declare function getFilteredColumnVisibilityColumns<TData>(columns: readonly Column<TData, unknown>[], query: string): Column<TData, unknown>[];
 declare function getNextColumnFilters(filters: ColumnFiltersState, columnId: ColumnId, value: string): ColumnFiltersState;
-declare function getPaginationProps(): PrimitiveProps;
-declare function getPaginationButtonProps(options: PaginationButtonPrimitiveOptions): PrimitiveProps;
+declare function getPaginationProps(localization?: GridLocalization): PrimitiveProps;
+declare function getPaginationButtonProps(options: PaginationButtonPrimitiveOptions, localization?: GridLocalization): PrimitiveProps;
 declare function getPaginationButtonText(action: PaginationAction): string;
 declare function getPaginationStatusProps(): PrimitiveProps;
-declare function getPaginationPageText<TData>(grid: Grid<TData>): string;
-declare function getPaginationPageSizeSelectProps(pageSize: number): PrimitiveProps;
+declare function getPaginationPageText<TData>(grid: Grid<TData>, localization?: GridLocalization): string;
+declare function getPaginationPageSizeSelectProps(pageSize: number, localization?: GridLocalization): PrimitiveProps;
 declare function getPaginationPageSizeOptions(options?: readonly number[], currentPageSize?: number): number[];
-declare function getPaginationPageSizeOptionText(pageSize: number): string;
+declare function getPaginationPageSizeOptionText(pageSize: number, localization?: GridLocalization): string;
 declare function getGridBodyProps(options?: GridBodyPrimitiveOptions): PrimitiveProps;
 declare function getGridEmptyRowProps(options?: GridEmptyRowPrimitiveOptions): PrimitiveProps;
 declare function getGridEmptyCellProps(options?: GridEmptyCellPrimitiveOptions): PrimitiveProps;
@@ -737,7 +804,7 @@ declare function getCellEditorKeyboardAction(event: {
     key: string;
 }): CellEditorKeyboardAction | null;
 declare function getGridKeyboardFocusMove(event: GridKeyboardShortcutEventLike): GridKeyboardFocusMove | null;
-declare function getColumnResizeHandleProps<TData>(column: Column<TData, unknown>, options?: ColumnResizeHandlePrimitiveOptions): PrimitiveProps;
+declare function getColumnResizeHandleProps<TData>(column: Column<TData, unknown>, options?: ColumnResizeHandlePrimitiveOptions, localization?: GridLocalization): PrimitiveProps;
 declare function getColumnResizeStartSize<TData>(grid: Grid<TData>, column: Column<TData, unknown>): number;
 declare function getColumnResizeKeyboardSize<TData>(column: Column<TData, unknown>, startSize: number, event: ColumnResizeKeyboardEventLike, options?: ColumnResizeKeyboardSizeOptions): number | null;
 declare function getColumnResizePointerSize(startSize: number, startX: number, event: ColumnResizePointerEventLike): number;
@@ -755,15 +822,15 @@ declare function addPointerMoveUpListeners(listeners: PointerMoveUpListeners, ta
 declare function addPointerUpCancelListeners(listeners: PointerUpCancelListeners, target?: PointerUpCancelListenerTargetLike | null | undefined): () => void;
 declare function addPointerMoveUpCancelListeners(listeners: PointerMoveUpCancelListeners, target?: PointerMoveUpCancelListenerTargetLike | null | undefined): () => void;
 declare function addPassiveScrollListener(listener: ScrollListener, target: ScrollListenerTargetLike): () => void;
-declare function getColumnPinningControlsProps<TData>(column: Column<TData, unknown>): PrimitiveProps;
+declare function getColumnPinningControlsProps<TData>(column: Column<TData, unknown>, localization?: GridLocalization): PrimitiveProps;
 declare function getColumnPinningButtonText(position: ColumnPinningPosition): string;
-declare function getColumnPinningButtonProps<TData>(column: Column<TData, unknown>, options: ColumnPinningButtonPrimitiveOptions): PrimitiveProps;
-declare function getHeaderActionMenuTriggerProps<TData>(column: Column<TData, unknown>, options: HeaderActionMenuTriggerPrimitiveOptions): PrimitiveProps;
+declare function getColumnPinningButtonProps<TData>(column: Column<TData, unknown>, options: ColumnPinningButtonPrimitiveOptions, localization?: GridLocalization): PrimitiveProps;
+declare function getHeaderActionMenuTriggerProps<TData>(column: Column<TData, unknown>, options: HeaderActionMenuTriggerPrimitiveOptions, localization?: GridLocalization): PrimitiveProps;
 declare function getHeaderActionMenuId(columnId: string): string;
 declare function getHeaderActionMenuTriggerId(columnId: string): string;
-declare function getHeaderActionMenuProps<TData>(column: Column<TData, unknown>): PrimitiveProps;
-declare function getHeaderActionMenuDefaultItemLabel(itemId: HeaderActionMenuDefaultItemId, options?: HeaderActionMenuDefaultItemLabelOptions): string;
-declare function getHeaderActionMenuDefaultItemDescriptors(options: HeaderActionMenuDefaultItemDescriptorOptions): HeaderActionMenuDefaultItemDescriptor[];
+declare function getHeaderActionMenuProps<TData>(column: Column<TData, unknown>, localization?: GridLocalization): PrimitiveProps;
+declare function getHeaderActionMenuDefaultItemLabel(itemId: HeaderActionMenuDefaultItemId, options?: HeaderActionMenuDefaultItemLabelOptions, localization?: GridLocalization): string;
+declare function getHeaderActionMenuDefaultItemDescriptors(options: HeaderActionMenuDefaultItemDescriptorOptions, localization?: GridLocalization): HeaderActionMenuDefaultItemDescriptor[];
 declare function getHeaderActionMenuItemProps(options?: HeaderActionMenuItemPrimitiveOptions): PrimitiveProps;
 declare function getHeaderActionMenuCustomItemProps(options?: HeaderActionMenuLabelPrimitiveOptions): PrimitiveProps;
 declare function getHeaderActionMenuLabelProps(): PrimitiveProps;
@@ -782,21 +849,21 @@ declare function isHeaderActionMenuSeparatorItem<TItem extends HeaderActionMenuP
     type: "separator";
 }>;
 declare function getHeaderActionMenuCustomItemUserProps(item: HeaderActionMenuPrimitiveCustomItem | null | false | undefined): Record<string, unknown>;
-declare function getGroupingPanelProps(options?: GroupingPanelPrimitiveOptions): PrimitiveProps;
+declare function getGroupingPanelProps(options?: GroupingPanelPrimitiveOptions, localization?: GridLocalization): PrimitiveProps;
 declare function getGroupingPanelPlaceholderProps(): PrimitiveProps;
 declare function getGroupingPanelChipProps<TData>(column: Column<TData, unknown>): PrimitiveProps;
-declare function getGroupingPanelMoveButtonProps<TData>(column: Column<TData, unknown>, options: GroupingPanelMoveButtonPrimitiveOptions): PrimitiveProps;
-declare function getGroupingPanelRemoveButtonProps<TData>(column: Column<TData, unknown>): PrimitiveProps;
+declare function getGroupingPanelMoveButtonProps<TData>(column: Column<TData, unknown>, options: GroupingPanelMoveButtonPrimitiveOptions, localization?: GridLocalization): PrimitiveProps;
+declare function getGroupingPanelRemoveButtonProps<TData>(column: Column<TData, unknown>, localization?: GridLocalization): PrimitiveProps;
 declare function getIsGroupLabelCell<TData>(row: Row<TData>, column: Column<TData, unknown>, visibleColumns: readonly Column<TData, unknown>[]): boolean;
-declare function getGroupValueText(value: unknown): string;
-declare function getGroupRowLabel<TData, TFallback = string>(row: Row<TData>, column: Column<TData, unknown>, options?: GroupRowLabelOptions<TFallback>): string | TFallback;
+declare function getGroupValueText(value: unknown, localization?: GridLocalization): string;
+declare function getGroupRowLabel<TData, TFallback = string>(row: Row<TData>, column: Column<TData, unknown>, options?: GroupRowLabelOptions<TFallback>, localization?: GridLocalization): string | TFallback;
 declare function getGroupCellIndent<TData>(row: Row<TData>, options?: GroupCellIndentOptions): number;
 declare function getGroupCellIndentStyle<TData>(row: Row<TData>, options?: GroupCellIndentOptions): GroupCellIndentStyleProps;
 declare function getGroupCellIndentStyleText<TData>(row: Row<TData>, options?: GroupCellIndentOptions): string;
 declare function getGroupRowCountText<TData>(row: Row<TData>): string | undefined;
 declare function getRowProps<TData>(row: Row<TData>, rowIndex: number, options?: RowPrimitiveOptions): PrimitiveProps;
 declare function getRowLayoutProps<TData>(row: Row<TData>, options?: RowLayoutPrimitiveOptions): PrimitiveProps;
-declare function getRowExpansionToggleProps<TData>(row: Row<TData>, options: RowExpansionTogglePrimitiveOptions): PrimitiveProps;
+declare function getRowExpansionToggleProps<TData>(row: Row<TData>, options: RowExpansionTogglePrimitiveOptions, localization?: GridLocalization): PrimitiveProps;
 declare function getRowExpansionToggleText(expanded: boolean): string;
 declare function getRowExpansionSpacerProps(): PrimitiveProps;
 declare function getCellProps<TData>(row: Row<TData>, column: Column<TData, unknown>, _rowIndex: number, columnIndex: number, options?: CellPrimitiveOptions): PrimitiveProps;
@@ -825,7 +892,7 @@ declare function escapeGridHtml(value: string): string;
 declare function getColumnHeaderText<TData>(column: Column<TData, unknown>): string;
 declare function getCellFillHandleVisible<TData>(row: Row<TData>, column: Column<TData, unknown>, options: CellFillHandleVisibilityOptions): boolean;
 declare function getCanStartCellPointerDrag(event: PointerButtonEventLike, editingCell: CellCoordinate | null | undefined): boolean;
-declare function getCellEditorProps<TData>(column: Column<TData, unknown>, options?: CellEditorPrimitiveOptions): PrimitiveProps;
+declare function getCellEditorProps<TData>(column: Column<TData, unknown>, options?: CellEditorPrimitiveOptions, localization?: GridLocalization): PrimitiveProps;
 declare function getCellEditorOptionProps(option: CellEditorOptionPrimitiveOptions): PrimitiveProps;
 declare function getCellEditorOptionText(option: CellEditorOptionPrimitiveOptions): string;
 declare function getCellValidationMessageProps(): PrimitiveProps;
@@ -928,4 +995,4 @@ declare function getPinnedColumnOffsetStyleText(layout: PinnedColumnOffsetStyleL
 declare function isCellCoordinateEqual(left: CellCoordinate | null | undefined, right: CellCoordinate | null | undefined): boolean;
 declare function isFocusedCell(focusedCell: CellCoordinate | null, rowId: string, columnId: string): boolean;
 
-export { type BrowserDownloadAnchorLike, type BrowserDownloadBlobConstructorLike, type BrowserDownloadDocumentLike, type BrowserDownloadEnvironment, type BrowserDownloadParentLike, type BrowserDownloadUrlLike, type BrowserExportFileLike, type CellEditValidationEventLike, type CellEditorKeyboardAction, type CellEditorOptionPrimitiveOptions, type CellEditorPrimitiveOptions, type CellEditorValueEventLike, type CellEditorValueTargetLike, type CellFillHandleVisibilityOptions, type CellLayoutPrimitiveOptions, type CellPrimitiveOptions, type CheckboxIndeterminateTargetLike, type ClickSuppressionController, type ClipboardTextAreaLike, type ClipboardTextDocumentLike, type ClipboardTextEnvironment, type ClipboardTextNavigatorLike, type ClipboardTextParentLike, type ColumnFilterCellPrimitiveOptions, type ColumnFilterInputPrimitiveOptions, type ColumnIdItemLike, type ColumnLayoutTotalWidthItemLike, type ColumnMoveDirection, type ColumnMoveGrid, type ColumnPinningButtonPrimitiveOptions, type ColumnResizeDefaultPreventableEventLike, type ColumnResizeFinalSizeEventLike, type ColumnResizeHandlePrimitiveOptions, type ColumnResizeKeyboardEventLike, type ColumnResizeKeyboardSizeOptions, type ColumnResizePointerEventLike, type ColumnVirtualizationPrimitiveOptions, type ColumnVisibilityCheckboxPrimitiveOptions, DEFAULT_PAGINATION_PAGE_SIZE_OPTIONS, type DatasetElementLike, type DefaultPreventableEventLike, type DefaultPreventablePropagationEventLike, type DefaultPreventedEventLike, type ElementIdLookupLike, type FocusableElementLike, type FocusableSelectableElementLike, type FocusedCellContainerLike, type FocusedCellRestoreFrameSyncOptions, type FocusedCellRestoreOptions, type FocusedCellScrollElementOptions, type FocusedCellScrollOptions, type FocusedCellScrollPosition, type FocusedRowSelectionTarget, GRID_DENSITIES, GRID_FOCUSED_CELL_SELECTOR, GRID_INTERACTIVE_KEYBOARD_TARGET_SELECTOR, GRID_PREFERENCES_VERSION, GROUPING_PANEL_EMPTY_MESSAGE, type GridBodyPrimitiveOptions, type GridDensity, type GridEmptyCellPrimitiveOptions, type GridEmptyRowPrimitiveOptions, type GridHeaderRowPrimitiveOptions, type GridKeyboardEditAction, type GridKeyboardFocusMove, type GridKeyboardShortcutAction, type GridKeyboardShortcutEventLike, type GridPreferences, type GridPreferencesOptions, type GridPreferencesState, type GridPreferencesStorageEnvironmentLike, type GridPreferencesStorageLike, type GridRowCoordinateOptions, type GroupCellIndentOptions, type GroupCellIndentStyleProps, type GroupRowLabelOptions, type GroupingColumnMoveGrid, type GroupingPanelMoveButtonPrimitiveOptions, type GroupingPanelPrimitiveOptions, HEADER_ACTION_MENU_ENABLED_ITEM_SELECTOR, HEADER_ACTION_MENU_TRIGGER_TEXT, type HeaderActionMenuActiveElementDocumentLike, type HeaderActionMenuActiveElementTargetLike, type HeaderActionMenuDefaultItemDescriptor, type HeaderActionMenuDefaultItemDescriptorOptions, type HeaderActionMenuDefaultItemId, type HeaderActionMenuDefaultItemLabelOptions, type HeaderActionMenuFocusTargetEventLike, type HeaderActionMenuFocusTargetLike, type HeaderActionMenuItemFocusPosition, type HeaderActionMenuItemFocusTargetLike, type HeaderActionMenuItemPrimitiveOptions, type HeaderActionMenuKeyboardAction, type HeaderActionMenuLabelPrimitiveOptions, type HeaderActionMenuPrimitiveCustomItem, type HeaderActionMenuPrimitiveItem, type HeaderActionMenuPrimitiveLabelItem, type HeaderActionMenuPrimitiveSeparatorItem, type HeaderActionMenuTriggerPrimitiveOptions, type HeaderButtonPrimitiveOptions, type HeaderCellLayoutPrimitiveOptions, type HeaderCellPrimitiveOptions, type HeaderDragEndAction, type HeaderDragEndActionOptions, type HeaderDragEndColumnLike, type HeaderDragEndLike, type HeaderKeyboardMoveEventLike, type HeaderSortIndicatorTextOptions, type InlineSizeStyleProps, type KeyboardTargetEventLike, type MeasuredBlockElementLike, type MeasuredBlockRectElementLike, type MeasuredBlockRectElementTargetLike, type MeasuredInlineDatasetElementTargetLike, type MeasuredInlineElementLike, type MeasuredSizeCacheLike, type ObservedElementMapLike, type OffsetBlockElementLike, type PaginationAction, type PaginationButtonPrimitiveOptions, type PinnedColumnOffsetStyleLayoutLike, type PinnedColumnOffsetStyleProps, type PointerButtonEventLike, type PointerButtonsEventLike, type PointerCaptureEventLike, type PointerCaptureTargetLike, type PointerClientCoordinateLike, type PointerDragMovementLike, type PointerDragSessionLike, type PointerDragStartLike, type PointerHitTestElementLike, type PointerIdEventLike, type PointerListener, type PointerMoveUpCancelListenerTargetLike, type PointerMoveUpCancelListeners, type PointerMoveUpListenerTargetLike, type PointerMoveUpListeners, type PointerUpCancelListenerTargetLike, type PointerUpCancelListeners, type PrimitiveProps, type PropagationEventLike, type QuickFilterInputPrimitiveOptions, type ResizeObserverBlockSizeEntryLike, type ResizeObserverConstructorLike, type ResizeObserverDatasetEntryLike, type ResizeObserverDatasetTargetLike, type ResizeObserverDisconnectLike, type ResizeObserverEntryDatasetKey, type ResizeObserverInlineSizeEntryLike, type ResizeObserverObserveLike, type ResizeObserverUnobserveLike, type ResolvedColumnVirtualizationOptions, type ResolvedRowVirtualizationOptions, type RowExpansionTogglePrimitiveOptions, type RowIdItemLike, type RowLayoutPrimitiveOptions, type RowPrimitiveOptions, type RowSelectionCheckboxPrimitiveOptions, type RowSelectionToggleEventLike, type RowVirtualizationPrimitiveOptions, type ScrollFrameElementLike, type ScrollFrameElementOptions, type ScrollFrameOptionsLike, type ScrollListener, type ScrollListenerTargetLike, type ScrollPositionElementLike, type VirtualBodyStyleProps, type VirtualBodyStyleRangeLike, type VirtualRowStyleItemLike, type VirtualRowStyleProps, type VirtualizedInlineSizeStyleProps, addPassiveScrollListener, addPointerMoveUpCancelListeners, addPointerMoveUpListeners, addPointerUpCancelListeners, applyResizeObserverMeasuredSizes, createClickSuppressionController, createGridPreferences, createResizeObserver, disconnectResizeObserver, downloadBrowserExportFile, escapeGridHtml, focusCellEditorElement, focusElement, focusElementById, focusFocusedCellInGrid, focusHeaderActionMenuItem, focusHeaderActionMenuItemById, focusHeaderActionMenuTrigger, focusHeaderActionMenuTriggerById, getBrowserGridPreferencesStorage, getCanApplyColumnResize, getCanCancelCellEdit, getCanContinuePointerDrag, getCanEndPointerDrag, getCanRestoreFocusedCell, getCanRunGridKeyboardShortcut, getCanStartCellEdit, getCanStartCellPointerDrag, getCanStartColumnResize, getCanStartFocusedCellEdit, getCanToggleRowSelection, getCellDisplayText, getCellEditText, getCellEditValidationMessage, getCellEditorEventValue, getCellEditorKeyboardAction, getCellEditorOptionProps, getCellEditorOptionText, getCellEditorProps, getCellEditorTargetValue, getCellFillHandleProps, getCellFillHandleVisible, getCellLayoutProps, getCellProps, getCellValidationMessageProps, getColumnById, getColumnFilterCellProps, getColumnFilterInputProps, getColumnFilterText, getColumnHeaderText, getColumnIndexById, getColumnLayoutById, getColumnLayoutTotalWidth, getColumnPinningButtonProps, getColumnPinningButtonText, getColumnPinningControlsProps, getColumnResizeFinalSize, getColumnResizeHandleProps, getColumnResizeKeyboardSize, getColumnResizePointerSize, getColumnResizeStartSize, getColumnSpacerProps, getColumnVisibilityCheckboxProps, getColumnVisibilityControlsProps, getColumnVisibilityEmptyText, getColumnVisibilityListProps, getColumnVisibilityResetButtonProps, getColumnVisibilityResetButtonText, getColumnVisibilitySearchInputProps, getColumnVisibilityStatusProps, getColumnVisibilityStatusText, getColumnVisibilitySummaryProps, getColumnVisibilitySummaryText, getDefaultBrowserDownloadEnvironment, getDefaultClipboardTextEnvironment, getDefaultPointerMoveUpCancelListenerTarget, getDefaultPointerMoveUpListenerTarget, getDefaultPointerUpCancelListenerTarget, getDensityButtonProps, getDensityButtonText, getDensityControlsProps, getElementOffsetBlockSize, getEnabledHeaderActionMenuItems, getFilteredColumnVisibilityColumns, getFocusedCellScrollOptionsFromElement, getFocusedRowSelectionTarget, getGridBodyProps, getGridBodyRowIndexOffset, getGridDensityProps, getGridDensityRowHeight, getGridEmptyCellProps, getGridEmptyRowProps, getGridErrorOverlayProps, getGridErrorRetryButtonProps, getGridErrorRetryButtonText, getGridErrorText, getGridHeaderProps, getGridHeaderRowCount, getGridHeaderRowProps, getGridKeyboardEditAction, getGridKeyboardFocusMove, getGridKeyboardShortcutAction, getGridLoadingOverlayProps, getGridLoadingText, getGridProps, getGroupCellIndent, getGroupCellIndentStyle, getGroupCellIndentStyleText, getGroupRowCountText, getGroupRowLabel, getGroupValueText, getGroupingPanelChipProps, getGroupingPanelMoveButtonProps, getGroupingPanelPlaceholderProps, getGroupingPanelProps, getGroupingPanelRemoveButtonProps, getHeaderActionMenuActiveElement, getHeaderActionMenuCustomItemProps, getHeaderActionMenuCustomItemUserProps, getHeaderActionMenuDefaultItemDescriptors, getHeaderActionMenuDefaultItemLabel, getHeaderActionMenuFocusTarget, getHeaderActionMenuId, getHeaderActionMenuItemProps, getHeaderActionMenuKeyboardAction, getHeaderActionMenuLabelProps, getHeaderActionMenuProps, getHeaderActionMenuSeparatorProps, getHeaderActionMenuTriggerFocusPosition, getHeaderActionMenuTriggerId, getHeaderActionMenuTriggerProps, getHeaderButtonProps, getHeaderCellLayoutProps, getHeaderCellProps, getHeaderDragEndAction, getHeaderKeyboardMoveDirection, getHeaderPlaceholderCellProps, getHeaderSortIndicatorProps, getHeaderSortIndicatorText, getInlineSizeStyle, getInlineSizeStyleText, getIsGroupLabelCell, getMeasuredElementBlockSize, getMeasuredElementBlockSizeFromRect, getMeasuredElementBlockSizeFromTarget, getMeasuredElementInlineSize, getNextColumnFilters, getPaginationButtonProps, getPaginationButtonText, getPaginationPageSizeOptionText, getPaginationPageSizeOptions, getPaginationPageSizeSelectProps, getPaginationPageText, getPaginationProps, getPaginationStatusProps, getPinnedColumnOffsetStyle, getPinnedColumnOffsetStyleText, getPointerCaptureTarget, getQuickFilterClearButtonProps, getQuickFilterClearButtonText, getQuickFilterInputProps, getQuickFilterProps, getResizeObserverEntryBlockSize, getResizeObserverEntryDatasetId, getResizeObserverEntryInlineSize, getRowById, getRowExpansionSpacerProps, getRowExpansionToggleProps, getRowExpansionToggleText, getRowLayoutProps, getRowProps, getRowSelectionCheckboxProps, getRowSelectionCheckboxText, getRowSelectionClearButtonProps, getRowSelectionClearButtonText, getRowSelectionControlsProps, getRowSelectionStatusProps, getRowSelectionStatusText, getScrollForFocusedCell, getScrollFrameOptionsFromElement, getShouldCancelFocusedCellRestoreOnFrameSync, getShouldPreventEventDefault, getSizeOffset, getVirtualBodyStyle, getVirtualBodyStyleText, getVirtualRowStyle, getVirtualRowStyleText, getVirtualizedInlineSizeStyle, getVirtualizedInlineSizeStyleText, hasPointerMovedPastDragThreshold, isCellCoordinateEqual, isFocusableElement, isFocusedCell, isGridInteractiveKeyboardEventTarget, isGridInteractiveKeyboardTarget, isHeaderActionMenuActionItem, isHeaderActionMenuCloseAction, isHeaderActionMenuCustomItem, isHeaderActionMenuFocusAction, isHeaderActionMenuFocusTarget, isHeaderActionMenuItem, isHeaderActionMenuLabelItem, isHeaderActionMenuSeparatorItem, isHeaderActionMenuTabCloseAction, isHeaderDragGroupAction, isHeaderDragMoveAction, isMeasuredBlockElement, isMeasuredBlockRectElement, isMeasuredBlockRectElementTarget, isMeasuredInlineDatasetElementTarget, isMeasuredInlineElement, isPointerCaptureTarget, isPointerInsideElement, isPrimaryPointerButton, isPrimaryPointerDragActive, isResizeObserverDatasetTarget, moveColumnToTarget, moveGroupedColumn, moveVisibleColumn, normalizeGridDensity, observeElements, parseCellEditValue, parseGridPreferences, preventDefaultAndStopPropagation, preventEventDefault, readClipboardText, readGridPreferences, removeGridPreferences, removeObservedElement, replaceObservedElement, resolveColumnVirtualizationOptions, resolveRowVirtualizationOptions, scrollElementToPosition, serializeGridPreferences, setCheckboxIndeterminate, setElementDatasetId, stopEventPropagation, tryReleasePointerCapture, trySetPointerCapture, updatePointerDragDidMovePastThreshold, writeClipboardText, writeGridPreferences };
+export { type BrowserDownloadAnchorLike, type BrowserDownloadBlobConstructorLike, type BrowserDownloadDocumentLike, type BrowserDownloadEnvironment, type BrowserDownloadParentLike, type BrowserDownloadUrlLike, type BrowserExportFileLike, type CellEditValidationEventLike, type CellEditorKeyboardAction, type CellEditorOptionPrimitiveOptions, type CellEditorPrimitiveOptions, type CellEditorValueEventLike, type CellEditorValueTargetLike, type CellFillHandleVisibilityOptions, type CellLayoutPrimitiveOptions, type CellPrimitiveOptions, type CheckboxIndeterminateTargetLike, type ClickSuppressionController, type ClipboardTextAreaLike, type ClipboardTextDocumentLike, type ClipboardTextEnvironment, type ClipboardTextNavigatorLike, type ClipboardTextParentLike, type ColumnFilterCellPrimitiveOptions, type ColumnFilterInputPrimitiveOptions, type ColumnIdItemLike, type ColumnLayoutTotalWidthItemLike, type ColumnMoveDirection, type ColumnMoveGrid, type ColumnPinningButtonPrimitiveOptions, type ColumnResizeDefaultPreventableEventLike, type ColumnResizeFinalSizeEventLike, type ColumnResizeHandlePrimitiveOptions, type ColumnResizeKeyboardEventLike, type ColumnResizeKeyboardSizeOptions, type ColumnResizePointerEventLike, type ColumnVirtualizationPrimitiveOptions, type ColumnVisibilityCheckboxPrimitiveOptions, DEFAULT_GRID_LOCALIZATION, DEFAULT_PAGINATION_PAGE_SIZE_OPTIONS, type DatasetElementLike, type DefaultPreventableEventLike, type DefaultPreventablePropagationEventLike, type DefaultPreventedEventLike, type ElementIdLookupLike, type FocusableElementLike, type FocusableSelectableElementLike, type FocusedCellContainerLike, type FocusedCellRestoreFrameSyncOptions, type FocusedCellRestoreOptions, type FocusedCellScrollElementOptions, type FocusedCellScrollOptions, type FocusedCellScrollPosition, type FocusedRowSelectionTarget, GRID_DENSITIES, GRID_FOCUSED_CELL_SELECTOR, GRID_INTERACTIVE_KEYBOARD_TARGET_SELECTOR, GRID_PREFERENCES_VERSION, GROUPING_PANEL_EMPTY_MESSAGE, type GridBodyPrimitiveOptions, type GridDensity, type GridEmptyCellPrimitiveOptions, type GridEmptyRowPrimitiveOptions, type GridHeaderRowPrimitiveOptions, type GridKeyboardEditAction, type GridKeyboardFocusMove, type GridKeyboardShortcutAction, type GridKeyboardShortcutEventLike, type GridLocalization, type GridLocalizationOverrides, type GridPreferences, type GridPreferencesMigration, type GridPreferencesOptions, type GridPreferencesParseOptions, type GridPreferencesState, type GridPreferencesStorageEnvironmentLike, type GridPreferencesStorageLike, type GridRowCoordinateOptions, type GroupCellIndentOptions, type GroupCellIndentStyleProps, type GroupRowLabelOptions, type GroupingColumnMoveGrid, type GroupingPanelMoveButtonPrimitiveOptions, type GroupingPanelPrimitiveOptions, HEADER_ACTION_MENU_ENABLED_ITEM_SELECTOR, HEADER_ACTION_MENU_TRIGGER_TEXT, type HeaderActionMenuActiveElementDocumentLike, type HeaderActionMenuActiveElementTargetLike, type HeaderActionMenuDefaultItemDescriptor, type HeaderActionMenuDefaultItemDescriptorOptions, type HeaderActionMenuDefaultItemId, type HeaderActionMenuDefaultItemLabelOptions, type HeaderActionMenuFocusTargetEventLike, type HeaderActionMenuFocusTargetLike, type HeaderActionMenuItemFocusPosition, type HeaderActionMenuItemFocusTargetLike, type HeaderActionMenuItemPrimitiveOptions, type HeaderActionMenuKeyboardAction, type HeaderActionMenuLabelPrimitiveOptions, type HeaderActionMenuPrimitiveCustomItem, type HeaderActionMenuPrimitiveItem, type HeaderActionMenuPrimitiveLabelItem, type HeaderActionMenuPrimitiveSeparatorItem, type HeaderActionMenuTriggerPrimitiveOptions, type HeaderButtonPrimitiveOptions, type HeaderCellLayoutPrimitiveOptions, type HeaderCellPrimitiveOptions, type HeaderDragEndAction, type HeaderDragEndActionOptions, type HeaderDragEndColumnLike, type HeaderDragEndLike, type HeaderKeyboardMoveEventLike, type HeaderSortIndicatorTextOptions, type InlineSizeStyleProps, type KeyboardTargetEventLike, type MeasuredBlockElementLike, type MeasuredBlockRectElementLike, type MeasuredBlockRectElementTargetLike, type MeasuredInlineDatasetElementTargetLike, type MeasuredInlineElementLike, type MeasuredSizeCacheLike, type ObservedElementMapLike, type OffsetBlockElementLike, type PaginationAction, type PaginationButtonPrimitiveOptions, type PinnedColumnOffsetStyleLayoutLike, type PinnedColumnOffsetStyleProps, type PointerButtonEventLike, type PointerButtonsEventLike, type PointerCaptureEventLike, type PointerCaptureTargetLike, type PointerClientCoordinateLike, type PointerDragMovementLike, type PointerDragSessionLike, type PointerDragStartLike, type PointerHitTestElementLike, type PointerIdEventLike, type PointerListener, type PointerMoveUpCancelListenerTargetLike, type PointerMoveUpCancelListeners, type PointerMoveUpListenerTargetLike, type PointerMoveUpListeners, type PointerUpCancelListenerTargetLike, type PointerUpCancelListeners, type PrimitiveProps, type PropagationEventLike, type QuickFilterInputPrimitiveOptions, type ResizeObserverBlockSizeEntryLike, type ResizeObserverConstructorLike, type ResizeObserverDatasetEntryLike, type ResizeObserverDatasetTargetLike, type ResizeObserverDisconnectLike, type ResizeObserverEntryDatasetKey, type ResizeObserverInlineSizeEntryLike, type ResizeObserverObserveLike, type ResizeObserverUnobserveLike, type ResolvedColumnVirtualizationOptions, type ResolvedRowVirtualizationOptions, type RowExpansionTogglePrimitiveOptions, type RowIdItemLike, type RowLayoutPrimitiveOptions, type RowPrimitiveOptions, type RowSelectionCheckboxPrimitiveOptions, type RowSelectionToggleEventLike, type RowVirtualizationPrimitiveOptions, type ScrollFrameElementLike, type ScrollFrameElementOptions, type ScrollFrameOptionsLike, type ScrollListener, type ScrollListenerTargetLike, type ScrollPositionElementLike, type VirtualBodyStyleProps, type VirtualBodyStyleRangeLike, type VirtualRowStyleItemLike, type VirtualRowStyleProps, type VirtualizedInlineSizeStyleProps, addPassiveScrollListener, addPointerMoveUpCancelListeners, addPointerMoveUpListeners, addPointerUpCancelListeners, applyResizeObserverMeasuredSizes, createClickSuppressionController, createGridLocalization, createGridPreferences, createResizeObserver, disconnectResizeObserver, downloadBrowserExportFile, escapeGridHtml, focusCellEditorElement, focusElement, focusElementById, focusFocusedCellInGrid, focusHeaderActionMenuItem, focusHeaderActionMenuItemById, focusHeaderActionMenuTrigger, focusHeaderActionMenuTriggerById, getBrowserGridPreferencesStorage, getCanApplyColumnResize, getCanCancelCellEdit, getCanContinuePointerDrag, getCanEndPointerDrag, getCanRestoreFocusedCell, getCanRunGridKeyboardShortcut, getCanStartCellEdit, getCanStartCellPointerDrag, getCanStartColumnResize, getCanStartFocusedCellEdit, getCanToggleRowSelection, getCellDisplayText, getCellEditText, getCellEditValidationMessage, getCellEditorEventValue, getCellEditorKeyboardAction, getCellEditorOptionProps, getCellEditorOptionText, getCellEditorProps, getCellEditorTargetValue, getCellFillHandleProps, getCellFillHandleVisible, getCellLayoutProps, getCellProps, getCellValidationMessageProps, getColumnById, getColumnFilterCellProps, getColumnFilterInputProps, getColumnFilterText, getColumnHeaderText, getColumnIndexById, getColumnLayoutById, getColumnLayoutTotalWidth, getColumnPinningButtonProps, getColumnPinningButtonText, getColumnPinningControlsProps, getColumnResizeFinalSize, getColumnResizeHandleProps, getColumnResizeKeyboardSize, getColumnResizePointerSize, getColumnResizeStartSize, getColumnSpacerProps, getColumnVisibilityCheckboxProps, getColumnVisibilityControlsProps, getColumnVisibilityEmptyText, getColumnVisibilityListProps, getColumnVisibilityResetButtonProps, getColumnVisibilityResetButtonText, getColumnVisibilitySearchInputProps, getColumnVisibilityStatusProps, getColumnVisibilityStatusText, getColumnVisibilitySummaryProps, getColumnVisibilitySummaryText, getDefaultBrowserDownloadEnvironment, getDefaultClipboardTextEnvironment, getDefaultPointerMoveUpCancelListenerTarget, getDefaultPointerMoveUpListenerTarget, getDefaultPointerUpCancelListenerTarget, getDensityButtonProps, getDensityButtonText, getDensityControlsProps, getElementOffsetBlockSize, getEnabledHeaderActionMenuItems, getFilteredColumnVisibilityColumns, getFocusedCellScrollOptionsFromElement, getFocusedRowSelectionTarget, getGridBodyProps, getGridBodyRowIndexOffset, getGridDensityProps, getGridDensityRowHeight, getGridEmptyCellProps, getGridEmptyRowProps, getGridErrorOverlayProps, getGridErrorRetryButtonProps, getGridErrorRetryButtonText, getGridErrorText, getGridHeaderProps, getGridHeaderRowCount, getGridHeaderRowProps, getGridKeyboardEditAction, getGridKeyboardFocusMove, getGridKeyboardShortcutAction, getGridLoadingOverlayProps, getGridLoadingText, getGridProps, getGroupCellIndent, getGroupCellIndentStyle, getGroupCellIndentStyleText, getGroupRowCountText, getGroupRowLabel, getGroupValueText, getGroupingPanelChipProps, getGroupingPanelMoveButtonProps, getGroupingPanelPlaceholderProps, getGroupingPanelProps, getGroupingPanelRemoveButtonProps, getHeaderActionMenuActiveElement, getHeaderActionMenuCustomItemProps, getHeaderActionMenuCustomItemUserProps, getHeaderActionMenuDefaultItemDescriptors, getHeaderActionMenuDefaultItemLabel, getHeaderActionMenuFocusTarget, getHeaderActionMenuId, getHeaderActionMenuItemProps, getHeaderActionMenuKeyboardAction, getHeaderActionMenuLabelProps, getHeaderActionMenuProps, getHeaderActionMenuSeparatorProps, getHeaderActionMenuTriggerFocusPosition, getHeaderActionMenuTriggerId, getHeaderActionMenuTriggerProps, getHeaderButtonProps, getHeaderCellLayoutProps, getHeaderCellProps, getHeaderDragEndAction, getHeaderKeyboardMoveDirection, getHeaderPlaceholderCellProps, getHeaderSortIndicatorProps, getHeaderSortIndicatorText, getInlineSizeStyle, getInlineSizeStyleText, getIsGroupLabelCell, getMeasuredElementBlockSize, getMeasuredElementBlockSizeFromRect, getMeasuredElementBlockSizeFromTarget, getMeasuredElementInlineSize, getNextColumnFilters, getPaginationButtonProps, getPaginationButtonText, getPaginationPageSizeOptionText, getPaginationPageSizeOptions, getPaginationPageSizeSelectProps, getPaginationPageText, getPaginationProps, getPaginationStatusProps, getPinnedColumnOffsetStyle, getPinnedColumnOffsetStyleText, getPointerCaptureTarget, getQuickFilterClearButtonProps, getQuickFilterClearButtonText, getQuickFilterInputProps, getQuickFilterProps, getResizeObserverEntryBlockSize, getResizeObserverEntryDatasetId, getResizeObserverEntryInlineSize, getRowById, getRowExpansionSpacerProps, getRowExpansionToggleProps, getRowExpansionToggleText, getRowLayoutProps, getRowProps, getRowSelectionCheckboxProps, getRowSelectionCheckboxText, getRowSelectionClearButtonProps, getRowSelectionClearButtonText, getRowSelectionControlsProps, getRowSelectionStatusProps, getRowSelectionStatusText, getScrollForFocusedCell, getScrollFrameOptionsFromElement, getShouldCancelFocusedCellRestoreOnFrameSync, getShouldPreventEventDefault, getSizeOffset, getVirtualBodyStyle, getVirtualBodyStyleText, getVirtualRowStyle, getVirtualRowStyleText, getVirtualizedInlineSizeStyle, getVirtualizedInlineSizeStyleText, hasPointerMovedPastDragThreshold, isCellCoordinateEqual, isFocusableElement, isFocusedCell, isGridInteractiveKeyboardEventTarget, isGridInteractiveKeyboardTarget, isHeaderActionMenuActionItem, isHeaderActionMenuCloseAction, isHeaderActionMenuCustomItem, isHeaderActionMenuFocusAction, isHeaderActionMenuFocusTarget, isHeaderActionMenuItem, isHeaderActionMenuLabelItem, isHeaderActionMenuSeparatorItem, isHeaderActionMenuTabCloseAction, isHeaderDragGroupAction, isHeaderDragMoveAction, isMeasuredBlockElement, isMeasuredBlockRectElement, isMeasuredBlockRectElementTarget, isMeasuredInlineDatasetElementTarget, isMeasuredInlineElement, isPointerCaptureTarget, isPointerInsideElement, isPrimaryPointerButton, isPrimaryPointerDragActive, isResizeObserverDatasetTarget, migrateGridPreferences, moveColumnToTarget, moveGroupedColumn, moveVisibleColumn, normalizeGridDensity, observeElements, parseCellEditValue, parseGridPreferences, preventDefaultAndStopPropagation, preventEventDefault, readClipboardText, readGridPreferences, removeGridPreferences, removeObservedElement, replaceObservedElement, resolveColumnVirtualizationOptions, resolveRowVirtualizationOptions, scrollElementToPosition, serializeGridPreferences, setCheckboxIndeterminate, setElementDatasetId, stopEventPropagation, tryReleasePointerCapture, trySetPointerCapture, updatePointerDragDidMovePastThreshold, writeClipboardText, writeGridPreferences };

package/dist/index.js

@@ -1,15 +1,84 @@
 // src/index.ts
 var GRID_DENSITIES = ["compact", "standard", "comfortable"];
+var DEFAULT_GRID_LOCALIZATION = Object.freeze({
+  dataGridLabel: "Data grid",
+  noRows: "No rows",
+  loadingRowsLabel: "Loading rows",
+  loadingRows: "Loading rows...",
+  gridErrorLabel: "Grid error",
+  gridError: "Unable to load rows.",
+  retryLoadingRowsLabel: "Retry loading rows",
+  retry: "Retry",
+  filterPlaceholder: "Filter",
+  filterColumnLabel: (label) => `Filter ${label}`,
+  searchGridRowsLabel: "Search grid rows",
+  searchRowsPlaceholder: "Search rows",
+  searchAllRowsLabel: "Search all rows",
+  clearRowSearchLabel: "Clear row search",
+  clear: "Clear",
+  rowSelectionLabel: "Row selection",
+  selectAllRowsOnCurrentPageLabel: "Select all rows on current page",
+  selectPage: "Select page",
+  selectedRows: (count) => `${count} ${count === 1 ? "row" : "rows"} selected`,
+  clearRowSelectionLabel: "Clear row selection",
+  clearSelection: "Clear selection",
+  gridColumnsLabel: "Grid columns",
+  manageColumnsLabel: (visibleCount, totalCount) => `Manage columns, ${visibleCount} of ${totalCount} columns visible`,
+  columnsSummary: (visibleCount, totalCount) => `Columns ${visibleCount}/${totalCount}`,
+  findColumns: "Find columns",
+  columnVisibilityLabel: "Column visibility",
+  columnsVisible: (visibleCount, totalCount) => `${visibleCount} of ${totalCount} columns visible`,
+  noColumnsFound: "No columns found",
+  showAllColumnsLabel: "Show all columns",
+  showAll: "Show all",
+  rowDensityLabel: "Row density",
+  useDensityLabel: (density) => `Use ${density} density`,
+  densityLabel: (density) => ({ compact: "Compact", standard: "Standard", comfortable: "Comfortable" })[density],
+  paginationLabel: "Pagination",
+  paginationActionLabel: (action) => ({ first: "First page", previous: "Previous page", next: "Next page", last: "Last page" })[action],
+  pageStatus: (page, pageCount) => `Page ${page} of ${pageCount}`,
+  rowsPerPageLabel: "Rows per page",
+  pageSizeOption: (pageSize) => `${pageSize} rows`,
+  resizeColumnLabel: (columnId) => `Resize ${columnId} column`,
+  columnPinningLabel: (columnId) => `${columnId} column pinning`,
+  pinColumnLabel: (columnId, position) => position === "left" ? `Pin ${columnId} left` : position === "right" ? `Pin ${columnId} right` : `Unpin ${columnId}`,
+  openColumnMenuLabel: (columnId) => `Open ${columnId} column menu`,
+  columnMenuLabel: (columnId) => `${columnId} column menu`,
+  headerActionMenuTrigger: "...",
+  headerActionMenuItemLabel: (itemId, grouped) => ({
+    "sort-asc": "Sort ascending",
+    "sort-desc": "Sort descending",
+    "clear-sort": "Clear sort",
+    "move-left": "Move left",
+    "move-right": "Move right",
+    "pin-left": "Pin left",
+    unpin: "Unpin",
+    "pin-right": "Pin right",
+    "toggle-group": grouped ? "Ungroup column" : "Group by column"
+  })[itemId],
+  columnGroupingLabel: "Column grouping",
+  groupingPanelEmpty: "Drag column headers here to group",
+  moveColumnGroupingLabel: (columnId, direction) => `Move ${columnId} grouping ${direction}`,
+  removeColumnGroupingLabel: (columnId) => `Remove ${columnId} grouping`,
+  toggleRowExpandedLabel: (expanded, label) => `${expanded ? "Collapse" : "Expand"} ${label}`,
+  blankGroupValue: "(blank)",
+  groupFooterTotal: "Total",
+  editColumnLabel: (columnId) => `Edit ${columnId}`
+});
+function createGridLocalization(overrides = {}) {
+  return Object.freeze({ ...DEFAULT_GRID_LOCALIZATION, ...overrides });
+}
 var GRID_PREFERENCES_VERSION = 1;
 var DEFAULT_PAGINATION_PAGE_SIZE_OPTIONS = [25, 50, 100];
 var HEADER_ACTION_MENU_ENABLED_ITEM_SELECTOR = '[role="menuitem"]:not(:disabled):not([aria-disabled="true"])';
-var HEADER_ACTION_MENU_TRIGGER_TEXT = "...";
-var GROUPING_PANEL_EMPTY_MESSAGE = "Drag column headers here to group";
+var HEADER_ACTION_MENU_TRIGGER_TEXT = DEFAULT_GRID_LOCALIZATION.headerActionMenuTrigger;
+var GROUPING_PANEL_EMPTY_MESSAGE = DEFAULT_GRID_LOCALIZATION.groupingPanelEmpty;
 var GRID_FOCUSED_CELL_SELECTOR = '[role="gridcell"][data-focused="true"]';
 var GRID_INTERACTIVE_KEYBOARD_TARGET_SELECTOR = "button, input, select, textarea, a[href], [contenteditable]:not([contenteditable='false']), [role='button'], [role='menuitem'], [role='separator'], [role='slider'], [role='textbox'], [role='combobox'], [role='searchbox'], [role='spinbutton']";
 function getGridProps(grid, options = {}) {
   const headerRowCount = getGridHeaderRowCount(grid, options);
-  const rowCount = grid.getOptions().manualPagination ? -1 : headerRowCount + Math.max(1, grid.getPrePaginationRowModel().rows.length);
+  const hasKnownRowCount = !grid.getOptions().manualPagination || typeof grid.getOptions().rowCount === "number";
+  const rowCount = hasKnownRowCount ? headerRowCount + Math.max(1, grid.getRowCount()) : -1;
   const columnCount = grid.getVisibleLeafColumns().length;
   return {
     role: "grid",
@@ -27,35 +96,35 @@ function getGridHeaderProps() {
     role: "rowgroup"
   };
 }
-function getGridLoadingOverlayProps() {
+function getGridLoadingOverlayProps(localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     role: "status",
     "aria-live": "polite",
-    "aria-label": "Loading rows"
+    "aria-label": localization.loadingRowsLabel
   };
 }
-function getGridLoadingText() {
-  return "Loading rows...";
+function getGridLoadingText(localization = DEFAULT_GRID_LOCALIZATION) {
+  return localization.loadingRows;
 }
-function getGridErrorOverlayProps() {
+function getGridErrorOverlayProps(localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     role: "alert",
     "aria-live": "assertive",
     "aria-atomic": true,
-    "aria-label": "Grid error"
+    "aria-label": localization.gridErrorLabel
   };
 }
-function getGridErrorText() {
-  return "Unable to load rows.";
+function getGridErrorText(localization = DEFAULT_GRID_LOCALIZATION) {
+  return localization.gridError;
 }
-function getGridErrorRetryButtonProps() {
+function getGridErrorRetryButtonProps(localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "button",
-    "aria-label": "Retry loading rows"
+    "aria-label": localization.retryLoadingRowsLabel
   };
 }
-function getGridErrorRetryButtonText() {
-  return "Retry";
+function getGridErrorRetryButtonText(localization = DEFAULT_GRID_LOCALIZATION) {
+  return localization.retry;
 }
 function getGridHeaderRowProps(options = {}) {
   return {
@@ -83,12 +152,12 @@ function getColumnFilterCellProps(column, options) {
     "data-pinned-edge": options.pinnedEdge
   };
 }
-function getColumnFilterInputProps(column, options) {
+function getColumnFilterInputProps(column, options, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "search",
     value: options.value == null ? "" : String(options.value),
-    placeholder: "Filter",
-    "aria-label": `Filter ${options.label}`,
+    placeholder: localization.filterPlaceholder,
+    "aria-label": localization.filterColumnLabel(options.label),
     "data-column-id": column.id,
     autoComplete: "off"
   };
@@ -97,48 +166,48 @@ function getColumnFilterText(filters, columnId) {
   const value = filters.find((filter) => filter.id === columnId)?.value;
   return value == null ? "" : String(value);
 }
-function getQuickFilterProps() {
+function getQuickFilterProps(localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     role: "search",
-    "aria-label": "Search grid rows"
+    "aria-label": localization.searchGridRowsLabel
   };
 }
-function getQuickFilterInputProps(options) {
+function getQuickFilterInputProps(options, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "search",
     value: options.value,
-    placeholder: "Search rows",
-    "aria-label": "Search all rows",
+    placeholder: localization.searchRowsPlaceholder,
+    "aria-label": localization.searchAllRowsLabel,
     autoComplete: "off"
   };
 }
-function getQuickFilterClearButtonProps(value) {
+function getQuickFilterClearButtonProps(value, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "button",
-    "aria-label": "Clear row search",
+    "aria-label": localization.clearRowSearchLabel,
     disabled: value.length === 0 || void 0
   };
 }
-function getQuickFilterClearButtonText() {
-  return "Clear";
+function getQuickFilterClearButtonText(localization = DEFAULT_GRID_LOCALIZATION) {
+  return localization.clear;
 }
-function getRowSelectionControlsProps() {
+function getRowSelectionControlsProps(localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     role: "group",
-    "aria-label": "Row selection"
+    "aria-label": localization.rowSelectionLabel
   };
 }
-function getRowSelectionCheckboxProps(options = {}) {
+function getRowSelectionCheckboxProps(options = {}, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "checkbox",
     checked: options.allSelected || false,
     disabled: options.disabled || void 0,
     "aria-checked": options.someSelected ? "mixed" : options.allSelected || false,
-    "aria-label": "Select all rows on current page"
+    "aria-label": localization.selectAllRowsOnCurrentPageLabel
   };
 }
-function getRowSelectionCheckboxText() {
-  return "Select page";
+function getRowSelectionCheckboxText(localization = DEFAULT_GRID_LOCALIZATION) {
+  return localization.selectPage;
 }
 function getRowSelectionStatusProps() {
   return {
@@ -147,19 +216,19 @@ function getRowSelectionStatusProps() {
     "aria-atomic": true
   };
 }
-function getRowSelectionStatusText(selectedCount) {
+function getRowSelectionStatusText(selectedCount, localization = DEFAULT_GRID_LOCALIZATION) {
   const count = Number.isFinite(selectedCount) ? Math.max(0, Math.floor(selectedCount)) : 0;
-  return `${count} ${count === 1 ? "row" : "rows"} selected`;
+  return localization.selectedRows(count);
 }
-function getRowSelectionClearButtonProps(disabled = false) {
+function getRowSelectionClearButtonProps(disabled = false, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "button",
     disabled: disabled || void 0,
-    "aria-label": "Clear row selection"
+    "aria-label": localization.clearRowSelectionLabel
   };
 }
-function getRowSelectionClearButtonText() {
-  return "Clear selection";
+function getRowSelectionClearButtonText(localization = DEFAULT_GRID_LOCALIZATION) {
+  return localization.clearSelection;
 }
 function setCheckboxIndeterminate(target, indeterminate) {
   if (!target || typeof target !== "object" || !("indeterminate" in target)) {
@@ -168,33 +237,34 @@ function setCheckboxIndeterminate(target, indeterminate) {
   target.indeterminate = indeterminate;
   return true;
 }
-function getColumnVisibilityControlsProps() {
+function getColumnVisibilityControlsProps(localization = DEFAULT_GRID_LOCALIZATION) {
   return {
-    "aria-label": "Grid columns"
+    "aria-label": localization.gridColumnsLabel
   };
 }
-function getColumnVisibilitySummaryProps(visibleCount, totalCount) {
+function getColumnVisibilitySummaryProps(visibleCount, totalCount, localization = DEFAULT_GRID_LOCALIZATION) {
+  const { visible, total } = normalizeColumnVisibilityCounts(visibleCount, totalCount);
   return {
-    "aria-label": `Manage columns, ${getColumnVisibilityStatusText(visibleCount, totalCount)}`
+    "aria-label": localization.manageColumnsLabel(visible, total)
   };
 }
-function getColumnVisibilitySummaryText(visibleCount, totalCount) {
+function getColumnVisibilitySummaryText(visibleCount, totalCount, localization = DEFAULT_GRID_LOCALIZATION) {
   const { visible, total } = normalizeColumnVisibilityCounts(visibleCount, totalCount);
-  return `Columns ${visible}/${total}`;
+  return localization.columnsSummary(visible, total);
 }
-function getColumnVisibilitySearchInputProps(value) {
+function getColumnVisibilitySearchInputProps(value, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "search",
     value,
-    placeholder: "Find columns",
-    "aria-label": "Find columns",
+    placeholder: localization.findColumns,
+    "aria-label": localization.findColumns,
     autoComplete: "off"
   };
 }
-function getColumnVisibilityListProps() {
+function getColumnVisibilityListProps(localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     role: "group",
-    "aria-label": "Column visibility"
+    "aria-label": localization.columnVisibilityLabel
   };
 }
 function getColumnVisibilityCheckboxProps(options) {
@@ -214,22 +284,22 @@ function getColumnVisibilityStatusProps() {
     "aria-atomic": true
   };
 }
-function getColumnVisibilityStatusText(visibleCount, totalCount) {
+function getColumnVisibilityStatusText(visibleCount, totalCount, localization = DEFAULT_GRID_LOCALIZATION) {
   const { visible, total } = normalizeColumnVisibilityCounts(visibleCount, totalCount);
-  return `${visible} of ${total} columns visible`;
+  return localization.columnsVisible(visible, total);
 }
-function getColumnVisibilityEmptyText() {
-  return "No columns found";
+function getColumnVisibilityEmptyText(localization = DEFAULT_GRID_LOCALIZATION) {
+  return localization.noColumnsFound;
 }
-function getColumnVisibilityResetButtonProps(hiddenCount) {
+function getColumnVisibilityResetButtonProps(hiddenCount, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "button",
     disabled: !Number.isFinite(hiddenCount) || hiddenCount <= 0 || void 0,
-    "aria-label": "Show all columns"
+    "aria-label": localization.showAllColumnsLabel
   };
 }
-function getColumnVisibilityResetButtonText() {
-  return "Show all";
+function getColumnVisibilityResetButtonText(localization = DEFAULT_GRID_LOCALIZATION) {
+  return localization.showAll;
 }
 function normalizeGridDensity(value, fallback = "standard") {
   return GRID_DENSITIES.includes(value) ? value : fallback;
@@ -237,6 +307,40 @@ function normalizeGridDensity(value, fallback = "standard") {
 function getGridPreferenceRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
+function getGridPreferenceVersion(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : null;
+}
+function migrateGridPreferences(value, migrations = []) {
+  let preferences = getGridPreferenceRecord(value);
+  const initialVersion = getGridPreferenceVersion(preferences?.version);
+  if (!preferences || initialVersion === null || initialVersion > GRID_PREFERENCES_VERSION) {
+    return null;
+  }
+  const migrationsByVersion = /* @__PURE__ */ new Map();
+  for (const migration of migrations) {
+    if (getGridPreferenceVersion(migration.fromVersion) === null || getGridPreferenceVersion(migration.toVersion) === null || migration.toVersion <= migration.fromVersion || migration.toVersion > GRID_PREFERENCES_VERSION || migrationsByVersion.has(migration.fromVersion)) {
+      return null;
+    }
+    migrationsByVersion.set(migration.fromVersion, migration);
+  }
+  let version = initialVersion;
+  while (version < GRID_PREFERENCES_VERSION) {
+    const migration = migrationsByVersion.get(version);
+    if (!migration) {
+      return null;
+    }
+    try {
+      preferences = getGridPreferenceRecord(migration.migrate(preferences));
+    } catch {
+      return null;
+    }
+    if (!preferences || preferences.version !== migration.toVersion) {
+      return null;
+    }
+    version = migration.toVersion;
+  }
+  return preferences;
+}
 function getGridPreferenceColumnIds(value, validColumnIds) {
   if (!Array.isArray(value)) {
     return [];
@@ -282,7 +386,7 @@ function serializeGridPreferences(preferences, options = {}) {
 }
 function parseGridPreferences(value, options = {}) {
   try {
-    const parsed = getGridPreferenceRecord(JSON.parse(value));
+    const parsed = migrateGridPreferences(JSON.parse(value), options.migrations);
     if (!parsed || parsed.version !== GRID_PREFERENCES_VERSION) {
       return null;
     }
@@ -357,28 +461,23 @@ function getGridDensityRowHeight(density) {
   };
   return heights[normalizeGridDensity(density)];
 }
-function getDensityControlsProps() {
+function getDensityControlsProps(localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     role: "group",
-    "aria-label": "Row density"
+    "aria-label": localization.rowDensityLabel
   };
 }
-function getDensityButtonProps(density, currentDensity) {
+function getDensityButtonProps(density, currentDensity, localization = DEFAULT_GRID_LOCALIZATION) {
   const normalizedDensity = normalizeGridDensity(density);
   return {
     type: "button",
-    "aria-label": `Use ${normalizedDensity} density`,
+    "aria-label": localization.useDensityLabel(normalizedDensity),
     "aria-pressed": normalizedDensity === normalizeGridDensity(currentDensity),
     "data-density": normalizedDensity
   };
 }
-function getDensityButtonText(density) {
-  const labels = {
-    compact: "Compact",
-    standard: "Standard",
-    comfortable: "Comfortable"
-  };
-  return labels[normalizeGridDensity(density)];
+function getDensityButtonText(density, localization = DEFAULT_GRID_LOCALIZATION) {
+  return localization.densityLabel(normalizeGridDensity(density));
 }
 function getFilteredColumnVisibilityColumns(columns, query) {
   const normalizedQuery = query.trim().toLocaleLowerCase();
@@ -407,22 +506,16 @@ function getNextColumnFilters(filters, columnId, value) {
   }
   return filters.map((filter, index) => index === existingIndex ? { id: columnId, value } : filter);
 }
-function getPaginationProps() {
+function getPaginationProps(localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     role: "navigation",
-    "aria-label": "Pagination"
+    "aria-label": localization.paginationLabel
   };
 }
-function getPaginationButtonProps(options) {
-  const labels = {
-    first: "First page",
-    previous: "Previous page",
-    next: "Next page",
-    last: "Last page"
-  };
+function getPaginationButtonProps(options, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "button",
-    "aria-label": labels[options.action],
+    "aria-label": localization.paginationActionLabel(options.action),
     disabled: options.disabled || void 0
   };
 }
@@ -441,18 +534,18 @@ function getPaginationStatusProps() {
     "aria-live": "polite"
   };
 }
-function getPaginationPageText(grid) {
+function getPaginationPageText(grid, localization = DEFAULT_GRID_LOCALIZATION) {
   const pageCount = grid.getPageCount();
   const rawPageIndex = grid.getState().pagination.pageIndex;
   const pageIndex = Math.min(
     Number.isFinite(rawPageIndex) ? Math.max(0, Math.floor(rawPageIndex)) : 0,
     pageCount - 1
   );
-  return `Page ${pageIndex + 1} of ${pageCount}`;
+  return localization.pageStatus(pageIndex + 1, pageCount);
 }
-function getPaginationPageSizeSelectProps(pageSize) {
+function getPaginationPageSizeSelectProps(pageSize, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
-    "aria-label": "Rows per page",
+    "aria-label": localization.rowsPerPageLabel,
     value: Number.isFinite(pageSize) && pageSize > 0 ? Math.max(1, Math.floor(pageSize)) : 1
   };
 }
@@ -463,8 +556,8 @@ function getPaginationPageSizeOptions(options = DEFAULT_PAGINATION_PAGE_SIZE_OPT
   const current = Number.isFinite(currentPageSize) && (currentPageSize ?? 0) > 0 ? Math.max(1, Math.floor(currentPageSize ?? 1)) : null;
   return Array.from(new Set(current === null ? normalized : [...normalized, current])).sort((left, right) => left - right);
 }
-function getPaginationPageSizeOptionText(pageSize) {
-  return `${pageSize} rows`;
+function getPaginationPageSizeOptionText(pageSize, localization = DEFAULT_GRID_LOCALIZATION) {
+  return localization.pageSizeOption(pageSize);
 }
 function getGridBodyProps(options = {}) {
   return {
@@ -662,11 +755,11 @@ function getGridKeyboardFocusMove(event) {
   }
   return null;
 }
-function getColumnResizeHandleProps(column, options = {}) {
+function getColumnResizeHandleProps(column, options = {}, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     role: "separator",
     "aria-orientation": "vertical",
-    "aria-label": `Resize ${column.id} column`,
+    "aria-label": localization.resizeColumnLabel(column.id),
     "aria-valuenow": options.valueNow ?? column.getSize(),
     "aria-valuemin": column.columnDef.minSize,
     "aria-valuemax": column.columnDef.maxSize,
@@ -807,9 +900,9 @@ function addPassiveScrollListener(listener, target) {
     target.removeEventListener("scroll", listener);
   };
 }
-function getColumnPinningControlsProps(column) {
+function getColumnPinningControlsProps(column, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
-    "aria-label": `${column.id} column pinning`
+    "aria-label": localization.columnPinningLabel(column.id)
   };
 }
 function getColumnPinningButtonText(position) {
@@ -821,19 +914,18 @@ function getColumnPinningButtonText(position) {
   }
   return "-";
 }
-function getColumnPinningButtonProps(column, options) {
-  const label = options.position === "left" ? `Pin ${column.id} left` : options.position === "right" ? `Pin ${column.id} right` : `Unpin ${column.id}`;
+function getColumnPinningButtonProps(column, options, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "button",
-    "aria-label": label,
+    "aria-label": localization.pinColumnLabel(column.id, options.position),
     "aria-pressed": options.active,
     disabled: options.active
   };
 }
-function getHeaderActionMenuTriggerProps(column, options) {
+function getHeaderActionMenuTriggerProps(column, options, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "button",
-    "aria-label": `Open ${column.id} column menu`,
+    "aria-label": localization.openColumnMenuLabel(column.id),
     "aria-expanded": options.expanded,
     "aria-haspopup": "menu",
     "aria-controls": options.expanded ? options.controls : void 0
@@ -845,85 +937,61 @@ function getHeaderActionMenuId(columnId) {
 function getHeaderActionMenuTriggerId(columnId) {
   return `${getHeaderActionMenuId(columnId)}-trigger`;
 }
-function getHeaderActionMenuProps(column) {
+function getHeaderActionMenuProps(column, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     role: "menu",
-    "aria-label": `${column.id} column menu`,
+    "aria-label": localization.columnMenuLabel(column.id),
     tabIndex: -1
   };
 }
-function getHeaderActionMenuDefaultItemLabel(itemId, options = {}) {
-  if (itemId === "sort-asc") {
-    return "Sort ascending";
-  }
-  if (itemId === "sort-desc") {
-    return "Sort descending";
-  }
-  if (itemId === "clear-sort") {
-    return "Clear sort";
-  }
-  if (itemId === "move-left") {
-    return "Move left";
-  }
-  if (itemId === "move-right") {
-    return "Move right";
-  }
-  if (itemId === "pin-left") {
-    return "Pin left";
-  }
-  if (itemId === "unpin") {
-    return "Unpin";
-  }
-  if (itemId === "pin-right") {
-    return "Pin right";
-  }
-  return options.grouped ? "Ungroup column" : "Group by column";
+function getHeaderActionMenuDefaultItemLabel(itemId, options = {}, localization = DEFAULT_GRID_LOCALIZATION) {
+  return localization.headerActionMenuItemLabel(itemId, options.grouped ?? false);
 }
-function getHeaderActionMenuDefaultItemDescriptors(options) {
+function getHeaderActionMenuDefaultItemDescriptors(options, localization = DEFAULT_GRID_LOCALIZATION) {
   const descriptors = [
     {
       id: "sort-asc",
-      label: getHeaderActionMenuDefaultItemLabel("sort-asc")
+      label: getHeaderActionMenuDefaultItemLabel("sort-asc", {}, localization)
     },
     {
       id: "sort-desc",
-      label: getHeaderActionMenuDefaultItemLabel("sort-desc")
+      label: getHeaderActionMenuDefaultItemLabel("sort-desc", {}, localization)
     },
     {
       id: "clear-sort",
-      label: getHeaderActionMenuDefaultItemLabel("clear-sort"),
+      label: getHeaderActionMenuDefaultItemLabel("clear-sort", {}, localization),
       disabled: !options.sortDirection
     },
     {
       id: "move-left",
-      label: getHeaderActionMenuDefaultItemLabel("move-left"),
+      label: getHeaderActionMenuDefaultItemLabel("move-left", {}, localization),
       disabled: !options.canMoveLeft
     },
     {
       id: "move-right",
-      label: getHeaderActionMenuDefaultItemLabel("move-right"),
+      label: getHeaderActionMenuDefaultItemLabel("move-right", {}, localization),
       disabled: !options.canMoveRight
     },
     {
       id: "pin-left",
-      label: getHeaderActionMenuDefaultItemLabel("pin-left"),
+      label: getHeaderActionMenuDefaultItemLabel("pin-left", {}, localization),
       disabled: options.pinningPosition === "left"
     },
     {
       id: "unpin",
-      label: getHeaderActionMenuDefaultItemLabel("unpin"),
+      label: getHeaderActionMenuDefaultItemLabel("unpin", {}, localization),
       disabled: options.pinningPosition === false
     },
     {
       id: "pin-right",
-      label: getHeaderActionMenuDefaultItemLabel("pin-right"),
+      label: getHeaderActionMenuDefaultItemLabel("pin-right", {}, localization),
       disabled: options.pinningPosition === "right"
     }
   ];
   if (options.canGroup) {
     descriptors.push({
       id: "toggle-group",
-      label: getHeaderActionMenuDefaultItemLabel("toggle-group", { grouped: options.isGrouped })
+      label: getHeaderActionMenuDefaultItemLabel("toggle-group", { grouped: options.isGrouped }, localization)
     });
   }
   return descriptors;
@@ -970,9 +1038,9 @@ function isHeaderActionMenuSeparatorItem(item) {
 function getHeaderActionMenuCustomItemUserProps(item) {
   return item ? item.props ?? {} : {};
 }
-function getGroupingPanelProps(options = {}) {
+function getGroupingPanelProps(options = {}, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
-    "aria-label": "Column grouping",
+    "aria-label": localization.columnGroupingLabel,
     "data-empty": options.empty || void 0
   };
 }
@@ -986,17 +1054,17 @@ function getGroupingPanelChipProps(column) {
     "data-column-id": column.id
   };
 }
-function getGroupingPanelMoveButtonProps(column, options) {
+function getGroupingPanelMoveButtonProps(column, options, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "button",
-    "aria-label": `Move ${column.id} grouping ${options.direction}`,
+    "aria-label": localization.moveColumnGroupingLabel(column.id, options.direction),
     disabled: options.disabled || false
   };
 }
-function getGroupingPanelRemoveButtonProps(column) {
+function getGroupingPanelRemoveButtonProps(column, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "button",
-    "aria-label": `Remove ${column.id} grouping`
+    "aria-label": localization.removeColumnGroupingLabel(column.id)
   };
 }
 function getIsGroupLabelCell(row, column, visibleColumns) {
@@ -1009,20 +1077,20 @@ function getIsGroupLabelCell(row, column, visibleColumns) {
   }
   return column.id === row.groupingColumnId || !visibleColumns.some((candidate) => candidate.id === row.groupingColumnId) && column.id === firstVisibleColumnId;
 }
-function getGroupValueText(value) {
+function getGroupValueText(value, localization = DEFAULT_GRID_LOCALIZATION) {
   if (value instanceof Date) {
     return value.toISOString();
   }
-  return value == null ? "(blank)" : String(value);
+  return value == null ? localization.blankGroupValue : String(value);
 }
-function getGroupRowLabel(row, column, options = {}) {
+function getGroupRowLabel(row, column, options = {}, localization = DEFAULT_GRID_LOCALIZATION) {
   if (row.getIsGroupFooter()) {
-    return row.groupFooterLabel ?? "Total";
+    return row.groupFooterLabel ?? localization.groupFooterTotal;
   }
   if (row.groupingColumnId) {
-    return `${row.groupingColumnId}: ${getGroupValueText(row.groupingValue)}`;
+    return `${row.groupingColumnId}: ${getGroupValueText(row.groupingValue, localization)}`;
   }
-  return options.fallback ?? getGroupValueText(row.getValue(column.id));
+  return options.fallback ?? getGroupValueText(row.getValue(column.id), localization);
 }
 function getGroupCellIndent(row, options = {}) {
   const depthSize = options.depthSize ?? 16;
@@ -1059,10 +1127,10 @@ function getRowLayoutProps(row, options = {}) {
     "data-column-virtualized": options.columnVirtualized || void 0
   };
 }
-function getRowExpansionToggleProps(row, options) {
+function getRowExpansionToggleProps(row, options, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
     type: "button",
-    "aria-label": `${options.expanded ? "Collapse" : "Expand"} ${options.label}`,
+    "aria-label": localization.toggleRowExpandedLabel(options.expanded, options.label),
     "aria-expanded": options.expanded,
     "data-row-id": row.id,
     "data-expanded": options.expanded
@@ -1276,9 +1344,9 @@ function getCellFillHandleVisible(row, column, options) {
 function getCanStartCellPointerDrag(event, editingCell) {
   return isPrimaryPointerButton(event) && !editingCell;
 }
-function getCellEditorProps(column, options = {}) {
+function getCellEditorProps(column, options = {}, localization = DEFAULT_GRID_LOCALIZATION) {
   return {
-    "aria-label": `Edit ${column.id}`,
+    "aria-label": localization.editColumnLabel(column.id),
     "aria-invalid": options.invalid || void 0
   };
 }
@@ -1831,6 +1899,7 @@ function isFocusedCell(focusedCell, rowId, columnId) {
   return isCellCoordinateEqual(focusedCell, { rowId, columnId });
 }
 export {
+  DEFAULT_GRID_LOCALIZATION,
   DEFAULT_PAGINATION_PAGE_SIZE_OPTIONS,
   GRID_DENSITIES,
   GRID_FOCUSED_CELL_SELECTOR,
@@ -1845,6 +1914,7 @@ export {
   addPointerUpCancelListeners,
   applyResizeObserverMeasuredSizes,
   createClickSuppressionController,
+  createGridLocalization,
   createGridPreferences,
   createResizeObserver,
   disconnectResizeObserver,
@@ -2055,6 +2125,7 @@ export {
   isPrimaryPointerButton,
   isPrimaryPointerDragActive,
   isResizeObserverDatasetTarget,
+  migrateGridPreferences,
   moveColumnToTarget,
   moveGroupedColumn,
   moveVisibleColumn,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-grid/primitives",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Unstyled primitive prop helpers for Open Grid.",
   "keywords": [
     "data-grid",
@@ -36,7 +36,7 @@
     "lint": "tsc --noEmit"
   },
   "dependencies": {
-    "@open-grid/core": "0.1.0"
+    "@open-grid/core": "0.3.0"
   },
   "devDependencies": {
     "tsup": "^8.3.5",