@kanunilabs/datagrid-react 1.8.3 → 1.8.5

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
-import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ToolbarOptions, PortalContainer, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, RowSaveStatus, DataRowNode, ColSpanPlan, SummaryDef, RemoteDistinctList, ToolbarSearchOptions, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, ValidationRule, CrudHandlers, EditingPermissions, NewRowPosition, RowEditSession, LookupMatchMode } from '@kanunilabs/datagrid-core';
+import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ToolbarOptions, PortalContainer, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, RowSaveStatus, DataRowNode, ColSpanPlan, SummaryDef, RemoteDistinctList, PortalKind, ToolbarSearchOptions, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, ValidationRule, CrudHandlers, EditingPermissions, NewRowPosition, RowEditSession, LookupMatchMode } from '@kanunilabs/datagrid-core';
 export { BusyChangedEvent, BusyPhase, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, ContentReadyEvent, CustomFilterOperator, CustomFilterOperatorId, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_COLOR_SCHEMES, GRID_PALETTES, GRID_THEMES, GridColorScheme, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridPaletteName, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, PortalContainer, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ToolbarOptions, ToolbarSearchOptions, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
 
 /** Formats an export menu can offer. */
@@ -120,6 +120,15 @@ interface PrintLayoutOptions {
      * streams instead.
      */
     maxRows?: number;
+    /**
+     * Called when a print is asked for and the result is over `maxRows`, so the
+     * grid prints the rows on screen only. Tell the user, or offer the PDF
+     * export: without it the shorter printout is silent (Tekax, 2026-10-28).
+     */
+    onLimit?: (info: {
+        rows: number;
+        maxRows: number;
+    }) => void;
 }
 /** Default row cap. Report-sized results print; result sets do not. */
 declare const PRINT_MAX_ROWS = 5000;
@@ -649,7 +658,9 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
      * chevron is not rendered, because a control that opens nothing is worse than
      * no control. `EnterpriseDataGrid` wires this to its own builder.
      */
-    onOpenFilterBuilder?: () => void;
+    onOpenFilterBuilder?: (context?: {
+        columnId?: string;
+    }) => void;
     /** Funnel button per header opening the distinct-value checklist popup. */
     headerFilter?: boolean;
     /**
@@ -1501,6 +1512,12 @@ interface GridHeaderFilterPopupProps {
      */
     onApply: (filter: FilterNode | null) => void;
     onClose: () => void;
+    /**
+     * Shows a "(Custom…)" entry above the list that opens the filter builder on
+     * this column. Given only where a builder can be opened (the app's
+     * `onOpenFilterBuilder`, or the Enterprise grid's own).
+     */
+    onCustom?: () => void;
     /**
      * `entries` is only the first page of a longer list.
      *
@@ -1526,7 +1543,7 @@ interface GridHeaderFilterPopupProps {
     pager?: RemoteDistinctList;
     labels?: Partial<Record<'search' | 'selectAll' | 'clear' | 'apply' | 'cancel' | 'blank' | 'noMatch' | 'loading' | 'truncated', string>>;
 }
-declare function GridHeaderFilterPopup({ gridId, columnId, headerLabel, entries, initialSelected, anchor, loading, dark, onApply, onClose, truncated, onSearch, pager, labels, }: GridHeaderFilterPopupProps): react.JSX.Element;
+declare function GridHeaderFilterPopup({ gridId, columnId, headerLabel, entries, initialSelected, anchor, loading, dark, onApply, onClose, onCustom, truncated, onSearch, pager, labels, }: GridHeaderFilterPopupProps): react.JSX.Element;
 
 interface GridContextMenuProps<TContext> {
     x: number;
@@ -1543,8 +1560,10 @@ declare function GridContextMenu<TContext>({ x, y, items, context, onClose, dark
 interface GridPortalProps {
     children: ReactNode;
     dark?: boolean;
+    /** `data-kanuni-portal`'s value: a `popup` (default) the user works in, or a `tooltip`. */
+    kind?: PortalKind;
 }
-declare function GridPortal({ children, dark }: GridPortalProps): react.ReactPortal | null;
+declare function GridPortal({ children, dark, kind }: GridPortalProps): react.ReactPortal | null;
 
 interface GridGroupPanelProps<TRow = GridRowData> {
     /** Columns offered for grouping (groupable and visible). */

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
-import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ToolbarOptions, PortalContainer, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, RowSaveStatus, DataRowNode, ColSpanPlan, SummaryDef, RemoteDistinctList, ToolbarSearchOptions, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, ValidationRule, CrudHandlers, EditingPermissions, NewRowPosition, RowEditSession, LookupMatchMode } from '@kanunilabs/datagrid-core';
+import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ToolbarOptions, PortalContainer, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, RowSaveStatus, DataRowNode, ColSpanPlan, SummaryDef, RemoteDistinctList, PortalKind, ToolbarSearchOptions, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, ValidationRule, CrudHandlers, EditingPermissions, NewRowPosition, RowEditSession, LookupMatchMode } from '@kanunilabs/datagrid-core';
 export { BusyChangedEvent, BusyPhase, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, ContentReadyEvent, CustomFilterOperator, CustomFilterOperatorId, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_COLOR_SCHEMES, GRID_PALETTES, GRID_THEMES, GridColorScheme, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridPaletteName, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, PortalContainer, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ToolbarOptions, ToolbarSearchOptions, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
 
 /** Formats an export menu can offer. */
@@ -120,6 +120,15 @@ interface PrintLayoutOptions {
      * streams instead.
      */
     maxRows?: number;
+    /**
+     * Called when a print is asked for and the result is over `maxRows`, so the
+     * grid prints the rows on screen only. Tell the user, or offer the PDF
+     * export: without it the shorter printout is silent (Tekax, 2026-10-28).
+     */
+    onLimit?: (info: {
+        rows: number;
+        maxRows: number;
+    }) => void;
 }
 /** Default row cap. Report-sized results print; result sets do not. */
 declare const PRINT_MAX_ROWS = 5000;
@@ -649,7 +658,9 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
      * chevron is not rendered, because a control that opens nothing is worse than
      * no control. `EnterpriseDataGrid` wires this to its own builder.
      */
-    onOpenFilterBuilder?: () => void;
+    onOpenFilterBuilder?: (context?: {
+        columnId?: string;
+    }) => void;
     /** Funnel button per header opening the distinct-value checklist popup. */
     headerFilter?: boolean;
     /**
@@ -1501,6 +1512,12 @@ interface GridHeaderFilterPopupProps {
      */
     onApply: (filter: FilterNode | null) => void;
     onClose: () => void;
+    /**
+     * Shows a "(Custom…)" entry above the list that opens the filter builder on
+     * this column. Given only where a builder can be opened (the app's
+     * `onOpenFilterBuilder`, or the Enterprise grid's own).
+     */
+    onCustom?: () => void;
     /**
      * `entries` is only the first page of a longer list.
      *
@@ -1526,7 +1543,7 @@ interface GridHeaderFilterPopupProps {
     pager?: RemoteDistinctList;
     labels?: Partial<Record<'search' | 'selectAll' | 'clear' | 'apply' | 'cancel' | 'blank' | 'noMatch' | 'loading' | 'truncated', string>>;
 }
-declare function GridHeaderFilterPopup({ gridId, columnId, headerLabel, entries, initialSelected, anchor, loading, dark, onApply, onClose, truncated, onSearch, pager, labels, }: GridHeaderFilterPopupProps): react.JSX.Element;
+declare function GridHeaderFilterPopup({ gridId, columnId, headerLabel, entries, initialSelected, anchor, loading, dark, onApply, onClose, onCustom, truncated, onSearch, pager, labels, }: GridHeaderFilterPopupProps): react.JSX.Element;
 
 interface GridContextMenuProps<TContext> {
     x: number;
@@ -1543,8 +1560,10 @@ declare function GridContextMenu<TContext>({ x, y, items, context, onClose, dark
 interface GridPortalProps {
     children: ReactNode;
     dark?: boolean;
+    /** `data-kanuni-portal`'s value: a `popup` (default) the user works in, or a `tooltip`. */
+    kind?: PortalKind;
 }
-declare function GridPortal({ children, dark }: GridPortalProps): react.ReactPortal | null;
+declare function GridPortal({ children, dark, kind }: GridPortalProps): react.ReactPortal | null;
 
 interface GridGroupPanelProps<TRow = GridRowData> {
     /** Columns offered for grouping (groupable and visible). */