@nice2dev/ui 1.0.8 → 1.0.11

package/dist/navigation.d.ts

@@ -1,5 +1,21 @@
 import { default as default_2 } from 'react';
 import { ForwardRefExoticComponent } from 'react';
+import { NiceAccessMode } from '@nice2dev/ui-core';
+import { NiceBaseProps } from '@nice2dev/ui-core';
+import { NiceEntityMenuDto } from '@nice2dev/ui-core';
+import { NiceFavoriteItem } from '@nice2dev/ui-core';
+import { NiceFormFieldProps } from '@nice2dev/ui-core';
+import { NiceModeInfo } from '@nice2dev/ui-core';
+import { NiceModuleInfo } from '@nice2dev/ui-core';
+import { NiceModuleStatus } from '@nice2dev/ui-core';
+import { NiceOnboardingAnswer } from '@nice2dev/ui-core';
+import { NiceOnboardingQuestion } from '@nice2dev/ui-core';
+import { NiceOrganizationProfile } from '@nice2dev/ui-core';
+import { NiceSize } from '@nice2dev/ui-core';
+import { NiceTabDescriptor } from '@nice2dev/ui-core';
+import { NiceTenantInfo } from '@nice2dev/ui-core';
+import { NiceUserMenuResponse } from '@nice2dev/ui-core';
+import { NiceWorkspaceState } from '@nice2dev/ui-core';
 import { RefAttributes } from 'react';
 
 declare interface ClosedTabEntry {
@@ -48,15 +64,6 @@ declare interface NavbarBreadcrumb {
     onClick?: () => void;
 }
 
-/**
- * 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';
-
 export declare const NiceAccordion: default_2.FC<NiceAccordionProps>;
 
 /** A panel definition for the {@link NiceAccordion}. */
@@ -81,6 +88,12 @@ export declare interface NiceAccordionProps extends NiceBaseProps {
     multiple?: boolean;
     /** IDs of panels that are open by default. */
     defaultOpen?: string[];
+    /** Constrain the accordion to a specific width (px or any CSS length). When unset the accordion fills its parent (`100%`). */
+    width?: number | string;
+    /** Optional maximum width (px or any CSS length). */
+    maxWidth?: number | string;
+    /** Open / close animation duration in milliseconds. Defaults to `220`. Set to `0` to disable animation. */
+    animationDuration?: number;
 }
 
 export declare const NiceAppLayout: default_2.ForwardRefExoticComponent<NiceAppLayoutProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -103,28 +116,6 @@ export declare interface NiceAppLayoutProps extends NiceBaseProps {
     footer?: default_2.ReactNode;
 }
 
-/** 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 const NiceBottomNavigation: default_2.ForwardRefExoticComponent<NiceBottomNavigationProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** A navigation item in the {@link NiceBottomNavigation} bar. */
@@ -191,6 +182,8 @@ export declare interface NiceCardProps extends NiceBaseProps {
     footer?: default_2.ReactNode;
     /** Elevate the card on hover. */
     hoverable?: boolean;
+    /** Render a 1px border around the card. Defaults to `true`. Set to `false` for a frameless / shadow-only look. */
+    bordered?: boolean;
     /** Makes the entire card clickable. */
     onClick?: () => void;
 }
@@ -273,7 +266,9 @@ declare interface NiceConsoleStatusItem {
     /** Unique key. */
     key: string;
     /** Rendered content. */
-    content: React.ReactNode;
+    content?: React.ReactNode;
+    /** Convenience alias for `content` (string label). */
+    label?: React.ReactNode;
     /** Side of the status bar. */
     position?: 'left' | 'right';
     /** Click handler. */
@@ -290,8 +285,10 @@ declare interface NiceConsoleTab {
     icon?: React.ReactNode;
     /** Whether the tab can be closed. */
     closable?: boolean;
-    /** Content renderer. */
-    render: () => React.ReactNode;
+    /** Content renderer (function form). */
+    render?: () => React.ReactNode;
+    /** Content renderer (node form — convenience alias for `render`). */
+    content?: React.ReactNode;
 }
 
 export declare const NiceContextMenu: default_2.FC<NiceContextMenuProps>;
@@ -423,13 +420,6 @@ export declare interface NiceDesktopProps extends NiceBaseProps {
     children?: React.ReactNode;
 }
 
-/**
- * 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';
-
 export declare const NiceDock: ForwardRefExoticComponent<NiceDockProps & RefAttributes<HTMLDivElement>>;
 
 /** An item in the {@link NiceDock} bar. */
@@ -476,6 +466,8 @@ export declare interface NiceDockProps extends NiceBaseProps {
     activeKey?: string;
     /** Called when an item is clicked. */
     onItemClick?: (key: string) => void;
+    /** Render inline within a parent container instead of fixed to viewport. */
+    contained?: boolean;
 }
 
 export declare const NiceDynamicSidebar: ForwardRefExoticComponent<NiceDynamicSidebarProps & RefAttributes<HTMLElement>>;
@@ -511,52 +503,6 @@ export declare interface NiceDynamicSidebarProps extends NiceBaseProps {
     footer?: React.ReactNode;
 }
 
-/** A single entity (list view / form view) inside a module. */
-declare interface NiceEntityMenuDto {
-    id: string;
-    name: string;
-    label: string;
-    icon?: string;
-    listViewId?: string;
-    formViewId?: string;
-    route: string;
-}
-
-declare interface NiceFavoriteItem {
-    id: string;
-    label: string;
-    icon?: string;
-    route: string;
-    entityId?: string;
-    moduleId?: string;
-}
-
-/** Extended base props for form-field components (inputs, selects, etc.). */
-declare interface NiceFormFieldProps extends NiceBaseProps {
-    /** Field label displayed above or beside the control. */
-    label?: string;
-    /** Assistive text shown below the field. */
-    helperText?: string;
-    /** Validation error message — when set the field is styled as invalid. */
-    error?: string;
-    /** Marks the field as required (adds visual indicator). */
-    required?: boolean;
-    /** Disables the field. */
-    disabled?: boolean;
-    /** Makes the field read-only. */
-    readOnly?: boolean;
-    /** Visual size of the field. */
-    size?: NiceSize;
-    /** HTML `name` attribute used in form serialization. */
-    name?: string;
-    /** When true, pressing Enter will trigger the onSubmit callback (if provided). */
-    submitOnEnter?: boolean;
-    /** Callback triggered when Enter is pressed (if submitOnEnter is true). */
-    onSubmit?: () => void;
-    /** Show a keyboard shortcuts hint icon (?) next to the label. */
-    showKeyboardHints?: boolean;
-}
-
 export declare const NiceHamburgerMenu: ForwardRefExoticComponent<NiceHamburgerMenuProps & RefAttributes<HTMLDivElement>>;
 
 export declare interface NiceHamburgerMenuProps extends NiceBaseProps {
@@ -578,6 +524,29 @@ export declare interface NiceHamburgerMenuProps extends NiceBaseProps {
     footer?: React.ReactNode;
 }
 
+export declare const NiceHybridShell: ForwardRefExoticComponent<NiceHybridShellProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceHybridShellProps extends NiceBaseProps {
+    /** Sidebar navigation data. */
+    menu?: NiceUserMenuResponse;
+    /** Active route. */
+    activeRoute?: string;
+    /** Tenant info shown in the top bar. */
+    tenant?: NiceTenantInfo;
+    /** Top bar content. */
+    toolbar?: React.ReactNode;
+    /** Optional right inspector panel. */
+    inspector?: React.ReactNode;
+    /** Inspector default visibility. */
+    inspectorOpen?: boolean;
+    /** Status bar. */
+    statusBar?: React.ReactNode;
+    /** Navigation handler. */
+    onNavigate?: (route: string) => void;
+    /** Main content. */
+    children?: React.ReactNode;
+}
+
 export declare const NiceKioskShell: ForwardRefExoticComponent<NiceKioskShellProps & RefAttributes<HTMLDivElement>>;
 
 export declare interface NiceKioskShellProps extends NiceBaseProps {
@@ -718,14 +687,40 @@ export declare interface NiceMenuProps extends NiceBaseProps {
     onItemClick?: (item: NiceMenuItem) => void;
 }
 
-/** A work mode supported by the OmniVerk platform (test, demo, dev, prod, etc.). */
-declare interface NiceModeInfo {
-    key: string;
-    displayName: string;
-    icon?: string;
-    color?: string;
-    sourcePackage?: string;
-    description?: string;
+export declare const NiceMinimalShell: ForwardRefExoticComponent<NiceMinimalShellProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceMinimalShellProps extends NiceBaseProps {
+    /** Optional slim header. */
+    header?: React.ReactNode;
+    /** Optional tenant info shown in the header. */
+    tenant?: NiceTenantInfo;
+    /** Maximum content width (px or css value). */
+    maxWidth?: number | string;
+    /** Centered? Default true. */
+    centered?: boolean;
+    /** Main content. */
+    children?: React.ReactNode;
+}
+
+export declare const NiceModernShell: ForwardRefExoticComponent<NiceModernShellProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceModernShellProps extends NiceBaseProps {
+    /** Navigation data for the rail. */
+    menu?: NiceUserMenuResponse;
+    /** Currently active route. */
+    activeRoute?: string;
+    /** Tenant info shown in the top bar. */
+    tenant?: NiceTenantInfo;
+    /** Top bar right-aligned content (user menu, notifications). */
+    topBarActions?: React.ReactNode;
+    /** Optional global search slot. */
+    globalSearch?: React.ReactNode;
+    /** Footer content. */
+    footer?: React.ReactNode;
+    /** Called when navigating. */
+    onNavigate?: (route: string) => void;
+    /** Main content. */
+    children?: React.ReactNode;
 }
 
 export declare const NiceModeSelector: ForwardRefExoticComponent<NiceModeSelectorProps & RefAttributes<HTMLDivElement>>;
@@ -753,20 +748,6 @@ export declare interface NiceModeSelectorProps extends NiceBaseProps {
 
 declare type NiceModuleAction = 'activate' | 'deactivate' | 'install' | 'uninstall' | 'update';
 
-/** A module entry in the lifecycle management panel. */
-declare interface NiceModuleInfo {
-    id: string;
-    name: string;
-    label: string;
-    description: string;
-    version: string;
-    icon?: string;
-    status: NiceModuleStatus;
-    author?: string;
-    dependencies?: string[];
-    isCore?: boolean;
-}
-
 export declare const NiceModuleLifecyclePanel: ForwardRefExoticComponent<NiceModuleLifecyclePanelProps & RefAttributes<HTMLDivElement>>;
 
 export declare interface NiceModuleLifecyclePanelProps extends NiceBaseProps {
@@ -794,42 +775,41 @@ export declare interface NiceModuleLifecyclePanelProps extends NiceBaseProps {
     onModuleClick?: (module: NiceModuleInfo) => void;
 }
 
-/** A top-level module in the navigation sidebar. */
-declare interface NiceModuleMenuDto {
-    id: string;
-    name: string;
-    label: string;
-    icon?: string;
-    order: number;
-    isAvailable: boolean;
-    entities: NiceEntityMenuDto[];
-    children?: NiceModuleMenuDto[];
-}
-
-declare type NiceModuleStatus = 'available' | 'installed' | 'active' | 'disabled' | 'error' | 'updating';
-
 export declare const NiceMultiView: default_2.FC<NiceMultiViewProps>;
 
 /** A view entry in the {@link NiceMultiView}. */
 declare interface NiceMultiViewItem {
     /** Unique key. */
     key: string;
+    /** Optional label shown in tabs / header. */
+    label?: string;
+    /** Optional icon shown in tabs / header. */
+    icon?: string;
     /** Content renderer. */
     render: () => default_2.ReactNode;
 }
 
-/** Props for the {@link NiceMultiView} component — a swipeable / indexed panel container (one visible at a time). */
+/** Navigation style for the NiceMultiView. */
+declare type NiceMultiViewNav = 'tabs' | 'dots' | 'arrows' | 'none';
+
+/** Props for the {@link NiceMultiView} component. */
 export declare interface NiceMultiViewProps extends NiceBaseProps {
     /** Size variant. */
     size?: NiceSize;
     /** View definitions. */
     items: NiceMultiViewItem[];
-    /** Currently visible view index. */
+    /** Currently visible view index (controlled). */
     selectedIndex?: number;
     /** Called when the visible index changes. */
     onSelectedIndexChange?: (index: number) => void;
-    /** Enable slide transition animation. */
+    /** Enable slide transition animation (default: true). */
     animationEnabled?: boolean;
+    /** Navigation style (default: 'tabs'). */
+    nav?: NiceMultiViewNav;
+    /** Show prev/next arrows alongside any nav style (default: true for 'dots' / 'none'). */
+    showArrows?: boolean;
+    /** Auto-cycle interval in ms (0 = disabled). */
+    autoPlay?: number;
 }
 
 /**
@@ -903,25 +883,6 @@ export declare interface NiceNavigationControlsProps extends NiceBaseProps {
     stopIcon?: React.ReactNode;
 }
 
-/** Answer submitted for an onboarding question. */
-declare interface NiceOnboardingAnswer {
-    questionId: string;
-    answer: string;
-}
-
-/** A single question in the onboarding wizard. */
-declare interface NiceOnboardingQuestion {
-    id: string;
-    question: string;
-    questionType: 'text' | 'select' | 'multiSelect' | 'boolean' | 'number' | 'date';
-    category: string;
-    orderIndex: number;
-    isRequired: boolean;
-    options?: string[];
-    helpText?: string;
-    defaultValue?: string;
-}
-
 export declare const NiceOnboardingWizard: ForwardRefExoticComponent<NiceOnboardingWizardProps & RefAttributes<HTMLDivElement>>;
 
 export declare interface NiceOnboardingWizardProps extends NiceBaseProps {
@@ -951,41 +912,6 @@ export declare interface NiceOnboardingWizardProps extends NiceBaseProps {
     logo?: React.ReactNode;
 }
 
-/** Full organization profile DTO (30+ fields across 8 sections). */
-declare interface NiceOrganizationProfile {
-    id?: string;
-    name: string;
-    legalName?: string;
-    taxId?: string;
-    registrationNumber?: string;
-    industry?: string;
-    employeeCount?: number;
-    email?: string;
-    phone?: string;
-    website?: string;
-    fax?: string;
-    street?: string;
-    city?: string;
-    state?: string;
-    postalCode?: string;
-    country?: string;
-    logoUrl?: string;
-    primaryColor?: string;
-    secondaryColor?: string;
-    defaultLanguage?: string;
-    defaultCurrency?: string;
-    defaultTimezone?: string;
-    dateFormat?: string;
-    fiscalYearStart?: string;
-    vatEnabled?: boolean;
-    defaultVatRate?: number;
-    workingDays?: string[];
-    workingHoursStart?: string;
-    workingHoursEnd?: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
-
 export declare const NiceOrganizationProfileForm: ForwardRefExoticComponent<NiceOrganizationProfileFormProps & RefAttributes<HTMLDivElement>>;
 
 export declare interface NiceOrganizationProfileFormProps extends NiceBaseProps {
@@ -1031,7 +957,7 @@ declare type NiceOrgProfileSection = 'basic' | 'contact' | 'address' | 'branding
 
 export declare const NicePagination: default_2.FC<NicePaginationProps>;
 
-/** Props for the {@link NicePagination} component — a page navigation bar with numbered buttons, prev/next, and ellipsis. */
+/** Props for the {@link NicePagination} component — a page navigation bar with numbered buttons, prev/next, ellipsis, optional first/last, jump-to-page input and page-size selector. */
 export declare interface NicePaginationProps extends NiceBaseProps {
     /** Pagination size. */
     size?: NiceSize;
@@ -1045,14 +971,48 @@ export declare interface NicePaginationProps extends NiceBaseProps {
     showInfo?: boolean;
     /** Number of page buttons shown on each side of the current page. */
     siblingCount?: number;
+    /** Show ⏮ / ⏭ first/last page buttons. */
+    showFirstLast?: boolean;
+    /** Show a "Go to page" number input (uses NiceNumberInput). */
+    showJumpInput?: boolean;
+    /** Label for the jump input. Defaults to "Go to". */
+    jumpInputLabel?: string;
+    /** Show a page-size selector. Provide {@link pageSizeOptions} together with {@link onPageSizeChange}. */
+    showPageSize?: boolean;
+    /** Available page sizes. */
+    pageSizeOptions?: number[];
+    /** Currently selected page size. */
+    pageSize?: number;
+    /** Called when user selects a different page size. */
+    onPageSizeChange?: (size: number) => void;
+    /** Disable all interactions. */
+    disabled?: boolean;
 }
 
-declare interface NiceQuickAction {
-    id: string;
-    label: string;
-    icon?: string;
-    route: string;
-    shortcut?: string;
+export declare const NicePwaShell: ForwardRefExoticComponent<NicePwaShellProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NicePwaShellProps extends NiceBaseProps {
+    /** App title shown in the top bar. */
+    appTitle?: string;
+    /** Optional tenant info (replaces the title when present). */
+    tenant?: NiceTenantInfo;
+    /** Top bar trailing actions (notifications, profile). */
+    topBarActions?: React.ReactNode;
+    /** Bottom tab items. */
+    tabs?: Array<{
+        id: string;
+        label: string;
+        icon?: React.ReactNode;
+        route: string;
+    }>;
+    /** Active tab id. */
+    activeTabId?: string;
+    /** Tab-change handler. */
+    onTabChange?: (id: string, route: string) => void;
+    /** Optional FAB. */
+    fab?: React.ReactNode;
+    /** Main content. */
+    children?: React.ReactNode;
 }
 
 export declare interface NiceRibbonGroup {
@@ -1221,6 +1181,10 @@ export declare interface NiceSidebarNavProps {
     onPreferencesChange?: (prefs: SidebarNavUserPrefs) => void;
     /** Sidebar width in px (default: 264) */
     width?: number;
+    /** Collapsed (icon-only) mode */
+    collapsed?: boolean;
+    /** Called when collapsed state changes (for toggle button) */
+    onCollapsedChange?: (collapsed: boolean) => void;
     /** Extra CSS class on the root element */
     className?: string;
     /** Size variant */
@@ -1228,9 +1192,6 @@ export declare interface NiceSidebarNavProps {
     'data-testid'?: string;
 }
 
-/** T-shirt sizing used across all components for consistent visual density. */
-declare type NiceSize = 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
-
 export declare const NiceSplitter: default_2.FC<NiceSplitterProps>;
 
 /** A resizable pane inside the {@link NiceSplitter}. */
@@ -1291,18 +1252,6 @@ export declare interface NiceSystemTrayItem {
     onClick?: () => void;
 }
 
-/** Descriptor for a single MDI tab. */
-declare interface NiceTabDescriptor {
-    id: string;
-    route: string;
-    title: string;
-    icon?: string;
-    entityId?: string;
-    isDirty?: boolean;
-    isPinned?: boolean;
-    closable?: boolean;
-}
-
 /** Definition of a single tab in a {@link NiceTabs} component. */
 declare interface NiceTabItem {
     /** Unique tab identifier. */
@@ -1487,13 +1436,6 @@ export declare interface NiceUserMenuProps extends NiceFormFieldProps {
     status?: 'online' | 'away' | 'busy' | 'offline';
 }
 
-/** Full API response for user-scoped navigation menu. */
-declare interface NiceUserMenuResponse {
-    modules: NiceModuleMenuDto[];
-    quickActions: NiceQuickAction[];
-    favorites: NiceFavoriteItem[];
-}
-
 /**
  * {@link NiceWizard} — Multi-step wizard/stepper with per-step validation, optional steps, and step branching.
  */
@@ -1536,13 +1478,6 @@ export declare interface NiceWizardProps {
     id?: string;
 }
 
-/** Response from workspace state API. */
-declare interface NiceWorkspaceState {
-    tabs: NiceTabDescriptor[];
-    activeTabIndex: number;
-    layoutPreferences?: Record<string, unknown>;
-}
-
 /** Field definition for schema-driven forms */
 declare interface SetupField {
     id: string;