@nu-grid/nuxt 0.1.1

package/dist/runtime/types/events.d.ts

@@ -0,0 +1,164 @@
+import type { TableData } from '@nuxt/ui';
+import type { Cell, Column, ColumnFiltersState, Row, SortingState } from '@tanstack/vue-table';
+import type { NuGridStateSnapshot } from '../composables/_internal/useNuGridStatePersistence.js';
+import type { RowDragEvent } from './drag-drop.js';
+/**
+ * Event payload for cell click events
+ */
+export interface NuGridCellClickEvent<T extends TableData = TableData> {
+    /** The row containing the clicked cell */
+    row: Row<T>;
+    /** The column definition of the clicked cell */
+    column: Column<T, unknown>;
+    /** The cell that was clicked */
+    cell: Cell<T, unknown>;
+    /** The current value of the cell */
+    value: unknown;
+    /** The original mouse event */
+    event: MouseEvent;
+}
+/**
+ * Event payload for row click events
+ */
+export interface NuGridRowClickEvent<T extends TableData = TableData> {
+    /** The row that was clicked */
+    row: Row<T>;
+    /** The original mouse event */
+    event: MouseEvent;
+}
+/**
+ * Event payload for focused cell changed events
+ */
+export interface NuGridFocusedCellChangedEvent<T extends TableData = TableData> {
+    /** Current row ID (null if no cell focused) */
+    rowId: string | null;
+    /** Current column ID (null if no cell focused) */
+    columnId: string | null;
+    /** Current row index (-1 if no cell focused) */
+    rowIndex: number;
+    /** Current column index (-1 if no cell focused) */
+    columnIndex: number;
+    /** The currently focused row (null if no cell focused) */
+    row: Row<T> | null;
+    /** The currently focused column (null if no cell focused) */
+    column: Column<T, unknown> | null;
+    /** Previous row index (null if no previous focus) */
+    previousRowIndex: number | null;
+    /** Previous column index (null if no previous focus) */
+    previousColumnIndex: number | null;
+}
+/**
+ * Event payload for focused row changed events
+ */
+export interface NuGridFocusedRowChangedEvent<T extends TableData = TableData> {
+    /** Current row ID (null if no row focused) */
+    rowId: string | null;
+    /** Current row index (-1 if no row focused) */
+    rowIndex: number;
+    /** The currently focused row (null if no row focused) */
+    row: Row<T> | null;
+    /** Previous row index (null if no previous focus) */
+    previousRowIndex: number | null;
+    /** The previously focused row (null if no previous focus) */
+    previousRow: Row<T> | null;
+}
+/**
+ * Event payload for cell editing started events
+ */
+export interface NuGridCellEditingStartedEvent<T extends TableData = TableData> {
+    /** The row being edited */
+    row: Row<T>;
+    /** The column being edited */
+    column: Column<T, unknown>;
+    /** The initial value when editing started */
+    value: unknown;
+}
+/**
+ * Event payload for cell editing cancelled events
+ */
+export interface NuGridCellEditingCancelledEvent<T extends TableData = TableData> {
+    /** The row that was being edited */
+    row: Row<T>;
+    /** The column that was being edited */
+    column: Column<T, unknown>;
+    /** The value when editing was cancelled */
+    value: unknown;
+}
+/**
+ * Event payload for cell value changed events
+ */
+export interface NuGridCellValueChangedEvent<T extends TableData = TableData> {
+    /** The row that was modified */
+    row: Row<T>;
+    /** The column that was modified */
+    column: Column<T, unknown>;
+    /** The previous value before the change */
+    oldValue: unknown;
+    /** The new value after the change */
+    newValue: unknown;
+}
+/**
+ * Event payload for sort changed events
+ */
+export interface NuGridSortChangedEvent {
+    /** The current sorting state */
+    sorting: SortingState;
+}
+/**
+ * Event payload for filter changed events
+ */
+export interface NuGridFilterChangedEvent {
+    /** The current column filters state */
+    columnFilters: ColumnFiltersState;
+}
+/**
+ * Centralized event emitter interface for NuGrid events.
+ * This is provided at the grid level and injected into composables
+ * to emit events without threading callbacks through parameters.
+ *
+ * @example
+ * ```typescript
+ * // In NuGrid.vue
+ * const eventEmitter: NuGridEventEmitter<T> = {
+ *   cellClicked: (e) => emit('cellClicked', e),
+ *   // ... other events
+ * }
+ * provide('nugrid-events', eventEmitter)
+ *
+ * // In composables
+ * const eventEmitter = inject<NuGridEventEmitter<T>>('nugrid-events')
+ * eventEmitter?.cellClicked?.(event)
+ * ```
+ */
+export interface NuGridEventEmitter<T extends TableData = TableData> {
+    /** Emit when a cell is clicked */
+    cellClicked?: (event: NuGridCellClickEvent<T>) => void;
+    /** Emit when a cell is double-clicked */
+    cellDoubleClicked?: (event: NuGridCellClickEvent<T>) => void;
+    /** Emit when a row is clicked */
+    rowClicked?: (event: NuGridRowClickEvent<T>) => void;
+    /** Emit when a row is double-clicked */
+    rowDoubleClicked?: (event: NuGridRowClickEvent<T>) => void;
+    /** Emit when the focused cell changes */
+    focusedCellChanged?: (event: NuGridFocusedCellChangedEvent<T>) => void;
+    /** Emit when the focused row changes */
+    focusedRowChanged?: (event: NuGridFocusedRowChangedEvent<T>) => void;
+    /** Emit when cell editing starts */
+    cellEditingStarted?: (event: NuGridCellEditingStartedEvent<T>) => void;
+    /** Emit when cell editing is cancelled */
+    cellEditingCancelled?: (event: NuGridCellEditingCancelledEvent<T>) => void;
+    /** Emit when a cell value is changed */
+    cellValueChanged?: (event: NuGridCellValueChangedEvent<T>) => void;
+    /** Emit when sorting changes */
+    sortChanged?: (event: NuGridSortChangedEvent) => void;
+    /** Emit when column filters change */
+    filterChanged?: (event: NuGridFilterChangedEvent) => void;
+    /** Emit when a row is dragged and dropped */
+    rowDragged?: (event: RowDragEvent<T>) => void;
+    /** Emit when grid state changes (for persistence) */
+    stateChanged?: (state: NuGridStateSnapshot) => void;
+}
+/**
+ * Injection key for the event emitter
+ */
+export declare const NUGRID_EVENTS_KEY: "nugrid-events";

package/dist/runtime/types/events.js

@@ -0,0 +1 @@
+export const NUGRID_EVENTS_KEY = "nugrid-events";

package/dist/runtime/types/focus.d.ts

@@ -0,0 +1,50 @@
+import type { TableData } from '@nuxt/ui';
+import type { Row } from '@tanstack/vue-table';
+import type { Ref } from 'vue';
+/**
+ * Focused cell position
+ * @internal
+ */
+export interface NuGridFocusedCell {
+    rowIndex: number;
+    columnIndex: number;
+    groupId?: string;
+    suppressOutline?: boolean;
+}
+/**
+ * Type for nugrid-focusfns injection
+ * Provides cell and row focus management
+ * @internal
+ */
+export interface NuGridFocus<T extends TableData = TableData> {
+    focusedCell: Ref<NuGridFocusedCell | null>;
+    gridHasFocus: Ref<boolean>;
+    onCellClick: (e: Event, row: Row<T>, columnIndex: number) => void;
+    onCellKeyDown: (e: KeyboardEvent) => void;
+    onCellKeyUp: (e: KeyboardEvent) => void;
+    getRowTabIndex: (row: Row<T>) => number;
+    shouldRowHandleKeydown: (row: Row<T>) => boolean;
+    getCellTabIndex: (row: Row<T>, cellIndex: number) => number;
+    shouldCellHandleKeydown: (row: Row<T>, cellIndex: number) => boolean;
+    isActiveRow: (row: Row<T>) => boolean;
+    isFocusedRow: (row: Row<T>) => boolean;
+    isFocusedCell: (row: Row<T>, cellIndex: number) => boolean;
+    rowFocusProps: (row: Row<T>) => Record<string, unknown>;
+    cellFocusProps: (row: Row<T>, cellIndex: number) => Record<string, unknown>;
+    focusCell: (targetRow: Row<T>, newRowIndex: number, newColumnIndex: number) => void;
+    findFirstFocusableColumn: (row: Row<T>) => number;
+    /** Get a cell element by row ID and column index (uses internal cache for performance) */
+    getCellElement: (rowId: string, columnIndex: number) => HTMLElement | null;
+    /** Ensure footer rows are visible when scrolling to bottom of grid */
+    ensureFootersVisible: (scrollContainer: HTMLElement) => void;
+    /** Scroll to a cell and focus it, with proper scroll management */
+    scrollToCellAndFocus: (options: {
+        cellElement: HTMLElement;
+        rowId: string;
+        rowIndex: number;
+        columnIndex: number;
+        behavior?: 'instant' | 'smooth';
+        skipHorizontalScroll?: boolean;
+        onComplete?: () => void;
+    }) => void;
+}

package/dist/runtime/types/grouping.d.ts

@@ -0,0 +1,7 @@
+import type { GroupingOptions } from '@tanstack/vue-table';
+/**
+ * NuGridGroupingOptions extends TanStack's GroupingOptions type.
+ * This wrapper type allows for future NuGrid-specific extensions
+ * without breaking changes to the public API.
+ */
+export type NuGridGroupingOptions = Omit<GroupingOptions, 'onGroupingChange'>;

package/dist/runtime/types/index.d.ts

@@ -0,0 +1,15 @@
+export type { NuGridAddRowFinalizeResult, NuGridAddRowState } from './_internal/contexts/add-row.js';
+export type { NuGridActionMenuItem, NuGridActionMenuOptions } from './action-menu.js';
+export type { NuGridAutosize } from './autosize.js';
+export type { NuGridCellEditorEmits, NuGridCellEditorProps, NuGridCellRenderContext, NuGridCellType, NuGridCellTypeContext, NuGridCellTypeKeyboardResult, NuGridFilterConfig, NuGridFilterContext, NuGridFilterOperator, NuGridRendererConfig, NuGridValidationResult, } from './cells.js';
+export type { NuGridColumn, NuGridColumnMenuItem, NuGridColumnMenuItemsCallback } from './column.js';
+export type { RowDragEvent } from './drag-drop.js';
+export type { NUGRID_EVENTS_KEY, NuGridCellClickEvent, NuGridCellEditingCancelledEvent, NuGridCellEditingStartedEvent, NuGridCellValueChangedEvent, NuGridEventEmitter, NuGridFilterChangedEvent, NuGridFocusedCellChangedEvent, NuGridFocusedRowChangedEvent, NuGridRowClickEvent, NuGridSortChangedEvent, } from './events.js';
+export type { NuGridGroupingOptions } from './grouping.js';
+export type { NuGridActionsOptions, NuGridAnimationOptions, NuGridAnimationPreset, NuGridAutoSizeStrategy, NuGridColumnMenuOptions, NuGridColumnMenuPreset, NuGridColumnPlacement, NuGridEditingOptions, NuGridExcelExportOptions, NuGridFocusOptions, NuGridLayoutMode, NuGridLayoutOptions, NuGridLookupItem, NuGridLookupOptions, NuGridMultiRowOptions, NuGridPagingOptions, NuGridSelectionOptions, NuGridStateOptions, NuGridStatePart, NuGridStorageType, NuGridTooltipOptions, } from './option-groups.js';
+export type { NuGridProps, NuGridScrollbars } from './props.js';
+export type { NuGridRow } from './row.js';
+export type { NuGridRowSelectOptions } from './row-selection.js';
+export type { NuGridSortIcon } from './sort-icon.js';
+export type { NuGridTheme, NuGridThemeDefinition } from './theme.js';
+export type { NuGridOnInvalid, NuGridShowErrors, NuGridValidateOn, NuGridValidationOptions, } from './validation.js';