@nice2dev/ui 1.0.6 → 1.0.10

package/dist/data.d.ts

@@ -2,8 +2,12 @@ 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 { NiceBaseProps } from '@nice2dev/ui-core';
+import { NiceDataSource } from '@nice2dev/ui-core';
+import { NiceSize } from '@nice2dev/ui-core';
 import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
+import { TracelessMode } from '@nice2dev/ui-core';
 
 declare interface AIFilter {
     field: string;
@@ -40,7 +44,7 @@ export declare interface BankStatementItem {
     /** Value date (settlement) */
     valueDate?: Date | string;
     /** Description / reference */
-    description: string;
+    description?: string;
     /** Transaction amount (positive=credit, negative=debit) */
     amount: number;
     /** ISO currency code */
@@ -61,6 +65,8 @@ export declare interface BankStatementItem {
     matchedEntryIds?: string[];
     /** AI confidence (0-100) */
     confidence?: number;
+    /** ID of suggested matching book entry. */
+    suggestedMatch?: string;
     /** Excluded from reconciliation */
     excluded?: boolean;
 }
@@ -76,7 +82,11 @@ export declare interface BookEntry {
     /** Document date */
     documentDate?: Date | string;
     /** Description / posting text */
-    description: string;
+    description?: string;
+    /** Reference / document code (alternative display when `description` is omitted). */
+    reference?: string;
+    /** GL account or bank account code. */
+    account?: string;
     /** Amount (positive=debit, negative=credit for bank account) */
     amount: number;
     /** ISO currency code */
@@ -129,8 +139,6 @@ export declare function computeAggregate(rows: Record<string, any>[], field: str
 
 export declare function escapeCsvField(val: string): string;
 
-declare type Listener<Args extends unknown[]> = (...args: Args) => void;
-
 /**
  * Match confidence level.
  */
@@ -204,7 +212,8 @@ declare interface ModuleEmptyState {
 declare interface ModuleEnumOption {
     value: string | number;
     label: string;
-    color?: 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'secondary' | 'default';
+    /** Visual variant — semantic name or any CSS color string. */
+    color?: 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'secondary' | 'default' | (string & {});
     icon?: React.ReactNode;
 }
 
@@ -225,8 +234,8 @@ declare type ModuleExportFormat = 'csv' | 'excel' | 'pdf' | 'json';
 declare interface ModuleFilterCondition {
     field: string;
     operator: ModuleFilterOperator;
-    value: any;
-    valueTo?: any;
+    value: unknown;
+    valueTo?: unknown;
 }
 
 /** Filter group with AND/OR logic. */
@@ -257,7 +266,7 @@ declare interface ModuleGridColumn<T = any> {
     /** Cell renderer type */
     type?: ModuleCellRendererType;
     /** Custom cell renderer function */
-    render?: (value: any, row: T, index: number) => React.ReactNode;
+    render?: (value: unknown, row: T, index: number) => React.ReactNode;
     /** Cell alignment */
     align?: 'left' | 'center' | 'right';
     /** Hide column by default */
@@ -267,13 +276,15 @@ declare interface ModuleGridColumn<T = any> {
     /** Enable inline editing */
     editable?: boolean;
     /** Custom inline editor */
-    editor?: (value: any, row: T, onChange: (val: any) => void) => React.ReactNode;
+    editor?: (value: unknown, row: T, onChange: (val: unknown) => void) => React.ReactNode;
     /** Enum options for badge/select renderers */
     enumOptions?: ModuleEnumOption[];
     /** Format pattern (date: 'YYYY-MM-DD', number: '#,##0.00', currency: 'PLN') */
     format?: string;
     /** Currency code for currency renderer */
     currencyCode?: string;
+    /** Alias for `currencyCode`. */
+    currency?: string;
     /** Max rating for rating renderer */
     maxRating?: number;
     /** Link URL template (use {{field}} for values) */
@@ -328,7 +339,7 @@ declare interface ModuleGridResponse<T> {
 declare interface ModuleGroupedRow<T = any> {
     isGroup: true;
     groupKey: string;
-    groupValue: any;
+    groupValue: unknown;
     groupLabel: string;
     count: number;
     aggregates?: Record<string, number>;
@@ -362,40 +373,9 @@ declare interface ModuleViewPreferences {
     displayDensity?: 'compact' | 'normal' | 'comfortable';
 }
 
-/**
- * Per-component visibility & interaction level used by the access control system.
- * - `'full'` — fully interactive (default)
- * - `'readOnly'` — renders but cannot be edited
- * - `'disabled'` — renders greyed-out
- * - `'hidden'` — not rendered at all
- */
-declare type NiceAccessMode = 'full' | 'readOnly' | 'disabled' | 'hidden';
-
 /** Supported aggregate functions for column footers. */
 declare type NiceAggregateType = 'sum' | 'avg' | 'count' | 'min' | 'max';
 
-/** Base props inherited by every NiceToDev component. */
-declare interface NiceBaseProps {
-    /** Additional CSS class name(s). */
-    className?: string;
-    /** Inline style object. */
-    style?: React.CSSProperties;
-    /** HTML `id` attribute. When omitted a stable auto-generated id is used. */
-    id?: string;
-    /** Tooltip text shown on hover. */
-    title?: string;
-    /** Test identifier for integration / e2e test selectors. */
-    'data-testid'?: string;
-    /** Controls component visibility and interaction — see {@link NiceAccessMode}. */
-    accessMode?: NiceAccessMode;
-    /**
-     * Visual presentation style override.
-     * When set, overrides the global `displayStyle` from `NiceThemeProvider`.
-     * @see NiceDisplayStyle
-     */
-    displayStyle?: NiceDisplayStyle;
-}
-
 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;
 
 /** An item displayed by the {@link NiceCardView} component. */
@@ -440,7 +420,7 @@ declare interface NiceColumnState {
 /** Conditional formatting rule for cells. */
 declare interface NiceConditionalFormat<T = any> {
     /** Condition to apply formatting */
-    when: (value: any, row: T, field: string) => boolean;
+    when: (value: unknown, row: T, field: string) => boolean;
     /** CSS class to apply */
     className?: string;
     /** Inline styles to apply */
@@ -477,7 +457,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, exportCsv, exportFilename, detailRow, expandedRowKeys: controlledExpandedRows, onExpandedRowChange, columnReorder, 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, stateStorageKey, initialState, onStateChange, flashRowKeys, flashDuration, autoFitColumns, showColumnStats, rowIndicator, 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, 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, bulkActions, onBulkDelete, exportCsv, exportFilename, detailRow, expandedRowKeys: controlledExpandedRows, onExpandedRowChange, columnReorder, 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, stateStorageKey, initialState, onStateChange, flashRowKeys, flashDuration, autoFitColumns, showColumnStats, rowIndicator, frozenRows, className, style, accessMode, id, displayStyle, }: NiceDataGridProps<T>): JSX_2.Element | null;
 
 export declare namespace NiceDataGrid {
     var displayName: string;
@@ -519,6 +499,22 @@ declare interface NiceDataGridAIRef<T> {
     generateInsights: () => Promise<string[]>;
 }
 
+/** Bulk action button shown in {@link NiceDataGrid} toolbar when rows are selected. */
+declare interface NiceDataGridBulkAction<T = any> {
+    /** Unique key for the action. */
+    key: string;
+    /** Visible label. */
+    label: string;
+    /** Optional icon node. */
+    icon?: React.ReactNode;
+    /** Visual variant. */
+    variant?: 'primary' | 'success' | 'warning' | 'danger' | 'secondary' | 'ghost';
+    /** Disable the action based on current selection. */
+    disabled?: (selectedKeys: string[], rows: T[]) => boolean;
+    /** Handler invoked with selected row keys and the matching rows. */
+    onClick: (selectedKeys: string[], rows: T[]) => void;
+}
+
 /** Column definition for {@link NiceDataGrid}. */
 export declare interface NiceDataGridColumn<T = any> {
     field: string;
@@ -527,7 +523,7 @@ export declare interface NiceDataGridColumn<T = any> {
     minWidth?: number;
     sortable?: boolean;
     filterable?: boolean;
-    render?: (value: any, row: T, index: number) => React.ReactNode;
+    render?: (value: unknown, row: T, index: number) => React.ReactNode;
     align?: 'left' | 'center' | 'right';
     hidden?: boolean;
     /** Pin column to left or right edge */
@@ -535,7 +531,7 @@ export declare interface NiceDataGridColumn<T = any> {
     /** Allow inline cell editing via double-click */
     editable?: boolean;
     /** Custom inline editor */
-    editor?: (value: any, row: T, onChange: (val: any) => void) => React.ReactNode;
+    editor?: (value: unknown, row: T, onChange: (val: unknown) => void) => React.ReactNode;
     /** Footer aggregation */
     aggregate?: NiceAggregateType;
     /** Custom aggregate label */
@@ -558,7 +554,7 @@ export declare interface NiceDataGridColumn<T = any> {
         min?: number;
         max?: number;
         pattern?: RegExp;
-        custom?: (value: any, row: T) => boolean | string;
+        custom?: (value: unknown, row: T) => boolean | string;
     };
     /** Tooltip for column header */
     headerTooltip?: string;
@@ -567,7 +563,7 @@ export declare interface NiceDataGridColumn<T = any> {
 }
 
 /**
- * Props for the NiceDataGrid component — a full-featured data table with sorting,
+ * Props for the NiceDataGrid component � a full-featured data table with sorting,
  * filtering, pagination, virtual scrolling, grouping, inline editing, master/detail and more.
  */
 export declare interface NiceDataGridProps<T extends Record<string, any> = any> extends NiceBaseProps {
@@ -600,8 +596,28 @@ export declare interface NiceDataGridProps<T extends Record<string, any> = any>
     rowHeight?: number;
     groupBy?: string;
     /** Custom group header renderer */
-    groupRender?: (groupValue: any, rows: T[]) => React.ReactNode;
-    onCellEdit?: (rowKey: string, field: string, newValue: any) => void;
+    groupRender?: (groupValue: unknown, rows: T[]) => React.ReactNode;
+    onCellEdit?: (rowKey: string, field: string, newValue: unknown) => void;
+    /** Editing mode. `'inline'` (default) edits a single cell in place; `'popup'` opens a NiceForm-based dialog for the whole row (or a subset defined by `formItems`). */
+    editMode?: 'inline' | 'popup';
+    /** Form item definitions for popup-edit mode. When omitted, auto-derived from `columns` (skipping non-editable). Use `field` to map back to the row data. */
+    formItems?: NiceFormItem[];
+    /** Number of columns for the popup form. Defaults to 2. */
+    formColumns?: number;
+    /** Modal title for popup edit. Defaults to `'Edit row'`. */
+    editFormTitle?: string;
+    /** Escape-hatch: extra props forwarded to the underlying `NiceForm` in the popup (e.g. `labelPosition`, `gap`, `size`, `responsiveColumns`). Aligns with the `NiceFormDesigner` standard. */
+    formProps?: Partial<Omit<NiceFormProps, 'items' | 'data' | 'onFieldChange' | 'onSubmit' | 'columns' | 'showActions' | 'submitLabel'>>;
+    /** Called when the popup form is submitted with the merged row. */
+    onRowEdit?: (rowKey: string, updatedRow: T) => void;
+    /** Called when user requests a new row (toolbar button). When provided a "+ Add" button is shown and the popup is opened with empty data. */
+    onRowAdd?: (newRow: T) => void;
+    /** Called when user clicks the row delete action. When provided, a delete column is rendered. */
+    onRowDelete?: (rowKey: string, row: T) => void;
+    /** Bulk action items shown in toolbar when one or more rows are selected. */
+    bulkActions?: NiceDataGridBulkAction<T>[];
+    /** Called when user clicks the built-in "Bulk delete" action (only if {@link bulkActions} not provided). */
+    onBulkDelete?: (selectedKeys: string[], rows: T[]) => void;
     exportCsv?: boolean;
     exportFilename?: string;
     /** Render detail content for an expanded row */
@@ -649,12 +665,12 @@ export declare interface NiceDataGridProps<T extends Record<string, any> = any>
     clipboard?: boolean;
     /** Default clipboard format */
     clipboardFormat?: ClipboardFormat;
-    /** Callback before copy — return false to cancel */
+    /** Callback before copy � return false to cancel */
     onBeforeCopy?: (data: T[], fields: string[]) => boolean | void;
     /** Callback after copy */
     onCopy?: (data: T[], fields: string[], format: ClipboardFormat) => void;
     /** Callback on paste */
-    onPaste?: (data: any[][], startCell: CellPosition) => void;
+    onPaste?: (data: unknown[][], startCell: CellPosition) => void;
     /** Quick filter chips */
     quickFilters?: QuickFilter<T>[];
     /** Active quick filter keys */
@@ -693,65 +709,112 @@ declare interface NiceDataGridState {
     expandedGroups?: string[];
 }
 
-/**
- * Universal data source interface for Nice2Dev UI data components.
- * All data-bound components (NiceDataGrid, NiceList, NiceForm, etc.) accept a `NiceDataSource`.
- * Create one via `createArrayDataSource`, `createRestDataSource`, `createODataDataSource`,
- * `createGraphQLDataSource`, or `createCustomDataSource`.
- */
-declare interface NiceDataSource<T = any> {
-    /** Field name used as unique row key. */
-    readonly keyField: string;
-    /** True when insert/update/remove are available. */
-    readonly writable: boolean;
-    load(options?: NiceLoadOptions): Promise<NiceLoadResult<T>>;
-    byKey(key: unknown): Promise<T | undefined>;
-    insert?(item: Partial<T>): Promise<T>;
-    update?(key: unknown, changes: Partial<T>): Promise<T>;
-    remove?(key: unknown): Promise<void>;
-    on<K extends keyof NiceDataSourceEventMap>(event: K, handler: Listener<NiceDataSourceEventMap[K]>): () => void;
-}
-
-/** Events emitted by all NiceDataSource implementations. */
-declare type NiceDataSourceEventMap = {
-    changed: [];
-    loading: [boolean];
-    error: [Error | null];
-    loaded: [NiceLoadResult<unknown>];
-};
-
-/**
- * Cross-component visual presentation style.
- * Each style maps 1:1 to a ThemeVariantConfig preset controlling
- * buttons, inputs, cards, badges, tabs, toggles, tooltips, tables, etc.
- */
-declare type NiceDisplayStyle = 'default' | 'minimal' | 'rounded' | 'sharp' | 'glass' | 'neumorphic' | 'playful' | 'enterprise' | 'modern3d' | 'brutalist' | 'luxe' | 'pill' | 'flat' | 'editorial' | 'dashboard' | 'softCloud' | 'cosmic' | 'corporate' | 'bank' | 'government' | 'military' | 'legal' | 'medical' | 'swiss' | 'scandinavian' | 'bauhaus' | 'notebook' | 'origami' | 'watercolor' | 'monochrome' | 'paper' | 'zen' | 'terminal' | 'hacker' | 'retro8bit' | 'synthwave' | 'cyberpunk' | 'steampunk' | 'vapor' | 'neon' | 'windows95' | 'material' | 'fluent' | 'cupertino' | 'ant' | 'bootstrap' | 'chakra' | 'notion' | 'linear' | 'vercel' | 'candy' | 'bubblegum' | 'cartoon' | 'kawaii' | 'circus' | 'gaming' | 'kiddo' | 'disco' | 'clown';
-
-/** A single filter condition in the {@link NiceFilterBuilder} tree. */
-declare type NiceFilterCondition = {
-    type: 'condition';
-    field: string;
-    operator: NiceFilterOperator;
-    value: unknown;
-};
-
-/** A group of conditions joined by AND/OR logic in the {@link NiceFilterBuilder}. */
-declare type NiceFilterGroup = {
-    type: 'group';
-    logic: 'and' | 'or';
-    items: (NiceFilterCondition | NiceFilterGroup)[];
-};
-
-/** Comparison operators available in the {@link NiceFilterBuilder}. */
-declare type NiceFilterOperator = '=' | '<>' | '<' | '<=' | '>' | '>=' | 'contains' | 'notcontains' | 'startswith' | 'endswith' | 'between' | 'isblank' | 'isnotblank' | (string & {});
-
 declare interface NiceFilterState {
     [key: string]: unknown;
 }
 
+/** Describes a single field in a {@link NiceForm} layout. */
+declare interface NiceFormItem {
+    field: string;
+    label?: string;
+    colSpan?: number;
+    required?: boolean;
+    /** Static visibility flag � set to false to always hide. */
+    visible?: boolean;
+    /**
+     * Dynamic visibility: evaluated against current form data.
+     * Example: `(data) => data.country === 'PL'`
+     */
+    visibleWhen?: (data: Record<string, any>) => boolean;
+    render?: (value: unknown, onChange: (v: unknown) => void) => default_2.ReactNode;
+    hint?: string;
+    /** Group name � fields with the same group are rendered together under a section header. */
+    group?: string;
+    /** Tab name � fields with the same tab are rendered together under a tab. Tabs take precedence over groups for top-level structure. */
+    tab?: string;
+    /** Field type for auto-rendering (text, number, select, etc.). */
+    type?: string;
+    /** Options for select/radio type fields. */
+    options?: Array<{
+        label: string;
+        value: string | number;
+    } | string>;
+    /** Mask pattern for `type: 'masked'`. */
+    mask?: string;
+    /** Placeholder text shown when no value is selected/entered. */
+    placeholder?: string;
+    /** Default value applied when no value exists in `data`. */
+    defaultValue?: unknown;
+    /** Disable this field individually. */
+    disabled?: boolean;
+    /** Render this field in read-only mode individually. */
+    readOnly?: boolean;
+    /** Hide this field (alias of `visible: false`). */
+    hidden?: boolean;
+    /**
+     * Optional unit / currency code rendered as a suffix for `type: 'currency'`
+     * or `type: 'number'` (e.g. `'PLN'`, `'$'`, `'kg'`). Defaults to `'PLN'`
+     * for currency.
+     */
+    unit?: string;
+    /** Decimal precision for `type: 'number'` / `type: 'currency'`. Default 2 for currency, 0 for number. */
+    precision?: number;
+    /** Stepper increment for `type: 'number'` / `type: 'currency'`. Default 100 for currency, 1 for number. */
+    step?: number;
+    /** For `type: 'address'` � render sub-fields in 1 or 2 columns. Default 2. */
+    columns?: 1 | 2;
+}
+
+/** Props for the {@link NiceForm} component � a declarative, data-driven form layout. */
+declare interface NiceFormProps extends NiceBaseProps {
+    items: NiceFormItem[];
+    /** Inline form data. Ignored when `dataSource` + `recordKey` are provided. */
+    data?: Record<string, any>;
+    /** Field change callback. Ignored when `dataSource` is provided. */
+    onFieldChange?: (field: string, value: unknown) => void;
+    onSubmit?: (data: Record<string, any>) => void;
+    /**
+     * Two-way data source binding.
+     * When provided together with `recordKey`, the form loads and edits
+     * a single record from the source. `data`/`onFieldChange` are ignored.
+     */
+    dataSource?: NiceDataSource;
+    /** Key of the record to load/edit. */
+    recordKey?: unknown;
+    columns?: number;
+    /**
+     * Responsive columns: map of min-width breakpoint (px) ? column count.
+     * Example: `{ 0: 1, 600: 2, 1024: 3 }` ? 1 col on small, 2 on medium, 3 on large.
+     */
+    responsiveColumns?: Record<number, number>;
+    gap?: number | string;
+    labelPosition?: 'top' | 'left';
+    size?: NiceSize;
+    readOnly?: boolean;
+    disabled?: boolean;
+    /** Auto-save delay in ms. When set, form auto-saves after this many ms of inactivity. */
+    autoSaveDelay?: number;
+    /** Callback when dirty state changes. */
+    onDirtyChange?: (isDirty: boolean) => void;
+    /** When true, render Submit/Reset buttons at the bottom. */
+    showActions?: boolean;
+    /** Custom Submit button label. */
+    submitLabel?: string;
+    /** Custom Reset button label. */
+    resetLabel?: string;
+    /**
+     * When provided, a Cancel button is rendered on the LEFT side of the
+     * actions row. Used by popup hosts (NiceDataGrid edit popup, NiceKanban
+     * edit popup, etc.) to dismiss the modal without submitting.
+     */
+    onCancel?: () => void;
+    /** Custom Cancel button label. */
+    cancelLabel?: string;
+}
+
 export declare const NiceKanbanBoard: default_2.ForwardRefExoticComponent<NiceKanbanBoardProps & default_2.RefAttributes<HTMLDivElement>>;
 
-/** Props for the {@link NiceKanbanBoard} component — a drag-and-drop kanban board with columns, WIP limits, and custom card rendering. */
+/** Props for the {@link NiceKanbanBoard} component � a drag-and-drop kanban board with columns, WIP limits, and custom card rendering. */
 export declare interface NiceKanbanBoardProps extends NiceBaseProps, TracelessStorageProps {
     /** Column definitions. */
     columns: NiceKanbanColumn[];
@@ -779,6 +842,22 @@ export declare interface NiceKanbanBoardProps extends NiceBaseProps, TracelessSt
     collapsedColumns?: (string | number)[];
     /** Callback when collapsed columns change */
     onCollapsedColumnsChange?: (keys: (string | number)[]) => void;
+    /** Form items for the built-in popup editor. When provided clicking a card opens a NiceForm modal. */
+    formItems?: NiceFormItem[];
+    /** Number of columns for the popup form. Defaults to 1. */
+    formColumns?: number;
+    /** Escape-hatch: extra props forwarded to the underlying `NiceForm` in the popup (e.g. `labelPosition`, `gap`, `size`, `responsiveColumns`). */
+    formProps?: Partial<Omit<NiceFormProps, 'items' | 'data' | 'onFieldChange' | 'columns'>>;
+    /** Modal title for editing an existing card. Defaults to "Edit card". */
+    editCardTitle?: string;
+    /** Modal title for creating a new card. Defaults to "New card". */
+    newCardTitle?: string;
+    /** Called when an existing card is saved from the popup form. */
+    onCardEdit?: (cardKey: string | number, updated: NiceKanbanCard) => void;
+    /** Called when a new card is saved from the popup form. */
+    onCardCreate?: (newCard: NiceKanbanCard) => void;
+    /** Called when the user requests deletion from the popup form. */
+    onCardDelete?: (cardKey: string | number) => void;
 }
 
 /** A card on the {@link NiceKanbanBoard}. */
@@ -794,7 +873,7 @@ export declare interface NiceKanbanCard {
     /** Sort order within column. */
     order?: number;
     /** Additional data fields. */
-    [extra: string]: any;
+    [extra: string]: unknown;
 }
 
 /** A column (swimlane) on the {@link NiceKanbanBoard}. */
@@ -827,7 +906,7 @@ declare interface NiceListItem {
     /** Trailing badge content. */
     badge?: default_2.ReactNode;
     /** Additional data fields (index signature). */
-    [key: string]: any;
+    [key: string]: unknown;
 }
 
 /** Props for the {@link NiceList} component — a versatile list with selection, grouping, search, reorder, and swipe actions. */
@@ -875,31 +954,6 @@ export declare interface NiceListProps extends NiceBaseProps {
     }[];
 }
 
-/** Parameters sent to `load()`. All optional — adapters use what they support. */
-declare interface NiceLoadOptions {
-    filter?: NiceFilterGroup;
-    sort?: NiceSortExpression[];
-    skip?: number;
-    take?: number;
-    search?: string;
-    searchFields?: string[];
-    select?: string[];
-    expand?: string[];
-    group?: {
-        field: string;
-        direction?: NiceSortDirection;
-    }[];
-    /** Arbitrary parameters forwarded to the adapter (e.g. custom query strings). */
-    customParams?: Record<string, unknown>;
-}
-
-/** Result returned by {@link NiceDataSource.load}. */
-declare interface NiceLoadResult<T> {
-    data: T[];
-    totalCount: number;
-    summary?: Record<string, unknown>;
-}
-
 /**
  * NiceModuleGrid — Enterprise data grid for OmniVerk ERP modules.
  *
@@ -1031,7 +1085,7 @@ export declare interface NiceModuleGridProps<T extends Record<string, any> = any
     /** Enable inline editing */
     editable?: boolean;
     /** Cell edit handler */
-    onCellEdit?: (rowKey: string, field: string, value: any, row: T) => Promise<boolean> | boolean;
+    onCellEdit?: (rowKey: string, field: string, value: unknown, row: T) => Promise<boolean> | boolean;
     /** Row edit handler */
     onRowEdit?: (rowKey: string, values: Partial<T>, row: T) => Promise<boolean> | boolean;
     /** Edit mode: cell or row */
@@ -1116,7 +1170,7 @@ declare interface NicePivotField {
     /** Aggregation function applied in the data area. */
     summaryType?: 'sum' | 'count' | 'avg' | 'min' | 'max';
     /** Custom value formatter. */
-    format?: (value: any) => string;
+    format?: (value: unknown) => string;
 }
 
 export declare const NicePivotGrid: default_2.FC<NicePivotGridProps>;
@@ -1173,9 +1227,13 @@ export declare const NiceReconciliationView: default_2.ForwardRefExoticComponent
  */
 export declare interface NiceReconciliationViewProps extends NiceBaseProps {
     /** Bank statement items */
-    statements: BankStatementItem[];
+    statements?: BankStatementItem[];
+    /** Alias for `statements`. */
+    bankTransactions?: BankStatementItem[];
     /** Book entries from ledger */
-    entries: BookEntry[];
+    entries?: BookEntry[];
+    /** Alias for `entries`. */
+    accountingEntries?: BookEntry[];
     /** Existing matches (controlled) */
     matches?: ReconciliationMatch[];
     /** Initial matches (uncontrolled) */
@@ -1184,12 +1242,18 @@ export declare interface NiceReconciliationViewProps extends NiceBaseProps {
     suggestions?: AISuggestion[];
     /** Reconciliation config */
     config?: ReconciliationConfig;
+    /** Currency code (alias placed on top-level for convenience). */
+    currency?: string;
+    /** Show AI confidence column. */
+    showConfidence?: boolean;
     /** Statement panel config */
     statementPanelConfig?: PanelConfig;
     /** Entry panel config */
     entryPanelConfig?: PanelConfig;
     /** Called when items are matched */
-    onMatch?: OnMatchCallback;
+    onMatch?: OnMatchCallback | ((statementId: string, entryId: string) => void);
+    /** Auto-match all using a minimum confidence threshold. */
+    onAutoMatch?: (minConfidence: number) => void;
     /** Called when match is removed */
     onUnmatch?: OnUnmatchCallback;
     /** Called for batch actions */
@@ -1283,18 +1347,6 @@ export declare interface NiceSavedQueryPanelProps extends NiceBaseProps {
 
 declare type NiceSavedQueryUpdate = Partial<NiceSavedQueryCreate>;
 
-/** T-shirt sizing used across all components for consistent visual density. */
-declare type NiceSize = 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
-
-/** Sort direction for data source queries. */
-declare type NiceSortDirection = 'asc' | 'desc';
-
-/** A single sort expression: field name + direction. */
-declare interface NiceSortExpression {
-    field: string;
-    direction: NiceSortDirection;
-}
-
 declare interface NiceSortState {
     field: string;
     direction: 'asc' | 'desc';
@@ -1324,9 +1376,9 @@ export declare interface NiceSpreadsheetCell {
     readOnly?: boolean;
     /** Comment / note for this cell. */
     comment?: string;
-    /** Merge span — how many columns this cell covers. */
+    /** Merge span � how many columns this cell covers. */
     colSpan?: number;
-    /** Merge span — how many rows this cell covers. */
+    /** Merge span � how many rows this cell covers. */
     rowSpan?: number;
     /** Whether this cell is hidden by a merge (covered by another cell). */
     mergedInto?: string;
@@ -1335,7 +1387,7 @@ export declare interface NiceSpreadsheetCell {
 /** Primitive cell value type in the {@link NiceSpreadsheet}. */
 declare type NiceSpreadsheetCellValue = string | number | boolean | null;
 
-/** Props for the {@link NiceSpreadsheet} component — an Excel-like spreadsheet with formulas, multi-sheet tabs, toolbar, and frozen panes. */
+/** Props for the {@link NiceSpreadsheet} component � an Excel-like spreadsheet with formulas, multi-sheet tabs, toolbar, and frozen panes. */
 export declare interface NiceSpreadsheetProps extends NiceBaseProps {
     /** Sheet data (controlled). */
     sheets?: NiceSpreadsheetSheet[];
@@ -1388,9 +1440,9 @@ declare interface NiceSpreadsheetSheet {
     name: string;
     /** Cell map keyed by address (e.g. "A1", "B3"). */
     data: Record<string, NiceSpreadsheetCell>;
-    /** Column width overrides (0-based index → px). */
+    /** Column width overrides (0-based index ? px). */
     colWidths?: Record<number, number>;
-    /** Row height overrides (0-based index → px). */
+    /** Row height overrides (0-based index ? px). */
     rowHeights?: Record<number, number>;
     /** Number of top rows frozen. */
     frozenRows?: number;
@@ -1836,7 +1888,7 @@ export declare interface ReconciliationMatch {
 /**
  * Reconciliation match status.
  */
-export declare type ReconciliationStatus = 'matched' | 'partial' | 'unmatched' | 'excluded';
+export declare type ReconciliationStatus = 'matched' | 'partial' | 'unmatched' | 'excluded' | 'suggested';
 
 /**
  * Reconciliation summary statistics.
@@ -1946,44 +1998,6 @@ export declare interface SuggestionFactor {
     entryValue?: string;
 }
 
-/**
- * @fileoverview Traceless™ — Zero-Trace Privacy Architecture
- * @module @nice2dev/ui/core/traceless
- *
- * Traceless™ is OmniVerk's flagship privacy feature that allows complete control
- * over client-side storage (cookies, localStorage, sessionStorage).
- *
- * "Żadnych śladów. Żadnych cookies. Żadnego localStorage. Żadnego bannera. Traceless."
- *
- * @example
- * ```tsx
- * import { TracelessProvider, useTracelessPolicy, StorageAdapter } from '@nice2dev/ui';
- *
- * // In your app root:
- * <TracelessProvider>
- *   <App />
- * </TracelessProvider>
- *
- * // In components:
- * const { mode, canUseCookies, canUseLocalStorage } = useTracelessPolicy();
- * const storage = useStorageAdapter();
- * storage.set('key', 'value'); // Automatically respects policy
- * ```
- */
-/**
- * Privacy storage modes from most private to most permissive.
- *
- * | Mode       | Cookies | localStorage | sessionStorage | Consent Banner |
- * |------------|---------|--------------|----------------|----------------|
- * | traceless  | ❌      | ❌           | ❌             | ❌ Never       |
- * | ephemeral  | ❌      | ❌           | ✅             | ❌ Never       |
- * | private    | 1 auth  | ❌           | ✅             | ❌ Exempt      |
- * | balanced   | ❌      | ✅           | ✅             | ⚠️ Maybe       |
- * | full       | ✅      | ✅           | ✅             | ✅ Required    |
- * | custom     | Config  | Config       | Config         | Config         |
- */
-declare type TracelessMode = 'traceless' | 'ephemeral' | 'private' | 'balanced' | 'full' | 'custom';
-
 /**
  * Standard props that can be added to any component to support Traceless policy.
  */

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-DUw8plYP.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-CZ5bYOe_.js";
 export {
   a as NiceCardView,
   s as NiceDataGrid,