@nice2dev/ui 1.0.24 → 1.0.25

package/dist/index.d.ts

@@ -3127,6 +3127,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;
 
@@ -4458,6 +4461,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;
@@ -10408,7 +10418,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 +10562,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;
@@ -16255,6 +16283,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 +19539,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 +19723,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 +21825,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;
@@ -23106,6 +23166,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 +23237,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 +23257,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 +23377,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 +25418,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 +29086,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';