@nice2dev/ui 1.0.24 → 1.0.26

package/dist/index.d.ts

@@ -66,6 +66,7 @@ import { CrossTabMessage } from '@nice2dev/ui-core';
 import { CSSProperties } from 'react';
 import { default as default_2 } from 'react';
 import { DEFAULT_VARIANT_CONFIG } from '@nice2dev/ui-core';
+import { defaultValidationMessage } from '@nice2dev/ui-core';
 import { DENSITY_VALUES } from '@nice2dev/ui-core';
 import { DensityVariant } from '@nice2dev/ui-core';
 import { deprecateProp } from '@nice2dev/ui-core';
@@ -74,6 +75,8 @@ import { deserializeTheme } from '@nice2dev/ui-core';
 import { Dispatch } from 'react';
 import { DisplayPreferences } from '@nice2dev/ui-core';
 import { endMark } from '@nice2dev/ui-core';
+import { evaluateValidation } from '@nice2dev/ui-core';
+import { evaluateValidationRule } from '@nice2dev/ui-core';
 import { FillVariant } from '@nice2dev/ui-core';
 import { filterGroupToWhere } from '@nice2dev/ui-core';
 import { filterNiceThemePacksByTag } from '@nice2dev/ui-core';
@@ -131,6 +134,7 @@ import { HelpProp } from '@nice2dev/ui-core';
 import { ICUValues } from '@nice2dev/ui-core';
 import { IndexedDBAdapter } from '@nice2dev/ui-core';
 import { InputStyleVariant } from '@nice2dev/ui-core';
+import { isRecordValid } from '@nice2dev/ui-core';
 import { ITracelessPolicy } from '@nice2dev/ui-core';
 import { JSX as JSX_2 } from 'react';
 import { KeyboardShortcut } from '@nice2dev/ui-core';
@@ -206,6 +210,9 @@ import { NiceFavoriteItem } from '@nice2dev/ui-core';
 import { NiceFieldState } from '@nice2dev/ui-core';
 import { NiceFieldStatus } from '@nice2dev/ui-core';
 import { NiceFieldStatusProps } from '@nice2dev/ui-core';
+import { NiceFieldValidationIssue } from '@nice2dev/ui-core';
+import { NiceFieldValidationOp } from '@nice2dev/ui-core';
+import { NiceFieldValidationRule } from '@nice2dev/ui-core';
 import { NiceFilterCondition } from '@nice2dev/ui-core';
 import { NiceFilterGroup } from '@nice2dev/ui-core';
 import { NiceFilterOperator } from '@nice2dev/ui-core';
@@ -3116,6 +3123,8 @@ export declare const DefaultLoadingFallback: default_2.FC<{
 /** Default cross-platform component type mapping. */
 export declare const defaultTypeMapping: NiceComponentTypeMapping;
 
+export { defaultValidationMessage }
+
 /** Default global registry instance. */
 export declare const defaultViewRegistry: NiceViewRegistry;
 
@@ -3127,6 +3136,9 @@ export { deprecateProp }
 
 export { deprecateSymbol }
 
+/** Derive {@link NiceExportColumn}s from the view's bound cells, falling back to data keys. */
+export declare function deriveExportColumns(view: NiceViewDefinition, rows: Array<Record<string, unknown>>): NiceExportColumn[];
+
 /** Deserialize and validate a module manifest from JSON. */
 export declare function deserializeManifest(json: string): NiceModuleManifest;
 
@@ -4292,6 +4304,10 @@ declare interface ESLintRuleContext {
     };
 }
 
+export { evaluateValidation }
+
+export { evaluateValidationRule }
+
 declare interface EventCondition {
     field: string;
     operator: 'eq' | 'neq' | 'gt' | 'lt' | 'gte' | 'lte' | 'contains' | 'exists';
@@ -4458,6 +4474,13 @@ export declare function exportToPDF<T extends Record<string, unknown>>(data: T[]
  */
 export declare function exportToXLSX<T extends Record<string, unknown>>(data: T[], columns: NiceExportColumn[], options?: NiceXLSXOptions): ArrayBuffer;
 
+/**
+ * Export a view + data to the given format. CSV/XLSX/PDF delegate to the
+ * dep-free {@link NiceExport} utilities; HTML/DOCX are produced here. Pass
+ * `options.onExport` to hand high-fidelity output to a host library.
+ */
+export declare function exportView(view: NiceViewDefinition, data: unknown, format: NiceViewExportFormat, options?: NiceViewExportOptions): Promise<void>;
+
 export declare interface Expression {
     id: string;
     name: string;
@@ -5696,6 +5719,8 @@ export declare interface InvoiceTotals {
 /** Check if a user can perform an action on a resource. Deny overrides allow. */
 export declare function isAllowed(resolved: NiceResolvedPermissions, resource: string, action: RbacAction): boolean;
 
+export { isRecordValid }
+
 /** Check if a version satisfies min/max constraints. */
 export declare function isVersionCompatible(version: SemVer, min?: SemVer, max?: SemVer): boolean;
 
@@ -8272,8 +8297,44 @@ export declare interface NiceCardProps extends NiceBaseProps {
     bordered?: boolean;
     /** Makes the entire card clickable. */
     onClick?: () => void;
+    /**
+     * Make the card behave as a selectable option (radio): cursor/hover affordance,
+     * `role="radio"` + `aria-checked`, keyboard select (Space/Enter). Inside a
+     * {@link NiceCardRadioGroup} this is implied for cards that carry a `value`.
+     */
+    selectable?: boolean;
+    /** Whether the card is currently selected (controlled; auto-wired inside a NiceCardRadioGroup). */
+    selected?: boolean;
+    /** The option value bound to this card (used for selection + the group's onChange). */
+    value?: NiceCardValue;
+    /** Fired with `value` when the card is selected. */
+    onSelect?: (value: NiceCardValue) => void;
+    /** Radio group name (auto-wired inside a NiceCardRadioGroup). */
+    name?: string;
+}
+
+/**
+ * {@link NiceCardRadioGroup} — wraps NiceCards into a single-select radio group:
+ * child cards that carry a `value` become selectable and report selection via
+ * `onChange` (the "binding + event on select"). Adds `role="radiogroup"`.
+ */
+export declare const NiceCardRadioGroup: default_2.FC<NiceCardRadioGroupProps>;
+
+/** Props for {@link NiceCardRadioGroup} — coordinates single-selection across child NiceCards. */
+export declare interface NiceCardRadioGroupProps extends NiceBaseProps {
+    /** Selected value (controlled). */
+    value?: NiceCardValue;
+    /** Fired with the newly-selected value. */
+    onChange?: (value: NiceCardValue) => void;
+    /** Radio group name applied to child cards. */
+    name?: string;
+    /** Child NiceCards (each with a `value`). */
+    children: default_2.ReactNode;
 }
 
+/** Value type used by selectable cards / card radio groups. */
+export declare type NiceCardValue = string | number;
+
 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. */
@@ -10408,7 +10469,7 @@ export declare interface NiceDataDiffViewerProps extends NiceBaseProps {
     onSelectRecord?: (table: string, recordId: string) => void;
 }
 
-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 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, autoPagination, stickyHeader, stickyFooter, 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;
@@ -10552,6 +10613,24 @@ export declare interface NiceDataGridProps<T extends Record<string, any> = any>
     page?: number;
     onPageChange?: (page: number) => void;
     totalRows?: number;
+    /**
+     * Auto-fit pagination: the grid fills 100% of its container height and the
+     * page size is computed from the available height ÷ `rowHeight` (recomputed on
+     * resize). The page-size control renders as an informational label instead of
+     * a select. Default `false`.
+     */
+    autoPagination?: boolean;
+    /**
+     * Keep the column header visible while scrolling the grid's own content.
+     * Engages only when the grid scrolls internally (bounded height / autoPagination);
+     * otherwise the header scrolls with the page. Default `true`.
+     */
+    stickyHeader?: boolean;
+    /**
+     * Keep the aggregate/summary footer row pinned while scrolling the grid's own
+     * content (same engagement rule as `stickyHeader`). Default `true`.
+     */
+    stickyFooter?: boolean;
     searchable?: boolean;
     searchPlaceholder?: string;
     virtualScroll?: boolean;
@@ -12058,6 +12137,12 @@ export { NiceFieldStatus }
 
 export { NiceFieldStatusProps }
 
+export { NiceFieldValidationIssue }
+
+export { NiceFieldValidationOp }
+
+export { NiceFieldValidationRule }
+
 /** A custom column in the {@link NiceFileManager} detail view. */
 export declare interface NiceFileColumnDef {
     /** Column key. */
@@ -16255,6 +16340,13 @@ export declare interface NiceNavShellProps {
     helpSteps?: NiceTutorialStep[];
     /** Disable individual default steps by key. */
     helpStepsExclude?: Array<'topNav' | 'sidebar' | 'tabs' | 'content'>;
+    /**
+     * Background opacity 0–1 (default `1` = opaque) for the shell chrome — applied
+     * to the content body and forwarded to the embedded top-nav and sidebar — so
+     * a translucent shell can sit over a wallpaper / floating UI. Exposed as the
+     * `--nice-shell-surface-alpha` CSS variable.
+     */
+    surfaceOpacity?: number;
     className?: string;
     contentClassName?: string;
     'data-testid'?: string;
@@ -19504,6 +19596,13 @@ export declare interface NiceSetupWizardProps {
     layout?: SetupWizardLayout;
     /** Size */
     size?: NiceSize;
+    /**
+     * When set, the wizard self-applies this theme (preset name or NiceTheme) by
+     * wrapping itself in a scoped NiceThemeProvider — so it themes correctly even
+     * when rendered outside an app-level provider (e.g. a standalone /setup page).
+     * Omit it when the wizard is already inside a NiceThemeProvider.
+     */
+    theme?: NiceTheme | string;
     /** Whether quick mode is enabled by default */
     defaultQuickMode?: boolean;
     /** Allow toggling quick mode */
@@ -19681,6 +19780,21 @@ export declare interface NiceSidebarNavProps {
     showFavorites?: boolean;
     /** Allow the footer Preferences view/mode. Default `!minimal`. */
     showFooterPreferences?: boolean;
+    /**
+     * **Sticky full-height** — when `true` (default) the sidebar sticks to the
+     * viewport and spans the full screen height (`position: sticky; top: 0;
+     * height: 100vh`), so the collapse button sits in the screen's bottom-left
+     * corner regardless of body/content height. Set `false` when a parent layout
+     * (e.g. NiceNavShell) already provides the full-height column. Ignored in
+     * `embedded` mode. Default `true`.
+     */
+    sticky?: boolean;
+    /**
+     * Background opacity of the sidebar surface, 0–1 (default `1` = opaque).
+     * Lower it for glassmorphism / floating-button backdrops; exposed as the
+     * `--nice-sidebar-surface-alpha` CSS variable consumed by the background.
+     */
+    surfaceOpacity?: number;
     /**
      * **Embedded mode** — render the sidebar inside another container (e.g. a
      * mobile drawer / hamburger menu). Forces full width, drops the footer with
@@ -21768,6 +21882,9 @@ export declare interface NiceTopNavProps {
     borderBottom?: boolean;
     elevated?: boolean;
     sticky?: boolean;
+    /** Background opacity 0–1 (default `1` = opaque). Lower for glass/floating UI;
+     *  exposed as the `--nice-topnav-surface-alpha` CSS variable. */
+    surfaceOpacity?: number;
     variant?: NiceTopNavVariant;
     accentBar?: boolean;
     accentBarColor?: string;
@@ -22707,6 +22824,24 @@ export { NiceUserPreferencesProvider }
 
 export { NiceUserPreferencesProviderProps }
 
+/**
+ * {@link NiceValidationBuilder} — visual editor for {@link NiceFieldValidationRule} lists,
+ * mirroring NiceFilterBuilder. Rules are enforced at runtime by the forms via
+ * `evaluateValidation` and can be reused by host codegen.
+ */
+export declare const NiceValidationBuilder: default_2.FC<NiceValidationBuilderProps>;
+
+/** Props for {@link NiceValidationBuilder}. */
+export declare interface NiceValidationBuilderProps extends NiceBaseProps {
+    /** Fields that rules may target (reuses the filter field descriptor). */
+    fields: NiceFilterField[];
+    /** The validation rules (controlled). */
+    value: NiceFieldValidationRule[];
+    onChange: (rules: NiceFieldValidationRule[]) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+
 export declare const NiceValidationGroup: default_2.FC<NiceValidationGroupProps>;
 
 /** Props for the {@link NiceValidationGroup} component — a context provider that orchestrates validation of all child {@link NiceValidator} instances. */
@@ -23106,6 +23241,8 @@ export declare interface NiceViewDefinition {
     id: string;
     /** Display name */
     name: string;
+    /** What kind of view this is (drives editor mode + export). Default `'form'`. */
+    kind?: NiceViewKind;
     /** Schema version */
     version: number;
     /** ERP module this view belongs to */
@@ -23175,6 +23312,12 @@ export declare interface NiceViewEditorProps extends NiceStandardProps {
     entities?: NiceEntityLike[];
     /** Save callback (shows a Save button when provided). */
     onSave?: (view: NiceViewDefinition) => void;
+    /**
+     * Optional host export hook for `report`/`print`/`grid` views. When provided
+     * it takes over from the built-in dep-free exporters (e.g. to produce
+     * high-fidelity DOCX/XLSX with the consumer's own library).
+     */
+    onExport?: NiceViewExportOptions['onExport'];
     /** Editor height. Default `560`. */
     height?: number | string;
     /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
@@ -23189,6 +23332,21 @@ export declare interface NiceViewEventBinding {
     actions: NiceViewAction[];
 }
 
+/** Supported export formats. */
+export declare type NiceViewExportFormat = 'pdf' | 'docx' | 'csv' | 'xlsx' | 'html';
+
+export declare interface NiceViewExportOptions {
+    /** File name (without extension). Defaults to the view name. */
+    fileName?: string;
+    /** Override columns; otherwise derived from the view, then from the data. */
+    columns?: NiceExportColumn[];
+    /**
+     * Host takeover for high-fidelity export. When provided it is called instead
+     * of the built-in exporter and is responsible for producing the file.
+     */
+    onExport?: (view: NiceViewDefinition, rows: Array<Record<string, unknown>>, format: NiceViewExportFormat) => void | Promise<void>;
+}
+
 export declare class NiceViewFetcher {
     private readonly config;
     constructor(config: NiceViewFetcherConfig);
@@ -23294,6 +23452,18 @@ export declare interface NiceViewHotReloadConfig {
     authToken?: string;
 }
 
+/**
+ * What a view IS — drives the editor mode, scaffolding and export options:
+ * - `form` / `detail` — record entry / read-only record
+ * - `grid` — tabular register
+ * - `dashboard` — widgets/KPIs
+ * - `content` — free page (e.g. a frontpage)
+ * - `report` — banded, data-bound report (exportable to PDF/XLSX/…)
+ * - `print` — a print/document template (the "wydruk")
+ * - `mix` — a mixed composition of the above
+ */
+export declare type NiceViewKind = 'form' | 'grid' | 'detail' | 'dashboard' | 'content' | 'report' | 'print' | 'mix';
+
 /** Layout types for container cells. */
 export declare type NiceViewLayoutType = 'grid' | 'tabs' | 'splitter' | 'accordion' | 'stack' | 'container';
 
@@ -25323,6 +25493,9 @@ export declare interface Resolution {
 
 export { resolveDisplayStyleConfig }
 
+/** Resolve the primary record array from a view data store or a plain array. */
+export declare function resolveExportRows(view: NiceViewDefinition, data: unknown): Array<Record<string, unknown>>;
+
 /** Resolve permissions for a set of user roles. */
 export declare function resolvePermissions(userRoleIds: string[], policy: NiceRbacPolicy): NiceResolvedPermissions;
 
@@ -28988,6 +29161,11 @@ export declare type ViewMode = 'grid' | 'list' | 'masonry' | 'details';
 
 declare type ViewMode_2 = 'split' | 'unified' | 'fields';
 
+/** Render a view + data as a standalone HTML document (used for the html/docx formats). */
+export declare function viewToHtml(view: NiceViewDefinition, data: unknown, options?: {
+    columns?: NiceExportColumn[];
+}): string;
+
 /** Validation severity. */
 export declare type ViewValidationSeverity = 'error' | 'warning' | 'info';