@toolbox-web/grid-react 0.6.0 → 0.8.0

package/lib/column-shorthand.d.ts

@@ -0,0 +1,59 @@
+import { ColumnConfig } from '@toolbox-web/grid';
+/**
+ * Type for column shorthand notation.
+ *
+ * Supports:
+ * - Simple string: `'name'` → `{ field: 'name', header: 'Name' }`
+ * - With type: `'salary:number'` → `{ field: 'salary', header: 'Salary', type: 'number' }`
+ * - Full config object: `{ field: 'id', header: 'ID', width: 80 }` (passed through)
+ *
+ * @example
+ * ```tsx
+ * // All equivalent:
+ * columns={['id', 'name', 'email']}
+ * columns={['id:number', 'name:string', 'email']}
+ * columns={[{ field: 'id' }, { field: 'name' }, { field: 'email' }]}
+ * ```
+ */
+export type ColumnShorthand<TRow = unknown> = string | ColumnConfig<TRow>;
+/**
+ * Parse a column shorthand string into a ColumnConfig.
+ *
+ * Supports formats:
+ * - `'fieldName'` → `{ field: 'fieldName', header: 'Field Name' }`
+ * - `'fieldName:type'` → `{ field: 'fieldName', header: 'Field Name', type: 'type' }`
+ *
+ * @param shorthand - The shorthand string (e.g., 'name', 'salary:number')
+ * @returns A ColumnConfig object
+ *
+ * @example
+ * parseColumnShorthand('name') → { field: 'name', header: 'Name' }
+ * parseColumnShorthand('salary:number') → { field: 'salary', header: 'Salary', type: 'number' }
+ */
+export declare function parseColumnShorthand<TRow = unknown>(shorthand: string): ColumnConfig<TRow>;
+/**
+ * Normalize an array of column shorthands to ColumnConfig objects.
+ *
+ * @param columns - Array of column shorthands (strings or ColumnConfig objects)
+ * @returns Array of ColumnConfig objects
+ *
+ * @example
+ * ```tsx
+ * normalizeColumns(['id:number', 'name', { field: 'email', width: 200 }])
+ * // Returns:
+ * // [
+ * //   { field: 'id', header: 'ID', type: 'number' },
+ * //   { field: 'name', header: 'Name' },
+ * //   { field: 'email', width: 200 }
+ * // ]
+ * ```
+ */
+export declare function normalizeColumns<TRow = unknown>(columns: ColumnShorthand<TRow>[]): ColumnConfig<TRow>[];
+/**
+ * Check if an array of columns contains any shorthand strings.
+ *
+ * @param columns - Array to check
+ * @returns True if any element is a string shorthand
+ */
+export declare function hasColumnShorthands<TRow>(columns: ColumnShorthand<TRow>[]): boolean;
+//# sourceMappingURL=column-shorthand.d.ts.map

package/lib/column-shorthand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-shorthand.d.ts","sourceRoot":"","sources":["../../../../libs/grid-react/src/lib/column-shorthand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,eAAe,CAAC,IAAI,GAAG,OAAO,IAAI,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;AA2C1E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAsB1F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,CAOvG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAEnF"}

package/lib/context-types.d.ts

@@ -1,4 +1,4 @@
-import { ColumnConfig } from '../../../../dist/libs/grid/index.d.ts';
+import { ColumnConfig } from '@toolbox-web/grid';
 /**
  * Context object passed to cell renderer components.
  */

package/lib/data-grid.d.ts

@@ -1,10 +1,21 @@
-import { ColumnConfig, DataGridElement, GridConfig } from '../../../../dist/libs/grid/index.d.ts';
+import { BaseGridPlugin, ColumnConfig, DataGridElement, GridConfig } from '@toolbox-web/grid';
 import { ReactNode } from 'react';
+import { ColumnShorthand } from './column-shorthand';
+import { EventProps } from './event-props';
+import { AllFeatureProps } from './feature-props';
 import { ReactGridConfig } from './react-column-config';
 /**
  * Props for the DataGrid component.
+ *
+ * @template TRow - The row data type
+ *
+ * Combines:
+ * - Core props (rows, columns, gridConfig)
+ * - Feature props (selection, editing, filtering, etc.) - plugins loaded via side-effect imports
+ * - Event props (onCellClick, onSelectionChange, etc.)
+ * - SSR props (ssr)
  */
-export interface DataGridProps<TRow = unknown> {
+export interface DataGridProps<TRow = unknown> extends AllFeatureProps<TRow>, EventProps<TRow> {
     /** Row data to display */
     rows: TRow[];
     /**
@@ -23,11 +34,98 @@ export interface DataGridProps<TRow = unknown> {
      * ```
      */
     gridConfig?: ReactGridConfig<TRow>;
-    /** Column definitions (alternative to gridConfig.columns) */
-    columns?: ColumnConfig<TRow>[];
+    /**
+     * Column definitions. Supports shorthand syntax for quick definitions.
+     *
+     * @example
+     * ```tsx
+     * // Shorthand strings (auto-generate headers from field names)
+     * columns={['id:number', 'name', 'email', 'salary:currency']}
+     *
+     * // Mixed: shorthand + full config
+     * columns={['id:number', 'name', { field: 'status', editable: true }]}
+     *
+     * // Full config objects (standard usage)
+     * columns={[{ field: 'id', type: 'number' }, { field: 'name' }]}
+     * ```
+     */
+    columns?: ColumnShorthand<TRow>[];
+    /**
+     * Default column properties applied to all columns.
+     * Individual column definitions override these defaults.
+     *
+     * @example
+     * ```tsx
+     * <DataGrid
+     *   columnDefaults={{ sortable: true, resizable: true }}
+     *   columns={[
+     *     { field: 'id', sortable: false }, // Override: not sortable
+     *     { field: 'name' }, // Inherits: sortable, resizable
+     *   ]}
+     * />
+     * ```
+     */
+    columnDefaults?: Partial<ColumnConfig<TRow>>;
     /** Fit mode for column sizing */
     fitMode?: 'stretch' | 'fit-columns' | 'auto-fit';
-    /** Edit trigger mode */
+    /**
+     * Grid-wide sorting toggle.
+     * When false, disables sorting for all columns regardless of their individual `sortable` setting.
+     * When true (default), columns with `sortable: true` can be sorted.
+     *
+     * For multi-column sorting, also add the `multiSort` prop.
+     *
+     * @default true
+     *
+     * @example
+     * ```tsx
+     * // Disable all sorting
+     * <DataGrid sortable={false} />
+     *
+     * // Enable sorting with multi-sort
+     * <DataGrid sortable multiSort />
+     * ```
+     */
+    sortable?: boolean;
+    /**
+     * Grid-wide filtering toggle.
+     * When false, disables filtering for all columns regardless of their individual `filterable` setting.
+     * When true (default), columns with `filterable: true` can be filtered.
+     *
+     * Requires the FilteringPlugin to be loaded (via `filtering` prop or feature import).
+     *
+     * @default true
+     *
+     * @example
+     * ```tsx
+     * // Disable all filtering
+     * <DataGrid filterable={false} filtering />
+     *
+     * // Enable filtering (default)
+     * <DataGrid filterable filtering />
+     * ```
+     */
+    filterable?: boolean;
+    /**
+     * Grid-wide selection toggle.
+     * When false, disables selection for all rows/cells.
+     * When true (default), selection is enabled based on plugin mode.
+     *
+     * Requires the SelectionPlugin to be loaded (via `selection` prop or feature import).
+     *
+     * @default true
+     *
+     * @example
+     * ```tsx
+     * // Disable all selection
+     * <DataGrid selectable={false} selection="range" />
+     *
+     * // Enable selection (default)
+     * <DataGrid selectable selection="range" />
+     * ```
+     */
+    selectable?: boolean;
+    /** Edit trigger mode - DEPRECATED: use `editing` prop instead */
     editOn?: 'click' | 'dblclick' | 'none';
     /** Custom CSS styles to inject into grid shadow DOM */
     customStyles?: string;
@@ -37,29 +135,23 @@ export interface DataGridProps<TRow = unknown> {
     style?: React.CSSProperties;
     /** Children (GridColumn components for custom renderers/editors) */
     children?: ReactNode;
+    /**
+     * Escape hatch: manually provide plugin instances.
+     * When provided, feature props for those plugins are ignored.
+     * Useful for advanced configurations not covered by feature props.
+     *
+     * @example
+     * ```tsx
+     * import { SelectionPlugin } from '@toolbox-web/grid/plugins/selection';
+     *
+     * <DataGrid
+     *   plugins={[new SelectionPlugin({ mode: 'range', checkbox: true })]}
+     * />
+     * ```
+     */
+    plugins?: BaseGridPlugin[];
     /** Fired when rows change (sorting, editing, etc.) */
     onRowsChange?: (rows: TRow[]) => void;
-    /** Fired when a cell value is edited */
-    onCellEdit?: (event: CustomEvent<{
-        row: TRow;
-        field: string;
-        oldValue: unknown;
-        newValue: unknown;
-    }>) => void;
-    /** Fired when a row is clicked */
-    onRowClick?: (event: CustomEvent<{
-        row: TRow;
-        rowIndex: number;
-    }>) => void;
-    /** Fired when column state changes (resize, reorder, visibility) */
-    onColumnStateChange?: (event: CustomEvent<{
-        columns: ColumnConfig<TRow>[];
-    }>) => void;
-    /** Fired when sort changes */
-    onSortChange?: (event: CustomEvent<{
-        field: string;
-        direction: 'asc' | 'desc';
-    } | null>) => void;
 }
 /**
  * Ref handle for the DataGrid component.

package/lib/data-grid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-grid.d.ts","sourceRoot":"","sources":["../../../../libs/grid-react/src/lib/data-grid.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-grid.d.ts","sourceRoot":"","sources":["../../../../libs/grid-react/src/lib/data-grid.tsx"],"names":[],"mappings":"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"}

package/lib/event-props.d.ts

@@ -0,0 +1,305 @@
+import { CellActivateDetail, CellChangeDetail, CellClickDetail, CellCommitDetail, ColumnMoveDetail, ColumnResizeDetail, ColumnVisibilityDetail, CopyDetail, DetailExpandDetail, ExportCompleteDetail, FilterChangeDetail, GridColumnState, GroupToggleDetail, PasteDetail, PrintCompleteDetail, PrintStartDetail, ResponsiveChangeDetail, RowClickDetail, RowCommitDetail, RowMoveDetail, SelectionChangeDetail, SortChangeDetail, TreeExpandDetail, UndoRedoDetail } from '@toolbox-web/grid/all';
+/**
+ * Event handler type with unwrapped detail.
+ * Pattern: `(detail: T, event?: CustomEvent) => void`
+ */
+export type EventHandler<T> = (detail: T, event?: CustomEvent<T>) => void;
+/**
+ * Event handler props for grid events.
+ * All handlers receive the unwrapped detail as first argument,
+ * with optional access to the full CustomEvent for preventDefault().
+ *
+ * @template TRow - The row data type
+ */
+export interface EventProps<TRow = unknown> {
+    /**
+     * Fired when a cell is clicked.
+     *
+     * @example
+     * ```tsx
+     * onCellClick={(detail) => console.log('Clicked:', detail.field, detail.value)}
+     * ```
+     */
+    onCellClick?: EventHandler<CellClickDetail<TRow>>;
+    /**
+     * Fired when a row is clicked.
+     *
+     * @example
+     * ```tsx
+     * onRowClick={(detail) => navigateTo(`/employees/${detail.row.id}`)}
+     * ```
+     */
+    onRowClick?: EventHandler<RowClickDetail<TRow>>;
+    /**
+     * Fired when a cell is activated (Enter key or double-click).
+     *
+     * @example
+     * ```tsx
+     * onCellActivate={(detail) => openEditor(detail.field, detail.row)}
+     * ```
+     */
+    onCellActivate?: EventHandler<CellActivateDetail<TRow>>;
+    /**
+     * Fired when a cell value changes (before commit).
+     *
+     * @example
+     * ```tsx
+     * onCellChange={(detail) => validateChange(detail)}
+     * ```
+     */
+    onCellChange?: EventHandler<CellChangeDetail<TRow>>;
+    /**
+     * Fired when a cell edit is committed.
+     * Cancelable - call `event.preventDefault()` to reject the edit.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/editing';`
+     *
+     * @example
+     * ```tsx
+     * onCellCommit={(detail, event) => {
+     *   if (!isValid(detail.value)) {
+     *     event?.preventDefault();
+     *     showError('Invalid value');
+     *   }
+     * }}
+     * ```
+     */
+    onCellCommit?: EventHandler<CellCommitDetail<TRow>>;
+    /**
+     * Fired when all pending row edits are committed.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/editing';`
+     *
+     * @example
+     * ```tsx
+     * onRowCommit={(detail) => saveToServer(detail.row)}
+     * ```
+     */
+    onRowCommit?: EventHandler<RowCommitDetail<TRow>>;
+    /**
+     * Fired when sort state changes.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/sorting';`
+     *
+     * @example
+     * ```tsx
+     * onSortChange={(detail) => console.log('Sort:', detail.field, detail.direction)}
+     * ```
+     */
+    onSortChange?: EventHandler<SortChangeDetail>;
+    /**
+     * Fired when filter values change.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/filtering';`
+     *
+     * @example
+     * ```tsx
+     * onFilterChange={(detail) => console.log('Filters:', detail.activeFilters)}
+     * ```
+     */
+    onFilterChange?: EventHandler<FilterChangeDetail>;
+    /**
+     * Fired when a column is resized.
+     *
+     * @example
+     * ```tsx
+     * onColumnResize={(detail) => console.log('Resized:', detail.field, detail.width)}
+     * ```
+     */
+    onColumnResize?: EventHandler<ColumnResizeDetail>;
+    /**
+     * Fired when a column is moved via drag-and-drop.
+     * Cancelable - call `event.preventDefault()` to cancel the move.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/reorder';`
+     *
+     * @example
+     * ```tsx
+     * onColumnMove={(detail, event) => {
+     *   if (detail.column.field === 'id') {
+     *     event?.preventDefault(); // Don't allow moving ID column
+     *   }
+     * }}
+     * ```
+     */
+    onColumnMove?: EventHandler<ColumnMoveDetail>;
+    /**
+     * Fired when column visibility changes.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/visibility';`
+     *
+     * @example
+     * ```tsx
+     * onColumnVisibility={(detail) => {
+     *   console.log(detail.hidden ? 'Hidden:' : 'Shown:', detail.field);
+     * }}
+     * ```
+     */
+    onColumnVisibility?: EventHandler<ColumnVisibilityDetail>;
+    /**
+     * Fired when column state changes (resize, reorder, visibility).
+     * Useful for persisting column state.
+     *
+     * @example
+     * ```tsx
+     * onColumnStateChange={(state) => saveToLocalStorage('gridState', state)}
+     * ```
+     */
+    onColumnStateChange?: EventHandler<GridColumnState>;
+    /**
+     * Fired when selection changes.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/selection';`
+     *
+     * @example
+     * ```tsx
+     * onSelectionChange={(detail) => {
+     *   console.log('Selected ranges:', detail.ranges);
+     *   console.log('Mode:', detail.mode);
+     * }}
+     * ```
+     */
+    onSelectionChange?: EventHandler<SelectionChangeDetail>;
+    /**
+     * Fired when a row is moved via drag-and-drop.
+     * Cancelable - call `event.preventDefault()` to cancel the move.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/row-reorder';`
+     *
+     * @example
+     * ```tsx
+     * onRowMove={(detail, event) => {
+     *   if (!canMove(detail.row)) {
+     *     event?.preventDefault();
+     *   }
+     * }}
+     * ```
+     */
+    onRowMove?: EventHandler<RowMoveDetail<TRow>>;
+    /**
+     * Fired when a group is expanded or collapsed.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/grouping-rows';`
+     *
+     * @example
+     * ```tsx
+     * onGroupToggle={(detail) => {
+     *   console.log(detail.expanded ? 'Expanded' : 'Collapsed', detail.key);
+     * }}
+     * ```
+     */
+    onGroupToggle?: EventHandler<GroupToggleDetail>;
+    /**
+     * Fired when a tree node is expanded.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/tree';`
+     *
+     * @example
+     * ```tsx
+     * onTreeExpand={(detail) => console.log('Expanded:', detail.row)}
+     * ```
+     */
+    onTreeExpand?: EventHandler<TreeExpandDetail<TRow>>;
+    /**
+     * Fired when a detail panel is expanded or collapsed.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/master-detail';`
+     *
+     * @example
+     * ```tsx
+     * onDetailExpand={(detail) => {
+     *   if (detail.expanded) loadDetailData(detail.rowId);
+     * }}
+     * ```
+     */
+    onDetailExpand?: EventHandler<DetailExpandDetail>;
+    /**
+     * Fired when responsive mode changes (table ↔ card).
+     *
+     * @requires `import '@toolbox-web/grid-react/features/responsive';`
+     *
+     * @example
+     * ```tsx
+     * onResponsiveChange={(detail) => {
+     *   console.log('Mode:', detail.mode); // 'table' | 'card'
+     * }}
+     * ```
+     */
+    onResponsiveChange?: EventHandler<ResponsiveChangeDetail>;
+    /**
+     * Fired when cells are copied to clipboard.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/clipboard';`
+     *
+     * @example
+     * ```tsx
+     * onCopy={(detail) => console.log('Copied:', detail.text)}
+     * ```
+     */
+    onCopy?: EventHandler<CopyDetail>;
+    /**
+     * Fired when cells are pasted from clipboard.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/clipboard';`
+     *
+     * @example
+     * ```tsx
+     * onPaste={(detail) => console.log('Pasted:', detail.affectedCells.length, 'cells')}
+     * ```
+     */
+    onPaste?: EventHandler<PasteDetail>;
+    /**
+     * Fired when undo/redo is performed.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/undo-redo';`
+     *
+     * @example
+     * ```tsx
+     * onUndoRedo={(detail) => console.log(detail.type, '- Can undo:', detail.canUndo)}
+     * ```
+     */
+    onUndoRedo?: EventHandler<UndoRedoDetail>;
+    /**
+     * Fired when export completes.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/export';`
+     *
+     * @example
+     * ```tsx
+     * onExportComplete={(detail) => console.log('Exported:', detail.filename)}
+     * ```
+     */
+    onExportComplete?: EventHandler<ExportCompleteDetail>;
+    /**
+     * Fired when print starts.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/print';`
+     *
+     * @example
+     * ```tsx
+     * onPrintStart={(detail) => console.log('Printing:', detail.rowCount, 'rows')}
+     * ```
+     */
+    onPrintStart?: EventHandler<PrintStartDetail>;
+    /**
+     * Fired when print completes.
+     *
+     * @requires `import '@toolbox-web/grid-react/features/print';`
+     *
+     * @example
+     * ```tsx
+     * onPrintComplete={() => console.log('Print complete')}
+     * ```
+     */
+    onPrintComplete?: EventHandler<PrintCompleteDetail>;
+}
+/**
+ * Map of event handler prop names to their corresponding event names.
+ * Used internally to wire up event listeners.
+ */
+export declare const EVENT_PROP_MAP: Record<keyof EventProps, string>;
+/**
+ * Gets all event prop names.
+ */
+export declare function getEventPropNames(): (keyof EventProps)[];
+//# sourceMappingURL=event-props.d.ts.map

package/lib/event-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-props.d.ts","sourceRoot":"","sources":["../../../../libs/grid-react/src/lib/event-props.ts"],"names":[],"mappings":"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"}