@nice2dev/ui 1.0.21 → 1.0.23

package/dist/data-branching.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./data-branching-B_9C6-hE.cjs");exports.NiceDataBranchGraph=a.NiceDataBranchGraph;exports.NiceDataBranchManager=a.NiceDataBranchManager;exports.NiceDataConflictResolver=a.NiceDataConflictResolver;exports.NiceDataDiffViewer=a.NiceDataDiffViewer;exports.NiceDataMergeBuilder=a.NiceDataMergeBuilder;exports.NiceDataSnapshot=a.NiceDataSnapshot;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./data-branching-B7dCyaWr.cjs");exports.NiceDataBranchGraph=a.NiceDataBranchGraph;exports.NiceDataBranchManager=a.NiceDataBranchManager;exports.NiceDataConflictResolver=a.NiceDataConflictResolver;exports.NiceDataDiffViewer=a.NiceDataDiffViewer;exports.NiceDataMergeBuilder=a.NiceDataMergeBuilder;exports.NiceDataSnapshot=a.NiceDataSnapshot;

package/dist/data-branching.d.ts

@@ -1,5 +1,6 @@
 import { default as default_2 } from 'react';
 import { NiceBaseProps } from '@nice2dev/ui-core';
+import { NiceComponentTutorial } from '@nice2dev/ui-core';
 
 declare type BranchStatus = 'active' | 'stale' | 'merged' | 'deleted' | 'syncing' | 'conflict';
 
@@ -212,6 +213,8 @@ export declare interface NiceDataMergeBuilderProps extends NiceBaseProps {
     onPreview?: (sourceId: string, targetId: string) => void;
     onMerge?: (config: MergeConfig) => void;
     onCancel?: () => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare const NiceDataSnapshot: default_2.FC<NiceDataSnapshotProps>;

package/dist/data-branching.mjs

@@ -1,4 +1,4 @@
-import { N as c, a as i, b as r, c as t, d as s, e as D } from "./data-branching-BmCKIXgr.js";
+import { N as c, a as i, b as r, c as t, d as s, e as D } from "./data-branching-BPAeL45o.js";
 export {
   c as NiceDataBranchGraph,
   i as NiceDataBranchManager,

package/dist/data.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./NiceSavedQueryPanel-CpcjQZDl.cjs");exports.NiceCardView=e.NiceCardView;exports.NiceDataGrid=e.NiceDataGrid;exports.NiceDataGridAI=e.NiceDataGridAI;exports.NiceKanbanBoard=e.NiceKanbanBoard;exports.NiceList=e.NiceList;exports.NiceModuleGrid=e.NiceModuleGrid;exports.NicePivotGrid=e.NicePivotGrid;exports.NicePivotGridFieldChooser=e.NicePivotGridFieldChooser;exports.NiceReconciliationView=e.NiceReconciliationView;exports.NiceSavedQueryPanel=e.NiceSavedQueryPanel;exports.NiceSpreadsheet=e.NiceSpreadsheet;exports.NiceTable=e.NiceTable;exports.NiceTileView=e.NiceTileView;exports.NiceTreeGrid=e.NiceTreeGrid;exports.NiceTreeList=e.NiceTreeList;exports.NiceTreeView=e.NiceTreeView;exports.computeAggregate=e.computeAggregate;exports.escapeCsvField=e.escapeCsvField;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./NiceSavedQueryPanel-DT9v7kUB.cjs");exports.NiceCardView=e.NiceCardView;exports.NiceDataGrid=e.NiceDataGrid;exports.NiceDataGridAI=e.NiceDataGridAI;exports.NiceKanbanBoard=e.NiceKanbanBoard;exports.NiceList=e.NiceList;exports.NiceModuleGrid=e.NiceModuleGrid;exports.NicePivotGrid=e.NicePivotGrid;exports.NicePivotGridFieldChooser=e.NicePivotGridFieldChooser;exports.NiceReconciliationView=e.NiceReconciliationView;exports.NiceSavedQueryPanel=e.NiceSavedQueryPanel;exports.NiceSpreadsheet=e.NiceSpreadsheet;exports.NiceTable=e.NiceTable;exports.NiceTileView=e.NiceTileView;exports.NiceTreeGrid=e.NiceTreeGrid;exports.NiceTreeList=e.NiceTreeList;exports.NiceTreeView=e.NiceTreeView;exports.computeAggregate=e.computeAggregate;exports.escapeCsvField=e.escapeCsvField;

package/dist/data.d.ts

@@ -1,9 +1,11 @@
 import { default as default_2 } from 'react';
 import { ForwardedRef } from 'react';
 import { ForwardRefExoticComponent } from 'react';
-import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { JSX as JSX_2 } from 'react';
 import { NiceBaseProps } from '@nice2dev/ui-core';
+import { NiceComponentTutorial } from '@nice2dev/ui-core';
 import { NiceDataSource } from '@nice2dev/ui-core';
+import { NiceFilterGroup } from '@nice2dev/ui-core';
 import { NiceSize } from '@nice2dev/ui-core';
 import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
@@ -376,7 +378,7 @@ declare interface ModuleViewPreferences {
 /** Supported aggregate functions for column footers. */
 declare type NiceAggregateType = 'sum' | 'avg' | 'count' | 'min' | 'max';
 
-export declare function NiceCardView<T extends NiceCardViewItem>({ items, renderCard, columns, gap, searchable, searchField, searchPlaceholder, loading, emptyText, onCardClick, className, style, accessMode, id, }: NiceCardViewProps<T>): JSX_2.Element | null;
+export declare function NiceCardView<T extends NiceCardViewItem>({ items, renderCard, columns, gap, searchable, searchField, searchPlaceholder, loading, emptyText, onCardClick, className, style, accessMode, id, }: NiceCardViewProps<T>): default_2.JSX.Element | null;
 
 /** An item displayed by the {@link NiceCardView} component. */
 declare interface NiceCardViewItem {
@@ -457,7 +459,7 @@ declare interface NiceConditionalFormatRule {
     };
 }
 
-export declare function NiceDataGrid<T extends Record<string, any>>({ columns, data: dataProp, keyField, dataSource, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, pagination, pageSize: initPageSize, page: controlledPage, onPageChange, totalRows, searchable, searchPlaceholder, virtualScroll, rowHeight, groupBy, groupRender, onCellEdit, editMode, formItems, formColumns, editFormTitle, formProps, onRowEdit, onRowAdd, onRowDelete: _onRowDelete, bulkActions, onBulkDelete, exportCsv, exportFilename, detailRow, expandedRowKeys: controlledExpandedRows, onExpandedRowChange, columnReorder: _columnReorder, onColumnReorder: _onColumnReorder, columnResize, rowDraggable, onRowReorder, striped, compact, loading: loadingProp, emptyText, toolbar, onRowClick, pinnedTopKeys, pinnedBottomKeys, colSpan: colSpanFn, showStatusBar, contextMenuItems, onContextMenuAction, printFriendly, keyboardNavigation, focusedCell: controlledFocusedCell, onFocusedCellChange, cellRangeSelection, selectedCellRange: controlledCellRange, onCellRangeChange, clipboard, clipboardFormat, onBeforeCopy, onCopy, onPaste, quickFilters, activeQuickFilters: controlledQuickFilters, onQuickFilterChange, columnGroups: _columnGroups, stateStorageKey, initialState, onStateChange, flashRowKeys, flashDuration, autoFitColumns: _autoFitColumns, showColumnStats: _showColumnStats, rowIndicator, frozenRows: _frozenRows, className, style, accessMode, id, displayStyle, }: NiceDataGridProps<T>): JSX_2.Element | null;
+export declare function NiceDataGrid<T extends Record<string, any>>({ columns, data: dataProp, keyField, dataSource, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, showAdvancedFilter, advancedFilter, onAdvancedFilterChange, filterFields, filterPresets, onSaveFilterPreset, onDeleteFilterPreset, selectable, selectedKeys: controlledSelected, onSelectionChange, pagination, pageSize: initPageSize, page: controlledPage, onPageChange, totalRows, searchable, searchPlaceholder, virtualScroll, rowHeight, groupBy, groupRender, onCellEdit, editMode, formItems, formColumns, editFormTitle, formProps, onRowEdit, onRowAdd, onRowDelete: _onRowDelete, bulkActions, onBulkDelete, exportCsv, exportFilename, detailRow, expandedRowKeys: controlledExpandedRows, onExpandedRowChange, columnReorder: _columnReorder, onColumnReorder: _onColumnReorder, columnResize, rowDraggable, onRowReorder, striped, compact, loading: loadingProp, emptyText, toolbar, onRowClick, pinnedTopKeys, pinnedBottomKeys, colSpan: colSpanFn, showStatusBar, contextMenuItems, onContextMenuAction, printFriendly, keyboardNavigation, focusedCell: controlledFocusedCell, onFocusedCellChange, cellRangeSelection, selectedCellRange: controlledCellRange, onCellRangeChange, clipboard, clipboardFormat, onBeforeCopy, onCopy, onPaste, quickFilters, activeQuickFilters: controlledQuickFilters, onQuickFilterChange, columnGroups: _columnGroups, stateStorageKey, initialState, onStateChange, flashRowKeys, flashDuration, autoFitColumns: _autoFitColumns, showColumnStats: _showColumnStats, rowIndicator, frozenRows: _frozenRows, className, style, accessMode, id, displayStyle, }: NiceDataGridProps<T>): default_2.JSX.Element | null;
 
 export declare namespace NiceDataGrid {
     var displayName: string;
@@ -581,6 +583,18 @@ export declare interface NiceDataGridProps<T extends Record<string, any> = any>
     sortField?: string;
     sortDirection?: SortDirection;
     onSort?: (field: string, direction: SortDirection) => void;
+    /** Show an "Advanced filter" toolbar button that opens a NiceFilterBuilder panel. */
+    showAdvancedFilter?: boolean;
+    /** The advanced filter tree (controlled). Applied client-side unless a dataSource is bound. */
+    advancedFilter?: NiceFilterGroup;
+    /** Change callback for the advanced filter. */
+    onAdvancedFilterChange?: (filter: NiceFilterGroup) => void;
+    /** Filterable fields for the builder. Defaults to the (filterable) columns. */
+    filterFields?: NiceFilterField[];
+    /** Saved filter presets shown in the builder. */
+    filterPresets?: NiceFilterPreset[];
+    onSaveFilterPreset?: (preset: NiceFilterPreset) => void;
+    onDeleteFilterPreset?: (name: string) => void;
     selectable?: boolean;
     selectedKeys?: Set<string>;
     onSelectionChange?: (keys: Set<string>) => void;
@@ -709,6 +723,28 @@ declare interface NiceDataGridState {
     expandedGroups?: string[];
 }
 
+/** A filterable field descriptor for the {@link NiceFilterBuilder}. */
+declare interface NiceFilterField {
+    field: string;
+    label: string;
+    type?: 'string' | 'number' | 'date' | 'boolean';
+    options?: {
+        value: string | number;
+        label: string;
+    }[];
+    /** Restrict operators for this field */
+    operators?: {
+        value: string;
+        label: string;
+    }[];
+}
+
+/** A named saved filter for the {@link NiceFilterBuilder}. */
+declare interface NiceFilterPreset {
+    name: string;
+    filter: NiceFilterGroup;
+}
+
 declare interface NiceFilterState {
     [key: string]: unknown;
 }
@@ -860,6 +896,8 @@ export declare interface NiceKanbanBoardProps extends NiceBaseProps, TracelessSt
     onCardCreate?: (newCard: NiceKanbanCard) => void;
     /** Called when the user requests deletion from the popup form. */
     onCardDelete?: (cardKey: string | number) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 /** A card on the {@link NiceKanbanBoard}. */
@@ -1465,7 +1503,7 @@ declare interface NiceSpreadsheetSheet {
     columnFilters?: Record<number, string>;
 }
 
-export declare function NiceTable<T extends Record<string, any>>({ columns, data, striped, compact, emptyText, className, style, accessMode, id, displayStyle, }: NiceTableProps<T>): JSX_2.Element | null;
+export declare function NiceTable<T extends Record<string, any>>({ columns, data, striped, compact, emptyText, className, style, accessMode, id, displayStyle, }: NiceTableProps<T>): default_2.JSX.Element | null;
 
 /** Column definition for the {@link NiceTable} component. */
 declare interface NiceTableColumn<T = any> {
@@ -1497,7 +1535,7 @@ export declare interface NiceTableProps<T extends Record<string, any> = any> ext
     emptyText?: string;
 }
 
-export declare function NiceTileView<T extends NiceTileViewItem>({ items, tileWidth, tileHeight, direction, renderTile, onTileClick, loading, emptyText, className, style, }: NiceTileViewProps<T>): JSX_2.Element;
+export declare function NiceTileView<T extends NiceTileViewItem>({ items, tileWidth, tileHeight, direction, renderTile, onTileClick, loading, emptyText, className, style, }: NiceTileViewProps<T>): default_2.JSX.Element;
 
 /** A tile item displayed by the {@link NiceTileView} component. */
 declare interface NiceTileViewItem {
@@ -1543,7 +1581,7 @@ declare interface NiceTreeContextMenuItem {
     disabled?: boolean;
 }
 
-export declare function NiceTreeGrid<T extends NiceTreeGridNode>({ columns, data, keyField, parentKeyField, nested, childrenField, expandedKeys: controlledExpanded, onExpandedChange, defaultExpandAll, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, searchable, searchPlaceholder, striped, compact, loading, emptyText, toolbar, onRowClick, className, style, }: NiceTreeGridProps<T>): JSX_2.Element;
+export declare function NiceTreeGrid<T extends NiceTreeGridNode>({ columns, data, keyField, parentKeyField, nested, childrenField, expandedKeys: controlledExpanded, onExpandedChange, defaultExpandAll, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, searchable, searchPlaceholder, striped, compact, loading, emptyText, toolbar, onRowClick, className, style, }: NiceTreeGridProps<T>): default_2.JSX.Element;
 
 /** A row node in the {@link NiceTreeGrid} (supports index-signature for dynamic fields). */
 export declare interface NiceTreeGridNode {
@@ -1602,7 +1640,7 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
     onRowClick?: (row: T) => void;
 }
 
-export declare function NiceTreeList<T extends NiceTreeListNode>({ columns, data, keyField, parentKeyField, expandedKeys: controlledExpanded, onExpandedChange, selectedKeys, onSelectionChange, selectable, loading, emptyText, className, style, accessMode, id, }: NiceTreeListProps<T>): JSX_2.Element | null;
+export declare function NiceTreeList<T extends NiceTreeListNode>({ columns, data, keyField, parentKeyField, expandedKeys: controlledExpanded, onExpandedChange, selectedKeys, onSelectionChange, selectable, loading, emptyText, className, style, accessMode, id, }: NiceTreeListProps<T>): default_2.JSX.Element | null;
 
 /** A tree-list node for the {@link NiceTreeList} component. */
 declare interface NiceTreeListNode {

package/dist/data.mjs

@@ -1,4 +1,4 @@
-import { N as a, a as s, b as c, c as r, d as N, e as d, f as o, g as t, h as l, i as n, j as G, k as p, l as T, m as g, n as v, o as w, p as V, q as b } from "./NiceSavedQueryPanel-DtgcsEls.js";
+import { N as a, a as s, b as c, c as r, d as N, e as d, f as o, g as t, h as l, i as n, j as G, k as p, l as T, m as g, n as v, o as w, p as V, q as b } from "./NiceSavedQueryPanel-RLj3BnDR.js";
 export {
   a as NiceCardView,
   s as NiceDataGrid,