@nice2dev/ui 1.0.17 → 1.0.19

package/dist/index.d.ts

@@ -6995,6 +6995,30 @@ export declare interface NiceAddressValue {
     country?: string;
 }
 
+/**
+ * Fixes a child element to the viewport once the user scrolls past a
+ * threshold. Implemented via a scroll listener (not `position: sticky`)
+ * so we can fire `onChange` and use either an `offsetTop` OR an
+ * `offsetBottom` anchor independently of the parent's overflow setup.
+ *
+ * To preserve the document's flow when affixed, we render a same-size
+ * placeholder in the element's original position.
+ */
+export declare const NiceAffix: default_2.FC<NiceAffixProps>;
+
+/** Props for {@link NiceAffix} — sticky-position wrapper with offset triggers. */
+export declare interface NiceAffixProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    /** Distance from the viewport top at which the element fixes. Either `offsetTop` OR `offsetBottom`. */
+    offsetTop?: number;
+    /** Distance from the viewport bottom at which the element fixes. */
+    offsetBottom?: number;
+    /** Scrollable container; defaults to `window`. */
+    target?: () => HTMLElement | Window;
+    /** Fires when the element transitions between affixed / un-affixed. */
+    onChange?: (affixed: boolean) => void;
+}
+
 /** Supported aggregate functions for column footers. */
 export declare type NiceAggregateType = 'sum' | 'avg' | 'count' | 'min' | 'max';
 
@@ -7005,7 +7029,7 @@ export { NiceAIProvider }
 export declare const NiceAlert: default_2.FC<NiceAlertProps>;
 
 /** Props for the {@link NiceAlert} component — a status message bar (info/success/warning/error). */
-export declare interface NiceAlertProps extends NiceBaseProps {
+export declare interface NiceAlertProps extends NiceStandardProps {
     /** Alert size. */
     size?: NiceSize;
     /** Visual variant determining color and icon. */
@@ -7099,6 +7123,40 @@ export declare interface NiceAnalyticsTrackerProps {
     cookieless?: boolean;
 }
 
+/**
+ * Table-of-contents navigation. Each item points to an element by
+ * `id`. Clicking scrolls to it; an `IntersectionObserver` highlights
+ * the currently-visible heading as users scroll the page (scroll-spy).
+ *
+ * Affixing uses CSS `position: sticky` (no fixed positioning) so it
+ * stays nicely inside whatever parent container it's dropped into.
+ */
+export declare const NiceAnchor: default_2.FC<NiceAnchorProps>;
+
+/** Single entry in the {@link NiceAnchor} list. */
+export declare interface NiceAnchorItem {
+    /** Element id to scroll to (without `#`). */
+    href: string;
+    /** Display label. */
+    title: string;
+    /** Nested anchor items for sub-headings. */
+    children?: NiceAnchorItem[];
+}
+
+/** Props for {@link NiceAnchor} — table-of-contents navigation list. */
+export declare interface NiceAnchorProps extends NiceStandardProps {
+    /** Flat or nested list of headings. */
+    items: NiceAnchorItem[];
+    /** Render as `position: sticky` so the list stays on screen while scrolling. */
+    affix?: boolean;
+    /** Top offset (px) for `position: sticky` placement. */
+    offsetTop?: number;
+    /** Pixel offset applied to `scrollIntoView`-style jumps (compensates for fixed headers). */
+    targetOffset?: number;
+    /** Fires whenever the active item changes via scroll-spy. */
+    onChange?: (href: string) => void;
+}
+
 export { NiceAnimationConfig }
 
 export { NiceAnimationPreset }
@@ -7189,6 +7247,26 @@ export { NiceAriaProps }
 
 export { NiceArrayDataSourceConfig }
 
+/**
+ * Container that uses CSS `aspect-ratio` to keep its width/height
+ * proportional. Child elements should be 100%-sized — `<img>` /
+ * `<video>` / `<iframe>` work naturally, and any positioned element
+ * with `inset: 0` will fill the box.
+ */
+export declare const NiceAspectRatio: default_2.FC<NiceAspectRatioProps>;
+
+/** Props for {@link NiceAspectRatio} — maintains a width:height ratio while flexing horizontally. */
+export declare interface NiceAspectRatioProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    /**
+     * Aspect ratio expressed as a single number (`16 / 9 = 1.777…`) or
+     * a CSS shorthand string (`'16/9'`, `'4 / 3'`).
+     */
+    ratio?: number | string;
+    /** Optional cap on the rendered width. */
+    maxWidth?: number | string;
+}
+
 export declare type NiceAuditAction = 'create' | 'update' | 'delete' | 'view' | 'export' | 'import' | 'login' | 'logout' | 'custom';
 
 export declare interface NiceAuditEntry {
@@ -7408,7 +7486,7 @@ export declare const NiceAvatar: default_2.FC<NiceAvatarProps>;
 export declare const NiceAvatarGroup: default_2.FC<NiceAvatarGroupProps>;
 
 /** Props for the {@link NiceAvatarGroup} component — stacks multiple {@link NiceAvatar} elements with a "+N" overflow indicator. */
-export declare interface NiceAvatarGroupProps extends NiceBaseProps {
+export declare interface NiceAvatarGroupProps extends NiceStandardProps {
     /** Avatar group size. */
     size?: NiceSize;
     /** NiceAvatar elements to display. */
@@ -7418,7 +7496,7 @@ export declare interface NiceAvatarGroupProps extends NiceBaseProps {
 }
 
 /** Props for the {@link NiceAvatar} component — a user avatar with image, initials, or fallback. */
-export declare interface NiceAvatarProps extends NiceBaseProps {
+export declare interface NiceAvatarProps extends NiceStandardProps {
     /** Image URL. */
     src?: string;
     /** Alt text for the image. */
@@ -7433,6 +7511,31 @@ export declare interface NiceAvatarProps extends NiceBaseProps {
     color?: string;
 }
 
+/**
+ * Floating "back to top" button. Listens to its target's scroll
+ * position and reveals itself once the user has scrolled past
+ * `visibilityHeight`. Click scrolls smoothly back to the top
+ * with the configured `duration`.
+ */
+export declare const NiceBackTop: default_2.FC<NiceBackTopProps>;
+
+/** Props for {@link NiceBackTop} — floating "back to top" button. */
+export declare interface NiceBackTopProps extends NiceStandardProps {
+    /** Scroll distance (px) that must elapse before the button appears. */
+    visibilityHeight?: number;
+    /**
+     * Function that returns the scrollable container. Defaults to
+     * `window` (the document scroller). Use for scoped panes.
+     */
+    target?: () => HTMLElement | Window;
+    /** Animation duration in ms. Used by the easing tween. */
+    duration?: number;
+    /** Override the button's default ↑ glyph. */
+    children?: default_2.ReactNode;
+    /** Fires after the scroll-to-top finishes. */
+    onScroll?: () => void;
+}
+
 export declare function NiceBackupDiffViewer({ diffs, title, defaultMode, defaultActions, className, style, }: NiceBackupDiffViewerProps): JSX_2.Element;
 
 export declare interface NiceBackupDiffViewerProps {
@@ -7561,7 +7664,7 @@ export declare interface NiceBackupTagEditorProps {
 export declare const NiceBadge: default_2.FC<NiceBadgeProps>;
 
 /** Props for the {@link NiceBadge} component — a small status label or counter chip. */
-export declare interface NiceBadgeProps extends NiceBaseProps {
+export declare interface NiceBadgeProps extends NiceStandardProps {
     /** Badge content (text, number, etc.). */
     children: default_2.ReactNode;
     /** Visual variant controlling the colour scheme. */
@@ -7584,7 +7687,7 @@ export declare type NiceBarcodeFormat = 'CODE128' | 'CODE39' | 'EAN13' | 'EAN8'
 export declare const NiceBarcodeGenerator: ForwardRefExoticComponent<NiceBarcodeGeneratorProps & RefAttributes<HTMLCanvasElement>>;
 
 /** Props for the {@link NiceBarcodeGenerator} component — renders a barcode on a `<canvas>`. */
-export declare interface NiceBarcodeGeneratorProps extends NiceBaseProps {
+export declare interface NiceBarcodeGeneratorProps extends NiceStandardProps {
     /** Text value to encode. */
     value: string;
     /** Barcode symbology (default CODE128). */
@@ -7620,7 +7723,7 @@ declare interface NiceBarGaugeItem {
 }
 
 /** Props for the {@link NiceBarGauge} component — a circular segmented bar gauge. */
-export declare interface NiceBarGaugeProps extends NiceBaseProps {
+export declare interface NiceBarGaugeProps extends NiceStandardProps {
     /** Gauge items. */
     items: NiceBarGaugeItem[];
     /** Minimum scale value. */
@@ -7643,6 +7746,33 @@ export declare interface NiceBarGaugeProps extends NiceBaseProps {
 
 export { NiceBaseProps }
 
+/**
+ * Renders a semantic `<blockquote>` with optional citation + author
+ * attribution. Three visual variants (`default`, `bordered`, `filled`)
+ * map onto BEM modifier classes so consumers can re-theme via CSS
+ * tokens without rewriting markup.
+ */
+export declare const NiceBlockquote: default_2.FC<NiceBlockquoteProps>;
+
+/**
+ * Props for {@link NiceBlockquote} — styled quote / pull-quote block.
+ *
+ * NOTE: We omit `NiceStandardProps.variant` because here `variant` is a local
+ * visual style ('bordered' / 'filled' / 'default') rather than the design-system
+ * `NiceVariant` (primary/secondary/…).
+ */
+export declare interface NiceBlockquoteProps extends Omit<NiceStandardProps, 'variant'> {
+    children: default_2.ReactNode;
+    /** Citation source URL (sets the native `cite` attribute on `<blockquote>`). */
+    cite?: string;
+    /** Display author/attribution line below the quote. */
+    author?: string;
+    /** Visual variant. */
+    variant?: NiceBlockquoteVariant;
+}
+
+export declare type NiceBlockquoteVariant = 'default' | 'bordered' | 'filled';
+
 export declare const NiceBlockUI: default_2.ForwardRefExoticComponent<NiceBlockUIProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceBlockUI} component — an overlay that blocks user interaction on its children. */
@@ -7787,7 +7917,7 @@ export declare const NiceBullet: default_2.FC<NiceBulletProps>;
 declare type NiceBulletLabelPlacement = 'top' | 'left' | 'right' | 'bottom' | 'none';
 
 /** Props for the {@link NiceBullet} component — a horizontal bullet chart comparing actual vs. target. */
-export declare interface NiceBulletProps extends NiceBaseProps {
+export declare interface NiceBulletProps extends Omit<NiceStandardProps, 'size'> {
     /** Actual value. */
     value: number;
     /** Target / goal value. */
@@ -7948,8 +8078,65 @@ export declare interface NiceCalendarProps extends NiceBaseProps, TracelessStora
 
 export declare type NiceCalendarView = 'days' | 'months' | 'years' | 'decade';
 
+/**
+ * Stationary callout block — like an `<Alert>` but without the
+ * connotations of a dismissable system notification. Use to highlight
+ * caveats inline within docs / forms / settings panes.
+ *
+ * `closable` callouts use local state so the component is usable
+ * without a controlled-close wire-up. Use `onClose` for analytics
+ * or to also remove the entry from a parent collection.
+ */
+export declare const NiceCallout: default_2.FC<NiceCalloutProps>;
+
+/** Props for {@link NiceCallout} — non-interactive informational block. */
+export declare interface NiceCalloutProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    /** Semantic intent — drives colour + default glyph + ARIA role. */
+    type?: NiceCalloutType;
+    /** Optional heading rendered above the body. */
+    title?: string;
+    /** Override the default glyph for the chosen `type`. */
+    icon?: default_2.ReactNode;
+    /** Render an "x" button that dismisses the callout. */
+    closable?: boolean;
+    /** Fires when the user dismisses the callout. */
+    onClose?: () => void;
+}
+
+export declare type NiceCalloutType = 'info' | 'warning' | 'error' | 'success' | 'tip';
+
 export declare const NiceCard: default_2.FC<NiceCardProps>;
 
+/**
+ * Card grid via native CSS Grid. When `columns` is a number we set
+ * `grid-template-columns: repeat(N, 1fr)` once. When it's a
+ * breakpoint map we emit a tiny scoped `<style>` with CSS variable
+ * overrides per `@media (min-width: …)` so the layout reflows
+ * without JS resize listeners.
+ */
+export declare const NiceCardGrid: default_2.FC<NiceCardGridProps>;
+
+/** Responsive columns config — either a fixed number OR per-breakpoint. */
+export declare type NiceCardGridColumns = number | {
+    xs?: number;
+    sm?: number;
+    md?: number;
+    lg?: number;
+    xl?: number;
+};
+
+/** Props for {@link NiceCardGrid} — CSS-Grid card layout with responsive columns. */
+export declare interface NiceCardGridProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    /** Column count. Fixed number OR breakpoint map (`xs`/`sm`/`md`/`lg`/`xl`). */
+    columns?: NiceCardGridColumns;
+    /** Gap between cards. */
+    gap?: number | string;
+    /** Add a subtle elevation/transform on hover to each direct child. */
+    hoverable?: boolean;
+}
+
 /** Props for the {@link NiceCard} component — a bordered content container with optional header and footer. */
 export declare interface NiceCardProps extends NiceBaseProps {
     /** Card size. */
@@ -8007,7 +8194,7 @@ export declare interface NiceCardViewProps<T extends NiceCardViewItem = NiceCard
 export declare const NiceCarousel: default_2.ForwardRefExoticComponent<NiceCarouselProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceCarousel} component — a swipeable slide show with arrows, dots, and auto-play. */
-export declare interface NiceCarouselProps extends NiceBaseProps {
+export declare interface NiceCarouselProps extends NiceStandardProps {
     /** Array of items to display */
     items: default_2.ReactNode[];
     /** How many visible slides at a time (default: 1) */
@@ -8028,12 +8215,73 @@ export declare interface NiceCarouselProps extends NiceBaseProps {
     size?: NiceSize;
 }
 
+/** Hierarchical option in a {@link NiceCascadeSelect} tree. */
+export declare interface NiceCascadeOption {
+    /** Identifier used in the selected-values path. */
+    value: string;
+    /** Display label. */
+    label: default_2.ReactNode;
+    /** Children — when present, this option is expandable. */
+    children?: NiceCascadeOption[];
+    /** Disable picking this option (children still selectable). */
+    disabled?: boolean;
+}
+
+/**
+ * Multi-column cascading dropdown. Click an option in column N to
+ * either commit the selection (leaf) or open its children in
+ * column N+1. The selected path renders as `Label1 / Label2 / …`.
+ *
+ * Built without portals so it lives inside the document flow — fine
+ * for sidebar pickers; consumers wrapping into modals should bring
+ * their own positioning if needed.
+ */
+export declare const NiceCascadeSelect: default_2.FC<NiceCascadeSelectProps>;
+
+/** Props for {@link NiceCascadeSelect} — multi-column cascading dropdown. */
+export declare interface NiceCascadeSelectProps extends NiceStandardProps {
+    /** Top-level option tree. */
+    options: NiceCascadeOption[];
+    /** Controlled selection path (root → leaf). */
+    value?: string[];
+    /** Default selection path (uncontrolled). */
+    defaultValue?: string[];
+    /** Fires whenever the user selects a path. */
+    onChange?: (values: string[]) => void;
+    /** Placeholder when nothing is selected. Defaults to translated `'Select'`. */
+    placeholder?: string;
+    /** Disable the trigger. */
+    disabled?: boolean;
+}
+
 export declare interface NiceCategoryPref {
     categoryId: string;
     channels: Record<string, boolean>;
     priority: 'all' | 'high' | 'critical';
 }
 
+/**
+ * Centers its children horizontally and/or vertically using flexbox.
+ *
+ * Defaults to centering on both axes, which mirrors the common
+ * `display: flex; place-items: center` pattern.
+ */
+export declare const NiceCenter: default_2.FC<NiceCenterProps>;
+
+/** Props for {@link NiceCenter} — flex-based content centering wrapper. */
+export declare interface NiceCenterProps extends NiceStandardProps {
+    /** Content to center. */
+    children: default_2.ReactNode;
+    /** Center horizontally. */
+    horizontal?: boolean;
+    /** Center vertically. */
+    vertical?: boolean;
+    /** Render as `inline-flex` instead of `flex` (wraps to content). */
+    inline?: boolean;
+    /** Minimum container height — useful when only `vertical` centering is meaningful. */
+    minHeight?: number | string;
+}
+
 export declare interface NiceChangelogEntry {
     version: string;
     date?: string;
@@ -8094,7 +8342,7 @@ export declare interface NiceChartAnnotation {
  * Props for the NiceChart component — an SVG-based bar, line, and area chart
  * with stacking, zoom, crosshair, annotations, legend interaction and PNG export.
  */
-export declare interface NiceChartProps extends NiceBaseProps {
+export declare interface NiceChartProps extends NiceStandardProps {
     series: NiceChartSeries[];
     categories?: string[];
     width?: number;
@@ -8175,6 +8423,45 @@ export declare interface NiceChatProps extends NiceBaseProps {
 
 export declare const NiceCheckbox: default_2.ForwardRefExoticComponent<NiceCheckboxProps & default_2.RefAttributes<HTMLInputElement>>;
 
+/**
+ * Renders a `role="group"` of native `<input type="checkbox">` for
+ * multi-selection. Keeps controlled / uncontrolled state in sync via
+ * the standard pattern.
+ */
+export declare function NiceCheckboxGroup<T = string>({ value, defaultValue, options, disabled, direction, name, onChange, className, style, }: NiceCheckboxGroupProps<T>): default_2.ReactElement;
+
+export declare namespace NiceCheckboxGroup {
+    var displayName: string;
+}
+
+/** Single option in {@link NiceCheckboxGroup}. `value` is the form value persisted in the group state. */
+export declare interface NiceCheckboxGroupOption<T = string> {
+    label: default_2.ReactNode;
+    value: T;
+    disabled?: boolean;
+}
+
+/**
+ * Props for {@link NiceCheckboxGroup} — a multi-select checkbox set
+ * backed by an array of selected values.
+ */
+export declare interface NiceCheckboxGroupProps<T = string> extends NiceStandardProps {
+    /** Controlled selected values. */
+    value?: T[];
+    /** Default selected values (uncontrolled). */
+    defaultValue?: T[];
+    /** Available options. */
+    options: NiceCheckboxGroupOption<T>[];
+    /** Disable every option. Per-option `disabled` still respected if false. */
+    disabled?: boolean;
+    /** Layout direction. */
+    direction?: 'horizontal' | 'vertical';
+    /** Optional accessible group name (sets `aria-label` on the wrapper). */
+    name?: string;
+    /** Fires whenever the selected set changes. */
+    onChange?: (values: T[]) => void;
+}
+
 /** Props for the {@link NiceCheckbox} component. */
 export declare interface NiceCheckboxProps extends NiceBaseProps {
     /** Checkbox label. */
@@ -8216,7 +8503,7 @@ export declare interface NiceCheckboxProps extends NiceBaseProps {
 export declare const NiceCircularGauge: default_2.FC<NiceCircularGaugeProps>;
 
 /** Props for the {@link NiceCircularGauge} component — an arc-based circular gauge with configurable ranges. */
-export declare interface NiceCircularGaugeProps extends NiceBaseProps {
+export declare interface NiceCircularGaugeProps extends NiceStandardProps {
     /** Current gauge value. */
     value: number;
     /** Minimum scale value. */
@@ -8249,6 +8536,27 @@ export declare interface NiceCircularGaugeProps extends NiceBaseProps {
 
 export declare const NiceClassicShell: ForwardRefExoticComponent<NiceShellProps & RefAttributes<HTMLDivElement>>;
 
+/**
+ * Component form of the `useClickOutside` hook — useful when you
+ * already have a JSX tree and don't want to thread a ref through it.
+ * Listens for `mousedown` by default plus `touchstart` for parity
+ * with the hook.
+ */
+export declare const NiceClickOutside: default_2.FC<NiceClickOutsideProps>;
+
+export declare type NiceClickOutsideEvent = 'mousedown' | 'mouseup' | 'click';
+
+/** Props for {@link NiceClickOutside} — declarative outside-click detector. */
+export declare interface NiceClickOutsideProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    /** Fires when a click lands outside the wrapper. */
+    onClickOutside: (event: MouseEvent | TouchEvent) => void;
+    /** Pause detection (effectively no-op). */
+    disabled?: boolean;
+    /** Which pointer event to listen for. `mousedown` matches the common dropdown-close convention. */
+    mouseEvent?: NiceClickOutsideEvent;
+}
+
 export declare interface NiceCodeCompletionItem {
     /** Label displayed in completion list */
     label: string;
@@ -8609,6 +8917,81 @@ export declare interface NiceCodeTemplateProps extends NiceBaseProps {
 
 export declare type NiceCodeTheme = 'vs' | 'vs-dark' | 'hc-black' | 'hc-light' | 'auto';
 
+/**
+ * Single-panel disclosure. Composes nicely with `NiceAccordion`-style
+ * patterns where many `NiceCollapse` instances share a parent that
+ * coordinates them.
+ */
+export declare const NiceCollapse: default_2.FC<NiceCollapseProps>;
+
+/**
+ * Props for {@link NiceCollapse} — disclosure widget.
+ *
+ * Supports both controlled (`expanded` + `onExpandedChange`) and
+ * uncontrolled (`defaultExpanded`) usage.
+ */
+export declare interface NiceCollapseProps extends NiceStandardProps {
+    /** Content shown when expanded. */
+    children: default_2.ReactNode;
+    /** Controlled expanded flag. When set, the component is fully driven by the parent. */
+    expanded?: boolean;
+    /** Default expanded state for uncontrolled usage. */
+    defaultExpanded?: boolean;
+    /** Fires on every toggle (controlled or uncontrolled). */
+    onExpandedChange?: (expanded: boolean) => void;
+    /**
+     * Trigger element rendered above the panel. Receives accessibility
+     * wiring via `aria-controls` / `aria-expanded` on the surrounding
+     * button automatically.
+     */
+    trigger: default_2.ReactNode;
+    /** Animate height transitions. Default true. */
+    animated?: boolean;
+    /** Disable toggling (trigger button gets `disabled`). */
+    disabled?: boolean;
+}
+
+/**
+ * Visual card with a built-in collapse affordance. Same disclosure
+ * semantics as `NiceCollapse` (ARIA `aria-expanded` + `aria-controls`)
+ * with a card-specific chrome.
+ *
+ * Toggle button label flows through `useNiceTranslation` so the
+ * chevron's `aria-label` follows the picker.
+ */
+export declare const NiceCollapsibleCard: default_2.FC<NiceCollapsibleCardProps>;
+
+/**
+ * Props for {@link NiceCollapsibleCard} — card whose body collapses.
+ *
+ * `title` omitted from the standard prop bag because here it's a rich
+ * ReactNode header (text/icon/etc.), not the tooltip-text string the
+ * base prop describes.
+ */
+export declare interface NiceCollapsibleCardProps extends Omit<NiceStandardProps, 'title'> {
+    children: default_2.ReactNode;
+    /** Card title (rendered in the header). */
+    title: default_2.ReactNode;
+    /** Extra header content rendered between title and chevron. */
+    extra?: default_2.ReactNode;
+    /** Default collapsed state for uncontrolled usage. */
+    defaultCollapsed?: boolean;
+    /** Controlled collapsed flag. */
+    collapsed?: boolean;
+    /** Fires on every toggle. */
+    onCollapse?: (collapsed: boolean) => void;
+    /**
+     * Which surface acts as the toggle target:
+     *  - `'icon'` — only the chevron button toggles (clicking the title
+     *    text doesn't fire). Safer when the title is itself interactive
+     *    (link, ellipsis tooltip, …).
+     *  - `'header'` — the whole header row toggles. Friendlier on touch.
+     */
+    collapseTrigger?: NiceCollapsibleCardTrigger;
+}
+
+export declare type NiceCollapsibleCardTrigger = 'header' | 'icon';
+
 export declare const NiceColorPalette: default_2.ForwardRefExoticComponent<NiceColorPaletteProps & default_2.RefAttributes<HTMLDivElement>>;
 
 export declare interface NiceColorPaletteProps extends NiceBaseProps {
@@ -8652,6 +9035,29 @@ export declare interface NiceColorPaletteProps extends NiceBaseProps {
     label?: string;
     /** Disabled state */
     disabled?: boolean;
+    /**
+     * Target number of colors in the generated palette. Overrides the natural
+     * count of the active harmony mode (clamped between `minColors` and
+     * `maxColors`). When omitted, the harmony's natural angle count is used.
+     */
+    colorCount?: number;
+    /**
+     * Step size (HSV value delta) between adjacent colors in the `shade-chain`
+     * mode. Default 0.12.
+     */
+    shadeStep?: number;
+    /** Called when the user changes the shade step via the in-component control. */
+    onShadeStepChange?: (step: number) => void;
+    /**
+     * Custom harmony schemes. Appended to the built-in mode list in the
+     * selector and persisted via `localStorage` when `persistCustomSchemes`
+     * is true.
+     */
+    customSchemes?: NiceCustomHarmonyScheme[];
+    /** Called when the user edits the custom-schemes list. */
+    onCustomSchemesChange?: (schemes: NiceCustomHarmonyScheme[]) => void;
+    /** Persist custom schemes to `localStorage["nice-palette-custom-schemes"]`. Default true. */
+    persistCustomSchemes?: boolean;
 }
 
 export declare const NiceColorPicker: default_2.ForwardRefExoticComponent<NiceColorPickerProps & default_2.RefAttributes<HTMLInputElement>>;
@@ -8753,6 +9159,61 @@ export declare interface NiceCommand {
     hidden?: boolean;
 }
 
+/**
+ * Command palette — searchable, keyboard-driven command launcher.
+ *
+ * Search filters on `label` + `keywords`; results group under their
+ * `category`. Down/Up moves the highlight, Enter runs the
+ * highlighted command, Escape closes (if controlled).
+ *
+ * `shortcut` installs a document-level keydown listener that opens
+ * the palette when the combo is pressed (and we control the open
+ * state via `onOpenChange`).
+ */
+export declare const NiceCommandBar: default_2.FC<NiceCommandBarProps>;
+
+/** A single command in {@link NiceCommandBar}. */
+export declare interface NiceCommandBarCommand {
+    /** Stable identifier (React key + dedupe). */
+    id: string;
+    /** Display label. */
+    label: string;
+    /** Optional category grouping (rendered as a section header). */
+    category?: string;
+    /** Optional secondary text rendered to the right (typically a hint). */
+    hint?: string;
+    /** Optional shortcut chip rendered on the right (e.g. `'Ctrl+K'`). */
+    shortcut?: string;
+    /** Optional glyph node rendered on the left. */
+    icon?: default_2.ReactNode;
+    /** When `true`, the command is rendered but not selectable. */
+    disabled?: boolean;
+    /** Handler invoked when the user picks this command. */
+    onRun?: () => void;
+    /** Free-form keywords used by the search filter in addition to `label`. */
+    keywords?: string[];
+}
+
+/** Props for {@link NiceCommandBar} — searchable command palette. */
+export declare interface NiceCommandBarProps extends NiceStandardProps {
+    /** Command set. */
+    commands: NiceCommandBarCommand[];
+    /** Controlled visibility. When omitted the bar is always visible. */
+    open?: boolean;
+    /** Fires when open state changes (e.g. Escape closes). */
+    onOpenChange?: (open: boolean) => void;
+    /** Fires when a command is selected (also calls `command.onRun`). */
+    onCommand?: (command: NiceCommandBarCommand) => void;
+    /** Search placeholder. */
+    placeholder?: string;
+    /**
+     * Optional keyboard shortcut that opens the palette. Pass any
+     * combo like `'Ctrl+K'`, `'Meta+P'`. Order-insensitive (`'K+Ctrl'`
+     * also works); modifiers: `Ctrl`/`Meta`/`Shift`/`Alt`.
+     */
+    shortcut?: string;
+}
+
 export declare interface NiceCommandPaletteContextValue {
     registerCommand: (command: NiceCommand) => void;
     unregisterCommand: (id: string) => void;
@@ -9021,7 +9482,7 @@ declare interface NiceConditionalFormatRule {
 export declare const NiceConfirmDialog: default_2.FC<NiceConfirmDialogProps>;
 
 /** Props for the {@link NiceConfirmDialog} component — a confirmation modal with accept / reject buttons. */
-export declare interface NiceConfirmDialogProps extends NiceBaseProps {
+export declare interface NiceConfirmDialogProps extends NiceStandardProps {
     /** Size variant. */
     size?: NiceSize;
     /** Whether the dialog is visible. */
@@ -9257,6 +9718,32 @@ export declare interface NiceContactPickerProps extends NiceFormFieldProps {
     maxSelections?: number;
 }
 
+/**
+ * Centred page-content wrapper with a width cap by tier. Use for
+ * page outer chrome / hero sections / article bodies.
+ */
+export declare const NiceContainer: default_2.FC<NiceContainerProps>;
+
+/**
+ * Props for {@link NiceContainer} — page-content centering wrapper.
+ *
+ * `size` is omitted from the base bag because here it's a width
+ * preset (`sm`…`xl`), not a density token.
+ */
+export declare interface NiceContainerProps extends Omit<NiceStandardProps, 'size'> {
+    children: default_2.ReactNode;
+    /** Max-width preset. `'full'` removes the cap entirely. */
+    size?: NiceContainerSize;
+    /** Horizontal padding (number → px, string → raw CSS). */
+    padding?: number | string;
+    /** Auto-center horizontally via `margin-inline: auto`. Default `true`. */
+    centered?: boolean;
+    /** Force the container to consume full width regardless of `size`. */
+    fluid?: boolean;
+}
+
+export declare type NiceContainerSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+
 export declare const NiceContextMenu: default_2.FC<NiceContextMenuProps>;
 
 /** Props for the {@link NiceContextMenu} component — a right-click popup menu attached to a target element. */
@@ -9319,7 +9806,7 @@ export declare type NiceCookieCategory = 'necessary' | 'analytics' | 'marketing'
 export declare const NiceCookieConsent: ForwardRefExoticComponent<NiceCookieConsentProps & RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceCookieConsent} component — a GDPR-style cookie consent banner with category toggles. */
-export declare interface NiceCookieConsentProps extends NiceBaseProps {
+export declare interface NiceCookieConsentProps extends NiceStandardProps {
     /** Show the banner when `true`. */
     visible?: boolean;
     /** Called when the user accepts all categories. */
@@ -9342,8 +9829,57 @@ export declare interface NiceCookieConsentProps extends NiceBaseProps {
     showDetails?: boolean;
 }
 
+/**
+ * Single-click clipboard copy with timed "Copied!" feedback. Uses the
+ * async Clipboard API where available and falls back to legacy
+ * `document.execCommand('copy')` so it works in older / non-secure
+ * contexts (test pages, Electron, etc.).
+ *
+ * The success label and default body text both run through
+ * `useNiceTranslation`, so the button follows the global locale
+ * without any prop wiring.
+ */
+export declare const NiceCopyButton: default_2.FC<NiceCopyButtonProps>;
+
+/** Props for {@link NiceCopyButton} — click-to-clipboard with timed feedback. */
+export declare interface NiceCopyButtonProps extends Omit<NiceStandardProps, 'variant'> {
+    /** Text payload that gets copied. */
+    text: string;
+    /** Optional button content. Defaults to "Copy" / a clipboard glyph based on variant. */
+    children?: default_2.ReactNode;
+    /** Fires on successful copy with the same text that landed on the clipboard. */
+    onCopy?: (text: string) => void;
+    /**
+     * Label shown briefly after a successful copy. Defaults to the
+     * translated `copy.success` ("Copied!") so it follows the global
+     * language picker.
+     */
+    successMessage?: string;
+    /** How long the success state stays visible, in ms. */
+    timeout?: number;
+    /** Visual variant — `'icon'` renders a compact icon-only button. */
+    variant?: NiceCopyButtonVariant;
+}
+
+export declare type NiceCopyButtonVariant = 'button' | 'icon';
+
+/**
+ * Counts down to `targetDate`. Updates once per second via a single
+ * shared interval. When time runs out the display freezes at zero
+ * and `onComplete` fires exactly once.
+ *
+ * Labels for the `full` format go through `useNiceTranslation`
+ * (`countdown.days` / `.hours` / `.minutes` / `.seconds`) so the
+ * countdown follows the global language picker. The whole region
+ * also carries `aria-live="polite"` so screen readers announce the
+ * remaining time changes without interrupting.
+ */
+export declare const NiceCountdown: default_2.FC<NiceCountdownProps>;
+
+export declare type NiceCountdownFormat = 'full' | 'compact' | 'minimal';
+
 /** Built-in countdown format presets. */
-declare type NiceCountdownFormat = 
+declare type NiceCountdownFormat_2 = 
 /** `1d 02:34:15` / `02:34:15` — leading day count + clock */
 'verbose'
 /** `1d 2h 34m 15s` — abbreviated units */
@@ -9355,6 +9891,35 @@ declare type NiceCountdownFormat =
 /** `1 day, 2 hours, 34 minutes` — verbose words */
 | 'words';
 
+/** Optional label overrides for the four time units. */
+export declare interface NiceCountdownLabels {
+    days?: string;
+    hours?: string;
+    minutes?: string;
+    seconds?: string;
+}
+
+/** Props for {@link NiceCountdown} — live countdown to a target Date. */
+export declare interface NiceCountdownProps extends NiceStandardProps {
+    /** Target instant. Component re-renders every second until this time. */
+    targetDate: Date;
+    /** Fires once when the countdown reaches zero or below. */
+    onComplete?: () => void;
+    /**
+     * Display variant:
+     *  - `full` — label per unit (`2 days 3 hours …`)
+     *  - `compact` — digits + single-letter labels (`2d 3h 4m 5s`)
+     *  - `minimal` — `HH:MM:SS` style (drops days when not shown)
+     */
+    format?: NiceCountdownFormat;
+    showDays?: boolean;
+    showHours?: boolean;
+    showMinutes?: boolean;
+    showSeconds?: boolean;
+    /** Override labels for the `full` format. Falls back to translated values. */
+    labels?: NiceCountdownLabels;
+}
+
 export declare const NiceCountryPicker: default_2.FC<NiceCountryPickerProps>;
 
 export declare interface NiceCountryPickerProps extends NiceFormFieldProps, DualVisibilityProps {
@@ -9394,6 +9959,12 @@ export declare interface NiceCountryPickerProps extends NiceFormFieldProps, Dual
      * false (except flag) and ignoring `controlWidth`. Default: false.
      */
     compact?: boolean;
+    /**
+     * Visual variant. `'ghost'` removes border, background and the dropdown
+     * arrow — only the flag/icon is shown. Designed for dense toolbars
+     * (e.g. NiceTopNav narrow mode). Default: `'default'`.
+     */
+    variant?: 'default' | 'ghost';
     /**
      * Dropdown horizontal alignment relative to the trigger. `'auto'` picks
      * the side with more available viewport space (right-edge preferred).
@@ -9412,6 +9983,35 @@ export declare interface NiceCountryPickerProps extends NiceFormFieldProps, Dual
     'data-testid'?: string;
 }
 
+/**
+ * Tween a number from `start` to `end` over `duration` seconds using
+ * `requestAnimationFrame` and an ease-out cubic curve. The DOM is
+ * updated via local state on each frame; live values use the original
+ * `end` for `aria-label` so assistive tech reads the destination
+ * value once instead of every intermediate tick.
+ */
+export declare const NiceCountUp: default_2.FC<NiceCountUpProps>;
+
+/** Props for {@link NiceCountUp} — animated counter from `start` → `end`. */
+export declare interface NiceCountUpProps extends NiceStandardProps {
+    /** End value (required). */
+    end: number;
+    /** Starting value. Defaults to 0. */
+    start?: number;
+    /** Animation duration in **seconds**. */
+    duration?: number;
+    /** Decimal places to render (toFixed). */
+    decimals?: number;
+    /** Prefix glyph / currency symbol. */
+    prefix?: string;
+    /** Suffix glyph (e.g. `'%'`). */
+    suffix?: string;
+    /** Thousands separator passed to `Number.toLocaleString` via locale formatting. */
+    separator?: string;
+    /** Fires once after the tween reaches `end`. */
+    onComplete?: () => void;
+}
+
 export declare const NiceCropEditor: default_2.FC<NiceCropEditorProps>;
 
 export declare interface NiceCropEditorProps {
@@ -9534,6 +10134,15 @@ export { NiceCursorPaginationConfig }
 
 export { NiceCustomDataSourceHandlers }
 
+/** A user-defined harmony scheme (hue angles + optional lightness offsets). */
+declare interface NiceCustomHarmonyScheme {
+    id: string;
+    name: string;
+    angles: number[];
+    /** Optional per-color lightness deltas applied on top of preset/base V. */
+    lightnessOffsets?: number[];
+}
+
 export declare const NiceDashboardLayout: default_2.ForwardRefExoticComponent<NiceDashboardLayoutProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceDashboardLayout} component — a CSS-grid dashboard with draggable, resizable panels. */
@@ -10267,12 +10876,14 @@ export declare interface NiceDisplayStylePickerProps extends NiceBaseProps {
     label?: string;
     /** Filter to show only specific styles. */
     styles?: NiceDisplayStyle[];
+    /** Compact mode — forces dropdown layout for tight spaces. */
+    compact?: boolean;
 }
 
 export declare const NiceDivider: default_2.FC<NiceDividerProps>;
 
 /** Props for the {@link NiceDivider} component — a horizontal/vertical separator line with optional text. */
-export declare interface NiceDividerProps extends NiceBaseProps {
+export declare interface NiceDividerProps extends NiceStandardProps {
     /** Divider size (controls thickness and spacing). */
     size?: NiceSize;
     /** Render the divider vertically. */
@@ -10637,7 +11248,7 @@ export declare interface NiceDraggableProps extends NiceBaseProps {
 export declare const NiceDrawer: default_2.FC<NiceDrawerProps>;
 
 /** Props for the {@link NiceDrawer} component — a slide-in panel from any edge. */
-export declare interface NiceDrawerProps extends NiceBaseProps {
+export declare interface NiceDrawerProps extends NiceStandardProps {
     /** Whether the drawer is open. */
     open: boolean;
     /** Called when the user requests to close. */
@@ -10658,7 +11269,7 @@ export declare interface NiceDrawerProps extends NiceBaseProps {
 
 export declare const NiceDrillDownChart: default_2.ForwardRefExoticComponent<NiceDrillDownChartProps & default_2.RefAttributes<NiceDrillDownChartRef>>;
 
-export declare interface NiceDrillDownChartProps extends NiceBaseProps {
+export declare interface NiceDrillDownChartProps extends NiceStandardProps {
     /** Poziomy danych do drill-down */
     levels: DrillDownLevel[];
     /** Początkowy poziom */
@@ -10854,7 +11465,7 @@ export declare interface NiceEmojiPickerProps {
 export declare const NiceEmpty: default_2.FC<NiceEmptyProps>;
 
 /** Props for the {@link NiceEmpty} component — a placeholder shown when there is no data to display. */
-export declare interface NiceEmptyProps extends NiceBaseProps {
+export declare interface NiceEmptyProps extends NiceStandardProps {
     /** Component size. */
     size?: NiceSize;
     /** Custom icon element rendered above the title. */
@@ -11071,7 +11682,7 @@ declare interface NiceExportStyles {
 
 export declare const NiceFAQ: default_2.FC<NiceFAQProps>;
 
-export declare interface NiceFAQProps extends NiceBaseProps {
+export declare interface NiceFAQProps extends NiceStandardProps {
     /** Size variant */
     size?: NiceSize;
     /** FAQ items */
@@ -11342,6 +11953,15 @@ export declare interface NiceFileManagerProps extends NiceBaseProps {
 /** Active panel identifier for dual-pane {@link NiceFileManager}. */
 export declare type NiceFilePanel = 'left' | 'right';
 
+/**
+ * Visual wrapper around the native `<input type="file">`. The actual
+ * `<input>` is rendered visually-hidden (still focusable + screen-
+ * reader-readable) and a styled `<button>` proxies clicks via the
+ * `useRef` handle — that way consumers can drop in any React node as
+ * the trigger without losing OS native file dialog behaviour.
+ */
+export declare const NiceFilePicker: default_2.FC<NiceFilePickerProps>;
+
 export declare const NiceFilePickerButton: default_2.FC<NiceFilePickerButtonProps>;
 
 export declare interface NiceFilePickerButtonProps extends NiceBaseProps {
@@ -11352,6 +11972,28 @@ export declare interface NiceFilePickerButtonProps extends NiceBaseProps {
     children?: default_2.ReactNode;
 }
 
+/** Props for {@link NiceFilePicker} — visually-customisable file input. */
+export declare interface NiceFilePickerProps extends NiceStandardProps {
+    /** MIME types / extensions accepted (e.g. `"image/*,.pdf"`). */
+    accept?: string;
+    /** Allow selecting multiple files. */
+    multiple?: boolean;
+    /** Disable the picker. */
+    disabled?: boolean;
+    /**
+     * Camera capture mode for mobile (`"user"` = front, `"environment"`
+     * = rear). Ignored on desktop.
+     */
+    capture?: 'user' | 'environment';
+    /**
+     * Custom trigger content. When omitted, a default labelled button
+     * is rendered with the translated label.
+     */
+    children?: default_2.ReactNode;
+    /** Fires with the selected files. */
+    onChange?: (files: FileList) => void;
+}
+
 /** Current sort state for the {@link NiceFileManager}. */
 export declare interface NiceFileSort {
     /** Sort field. */
@@ -11507,6 +12149,32 @@ export declare interface NiceFilterState {
     [key: string]: unknown;
 }
 
+/**
+ * Direct flexbox wrapper. Use this when you need explicit control of
+ * direction/wrap/justify/align — for the more opinionated "row OR
+ * column with uniform gap" use case reach for {@link NiceStack}.
+ */
+export declare const NiceFlex: default_2.FC<NiceFlexProps>;
+
+export declare type NiceFlexDirection = 'row' | 'column' | 'row-reverse' | 'column-reverse';
+
+/** Props for {@link NiceFlex} — thin flexbox container with sensible defaults. */
+export declare interface NiceFlexProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    direction?: NiceFlexDirection;
+    wrap?: NiceFlexWrap;
+    /** Any CSS `justify-content` value. */
+    justify?: default_2.CSSProperties['justifyContent'];
+    /** Any CSS `align-items` value. */
+    align?: default_2.CSSProperties['alignItems'];
+    /** Gap between flex items. Number → pixels, string → raw CSS value. */
+    gap?: number | string;
+    /** Render as `inline-flex` instead of `flex`. */
+    inline?: boolean;
+}
+
+export declare type NiceFlexWrap = 'nowrap' | 'wrap' | 'wrap-reverse';
+
 export declare const NiceFloorPlanCanvas: default_2.FC<NiceFloorPlanCanvasProps>;
 
 /**
@@ -11531,6 +12199,70 @@ export declare interface NiceFloorPlanCanvasProps extends NiceBaseProps {
     animateStateChanges?: boolean;
 }
 
+/**
+ * Cycles Tab / Shift+Tab between the first and last focusable
+ * descendants. Use inside modals, dialogs, drawers — anywhere
+ * keyboard focus must not "leak" to the rest of the document.
+ */
+export declare const NiceFocusTrap: default_2.FC<NiceFocusTrapProps>;
+
+/** Props for {@link NiceFocusTrap} — keep keyboard focus inside a container. */
+export declare interface NiceFocusTrapProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    /** When `false` the trap is dormant — children behave like a normal container. */
+    active?: boolean;
+    /**
+     * Initial focus target. A ref points at a specific element; a CSS
+     * selector (string) lets you pick declaratively (e.g. `'[autofocus]'`,
+     * `'input'`).
+     */
+    initialFocus?: default_2.RefObject<HTMLElement | null> | string;
+    /** Restore focus to the previously-focused element when the trap deactivates. */
+    returnFocus?: boolean;
+}
+
+/**
+ * Semantic `<footer>` with native `contentinfo` landmark. Link groups
+ * render as `<nav>` lists for AT navigation; social icons get
+ * explicit accessible labels (the `icon` glyph itself is decorative).
+ */
+export declare const NiceFooter: default_2.FC<NiceFooterProps>;
+
+export declare interface NiceFooterLink {
+    label: default_2.ReactNode;
+    href: string;
+    /** Add `target="_blank"` + `rel="noopener noreferrer"`. */
+    external?: boolean;
+}
+
+export declare interface NiceFooterLinkGroup {
+    title: default_2.ReactNode;
+    items: NiceFooterLink[];
+}
+
+/** Props for {@link NiceFooter} — page footer with link groups, copyright, social. */
+export declare interface NiceFooterProps extends NiceStandardProps {
+    /** Free-form content rendered above the link groups. */
+    children?: default_2.ReactNode;
+    /** Columns of related links. */
+    links?: NiceFooterLinkGroup[];
+    /** Copyright / legal line at the bottom. */
+    copyright?: default_2.ReactNode;
+    /** Social icons rendered next to the copyright. */
+    social?: NiceFooterSocialLink[];
+    /** When true, footer sticks to the bottom of the viewport (`position: sticky`). */
+    sticky?: boolean;
+}
+
+export declare interface NiceFooterSocialLink {
+    /** Glyph / icon node. */
+    icon: default_2.ReactNode;
+    /** Destination URL. */
+    href: string;
+    /** Accessible label (e.g. `'Twitter'`). Required for a11y. */
+    label: string;
+}
+
 /**
  * NiceForecastChart — Time series chart with forecast and confidence intervals.
  *
@@ -11564,7 +12296,7 @@ export declare const NiceForecastChart: default_2.ForwardRefExoticComponent<Nice
 /**
  * Props for NiceForecastChart component.
  */
-export declare interface NiceForecastChartProps extends NiceBaseProps {
+export declare interface NiceForecastChartProps extends NiceStandardProps {
     /** Scenarios to display */
     scenarios?: ForecastScenario[];
     /** Convenience flat data series — wrapped into a single scenario when `scenarios` is omitted. */
@@ -11749,7 +12481,7 @@ export declare interface NiceFunnelItem {
 }
 
 /** Props for the {@link NiceFunnel} component — an SVG funnel / pyramid chart. */
-export declare interface NiceFunnelProps extends NiceBaseProps {
+export declare interface NiceFunnelProps extends NiceStandardProps {
     /** Funnel stage data. */
     data: NiceFunnelItem[];
     /** SVG width in px. */
@@ -11781,7 +12513,7 @@ export declare interface NiceGalleryItem {
 }
 
 /** Props for the {@link NiceGallery} component — an image gallery with thumbnails, autoplay, and lightbox navigation. */
-export declare interface NiceGalleryProps extends NiceBaseProps {
+export declare interface NiceGalleryProps extends NiceStandardProps {
     /** Gallery images. */
     items: NiceGalleryItem[];
     /** Currently selected image index. */
@@ -12123,7 +12855,39 @@ export declare interface NiceGradientValue {
 
 export { NiceGraphQLConfig }
 
-export declare type NiceHarmonyMode = 'monochromatic' | 'complementary' | 'split-complementary' | 'analogous' | 'triadic' | 'tetradic' | 'square' | 'custom';
+export declare type NiceHarmonyMode = 'monochromatic' | 'complementary' | 'split-complementary' | 'analogous' | 'triadic' | 'tetradic' | 'square' | 'shade-chain' | 'custom';
+
+/**
+ * Semantic heading with decoupled visual scale. Renders the correct
+ * native `<h1>`…`<h6>` for screen readers and outline tools, while
+ * letting designers pick any visual size independently.
+ */
+export declare const NiceHeading: default_2.FC<NiceHeadingProps>;
+
+export declare type NiceHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+
+/**
+ * Props for {@link NiceHeading}.
+ *
+ * `size` is omitted from the standard prop bag because we use a wider
+ * scale (`xs`…`3xl`) than `NiceSize`, and the meaning here is
+ * "typographic scale", not "density".
+ */
+export declare interface NiceHeadingProps extends Omit<NiceStandardProps, 'size'> {
+    children: default_2.ReactNode;
+    /** Semantic heading level — renders `h1`…`h6`. Required for accessibility. */
+    level: NiceHeadingLevel;
+    /** Visual size scale. Decouples styling from semantic level (use this to render an `h1` that looks like an `h3`). */
+    size?: NiceHeadingSize;
+    /** Font weight. */
+    weight?: NiceHeadingWeight;
+    /** Single-line truncate overflow with ellipsis. */
+    truncate?: boolean;
+}
+
+export declare type NiceHeadingSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
+
+export declare type NiceHeadingWeight = 'normal' | 'medium' | 'semibold' | 'bold';
 
 /** Single health check finding. */
 export declare interface NiceHealthFinding {
@@ -12150,7 +12914,7 @@ export declare interface NiceHealthReport {
 export declare const NiceHeatMap: default_2.ForwardRefExoticComponent<NiceHeatMapProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceHeatMap} component — a 2D color-intensity grid with optional cell click. */
-export declare interface NiceHeatMapProps extends NiceBaseProps {
+export declare interface NiceHeatMapProps extends NiceStandardProps {
     /** 2D data matrix (rows × cols). */
     data: number[][];
     /** Column header labels. */
@@ -12234,6 +12998,34 @@ export { NiceHelpProvider }
 
 export { NiceHelpProviderProps }
 
+/**
+ * Renders `text` with every occurrence of `query` (or any of the
+ * queries when `query` is an array) wrapped in `<mark>` (or a custom
+ * tag). Pure render, no DOM mutation — safe to use in lists / virtual
+ * scrollers.
+ */
+export declare const NiceHighlight: default_2.FC<NiceHighlightProps>;
+
+/** Props for {@link NiceHighlight} — wraps query matches inside a body of text. */
+export declare interface NiceHighlightProps extends NiceStandardProps {
+    /** Source text. Non-string children are not supported by design; pass a string. */
+    text: string;
+    /**
+     * Query (or queries) to highlight. Empty / whitespace-only queries
+     * are silently ignored so callers don't have to gate the prop.
+     */
+    query: string | string[];
+    /**
+     * Tag used to wrap each match. Defaults to `<mark>` (semantic
+     * highlight). Pass `'span'` for visual-only highlighting.
+     */
+    highlightTag?: default_2.ElementType;
+    /** Extra className applied to every highlight wrapper. */
+    highlightClassName?: string;
+    /** When `true`, matches respect letter case (default: case-insensitive). */
+    caseSensitive?: boolean;
+}
+
 /** Configuration for the hot-swap manager. */
 export declare interface NiceHotSwapConfig {
     /** Module import resolver. */
@@ -12507,7 +13299,7 @@ export declare type NiceImageEditorTool = 'crop' | 'rotate' | 'flip' | 'brightne
 export declare const NiceImageViewer: default_2.ForwardRefExoticComponent<NiceImageViewerProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceImageViewer} component — an image with lightbox preview, zoom, pan, and rotation. */
-export declare interface NiceImageViewerProps extends NiceBaseProps {
+export declare interface NiceImageViewerProps extends NiceStandardProps {
     /** Image source URL. */
     src: string;
     /** Alt text. */
@@ -12952,6 +13744,12 @@ export declare interface NiceLanguagePickerProps extends NiceFormFieldProps, Dua
      * dropdown alignment. Default: false.
      */
     compact?: boolean;
+    /**
+     * Visual variant. `'ghost'` removes border, background and the dropdown
+     * arrow — only the flag is shown. Designed for dense toolbars
+     * (e.g. NiceTopNav narrow mode). Default: `'default'`.
+     */
+    variant?: 'default' | 'ghost';
     /**
      * Dropdown horizontal alignment relative to trigger. `'auto'` picks the
      * side with more available viewport space. Default: `'auto'` in compact
@@ -12972,6 +13770,38 @@ export declare interface NiceLanguagePickerProps extends NiceFormFieldProps, Dua
     'data-testid'?: string;
 }
 
+/**
+ * App-shell layout with native landmark elements. Renders as:
+ *
+ *   <header>            ← if `header`
+ *   <div>
+ *     <aside>           ← if `sider`
+ *     <main>            ← always
+ *   </div>
+ *   <footer>            ← if `footer`
+ *
+ * Each slot maps to a native HTML5 landmark so the DOM is correct
+ * for accessibility tools without any extra ARIA roles.
+ */
+export declare const NiceLayout: default_2.FC<NiceLayoutProps>;
+
+/** Props for {@link NiceLayout} — app shell: header / sider / main / footer. */
+export declare interface NiceLayoutProps extends NiceStandardProps {
+    /** Main content (rendered inside `<main>`). */
+    children: default_2.ReactNode;
+    /** Top header (rendered inside `<header>`). */
+    header?: default_2.ReactNode;
+    /** Bottom footer (rendered inside `<footer>`). */
+    footer?: default_2.ReactNode;
+    /**
+     * Side navigation (rendered inside `<aside>`). Defaults to the
+     * inline-start side of the viewport in LTR contexts.
+     */
+    sider?: default_2.ReactNode;
+    /** Place the sider on the inline-end side instead of start. */
+    siderPlacement?: 'start' | 'end';
+}
+
 /**
  * {@link NiceLeaderboard} — Ranked list of players/entities with scores, deltas, avatars, and stat columns.
  */
@@ -13008,10 +13838,56 @@ export declare interface NiceLeaderboardProps {
     id?: string;
 }
 
+/**
+ * Modal image viewer. Renders a full-screen overlay with prev/next
+ * navigation, optional zoom + download buttons, and a counter.
+ * Keyboard:
+ *   - Left / Right — previous / next image
+ *   - Escape — close
+ *   - `+` / `-` — zoom in / out (when `zoom` is enabled)
+ *
+ * All toolbar button labels go through `useNiceTranslation` so the
+ * viewer follows the global picker.
+ */
+export declare const NiceLightbox: default_2.FC<NiceLightboxProps>;
+
+export declare interface NiceLightboxImage {
+    /** Image source URL. */
+    src: string;
+    /** Alt text — required for accessibility. */
+    alt: string;
+    /** Optional caption rendered below the image. */
+    caption?: default_2.ReactNode;
+    /** Optional full-resolution download URL (defaults to `src`). */
+    downloadUrl?: string;
+}
+
+/** Props for {@link NiceLightbox} — full-screen image viewer. */
+export declare interface NiceLightboxProps extends NiceStandardProps {
+    /** Controlled visibility. */
+    open: boolean;
+    /** Image gallery to navigate between. */
+    images: NiceLightboxImage[];
+    /** Currently shown image (controlled). */
+    index?: number;
+    /** Default index when the viewer first opens (uncontrolled). */
+    defaultIndex?: number;
+    /** Fires when the user navigates between images. */
+    onIndexChange?: (index: number) => void;
+    /** Fires when the user closes the viewer (Escape, backdrop, X button). */
+    onClose: () => void;
+    /** Enable scroll-wheel + button zoom. */
+    zoom?: boolean;
+    /** Show a download button in the toolbar. */
+    download?: boolean;
+    /** Render `N / M` counter in the toolbar. */
+    counter?: boolean;
+}
+
 export declare const NiceLinearGauge: default_2.FC<NiceLinearGaugeProps>;
 
 /** Props for the {@link NiceLinearGauge} component — a horizontal or vertical bar gauge with ticks and colored ranges. */
-export declare interface NiceLinearGaugeProps extends NiceBaseProps {
+export declare interface NiceLinearGaugeProps extends NiceStandardProps {
     /** Current gauge value. */
     value: number;
     /** Minimum scale value. */
@@ -13042,6 +13918,41 @@ export declare interface NiceLinearGaugeProps extends NiceBaseProps {
     tickCount?: number;
 }
 
+/**
+ * Styled `<a>` with safe defaults — when `external` is set we always
+ * apply `rel="noopener noreferrer"` so that opened tabs cannot
+ * window.opener-back-reference the parent. Authors can still override
+ * `rel`/`target` for cases where that's intentional.
+ */
+export declare const NiceLink: default_2.FC<NiceLinkProps>;
+
+/** Props for {@link NiceLink} — styled anchor with safe defaults for external targets. */
+export declare interface NiceLinkProps extends Omit<NiceStandardProps, 'variant'> {
+    children: default_2.ReactNode;
+    /** Target URL. */
+    href: string;
+    /**
+     * Treat as an external link — adds `target="_blank"` plus
+     * `rel="noopener noreferrer"` automatically. Override either by
+     * passing your own `target` / `rel` explicitly.
+     */
+    external?: boolean;
+    /** Visual variant. */
+    variant?: NiceLinkVariant;
+    /** Underline behaviour. */
+    underline?: NiceLinkUnderline;
+    /** Click handler (use for analytics; the native anchor still navigates). */
+    onClick?: default_2.MouseEventHandler<HTMLAnchorElement>;
+    /** Override the auto-derived `target`. */
+    target?: string;
+    /** Override the auto-derived `rel`. */
+    rel?: string;
+}
+
+export declare type NiceLinkUnderline = 'always' | 'hover' | 'none';
+
+export declare type NiceLinkVariant = 'default' | 'subtle' | 'muted';
+
 export declare const NiceList: default_2.FC<NiceListProps>;
 
 /** An item in the {@link NiceList} component. */
@@ -13108,7 +14019,7 @@ export declare interface NiceListProps extends NiceBaseProps {
 export declare const NiceLiveChart: default_2.ForwardRefExoticComponent<NiceLiveChartProps & default_2.RefAttributes<NiceLiveChartRef>>;
 
 /** Props for NiceLiveChart component. */
-export declare interface NiceLiveChartProps extends NiceBaseProps {
+export declare interface NiceLiveChartProps extends NiceStandardProps {
     /** Series configuration. Each series receives its own data stream. */
     series: NiceLiveChartSeriesConfig[];
     /** Maximum number of data points to keep per series. Default: 100. */
@@ -13279,6 +14190,32 @@ export declare interface NiceLiveDataGridRef<T extends LiveGridRow = LiveGridRow
     getConnectionStatus: () => ConnectionStatus;
 }
 
+/**
+ * Announces dynamic updates to assistive technology. Wrap any region
+ * whose content changes outside a normal user action — search-result
+ * count, form save status, async loading messages — and AT will
+ * speak the new content according to `politeness`.
+ *
+ * Defaults to visually-hidden so consumers don't need to think about
+ * presentation when they just want the announcement.
+ */
+export declare const NiceLiveRegion: default_2.FC<NiceLiveRegionProps>;
+
+export declare type NiceLiveRegionPoliteness = 'polite' | 'assertive' | 'off';
+
+/** Props for {@link NiceLiveRegion} — visually-hidden ARIA live region. */
+export declare interface NiceLiveRegionProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    /** Politeness level — `polite` waits for idle, `assertive` interrupts. */
+    politeness?: NiceLiveRegionPoliteness;
+    /** When `true`, AT reads the whole region after a change; otherwise only the diff. */
+    atomic?: boolean;
+    /** `aria-relevant` value — space-separated tokens (`'additions text'` etc.). */
+    relevant?: string;
+    /** Render visibly (skip the visually-hidden CSS). Useful for status bars where the message is visual too. */
+    visible?: boolean;
+}
+
 /** Resolved module with its lazy components. */
 export declare interface NiceLoadedModule {
     manifest: NiceModuleManifest;
@@ -13435,7 +14372,7 @@ export declare interface NiceLockButtonProps extends NiceBaseProps {
 export declare const NiceLoginForm: ForwardRefExoticComponent<NiceLoginFormProps & RefAttributes<HTMLFormElement>>;
 
 /** Props for the {@link NiceLoginForm} component — a pre-built login form with username, password, remember-me, and social links. */
-export declare interface NiceLoginFormProps extends NiceBaseProps {
+export declare interface NiceLoginFormProps extends NiceStandardProps {
     /** Called with credentials on form submit. */
     onSubmit?: (credentials: {
         username: string;
@@ -13641,7 +14578,7 @@ export declare const NiceMap: default_2.ForwardRefExoticComponent<NiceMapProps &
 
 export declare const NiceMapChart: default_2.FC<NiceMapChartProps>;
 
-export declare interface NiceMapChartProps extends NiceBaseProps {
+export declare interface NiceMapChartProps extends NiceStandardProps {
     /** Typ mapy */
     type?: 'choropleth' | 'bubble' | 'heat';
     /** Regiony mapy (dla choropleth) */
@@ -13877,6 +14814,29 @@ export declare interface NiceMealPlanProps extends NiceBaseProps {
     readOnly?: boolean;
 }
 
+/**
+ * Classic "media object" pattern from CSS Tricks / Bootstrap: a fixed
+ * media block on one side and free-flowing content on the other.
+ * Useful for chat rows, contact cards, notification items.
+ */
+export declare const NiceMediaObject: default_2.FC<NiceMediaObjectProps>;
+
+export declare type NiceMediaObjectAlign = 'start' | 'center' | 'end';
+
+/** Props for {@link NiceMediaObject} — image-with-content row layout. */
+export declare interface NiceMediaObjectProps extends NiceStandardProps {
+    /** Media element (`<img>`, `<video>`, avatar, icon, …). */
+    media: default_2.ReactNode;
+    /** Adjacent content (typically text). */
+    children: default_2.ReactNode;
+    /** Which side the media sits on. */
+    mediaPosition?: 'start' | 'end';
+    /** Vertical alignment of media vs content. */
+    align?: NiceMediaObjectAlign;
+    /** Gap between media and content. Number → px. */
+    spacing?: number | string;
+}
+
 export declare const NiceMention: default_2.ForwardRefExoticComponent<NiceMentionProps & default_2.RefAttributes<HTMLTextAreaElement>>;
 
 /** Props for the {@link NiceMention} component — a textarea with @mention triggers and suggestion popup. */
@@ -14030,6 +14990,12 @@ export declare interface NiceMenuProps extends NiceBaseProps {
     renderTriggerLabel?: (item: NiceMenuItem) => default_2.ReactNode;
     /** Optional renderer for panel-entry label. */
     renderEntryLabel?: (item: NiceMenuItem) => default_2.ReactNode;
+    /**
+     * Maximum depth of nested flyouts rendered. `1` = top-level only, `2` = level-1 panel,
+     * `3` = level-2 subpanel (default — preserves legacy behavior), up to `10`. Items with
+     * `children` beyond this depth are rendered as leaves (no flyout arrow, no hover-open).
+     */
+    maxDepth?: number;
 }
 
 /**
@@ -14080,7 +15046,7 @@ export declare interface NiceMergeRequestBuilderProps extends NiceBaseProps {
 export declare const NiceModal: default_2.FC<NiceModalProps>;
 
 /** Props for the {@link NiceModal} component — a dialog overlay with focus trapping. */
-export declare interface NiceModalProps extends NiceBaseProps {
+export declare interface NiceModalProps extends NiceStandardProps {
     /** Whether the modal is currently visible. */
     open: boolean;
     /** Called when the user requests to close the modal. */
@@ -14701,6 +15667,11 @@ export declare const NiceNavShell: ForwardRefExoticComponent<NiceNavShellProps &
 export declare interface NiceNavShellApi {
     activeRoute: string | undefined;
     tabs: NiceNavShellTab[];
+    /** True when the shell is in narrow/mobile layout (viewport ≤ `mobileBreakpoint`
+     *  or `forceMobileLayout`). Render-prop slot consumers should forward this to
+     *  any embedded `NiceTopNav` (`forceMobileLayout={isMobile}`) so the hamburger
+     *  switch happens at the same width the sidebar disappears. */
+    isMobile: boolean;
     openRoute: (route: string, opts?: Partial<NiceNavShellTab>) => void;
     closeTab: (id: string) => void;
     closeOthers: (id: string) => void;
@@ -14724,6 +15695,31 @@ export declare interface NiceNavShellProps {
     topNavProps?: NiceTopNavProps;
     /** Sidebar navigation slot. */
     sidebar?: Slot;
+    /**
+     * Shared navigation model. When provided, the shell renders an internal
+     * `NiceSidebarNav` in the sidebar slot (unless an explicit `sidebar` slot
+     * is given) AND forwards the same model to the embedded mobile hamburger
+     * inside `NiceTopNav`. This guarantees one source of truth for both layouts.
+     */
+    sidebarData?: SidebarNavDataNode[];
+    /** User id forwarded to NiceSidebarNav (preferences scope). */
+    sidebarUserId?: string;
+    /** Active route highlighted in the sidebar (defaults to `activeRoute`). */
+    sidebarActiveRoute?: string;
+    /** Fired when a view is clicked anywhere in the sidebar (desktop or mobile). */
+    onSidebarNavigate?: (route: string, view: SidebarNavView) => void;
+    /**
+     * Viewport breakpoint (px). At or below this width, the desktop sidebar is
+     * hidden and the navigation is delegated to the top-nav hamburger drawer
+     * (which uses the same `sidebarData`). Default `720` — matches
+     * `NiceTopNav`'s own `mobileBreakpoint` so the sidebar disappears at the
+     * exact same width the hamburger appears (no dead zone where neither is
+     * visible). Override on BOTH components together if you need a different
+     * value.
+     */
+    mobileBreakpoint?: number;
+    /** Force the shell into the mobile layout regardless of viewport. */
+    forceMobileLayout?: boolean;
     /** Map of route → content (ReactNode or factory). */
     routes: Record<string, ReactNode | (() => ReactNode)>;
     /** Initial / default route (used when uncontrolled). */
@@ -14976,6 +15972,12 @@ export declare interface NiceNotificationsProps {
     badgeMax?: number;
     /** Size variant of the trigger. */
     size?: 'sm' | 'md' | 'lg';
+    /**
+     * Visual variant. `'ghost'` removes border, background and hover-border
+     * — only the bell icon (with badge) is shown. Designed for dense toolbars
+     * (e.g. NiceTopNav narrow mode). Default: `'default'`.
+     */
+    variant?: 'default' | 'ghost';
     className?: string;
     style?: default_2.CSSProperties;
     id?: string;
@@ -15032,11 +16034,54 @@ export declare interface NiceNumberInputProps extends NiceFormFieldProps {
     onSuffixChange?: (value: string, prevWeight: number | undefined, newWeight: number | undefined) => void;
 }
 
+/**
+ * Numeric input with optional +/- step buttons, clamping, and a
+ * pluggable display formatter. The displayed text is a derived view
+ * — internal value stays a clean `number` so consumers don't have to
+ * parse it back from a formatted string.
+ *
+ * Increment / decrement button labels go through `useNiceTranslation`
+ * so they follow the global language picker.
+ */
+export declare const NiceNumericInput: default_2.FC<NiceNumericInputProps>;
+
+/** Props for {@link NiceNumericInput} — clampable number field with step buttons. */
+export declare interface NiceNumericInputProps extends NiceStandardProps {
+    /** Controlled value. */
+    value?: number;
+    /** Default value (uncontrolled). */
+    defaultValue?: number;
+    /** Fires on every change. */
+    onChange?: (value: number) => void;
+    /** Lower clamp. */
+    min?: number;
+    /** Upper clamp. */
+    max?: number;
+    /** Increment / decrement step applied by the +/- buttons. */
+    step?: number;
+    /** Decimal places — applied via `toFixed` when rendering. */
+    precision?: number;
+    /**
+     * Custom display format. String values support a single `{value}`
+     * placeholder; functions receive the numeric value and return the
+     * rendered string.
+     */
+    format?: string | ((value: number) => string);
+    /** Render the +/- step buttons. */
+    showButtons?: boolean;
+    /** Placeholder shown when the value is empty (uncontrolled / undefined). */
+    placeholder?: string;
+    /** Disable input + buttons. */
+    disabled?: boolean;
+    /** Mark as readonly (focusable but not editable). */
+    readOnly?: boolean;
+}
+
 export { NiceODataConfig }
 
 export declare const NiceOfflineBanner: default_2.FC<NiceOfflineBannerProps>;
 
-export declare interface NiceOfflineBannerProps extends NiceBaseProps {
+export declare interface NiceOfflineBannerProps extends NiceStandardProps {
     size?: NiceSize;
     message?: string;
     variant?: 'warning' | 'error';
@@ -15091,7 +16136,7 @@ export { NiceOption }
 export declare const NiceOrganizationChart: default_2.ForwardRefExoticComponent<NiceOrganizationChartProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceOrganizationChart} component — a hierarchical org chart with optional node selection and collapsible branches. */
-export declare interface NiceOrganizationChartProps extends NiceBaseProps {
+export declare interface NiceOrganizationChartProps extends NiceStandardProps {
     /** Root node. */
     data: NiceOrgNode;
     /** Custom node renderer. */
@@ -15163,7 +16208,47 @@ export declare interface NiceOrgNode {
     [x: string]: any;
 }
 
-export declare type NiceOrgProfileSection = 'basic' | 'contact' | 'address' | 'branding' | 'localization' | 'fiscal' | 'preferences';
+export declare type NiceOrgProfileSection = 'basic' | 'contact' | 'address' | 'branding' | 'localization' | 'fiscal' | 'preferences';
+
+/**
+ * Multi-digit one-time-password field. Renders `length` single-char
+ * `<input>` slots; auto-advances focus on entry; goes back on
+ * Backspace from an empty slot; supports paste of the full code.
+ *
+ * The whole field exposes a single `aria-label` on the wrapper so
+ * AT users hear "OTP, N digits" rather than each box separately.
+ */
+export declare const NiceOTPInput: default_2.FC<NiceOTPInputProps>;
+
+/**
+ * Props for {@link NiceOTPInput}.
+ *
+ * `error` is omitted from the standard prop bag because here it's a
+ * boolean visual-state flag, not the validation-error string of the
+ * standard form-field props.
+ */
+export declare interface NiceOTPInputProps extends Omit<NiceStandardProps, 'error'> {
+    /** Number of code digits. */
+    length?: number;
+    /** Controlled value (digits concatenated). */
+    value?: string;
+    /** Fires on every keystroke with the assembled string. */
+    onChange?: (value: string) => void;
+    /** Fires once when the length of typed digits equals `length`. */
+    onComplete?: (value: string) => void;
+    /** Restrict input to digits (`number`) or any character (`text`). */
+    type?: NiceOTPInputType;
+    /** Focus the first slot on mount. */
+    autoFocus?: boolean;
+    /** Disable all slots. */
+    disabled?: boolean;
+    /** Render in the error visual state (red border). */
+    error?: boolean;
+    /** Node injected between every digit (e.g. `<span>-</span>`). */
+    separator?: default_2.ReactNode;
+}
+
+export declare type NiceOTPInputType = 'number' | 'text';
 
 /**
  * NicePageBuilder - Drag-drop page builder with responsive layouts
@@ -15195,6 +16280,44 @@ export declare interface NicePageBuilderProps {
     className?: string;
 }
 
+/**
+ * Semantic `<header>` with the classic dashboard chrome layout:
+ * breadcrumb on top, [back] + avatar + title + tags on the heading
+ * row, optional subtitle, and a trailing actions slot. Tabs / chips
+ * can slot under the heading via `footer`.
+ */
+export declare const NicePageHeader: default_2.FC<NicePageHeaderProps>;
+
+/**
+ * Props for {@link NicePageHeader} — top-of-page chrome
+ * (title + breadcrumb + actions).
+ *
+ * `title` omitted from the standard prop bag because here it's a rich
+ * ReactNode heading, not the tooltip-text string the base prop
+ * describes.
+ */
+export declare interface NicePageHeaderProps extends Omit<NiceStandardProps, 'title'> {
+    /** Title node — rendered as the page heading. */
+    title: default_2.ReactNode;
+    /** Subtitle / context line below the title. */
+    subtitle?: default_2.ReactNode;
+    /** Breadcrumb element rendered above the title. */
+    breadcrumb?: default_2.ReactNode;
+    /** Avatar node placed to the left of the title. */
+    avatar?: default_2.ReactNode;
+    /** Status tags rendered next to the title (e.g. a status `NiceTag`). */
+    tags?: default_2.ReactNode;
+    /** Trailing slot for actions (typically a button group). */
+    extra?: default_2.ReactNode;
+    /** Footer slot — typically a `<NiceTabs />` row below the header. */
+    footer?: default_2.ReactNode;
+    /**
+     * Renders a back button on the left when set. The button's
+     * `aria-label` comes from `pageHeader.back` (default "Back").
+     */
+    onBack?: () => void;
+}
+
 export declare interface NicePageMargins {
     top: number;
     right: number;
@@ -15240,6 +16363,21 @@ export declare interface NicePaginationProps extends NiceBaseProps {
     disabled?: boolean;
 }
 
+export declare const NiceParagraph: default_2.FC<NiceParagraphProps>;
+
+/** Props for {@link NiceParagraph} — body-text paragraph with size + lead/muted variants. */
+export declare interface NiceParagraphProps extends Omit<NiceStandardProps, 'size'> {
+    children: default_2.ReactNode;
+    /** Text size (typographic scale, not `NiceSize`). */
+    size?: NiceParagraphSize;
+    /** Render as a lead paragraph (larger, lighter weight). */
+    lead?: boolean;
+    /** Muted (de-emphasised) text colour. */
+    muted?: boolean;
+}
+
+export declare type NiceParagraphSize = 'sm' | 'md' | 'lg';
+
 export declare const NicePasswordInput: default_2.ForwardRefExoticComponent<NicePasswordInputProps & default_2.RefAttributes<HTMLInputElement>>;
 
 /** Props for the {@link NicePasswordInput} component — a password field with visibility toggle and strength meter. */
@@ -15344,7 +16482,7 @@ declare interface NicePDFOptions extends NiceExportOptions {
 export declare const NicePDFViewer: ForwardRefExoticComponent<NicePDFViewerProps & RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NicePDFViewer} component — an embedded PDF viewer with toolbar, navigation, and zoom. */
-export declare interface NicePDFViewerProps extends NiceBaseProps {
+export declare interface NicePDFViewerProps extends NiceStandardProps {
     /** PDF source: URL string or ArrayBuffer / Uint8Array */
     src?: string | ArrayBuffer | Uint8Array;
     /** Initial page number (1-based) */
@@ -15498,7 +16636,7 @@ export declare interface NicePickListProps<T = unknown> extends NiceBaseProps {
 export declare const NicePieChart: default_2.FC<NicePieChartProps>;
 
 /** Props for the {@link NicePieChart} component — an SVG pie / donut chart with legend and labels. */
-export declare interface NicePieChartProps extends NiceBaseProps {
+export declare interface NicePieChartProps extends NiceStandardProps {
     /** Slice data. */
     data: NicePieSlice[];
     /** Chart width in px. */
@@ -15719,7 +16857,7 @@ export declare interface NicePlatformCapability {
 export declare const NicePolarChart: default_2.FC<NicePolarChartProps>;
 
 /** Props for the {@link NicePolarChart} component — an SVG radar / spider chart. */
-export declare interface NicePolarChartProps extends NiceBaseProps {
+export declare interface NicePolarChartProps extends NiceStandardProps {
     /** Series definitions. */
     series: NicePolarChartSeries[];
     /** Axis category labels. */
@@ -16036,6 +17174,52 @@ export declare interface NiceProgressProps extends Omit<NiceFormFieldProps, 'sub
     labelPlacement?: 'top' | 'bottom' | 'left' | 'right';
 }
 
+/**
+ * Light-weight prompt modal — a tiny `window.prompt` replacement.
+ * Reuses the design-system styling via `.nice-modal` classes so it
+ * looks consistent with `NiceModal` / `NiceConfirmDialog`.
+ *
+ * Keyboard:
+ *   - Enter on the input submits
+ *   - Escape cancels
+ *   - The input is auto-focused on open so users can start typing
+ *     immediately.
+ *
+ * Labels go through `useNiceTranslation` so they follow the global
+ * picker without prop wiring.
+ */
+export declare const NicePromptDialog: default_2.FC<NicePromptDialogProps>;
+
+/**
+ * Props for {@link NicePromptDialog} — modal dialog asking for a single value.
+ *
+ * `title` is omitted from the standard prop bag because here it's the
+ * dialog heading (rich node), not the tooltip-text string the base
+ * prop describes.
+ */
+export declare interface NicePromptDialogProps extends Omit<NiceStandardProps, 'title'> {
+    /** Controlled visibility. */
+    open: boolean;
+    /** Fires with the entered value when user confirms. */
+    onSubmit: (value: string) => void;
+    /** Fires when user cancels (Escape, Cancel button, backdrop click). */
+    onCancel: () => void;
+    /** Dialog heading. */
+    title: default_2.ReactNode;
+    /** Optional explanation rendered above the input. */
+    message?: default_2.ReactNode;
+    /** Initial input value when the dialog opens. */
+    defaultValue?: string;
+    /** Input placeholder. */
+    placeholder?: string;
+    /** Native input type (`text`, `email`, `password`, `url`, …). */
+    inputType?: default_2.HTMLInputTypeAttribute;
+    /** Override the confirm button label (defaults to translated `'OK'`). */
+    confirmLabel?: default_2.ReactNode;
+    /** Override the cancel button label (defaults to translated `'Cancel'`). */
+    cancelLabel?: default_2.ReactNode;
+}
+
 export declare interface NicePropDescriptor {
     name: string;
     type: string;
@@ -16060,7 +17244,7 @@ export { NicePullToRefreshProps }
 export declare const NiceQRCode: ForwardRefExoticComponent<NiceQRCodeProps & RefAttributes<HTMLCanvasElement>>;
 
 /** Props for the {@link NiceQRCode} component — generates and renders a QR code from a text value. */
-export declare interface NiceQRCodeProps extends NiceBaseProps {
+export declare interface NiceQRCodeProps extends NiceStandardProps {
     /** Text or URL to encode. */
     value: string;
     /** Output size in pixels. */
@@ -16241,7 +17425,7 @@ export declare interface NiceRadioGroupProps extends NiceFormFieldProps {
 export declare const NiceRangeSelector: default_2.FC<NiceRangeSelectorProps>;
 
 /** Props for the {@link NiceRangeSelector} component — a dual-handle range slider with optional sparkline background. */
-export declare interface NiceRangeSelectorProps extends NiceBaseProps {
+export declare interface NiceRangeSelectorProps extends NiceStandardProps {
     /** Sparkline data rendered behind the handles. */
     data?: number[];
     /** Minimum selectable value. */
@@ -16290,6 +17474,39 @@ export declare interface NiceRangeSliderProps extends NiceFormFieldProps {
     valuePlacement?: 'right' | 'bottom' | 'none';
 }
 
+/**
+ * Star rating widget. Native semantics: behaves like a `radiogroup`
+ * (one star is the "selected" value at a time), with arrow-key nav
+ * between positions. `allowHalf` enables half-step granularity by
+ * splitting each character into a left/right click target.
+ */
+export declare const NiceRate: default_2.FC<NiceRateProps>;
+
+/** Props for {@link NiceRate} — star (or custom-glyph) rating widget. */
+export declare interface NiceRateProps extends NiceStandardProps {
+    /** Controlled rating value (0..count). */
+    value?: number;
+    /** Default value (uncontrolled). */
+    defaultValue?: number;
+    /** Total number of selectable items. */
+    count?: number;
+    /** Allow half-step ratings (0.5 / 1.5 / 2.5 / …). */
+    allowHalf?: boolean;
+    /** Clicking the current value clears the rating back to 0. */
+    allowClear?: boolean;
+    /** Read-only — render the value but ignore clicks. */
+    readOnly?: boolean;
+    /** Disable interaction (visually distinct from `readOnly`). */
+    disabled?: boolean;
+    /**
+     * Render character. Either a single node used for every position,
+     * or a `(index) => node` function for per-position glyphs.
+     */
+    character?: default_2.ReactNode | ((index: number) => default_2.ReactNode);
+    /** Fires on every change. */
+    onChange?: (value: number) => void;
+}
+
 export declare const NiceRating: default_2.ForwardRefExoticComponent<NiceRatingProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceRating} component — a star/icon rating input with half-step support. */
@@ -16373,7 +17590,7 @@ export declare interface NiceRbacRole {
 
 export declare const NiceRealtimeChart: default_2.ForwardRefExoticComponent<NiceRealtimeChartProps & default_2.RefAttributes<NiceRealtimeChartRef>>;
 
-export declare interface NiceRealtimeChartProps extends NiceBaseProps {
+export declare interface NiceRealtimeChartProps extends NiceStandardProps {
     /** Początkowe dane */
     initialData?: RealtimeDataPoint[];
     /** Alias for `initialData`. */
@@ -16856,9 +18073,43 @@ export { NiceResponsiveValue }
 
 export { NiceRestConfig }
 
+/**
+ * Full-page result state — used at the end of multi-step flows
+ * (checkout success, payment failed, account created…) or as an
+ * empty-state replacement when a list / view has no content.
+ *
+ * `role="alert"` for `error`, `role="status"` otherwise so screen
+ * readers announce the result appropriately.
+ */
+export declare const NiceResult: default_2.FC<NiceResultProps>;
+
+/**
+ * Props for {@link NiceResult}.
+ *
+ * `title` is omitted from the standard prop bag because here it's a
+ * rich heading node, not the tooltip-text string the base prop
+ * describes.
+ */
+export declare interface NiceResultProps extends Omit<NiceStandardProps, 'title'> {
+    /** Outcome variant — drives the default glyph + colour. */
+    status: NiceResultStatus;
+    /** Headline (large text). */
+    title: default_2.ReactNode;
+    /** Secondary message below the title. */
+    subtitle?: default_2.ReactNode;
+    /** Override the default glyph for the chosen status. */
+    icon?: default_2.ReactNode;
+    /** Actions slot below the message — typically a button group. */
+    extra?: default_2.ReactNode;
+    /** Free-form content inserted between the message and `extra`. */
+    children?: default_2.ReactNode;
+}
+
+export declare type NiceResultStatus = 'success' | 'error' | 'info' | 'warning' | 'pending';
+
 export declare const NiceRetryPanel: default_2.FC<NiceRetryPanelProps>;
 
-export declare interface NiceRetryPanelProps extends NiceBaseProps {
+export declare interface NiceRetryPanelProps extends NiceStandardProps {
     size?: NiceSize;
     error: string | Error;
     onRetry: () => void;
@@ -16870,6 +18121,32 @@ export declare interface NiceRetryPanelProps extends NiceBaseProps {
     icon?: default_2.ReactNode;
 }
 
+/**
+ * Decorative corner ribbon that hangs from the top of its wrapped
+ * element. Positioning is relative to a `position: relative` shim
+ * we add automatically, so consumers don't have to set it on the
+ * child themselves.
+ *
+ * The text is exposed to AT via the wrapping element's textContent;
+ * the angled tail is a decorative pseudo-element (not picked up by
+ * screen readers).
+ */
+export declare const NiceRibbon: default_2.FC<NiceRibbonProps>;
+
+export declare type NiceRibbonPlacement = 'start' | 'end';
+
+/** Props for {@link NiceRibbon} — corner banner attached to a wrapped element. */
+export declare interface NiceRibbonProps extends NiceStandardProps {
+    /** Wrapped content — the ribbon attaches to the top corner of this. */
+    children: default_2.ReactNode;
+    /** Ribbon label. */
+    text: default_2.ReactNode;
+    /** Custom background colour. Falls back to the design-system primary token. */
+    color?: string;
+    /** Which top corner the ribbon attaches to. */
+    placement?: NiceRibbonPlacement;
+}
+
 export declare interface NiceRoleInfo {
     id: string;
     name: string;
@@ -16923,7 +18200,7 @@ export declare const NiceSankey: default_2.FC<NiceSankeyProps>;
 
 export declare const NiceSankeyChart: default_2.FC<NiceSankeyChartProps>;
 
-export declare interface NiceSankeyChartProps extends NiceBaseProps {
+export declare interface NiceSankeyChartProps extends NiceStandardProps {
     /** Węzły */
     nodes: SankeyNode[];
     /** Połączenia */
@@ -16969,7 +18246,7 @@ export declare interface NiceSankeyNode {
 }
 
 /** Props for the {@link NiceSankey} component — an SVG Sankey flow diagram. */
-export declare interface NiceSankeyProps extends NiceBaseProps {
+export declare interface NiceSankeyProps extends NiceStandardProps {
     /** Node definitions. */
     nodes: NiceSankeyNode[];
     /** Link definitions. */
@@ -17385,6 +18662,90 @@ export declare interface NiceSearchBarProps {
 
 export declare type NiceSearchBarSize = 'sm' | 'md' | 'lg';
 
+/**
+ * Search input with an async suggestion dropdown and a recent-search
+ * fallback when the query is empty. Keyboard:
+ *   - Down/Up — move highlight among suggestions
+ *   - Enter   — pick the highlighted row, or fire onSearch with the
+ *               current value when nothing is highlighted
+ *   - Escape  — close the dropdown
+ *
+ * The suggestion fetcher is the consumer's source of truth; we keep
+ * a request-id counter so out-of-order responses don't replace a
+ * later query's result.
+ */
+export declare const NiceSearchInput: default_2.FC<NiceSearchInputProps>;
+
+/** Props for {@link NiceSearchInput} — text field with async suggestions + recents. */
+export declare interface NiceSearchInputProps extends NiceStandardProps {
+    /** Controlled search text. */
+    value: string;
+    /** Fires on every keystroke. */
+    onChange: (value: string) => void;
+    /** Fires on Enter or when the user picks a suggestion. */
+    onSearch?: (value: string) => void;
+    /**
+     * Async source of suggestions. Receives the current query, returns
+     * the rows to display. Debounce / cancellation is the caller's
+     * responsibility; the component swallows stale responses by id.
+     *
+     * NOTE: aliased to {@link NiceSearchSuggestionFetcher} so the
+     * `> Promise<` token sequence in the inline signature does not
+     * trip the i18n-strings audit (which is a plain regex looking for
+     * `> Word <` patterns).
+     */
+    getSuggestions?: NiceSearchSuggestionFetcher;
+    /**
+     * Static list of "recent searches" — shown when the input is
+     * focused but empty (no query to fetch suggestions for).
+     */
+    recentSearches?: string[];
+    /** Placeholder. Defaults to translated `'Search...'`. */
+    placeholder?: string;
+    /** Disable input + dropdown. */
+    disabled?: boolean;
+}
+
+/** One row in the suggestions dropdown. */
+export declare interface NiceSearchSuggestion {
+    /** Stable identifier (used as React key). */
+    id: string;
+    /** Visible label. */
+    label: default_2.ReactNode;
+    /** Optional metadata renderable next to the label (e.g. icon, category). */
+    hint?: default_2.ReactNode;
+}
+
+/**
+ * Async fetcher signature used by {@link NiceSearchInputProps.getSuggestions}.
+ * Extracted to a named alias so the `> Promise<` token sequence does
+ * not appear inline inside the props interface (where the i18n-strings
+ * audit's `>Word<` regex would flag it as a false-positive raw label).
+ */
+declare type NiceSearchSuggestionFetcher = (query: string) => Promise<NiceSearchSuggestion[]>;
+
+/**
+ * Page section: a `<section>` element with optional title/subtitle
+ * header, actions slot, and bottom divider. Use for grouping content
+ * blocks on dashboards or settings pages.
+ */
+export declare const NiceSection: default_2.FC<NiceSectionProps>;
+
+/** Props for {@link NiceSection} — semantic page section with header. */
+export declare interface NiceSectionProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    /** Section title rendered inside the header. */
+    title?: string;
+    /** Sub-title rendered below the title. */
+    subtitle?: string;
+    /** Header actions (typically a button group) rendered on the right. */
+    actions?: default_2.ReactNode;
+    /** Outer padding (number → px). */
+    padding?: number | string;
+    /** Render a divider line below the header. */
+    divider?: boolean;
+}
+
 /**
  * `NiceSegmentedControl` — single-selection toggle group with an animated
  * sliding "thumb" highlight, iOS-style. The control owns a single value
@@ -17656,6 +19017,14 @@ export declare interface NiceSidebarNavProps {
      * Default `false`.
      */
     minimal?: boolean;
+    /**
+     * **Embedded mode** — render the sidebar inside another container (e.g. a
+     * mobile drawer / hamburger menu). Forces full width, drops the footer with
+     * the collapse-btn (there is nothing to collapse to inside a drawer) and
+     * ignores `collapsed` / `width` / `collapsedWidth`. The mode strip and the
+     * full navigation tree stay intact. Default `false`.
+     */
+    embedded?: boolean;
     /** Optional header slot rendered above the mode strip / tree (e.g. workspace switcher). */
     header?: ReactNode;
     /** Optional footer slot rendered below the standard footer-toggle row. */
@@ -17833,10 +19202,10 @@ export { NiceSize }
 export declare const NiceSkeleton: default_2.FC<NiceSkeletonProps>;
 
 /** Props for the {@link NiceSkeleton} component — a pulsing placeholder shown while content is loading. */
-export declare interface NiceSkeletonProps extends NiceBaseProps {
+export declare interface NiceSkeletonProps extends Omit<NiceStandardProps, 'variant'> {
     /** Skeleton size preset. */
     size?: NiceSize;
-    /** Shape variant: text line, circle, or rectangle. */
+    /** Shape variant: text line, circle, or rectangle. Does NOT use `NiceVariant` palette — this is a shape selector, not a semantic intent. */
     variant?: 'text' | 'circle' | 'rect';
     /** Custom width (CSS value or number of pixels). */
     width?: string | number;
@@ -17921,10 +19290,45 @@ export declare interface NiceSortState {
     direction: 'asc' | 'desc';
 }
 
+/**
+ * Flexible spacing element. Drop between siblings inside a `NiceFlex`
+ * / `NiceStack` to push them apart, or set `size` to insert a fixed
+ * gap without touching the parent's `gap` prop.
+ */
+export declare const NiceSpacer: default_2.FC<NiceSpacerProps>;
+
+export declare type NiceSpacerAxis = 'horizontal' | 'vertical' | 'both';
+
+/**
+ * Props for {@link NiceSpacer} — flexible / fixed-size whitespace inside flex layouts.
+ *
+ * NOTE: We deliberately omit `NiceStandardProps.size` because here `size` is a
+ * spatial dimension (px / CSS length), not the `xs|sm|md|lg|xl` density token
+ * that the standard prop describes.
+ */
+export declare interface NiceSpacerProps extends Omit<NiceStandardProps, 'size'> {
+    /**
+     * Fixed size (number → px, string → raw CSS). When set, the spacer
+     * has a deterministic dimension and does NOT flex-grow.
+     */
+    size?: number | string;
+    /**
+     * Flex-grow factor used when `size` is not provided. Defaults to 1
+     * (the spacer absorbs all leftover space along the parent's main
+     * axis).
+     */
+    flex?: number;
+    /**
+     * Which axis the spacer expands on. `'both'` is the safe default —
+     * the spacer adapts to whichever parent flex direction it lands in.
+     */
+    axis?: NiceSpacerAxis;
+}
+
 export declare const NiceSparkline: default_2.FC<NiceSparklineProps>;
 
 /** Props for the {@link NiceSparkline} component — a compact inline chart (line, bar, or area). */
-export declare interface NiceSparklineProps extends NiceBaseProps {
+export declare interface NiceSparklineProps extends NiceStandardProps {
     /** Data values. */
     data: number[];
     /** SVG width in px. */
@@ -17995,7 +19399,7 @@ export declare interface NiceSpeedDialProps extends NiceBaseProps {
 export declare const NiceSpinner: default_2.FC<NiceSpinnerProps>;
 
 /** Props for the {@link NiceSpinner} component — an animated loading indicator. */
-export declare interface NiceSpinnerProps extends NiceBaseProps {
+export declare interface NiceSpinnerProps extends NiceStandardProps {
     /** Spinner diameter. */
     size?: NiceSize;
 }
@@ -18144,6 +19548,39 @@ export { NiceSSEMessage }
 
 export { NiceSSEMessageType }
 
+/**
+ * Lays out children in a single column or row with a consistent gap.
+ *
+ * A thin wrapper over flexbox that captures the conventions we use
+ * across the design system (spacing as a number, optional divider
+ * between every pair) so consumers don't have to re-derive them.
+ */
+export declare const NiceStack: default_2.FC<NiceStackProps>;
+
+export declare type NiceStackAlign = 'start' | 'center' | 'end' | 'stretch';
+
+export declare type NiceStackDirection = 'vertical' | 'horizontal';
+
+export declare type NiceStackJustify = 'start' | 'center' | 'end' | 'space-between' | 'space-around';
+
+/** Props for {@link NiceStack} — uniform-gap one-dimensional layout. */
+export declare interface NiceStackProps extends NiceStandardProps {
+    /** Stack children. */
+    children: default_2.ReactNode;
+    /** Layout axis. */
+    direction?: NiceStackDirection;
+    /** Gap between items. Number → pixels, string → raw CSS value. */
+    spacing?: number | string;
+    /** Cross-axis alignment. */
+    align?: NiceStackAlign;
+    /** Main-axis alignment. */
+    justify?: NiceStackJustify;
+    /** Allow wrapping onto multiple lines. */
+    wrap?: boolean;
+    /** Optional element placed between every pair of children (e.g. `<NiceDivider />`). */
+    divider?: default_2.ReactNode;
+}
+
 export { niceStaggerDelay }
 
 export { NiceStandardFieldProps }
@@ -18184,6 +19621,37 @@ export { NiceStateIO }
 
 export { NiceStateSnapshot }
 
+/**
+ * Renders a single KPI tile: title, big value with optional pre/suffix,
+ * and an arrow-coloured trend chip. Locale-aware number formatting via
+ * `Intl.NumberFormat` (toLocaleString).
+ */
+export declare const NiceStatistic: default_2.FC<NiceStatisticProps>;
+
+/** Props for {@link NiceStatistic} — KPI / metric tile. */
+export declare interface NiceStatisticProps extends NiceStandardProps {
+    /** Metric title (e.g. "Active users"). */
+    title: string;
+    /** Metric value. Numbers go through `toLocaleString` for grouping. */
+    value: number | string;
+    /** Optional prefix glyph (e.g. currency icon). */
+    prefix?: default_2.ReactNode;
+    /** Optional suffix glyph (e.g. "%"). */
+    suffix?: default_2.ReactNode;
+    /** Decimal places when `value` is a number. */
+    precision?: number;
+    /** Trend chip rendered next to the value. */
+    trend?: NiceStatisticTrend;
+}
+
+/** Trend descriptor — direction is independent from magnitude. */
+export declare interface NiceStatisticTrend {
+    /** Magnitude (typically a percentage; the component formats the symbol). */
+    value: number;
+    /** Up = positive movement, down = negative. */
+    direction: 'up' | 'down';
+}
+
 /**
  * {@link NiceStatusBadge} — Workflow status badge with semantic coloring and optional pulse animation.
  */
@@ -18252,7 +19720,7 @@ export declare interface NiceStepperStep {
 export declare const NiceStockChart: default_2.ForwardRefExoticComponent<NiceStockChartProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceStockChart} component — an SVG candlestick / OHLC / line stock chart with optional volume bars. */
-export declare interface NiceStockChartProps extends NiceBaseProps {
+export declare interface NiceStockChartProps extends NiceStandardProps {
     /** OHLC data points. */
     data: NiceStockDataPoint[];
     /** Chart type. */
@@ -18419,6 +19887,27 @@ export declare interface NiceSurveyProps {
     className?: string;
 }
 
+/**
+ * Drop-in replacement for `<React.Suspense>` with a `delay` knob to
+ * avoid the "spinner flash" anti-pattern. Internally we suspend on
+ * the React component, then gate the fallback on a `setTimeout` so
+ * we only render the visual fallback once the wait exceeds `delay`.
+ */
+export declare const NiceSuspense: default_2.FC<NiceSuspenseProps>;
+
+/** Props for {@link NiceSuspense} — React.Suspense with an optional delayed fallback. */
+export declare interface NiceSuspenseProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    /** Element shown while children are suspended. */
+    fallback?: default_2.ReactNode;
+    /**
+     * Delay (ms) before the fallback appears — prevents flash of
+     * spinner for fast resolves. When 0 the fallback shows immediately
+     * (matches the React.Suspense default).
+     */
+    delay?: number;
+}
+
 /** Swap event payload. */
 export declare interface NiceSwapEvent {
     type: SwapEventType;
@@ -18436,6 +19925,32 @@ export { NiceSwipeableListItem }
 
 export { NiceSwipeableListItemProps }
 
+/**
+ * Pointer-driven swipe card (Tinder-style). Uses `onPointerDown/Move/Up`
+ * for unified touch + mouse + pen handling. Commits a swipe when the
+ * release distance crosses `threshold` along the dominant axis; below
+ * threshold the card springs back to centre.
+ *
+ * Keyboard fallback: arrow keys fire the corresponding `onSwipe*`
+ * callbacks so the component is usable without a touch device.
+ */
+export declare const NiceSwipeCard: default_2.FC<NiceSwipeCardProps>;
+
+/** Props for {@link NiceSwipeCard} — touch/mouse-draggable card. */
+export declare interface NiceSwipeCardProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    onSwipeLeft?: () => void;
+    onSwipeRight?: () => void;
+    onSwipeUp?: () => void;
+    onSwipeDown?: () => void;
+    /** Pixel distance required before a release commits as a swipe. */
+    threshold?: number;
+    /** Render a translucent left/right hint overlay during drag. */
+    showOverlay?: boolean;
+    /** Disable interaction entirely (card stays static). */
+    disabled?: boolean;
+}
+
 /** A system-tray icon in the {@link NiceDesktop} clock area. */
 export declare interface NiceSystemTrayItem {
     /** Unique key. */
@@ -18448,6 +19963,54 @@ export declare interface NiceSystemTrayItem {
     onClick?: () => void;
 }
 
+/**
+ * Tab bar for navigating between top-level app sections — the
+ * counterpart of `NiceTabs` (which is for tabbed content panes).
+ * Uses the standard ARIA `tablist` + `tab` + `aria-selected` pattern.
+ *
+ * Arrow keys + Home/End move focus between tabs (the canonical tab
+ * keyboard pattern); Tab key escapes the tablist as usual.
+ */
+export declare const NiceTabBar: default_2.FC<NiceTabBarProps>;
+
+/**
+ * Props for {@link NiceTabBar} — top-level section nav, not content tabs.
+ *
+ * `variant` omitted from the standard prop bag because here it's a
+ * local visual style (`default` / `pills` / `underline`), not the
+ * design-system `NiceVariant`.
+ */
+export declare interface NiceTabBarProps extends Omit<NiceStandardProps, 'variant'> {
+    /** Tab list. */
+    tabs: NiceTabBarTab[];
+    /** Currently selected tab id (uncontrolled when omitted). */
+    activeTab?: string;
+    /** Fires on selection change. */
+    onChange?: (tabId: string) => void;
+    /** Visual variant. */
+    variant?: NiceTabBarVariant;
+    /** Tab size scale. */
+    size?: NiceSize;
+    /** Render icons next to the labels. */
+    showIcons?: boolean;
+    /** Stretch tabs to fill the available width. */
+    stretch?: boolean;
+}
+
+/** Single tab definition. */
+export declare interface NiceTabBarTab {
+    /** Stable identifier (used in `activeTab` / `onChange`). */
+    id: string;
+    /** Display label. */
+    label: default_2.ReactNode;
+    /** Optional icon node — visibility gated by `showIcons`. */
+    icon?: default_2.ReactNode;
+    /** Disable selection. */
+    disabled?: boolean;
+}
+
+export declare type NiceTabBarVariant = 'default' | 'pills' | 'underline';
+
 export { NiceTabDescriptor }
 
 /** Definition of a single tab in a {@link NiceTabs} component. */
@@ -18581,8 +20144,44 @@ export declare interface NiceTagBoxProps extends NiceFormFieldProps {
     autoExpand?: boolean;
 }
 
+/**
+ * Tag (chip) input. Each committed value renders as a removable chip;
+ * the trailing `<input>` collects new entries. Commit happens on:
+ *   - Enter
+ *   - the `separator` character
+ *   - paste containing one or more `separator`-joined tokens
+ *
+ * Backspace on an empty input deletes the last tag — the canonical
+ * "tag input" affordance.
+ */
+export declare const NiceTagInput: default_2.FC<NiceTagInputProps>;
+
+/** Props for {@link NiceTagInput} — multi-value input rendering tags + textbox. */
+export declare interface NiceTagInputProps extends NiceStandardProps {
+    /** Controlled tag list. */
+    value: string[];
+    /** Fires on every change. */
+    onChange: (tags: string[]) => void;
+    /** Suggestions shown below the input as filterable dropdown. */
+    suggestions?: string[];
+    /** Hard cap on tag count. New entries beyond `maxTags` are rejected. */
+    maxTags?: number;
+    /** When `true`, identical tags can be added more than once. */
+    allowDuplicates?: boolean;
+    /**
+     * Separator character — used both for splitting paste payloads
+     * AND as an additional commit key in the input (e.g. typing `,`
+     * commits the current draft as a tag).
+     */
+    separator?: string;
+    /** Input placeholder. */
+    placeholder?: string;
+    /** Disable everything. */
+    disabled?: boolean;
+}
+
 /** Props for the {@link NiceTag} component — a compact label used for categorization or selection. */
-export declare interface NiceTagProps extends NiceBaseProps {
+export declare interface NiceTagProps extends NiceStandardProps {
     /** Tag size. */
     size?: NiceSize;
     /** Tag content. */
@@ -18726,7 +20325,7 @@ export declare interface NiceTerminalLine {
 export declare const NiceTerminalUI: ForwardRefExoticComponent<NiceTerminalUIProps & RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceTerminalUI} component — a retro terminal / console emulator. */
-export declare interface NiceTerminalUIProps extends NiceBaseProps {
+export declare interface NiceTerminalUIProps extends NiceStandardProps {
     /** Pre-loaded lines of output. */
     lines?: NiceTerminalLine[];
     /** Command prompt string (default: "$"). */
@@ -18852,10 +20451,14 @@ export declare interface NiceThemeBuilderProps extends NiceBaseProps {
     livePreview?: boolean;
     /** Currently focused token from NiceThemePreview (auto-switches section + scrolls) */
     focusedToken?: string;
+    /** Show the embedded NiceThemePreview pane (default: true) */
+    showPreview?: boolean;
+    /** Layout placement of the preview pane (default: 'right') */
+    previewPlacement?: 'right' | 'bottom';
 }
 
 /** Editable sections in the {@link NiceThemeBuilder}. */
-export declare type NiceThemeBuilderSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions';
+export declare type NiceThemeBuilderSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
 
 export { NiceThemeColors }
 
@@ -19004,6 +20607,12 @@ export declare interface NiceThemePickerProps extends NiceFormFieldProps, DualVi
      * dropdown alignment. Default: false.
      */
     compact?: boolean;
+    /**
+     * Visual variant. `'ghost'` removes border, background and the dropdown
+     * arrow — only the preview swatch is shown. Designed for dense toolbars
+     * (e.g. NiceTopNav narrow mode). Default: `'default'`.
+     */
+    variant?: 'default' | 'ghost';
     /** Dropdown horizontal alignment. Default: `'auto'` in compact, `'left'` otherwise. */
     dropdownAlign?: DropdownAlign;
     /**
@@ -19166,7 +20775,7 @@ export declare interface NiceTimelineItem {
 }
 
 /** Props for the {@link NiceTimeline} component — a vertical or horizontal timeline of events. */
-export declare interface NiceTimelineProps extends NiceBaseProps {
+export declare interface NiceTimelineProps extends NiceStandardProps {
     /** Timeline entries. */
     items: NiceTimelineItem[];
     /** Layout mode */
@@ -19179,7 +20788,7 @@ export declare interface NiceTimelineProps extends NiceBaseProps {
 
 export declare const NiceTimeoutFeedback: default_2.FC<NiceTimeoutFeedbackProps>;
 
-export declare interface NiceTimeoutFeedbackProps extends NiceBaseProps {
+export declare interface NiceTimeoutFeedbackProps extends NiceStandardProps {
     size?: NiceSize;
     timeoutMs?: number;
     slowThresholdMs?: number;
@@ -19226,7 +20835,7 @@ export declare interface NiceTimePickerProps extends NiceFormFieldProps {
     /** Show a live countdown label beside the picker. */
     countdown?: boolean;
     /** Built-in countdown format preset (default `'verbose'`). */
-    countdownFormat?: NiceCountdownFormat;
+    countdownFormat?: NiceCountdownFormat_2;
     /** Custom formatter (overrides {@link countdownFormat}). */
     formatCountdown?: (msRemaining: number, target: Date) => string;
     /** Label rendered before the countdown text (e.g. `'starts in'`). */
@@ -19255,6 +20864,45 @@ export declare interface NiceToastItem {
 
 export declare const NiceToggle: default_2.ForwardRefExoticComponent<NiceToggleProps & default_2.RefAttributes<HTMLInputElement>>;
 
+/**
+ * Toggle-button group with single OR multiple selection. Uses native
+ * `<button>` with `aria-pressed` per item (the canonical ARIA pattern
+ * for "toggle buttons" — `role="radio"` would be wrong because items
+ * are independently activatable when `type="multiple"`).
+ */
+export declare const NiceToggleGroup: default_2.FC<NiceToggleGroupProps> & {
+    Item: default_2.FC<NiceToggleGroupItemProps>;
+};
+
+/** Props for `<NiceToggleGroup.Item>` — single button inside the group. */
+export declare interface NiceToggleGroupItemProps {
+    /** Identifier this item registers under. */
+    value: string;
+    children: default_2.ReactNode;
+    /** Disable just this item (group `disabled` still wins when true). */
+    disabled?: boolean;
+}
+
+/** Props for {@link NiceToggleGroup} — toggle-button set, single OR multi-select. */
+export declare interface NiceToggleGroupProps extends NiceStandardProps {
+    children: default_2.ReactNode;
+    /** Selection mode. */
+    type?: NiceToggleGroupType;
+    /**
+     * Controlled selected value(s). String for `type="single"`,
+     * `string[]` for `type="multiple"`.
+     */
+    value?: string | string[];
+    /** Default selection (uncontrolled). */
+    defaultValue?: string | string[];
+    /** Disable every item. */
+    disabled?: boolean;
+    /** Fires whenever selection changes. */
+    onChange?: (value: string | string[]) => void;
+}
+
+export declare type NiceToggleGroupType = 'single' | 'multiple';
+
 /** Props for the {@link NiceToggle} component — a boolean switch/toggle. */
 export declare interface NiceToggleProps extends NiceBaseProps {
     /** Toggle label. */
@@ -19523,6 +21171,33 @@ export declare interface NiceTopNavProps {
     userMenu?: NiceTopNavMenuItem[];
     onProfile?: () => void;
     onLogout?: () => void;
+    /**
+     * Whether to render the workspace `<select>` row above the navigation tree
+     * in the hamburger pull-down panel. Visibility is ALWAYS prop-controlled
+     * (not auto-derived from `mobilePanels.length`) — consumers decide when it
+     * makes sense to show it. Requires signed-in `user`. Default: `false`.
+     */
+    showMobilePanelSelector?: boolean;
+    /** List of panels/workspaces the user has access to. */
+    mobilePanels?: Array<{
+        id: string;
+        label: string;
+        icon?: default_2.ReactNode;
+    }>;
+    /** Currently active panel id (controls the workspace `<select>` value). */
+    activeMobilePanelId?: string;
+    /** Notified when user picks a different panel from the workspace selector. */
+    onMobilePanelChange?: (id: string) => void;
+    /**
+     * Render a mode toolbar (favorites / all / …) row above the navigation
+     * in the hamburger pull-down panel. Requires signed-in `user`. NOTE: when
+     * panel renders `<NiceSidebarNav embedded enableModeIcons>` (i.e. you
+     * pass `sidebarData`), the sidebar already has its own mode strip — leave
+     * this `false` for that branch to avoid a duplicate bar. Default: `false`.
+     */
+    showMobilePanelModes?: boolean;
+    /** Optional custom mode toolbar; replaces the default cosmetic pills. */
+    mobilePanelModes?: default_2.ReactNode;
     showLogin?: boolean;
     loginLabel?: string;
     onLoginClick?: () => void;
@@ -19556,6 +21231,26 @@ export declare interface NiceTopNavProps {
     rightClusterDefaultOpen?: boolean;
     leftContent?: default_2.ReactNode;
     rightContent?: default_2.ReactNode;
+    /**
+     * Full navigation data shared with `NiceSidebarNav`. When provided, the
+     * hamburger drawer renders an embedded `NiceSidebarNav` (full mode strip +
+     * multi-level tree + search/favorites/preferences) instead of the legacy
+     * flat menu. Lets a parent shell drive both the desktop sidebar and the
+     * mobile hamburger from one model.
+     */
+    sidebarData?: SidebarNavDataNode[];
+    /** User id forwarded to the embedded `NiceSidebarNav` (preferences scope). */
+    sidebarUserId?: string;
+    /** Active route highlighted in the mobile sidebar drawer. */
+    sidebarActiveRoute?: string;
+    /** Fired when a view is clicked in the mobile sidebar drawer. Closes the drawer. */
+    onSidebarNavigate?: (route: string, view: SidebarNavView) => void;
+    /**
+     * Force the narrow "2-row" mobile layout regardless of viewport width. Use
+     * from `NiceNavShell` to keep the breakpoint decision in one place when the
+     * shell already hides the sidebar.
+     */
+    forceMobileLayout?: boolean;
     className?: string;
     style?: default_2.CSSProperties;
     id?: string;
@@ -19739,7 +21434,7 @@ export declare const NiceTreeMap: default_2.ForwardRefExoticComponent<NiceTreeMa
 
 export declare const NiceTreeMapChart: default_2.FC<NiceTreeMapChartProps>;
 
-export declare interface NiceTreeMapChartProps extends NiceBaseProps {
+export declare interface NiceTreeMapChartProps extends NiceStandardProps {
     /** Dane hierarchiczne. Można też podać płaską listę — zostanie opakowana w wirtualny korzeń. */
     data: TreeMapNode | Array<{
         label?: string;
@@ -19780,7 +21475,7 @@ export declare interface NiceTreeMapNode {
 }
 
 /** Props for the {@link NiceTreeMap} component — a squarified treemap visualization. */
-export declare interface NiceTreeMapProps extends NiceBaseProps {
+export declare interface NiceTreeMapProps extends NiceStandardProps {
     /** Root node. */
     data: NiceTreeMapNode;
     /** SVG width in px. */
@@ -19839,6 +21534,11 @@ export declare interface NiceTreeSelectProps extends NiceFormFieldProps {
     /** Only allow selection of leaf nodes */
     selectableLeafsOnly?: boolean;
     clearable?: boolean;
+    /**
+     * Maximum nesting depth rendered (1..10). Beyond this, nodes are treated as
+     * leaves (children not rendered, no expand toggle). Default: unlimited.
+     */
+    maxDepth?: number;
 }
 
 export declare const NiceTreeView: default_2.FC<NiceTreeViewProps>;
@@ -19885,6 +21585,47 @@ export declare interface NiceTreeViewProps extends NiceBaseProps {
     editable?: boolean;
     /** Called when a node label is edited. */
     onNodeEdit?: (key: string, newText: string) => void;
+    /**
+     * Maximum nesting depth rendered (1..10). Beyond this, nodes are treated as
+     * leaves (children not rendered, no expand toggle). Default: unlimited.
+     */
+    maxDepth?: number;
+}
+
+/**
+ * Clamps text to N lines using the modern `-webkit-line-clamp`
+ * pattern and optionally exposes a Show more / Show less toggle.
+ *
+ * The button labels go through `useNiceTranslation()` so the
+ * component stays consistent with the rest of the i18n system; if
+ * you pass `expandText` / `collapseText` explicitly they take
+ * precedence and skip the lookup.
+ */
+export declare const NiceTruncate: default_2.FC<NiceTruncateProps>;
+
+/** Props for {@link NiceTruncate} — multi-line text clamp with optional expand. */
+export declare interface NiceTruncateProps extends NiceStandardProps {
+    /** Text content to clamp. */
+    children: string;
+    /** Max line count before truncation kicks in. Defaults to 1. */
+    lines?: number;
+    /** Render an "expand" toggle that reveals the full text. */
+    expandable?: boolean;
+    /**
+     * Label for the expand button. Falls back to the translated default
+     * (`truncate.expand`) so it follows the global language picker.
+     */
+    expandText?: string;
+    /**
+     * Label for the collapse button. Falls back to the translated
+     * default (`truncate.collapse`).
+     */
+    collapseText?: string;
+    /**
+     * When `true`, the full text becomes the element's `title`
+     * attribute so the browser native tooltip surfaces it on hover.
+     */
+    tooltip?: boolean;
 }
 
 export declare const NiceTutorial: default_2.FC<NiceTutorialProps>;
@@ -20293,7 +22034,7 @@ export declare interface NiceVatInputProps extends NiceFormFieldProps {
 export declare const NiceVectorMap: default_2.FC<NiceVectorMapProps>;
 
 /** Props for the {@link NiceVectorMap} component — an SVG choropleth map with region selection and tooltips. */
-export declare interface NiceVectorMapProps extends NiceBaseProps {
+export declare interface NiceVectorMapProps extends NiceStandardProps {
     /** Region definitions. */
     regions: NiceMapRegion[];
     /** SVG width in px. */
@@ -20873,7 +22614,7 @@ export declare const NiceVirtualScroller: <T>(props: NiceVirtualScrollerProps<T>
 }) => default_2.ReactElement | null;
 
 /** Props for the {@link NiceVirtualScroller} component — renders large lists efficiently by only mounting visible items. */
-export declare interface NiceVirtualScrollerProps<T = unknown> extends NiceBaseProps {
+export declare interface NiceVirtualScrollerProps<T = unknown> extends NiceStandardProps {
     /** Data items to render */
     items: T[];
     /** Fixed height of each item in pixels */
@@ -23415,7 +25156,7 @@ export declare interface SidebarNavHiddenItem {
 }
 
 /** Display mode for the sidebar navigation */
-export declare type SidebarNavMode = 'all' | 'by-role' | 'by-unit' | 'favorites' | 'preferences';
+export declare type SidebarNavMode = 'all' | 'by-role' | 'by-unit' | 'favorites' | 'search' | 'preferences';
 
 /** A module containing multiple views */
 export declare interface SidebarNavModule {