@dynostack/react-grid 0.3.2 → 0.5.0

package/dist/index.d.cts

@@ -1,7 +1,6 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Column, RowData, ColumnDef, SortingState, ColumnFiltersState, ColumnPinningState, VisibilityState, Table, CellContext, FilterFn } from '@tanstack/react-table';
 import * as React$1 from 'react';
 import { CSSProperties } from 'react';
+import { Column, RowData, ColumnDef, SortingState, ColumnFiltersState, ColumnPinningState, VisibilityState, Table, CellContext, FilterFn } from '@tanstack/react-table';
 
 type RowActionId = "view" | "edit" | "duplicate" | "delete" | string;
 type CustomRowAction<TData> = {
@@ -20,7 +19,7 @@ type DataTableRowActionsProps<TData> = {
     onSaveEdit?: () => void;
     onCancelEdit?: () => void;
 };
-declare function DataTableRowActions<TData>({ row, actions, customActions, onAction, isEditing, onSaveEdit, onCancelEdit, }: DataTableRowActionsProps<TData>): react_jsx_runtime.JSX.Element;
+declare function DataTableRowActions<TData>({ row, actions, customActions, onAction, isEditing, onSaveEdit, onCancelEdit, }: DataTableRowActionsProps<TData>): React$1.JSX.Element;
 
 /**
  * CSS variable overrides for a single DataTable instance.
@@ -119,6 +118,54 @@ declare function tokensToCssBlock(tokens?: DataTableTokens): string;
  */
 declare const themePresets: {
     neutral: DataTableModedTheme;
+    graphite: {
+        light: {
+            background: string;
+            card: string;
+            border: string;
+            radius: string;
+            fontFamily: string;
+            foreground?: string;
+            cardForeground?: string;
+            popover?: string;
+            popoverForeground?: string;
+            primary?: string;
+            primaryForeground?: string;
+            secondary?: string;
+            secondaryForeground?: string;
+            muted?: string;
+            mutedForeground?: string;
+            accent?: string;
+            accentForeground?: string;
+            destructive?: string;
+            destructiveForeground?: string;
+            input?: string;
+            ring?: string;
+        };
+        dark: {
+            background: string;
+            card: string;
+            popover: string;
+            border: string;
+            input: string;
+            muted: string;
+            mutedForeground: string;
+            accent: string;
+            primary: string;
+            primaryForeground: string;
+            ring: string;
+            destructive: string;
+            radius: string;
+            fontFamily: string;
+            foreground?: string;
+            cardForeground?: string;
+            popoverForeground?: string;
+            secondary?: string;
+            secondaryForeground?: string;
+            accentForeground?: string;
+            destructiveForeground?: string;
+        };
+    };
     light: {
         light: DataTableTokens | undefined;
     };
@@ -357,6 +404,18 @@ type DataTableProps<TData extends {
     pageSizeOptions?: number[];
     initialColumnPinning?: ColumnPinningState;
     initialColumnVisibility?: VisibilityState;
+    /** Initial sort order. */
+    initialSorting?: SortingState;
+    /** Observe selected row objects (loaded rows only in server mode). */
+    onSelectionChange?: (rows: TData[]) => void;
+    /** Accessible table name. */
+    ariaLabel?: string;
+    /** Alternating row backgrounds. */
+    striped?: boolean;
+    /** Keep headers visible inside a vertically constrained table. */
+    stickyHeader?: boolean;
+    /** Scroll viewport height, e.g. "480px". */
+    maxHeight?: React.CSSProperties["maxHeight"];
     /** Optional controlled global filter (for cross-tab persistence). */
     globalFilter?: string;
     onGlobalFilterChange?: (value: string) => void;
@@ -396,7 +455,7 @@ type DataTableProps<TData extends {
 };
 declare function DataTable<TData extends {
     id: string | number;
-}>({ data, columns, dataSource, isLoading, isFetching, onRefresh, totalRecords, exportFileName, enableSelection, renderSubRow, getSubRows, rowActions, customRowActions, onRowAction, onCellEdit, onRowSave, onAddRow, onBulkDelete, initialPageSize, pageSizeOptions, initialColumnPinning, initialColumnVisibility, globalFilter: globalFilterProp, onGlobalFilterChange, className, toolbarSlot, features, labels: labelsProp, density, theme, isolate, onView, onDelete, viewSheet, confirmDelete, }: DataTableProps<TData>): react_jsx_runtime.JSX.Element;
+}>({ data, columns, dataSource, isLoading, isFetching, onRefresh, totalRecords, exportFileName, enableSelection, renderSubRow, getSubRows, rowActions, customRowActions, onRowAction, onCellEdit, onRowSave, onAddRow, onBulkDelete, initialPageSize, pageSizeOptions, initialColumnPinning, initialColumnVisibility, initialSorting, onSelectionChange, ariaLabel, striped, stickyHeader, maxHeight, globalFilter: globalFilterProp, onGlobalFilterChange, className, toolbarSlot, features, labels: labelsProp, density, theme, isolate, onView, onDelete, viewSheet, confirmDelete, }: DataTableProps<TData>): React$1.JSX.Element;
 
 /**
  * Shared portal container for every overlay inside a DataTable (popover,
@@ -426,13 +485,13 @@ type Props$2<TData, TValue> = {
     column: Column<TData, TValue>;
     title: string;
 };
-declare function DataTableColumnHeader<TData, TValue>({ column, title, }: Props$2<TData, TValue>): react_jsx_runtime.JSX.Element;
+declare function DataTableColumnHeader<TData, TValue>({ column, title, }: Props$2<TData, TValue>): React$1.JSX.Element;
 
 type Props$1<TData> = {
     table: Table<TData>;
     pageSizeOptions?: number[];
 };
-declare function DataTablePagination<TData>({ table, pageSizeOptions, }: Props$1<TData>): react_jsx_runtime.JSX.Element;
+declare function DataTablePagination<TData>({ table, pageSizeOptions, }: Props$1<TData>): React$1.JSX.Element;
 
 type ToolbarFeatureFlags = {
     search?: boolean;
@@ -468,7 +527,7 @@ type Props<TData> = {
     features?: ToolbarFeatureFlags;
     labels?: ToolbarLabels;
 };
-declare function DataTableToolbar<TData>({ table, totalRecords, isFetching, onRefresh, onAddRow, onBulkDelete, exportFileName, globalFilter, onGlobalFilterChange, toolbarSlot, features, labels: labelsProp, }: Props<TData>): react_jsx_runtime.JSX.Element;
+declare function DataTableToolbar<TData>({ table, totalRecords, isFetching, onRefresh, onAddRow, onBulkDelete, exportFileName, globalFilter, onGlobalFilterChange, toolbarSlot, features, labels: labelsProp, }: Props<TData>): React$1.JSX.Element;
 
 type EditableCellProps<TData, TValue> = CellContext<TData, TValue> & {
     isEditing: boolean;
@@ -478,7 +537,7 @@ type EditableCellProps<TData, TValue> = CellContext<TData, TValue> & {
     onCancel: () => void;
     onStartEdit: () => void;
 };
-declare function EditableCell<TData, TValue>({ getValue, column, row, isEditing, autoOpen, onCommit, onCancel, onStartEdit, }: EditableCellProps<TData, TValue>): react_jsx_runtime.JSX.Element;
+declare function EditableCell<TData, TValue>({ getValue, column, row, isEditing, autoOpen, onCommit, onCancel, onStartEdit, }: EditableCellProps<TData, TValue>): React$1.JSX.Element;
 
 type TextOp = "contains" | "notContains" | "equals" | "notEqual" | "startsWith" | "endsWith" | "blank" | "notBlank";
 type NumberOp = "equals" | "notEqual" | "lessThan" | "lessThanOrEqual" | "greaterThan" | "greaterThanOrEqual" | "inRange" | "blank" | "notBlank";
@@ -507,9 +566,11 @@ type CommonProps<TData, TValue> = {
     column: Column<TData, TValue>;
     onClose: () => void;
 };
-declare function ColumnFilterPanel<TData, TValue>(props: CommonProps<TData, TValue>): react_jsx_runtime.JSX.Element | null;
+declare function ColumnFilterPanel<TData, TValue>(props: CommonProps<TData, TValue>): React$1.JSX.Element | null;
 
+/** Neutralize spreadsheet formulas in untrusted text; preserve real numbers. */
+declare function sanitizeSpreadsheetValue(value: unknown): string;
 declare function exportToCsv<TData>(table: Table<TData>, fileName?: string): void;
 declare function exportToExcel<TData>(table: Table<TData>, fileName?: string): void;
 
-export { type AdvFilter, type CellEditorType, ColumnFilterPanel, type Combine, type Condition, type ConfirmDeleteConfig, type ConfirmDeleteContext, type CustomRowAction, DataTable, type DataTableColumn, DataTableColumnHeader, type DataTableDataSource, type DataTableDataSourceResult, type DataTableDensity, type DataTableErrorContext, type DataTableFeatures, type DataTableFetchParams, type DataTableLabels, type DataTableModedTheme, DataTablePagination, type DataTableProps, DataTableRowActions, type DataTableRowActionsProps, type DataTableTheme, type DataTableThemeName, type DataTableTokens, DataTableToolbar, type DateOp, EditableCell, type FilterType, ISOLATE_DARK_TOKENS, ISOLATE_LIGHT_TOKENS, type NumberOp, PortalContainerContext, type RowAction, type RowActionId, type SelectOption, type SetFilter, type TextOp, type ViewSheetConfig, type ViewSheetDensity, type ViewSheetLabels, booleanFilterFn, buildPreset, dateFilterFn, exportToCsv, exportToExcel, isFilterActive, numberFilterFn, setFilterFn, splitTheme, textFilterFn, themePresets, themeToStyle, tokensToCssBlock, tokensToStyle, usePortalContainer };
+export { type AdvFilter, type CellEditorType, ColumnFilterPanel, type Combine, type Condition, type ConfirmDeleteConfig, type ConfirmDeleteContext, type CustomRowAction, DataTable, type DataTableColumn, DataTableColumnHeader, type DataTableDataSource, type DataTableDataSourceResult, type DataTableDensity, type DataTableErrorContext, type DataTableFeatures, type DataTableFetchParams, type DataTableLabels, type DataTableModedTheme, DataTablePagination, type DataTableProps, DataTableRowActions, type DataTableRowActionsProps, type DataTableTheme, type DataTableThemeName, type DataTableTokens, DataTableToolbar, type DateOp, EditableCell, type FilterType, ISOLATE_DARK_TOKENS, ISOLATE_LIGHT_TOKENS, type NumberOp, PortalContainerContext, type RowAction, type RowActionId, type SelectOption, type SetFilter, type TextOp, type ViewSheetConfig, type ViewSheetDensity, type ViewSheetLabels, booleanFilterFn, buildPreset, dateFilterFn, exportToCsv, exportToExcel, isFilterActive, numberFilterFn, sanitizeSpreadsheetValue, setFilterFn, splitTheme, textFilterFn, themePresets, themeToStyle, tokensToCssBlock, tokensToStyle, usePortalContainer };

package/dist/index.d.ts

@@ -1,7 +1,6 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Column, RowData, ColumnDef, SortingState, ColumnFiltersState, ColumnPinningState, VisibilityState, Table, CellContext, FilterFn } from '@tanstack/react-table';
 import * as React$1 from 'react';
 import { CSSProperties } from 'react';
+import { Column, RowData, ColumnDef, SortingState, ColumnFiltersState, ColumnPinningState, VisibilityState, Table, CellContext, FilterFn } from '@tanstack/react-table';
 
 type RowActionId = "view" | "edit" | "duplicate" | "delete" | string;
 type CustomRowAction<TData> = {
@@ -20,7 +19,7 @@ type DataTableRowActionsProps<TData> = {
     onSaveEdit?: () => void;
     onCancelEdit?: () => void;
 };
-declare function DataTableRowActions<TData>({ row, actions, customActions, onAction, isEditing, onSaveEdit, onCancelEdit, }: DataTableRowActionsProps<TData>): react_jsx_runtime.JSX.Element;
+declare function DataTableRowActions<TData>({ row, actions, customActions, onAction, isEditing, onSaveEdit, onCancelEdit, }: DataTableRowActionsProps<TData>): React$1.JSX.Element;
 
 /**
  * CSS variable overrides for a single DataTable instance.
@@ -119,6 +118,54 @@ declare function tokensToCssBlock(tokens?: DataTableTokens): string;
  */
 declare const themePresets: {
     neutral: DataTableModedTheme;
+    graphite: {
+        light: {
+            background: string;
+            card: string;
+            border: string;
+            radius: string;
+            fontFamily: string;
+            foreground?: string;
+            cardForeground?: string;
+            popover?: string;
+            popoverForeground?: string;
+            primary?: string;
+            primaryForeground?: string;
+            secondary?: string;
+            secondaryForeground?: string;
+            muted?: string;
+            mutedForeground?: string;
+            accent?: string;
+            accentForeground?: string;
+            destructive?: string;
+            destructiveForeground?: string;
+            input?: string;
+            ring?: string;
+        };
+        dark: {
+            background: string;
+            card: string;
+            popover: string;
+            border: string;
+            input: string;
+            muted: string;
+            mutedForeground: string;
+            accent: string;
+            primary: string;
+            primaryForeground: string;
+            ring: string;
+            destructive: string;
+            radius: string;
+            fontFamily: string;
+            foreground?: string;
+            cardForeground?: string;
+            popoverForeground?: string;
+            secondary?: string;
+            secondaryForeground?: string;
+            accentForeground?: string;
+            destructiveForeground?: string;
+        };
+    };
     light: {
         light: DataTableTokens | undefined;
     };
@@ -357,6 +404,18 @@ type DataTableProps<TData extends {
     pageSizeOptions?: number[];
     initialColumnPinning?: ColumnPinningState;
     initialColumnVisibility?: VisibilityState;
+    /** Initial sort order. */
+    initialSorting?: SortingState;
+    /** Observe selected row objects (loaded rows only in server mode). */
+    onSelectionChange?: (rows: TData[]) => void;
+    /** Accessible table name. */
+    ariaLabel?: string;
+    /** Alternating row backgrounds. */
+    striped?: boolean;
+    /** Keep headers visible inside a vertically constrained table. */
+    stickyHeader?: boolean;
+    /** Scroll viewport height, e.g. "480px". */
+    maxHeight?: React.CSSProperties["maxHeight"];
     /** Optional controlled global filter (for cross-tab persistence). */
     globalFilter?: string;
     onGlobalFilterChange?: (value: string) => void;
@@ -396,7 +455,7 @@ type DataTableProps<TData extends {
 };
 declare function DataTable<TData extends {
     id: string | number;
-}>({ data, columns, dataSource, isLoading, isFetching, onRefresh, totalRecords, exportFileName, enableSelection, renderSubRow, getSubRows, rowActions, customRowActions, onRowAction, onCellEdit, onRowSave, onAddRow, onBulkDelete, initialPageSize, pageSizeOptions, initialColumnPinning, initialColumnVisibility, globalFilter: globalFilterProp, onGlobalFilterChange, className, toolbarSlot, features, labels: labelsProp, density, theme, isolate, onView, onDelete, viewSheet, confirmDelete, }: DataTableProps<TData>): react_jsx_runtime.JSX.Element;
+}>({ data, columns, dataSource, isLoading, isFetching, onRefresh, totalRecords, exportFileName, enableSelection, renderSubRow, getSubRows, rowActions, customRowActions, onRowAction, onCellEdit, onRowSave, onAddRow, onBulkDelete, initialPageSize, pageSizeOptions, initialColumnPinning, initialColumnVisibility, initialSorting, onSelectionChange, ariaLabel, striped, stickyHeader, maxHeight, globalFilter: globalFilterProp, onGlobalFilterChange, className, toolbarSlot, features, labels: labelsProp, density, theme, isolate, onView, onDelete, viewSheet, confirmDelete, }: DataTableProps<TData>): React$1.JSX.Element;
 
 /**
  * Shared portal container for every overlay inside a DataTable (popover,
@@ -426,13 +485,13 @@ type Props$2<TData, TValue> = {
     column: Column<TData, TValue>;
     title: string;
 };
-declare function DataTableColumnHeader<TData, TValue>({ column, title, }: Props$2<TData, TValue>): react_jsx_runtime.JSX.Element;
+declare function DataTableColumnHeader<TData, TValue>({ column, title, }: Props$2<TData, TValue>): React$1.JSX.Element;
 
 type Props$1<TData> = {
     table: Table<TData>;
     pageSizeOptions?: number[];
 };
-declare function DataTablePagination<TData>({ table, pageSizeOptions, }: Props$1<TData>): react_jsx_runtime.JSX.Element;
+declare function DataTablePagination<TData>({ table, pageSizeOptions, }: Props$1<TData>): React$1.JSX.Element;
 
 type ToolbarFeatureFlags = {
     search?: boolean;
@@ -468,7 +527,7 @@ type Props<TData> = {
     features?: ToolbarFeatureFlags;
     labels?: ToolbarLabels;
 };
-declare function DataTableToolbar<TData>({ table, totalRecords, isFetching, onRefresh, onAddRow, onBulkDelete, exportFileName, globalFilter, onGlobalFilterChange, toolbarSlot, features, labels: labelsProp, }: Props<TData>): react_jsx_runtime.JSX.Element;
+declare function DataTableToolbar<TData>({ table, totalRecords, isFetching, onRefresh, onAddRow, onBulkDelete, exportFileName, globalFilter, onGlobalFilterChange, toolbarSlot, features, labels: labelsProp, }: Props<TData>): React$1.JSX.Element;
 
 type EditableCellProps<TData, TValue> = CellContext<TData, TValue> & {
     isEditing: boolean;
@@ -478,7 +537,7 @@ type EditableCellProps<TData, TValue> = CellContext<TData, TValue> & {
     onCancel: () => void;
     onStartEdit: () => void;
 };
-declare function EditableCell<TData, TValue>({ getValue, column, row, isEditing, autoOpen, onCommit, onCancel, onStartEdit, }: EditableCellProps<TData, TValue>): react_jsx_runtime.JSX.Element;
+declare function EditableCell<TData, TValue>({ getValue, column, row, isEditing, autoOpen, onCommit, onCancel, onStartEdit, }: EditableCellProps<TData, TValue>): React$1.JSX.Element;
 
 type TextOp = "contains" | "notContains" | "equals" | "notEqual" | "startsWith" | "endsWith" | "blank" | "notBlank";
 type NumberOp = "equals" | "notEqual" | "lessThan" | "lessThanOrEqual" | "greaterThan" | "greaterThanOrEqual" | "inRange" | "blank" | "notBlank";
@@ -507,9 +566,11 @@ type CommonProps<TData, TValue> = {
     column: Column<TData, TValue>;
     onClose: () => void;
 };
-declare function ColumnFilterPanel<TData, TValue>(props: CommonProps<TData, TValue>): react_jsx_runtime.JSX.Element | null;
+declare function ColumnFilterPanel<TData, TValue>(props: CommonProps<TData, TValue>): React$1.JSX.Element | null;
 
+/** Neutralize spreadsheet formulas in untrusted text; preserve real numbers. */
+declare function sanitizeSpreadsheetValue(value: unknown): string;
 declare function exportToCsv<TData>(table: Table<TData>, fileName?: string): void;
 declare function exportToExcel<TData>(table: Table<TData>, fileName?: string): void;
 
-export { type AdvFilter, type CellEditorType, ColumnFilterPanel, type Combine, type Condition, type ConfirmDeleteConfig, type ConfirmDeleteContext, type CustomRowAction, DataTable, type DataTableColumn, DataTableColumnHeader, type DataTableDataSource, type DataTableDataSourceResult, type DataTableDensity, type DataTableErrorContext, type DataTableFeatures, type DataTableFetchParams, type DataTableLabels, type DataTableModedTheme, DataTablePagination, type DataTableProps, DataTableRowActions, type DataTableRowActionsProps, type DataTableTheme, type DataTableThemeName, type DataTableTokens, DataTableToolbar, type DateOp, EditableCell, type FilterType, ISOLATE_DARK_TOKENS, ISOLATE_LIGHT_TOKENS, type NumberOp, PortalContainerContext, type RowAction, type RowActionId, type SelectOption, type SetFilter, type TextOp, type ViewSheetConfig, type ViewSheetDensity, type ViewSheetLabels, booleanFilterFn, buildPreset, dateFilterFn, exportToCsv, exportToExcel, isFilterActive, numberFilterFn, setFilterFn, splitTheme, textFilterFn, themePresets, themeToStyle, tokensToCssBlock, tokensToStyle, usePortalContainer };
+export { type AdvFilter, type CellEditorType, ColumnFilterPanel, type Combine, type Condition, type ConfirmDeleteConfig, type ConfirmDeleteContext, type CustomRowAction, DataTable, type DataTableColumn, DataTableColumnHeader, type DataTableDataSource, type DataTableDataSourceResult, type DataTableDensity, type DataTableErrorContext, type DataTableFeatures, type DataTableFetchParams, type DataTableLabels, type DataTableModedTheme, DataTablePagination, type DataTableProps, DataTableRowActions, type DataTableRowActionsProps, type DataTableTheme, type DataTableThemeName, type DataTableTokens, DataTableToolbar, type DateOp, EditableCell, type FilterType, ISOLATE_DARK_TOKENS, ISOLATE_LIGHT_TOKENS, type NumberOp, PortalContainerContext, type RowAction, type RowActionId, type SelectOption, type SetFilter, type TextOp, type ViewSheetConfig, type ViewSheetDensity, type ViewSheetLabels, booleanFilterFn, buildPreset, dateFilterFn, exportToCsv, exportToExcel, isFilterActive, numberFilterFn, sanitizeSpreadsheetValue, setFilterFn, splitTheme, textFilterFn, themePresets, themeToStyle, tokensToCssBlock, tokensToStyle, usePortalContainer };