@nova-design-system/nova-angular 3.20.0 → 3.21.0

package/dist/nova-components/lib/components/nv-datatable.component.d.ts

@@ -1,6 +1,6 @@
 import { TemplateRef, QueryList, AfterViewInit, OnDestroy } from '@angular/core';
 import { NvDatatableCellDirective } from './nv-datatable-cell.directive';
-import { type FlexRenderComponent, type ColumnDef, type CellContext, type NoInfer } from './datatable.utils';
+import { type FlexRenderComponent, type ColumnDef, type CellContext, type SortingState, type NoInfer } from './datatable.utils';
 import * as i0 from "@angular/core";
 /**
  * A powerful, flexible datatable component built on TanStack Table.
@@ -13,6 +13,8 @@ export declare class NvDatatable<T> implements AfterViewInit, OnDestroy {
     rows: import("@angular/core").InputSignal<T[]>;
     /** Optional pagination configuration */
     pagination: import("@angular/core").InputSignal<NvDatatablePaginationConfig | undefined>;
+    /** Optional sorting configuration */
+    sorting: import("@angular/core").InputSignal<NvDatatableSortingConfig | undefined>;
     /** Should the header stick to the top of the table when scrolling? */
     stickyHeader: import("@angular/core").InputSignal<boolean>;
     /** Template for custom pagination UI */
@@ -27,6 +29,8 @@ export declare class NvDatatable<T> implements AfterViewInit, OnDestroy {
     private cellTemplateMap;
     /** Pagination state for server mode */
     private paginationState;
+    /** Sorting state for controlled sorting (server mode) */
+    private sortingState;
     /** Reference to table rows for infinite scroll observer */
     private tableRows;
     /** Intersection observer for infinite scroll */
@@ -39,13 +43,24 @@ export declare class NvDatatable<T> implements AfterViewInit, OnDestroy {
     private tableInstance;
     /** Public getter for table instance. */
     table(): import("./datatable.utils").Table<T>;
+    /**
+     * Handle sort direction change from table header
+     * @param {Event} event The sort direction change event or direction string
+     * @param {object} header The table header object
+     */
+    handleSortDirectionChanged(event: Event | CustomEvent<string> | string, header: {
+        column: {
+            clearSorting: () => void;
+            toggleSorting: (desc?: boolean, multi?: boolean) => void;
+        };
+    }): void;
     /** Build pagination API for template */
     paginationAPI: import("@angular/core").Signal<NvDatatableRenderPaginationAPI | null>;
     constructor();
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NvDatatable<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<NvDatatable<any>, "nv-datatable", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; }, {}, ["paginationTemplate", "cellTemplates"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NvDatatable<any>, "nv-datatable", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": false; "isSignal": true; }; "sorting": { "alias": "sorting"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; }, {}, ["paginationTemplate", "cellTemplates"], never, true, never>;
 }
 /********************************* UTILS **************************************/
 /**
@@ -97,6 +112,16 @@ export interface NvDatatableColumn<Row, K extends keyof Row = keyof Row, F = Row
     renderCell?: (context: CellContext<Row, F>) => string | FlexRenderComponent | TemplateRef<{
         $implicit: CellContext<Row, F>;
     }>;
+    /** Enable/disable sorting for this column */
+    sortable?: boolean;
+    /** Custom sorting function or built-in function name */
+    sortingFn?: ((rowA: any, rowB: any, columnId: string) => number) | string;
+    /** Start with descending sort for this column */
+    sortDescFirst?: boolean;
+    /** Invert the sort order (useful for rankings) */
+    invertSorting?: boolean;
+    /** Where to place undefined values in sort */
+    sortUndefined?: 'first' | 'last' | false | -1 | 1;
 }
 /** Parameters for custom cell rendering function. */
 export interface NvTableRenderCellParams<Row, Value, Field> {
@@ -184,3 +209,27 @@ export interface NvDatatableRenderPaginationAPI {
     /** Whether more items are available (only for infinite scroll) */
     hasMore?: boolean;
 }
+/**
+ * Sorting configuration for NvDatatable.
+ * Supports both client-side and server-side sorting.
+ */
+export interface NvDatatableSortingConfig {
+    /** Sorting mode */
+    mode: 'client' | 'server';
+    /** Enable multi-column sorting with Shift+Click */
+    enableMultiSort?: boolean;
+    /** Allow cycling through to "no sort" state */
+    enableSortingRemoval?: boolean;
+    /** Maximum number of columns for multi-sort */
+    maxMultiSortColCount?: number;
+    /** Start with descending sort as first toggle state */
+    sortDescFirst?: boolean;
+    /** Controlled sort state (for server-side sorting) */
+    sortState?: SortingState;
+    /** Callback when sorting changes (for server-side sorting) */
+    onSortingChange?: (sorting: SortingState) => void;
+}
+/**
+ * Sorting state type - array of sort descriptors
+ */
+export type NvDataTableSortingState = SortingState;

package/dist/nova-components/lib/nova-components.module.d.ts

@@ -12,7 +12,7 @@ import * as i4 from "./providers/notification-service.component";
 export declare function provideNovaComponents(): Provider;
 export declare class NovaComponentsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<NovaComponentsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<NovaComponentsModule, [typeof i1.NvAccordion, typeof i1.NvAccordionItem, typeof i1.NvAlert, typeof i1.NvAvatar, typeof i1.NvBadge, typeof i1.NvBreadcrumb, typeof i1.NvBreadcrumbs, typeof i1.NvButton, typeof i1.NvButtongroup, typeof i1.NvCalendar, typeof i1.NvCol, typeof i1.NvDatagrid, typeof i1.NvDatagridcolumn, typeof i1.NvDialog, typeof i1.NvDialogfooter, typeof i1.NvDialogheader, typeof i1.NvFieldcheckbox, typeof i1.NvFielddate, typeof i1.NvFielddaterange, typeof i1.NvFielddropdown, typeof i1.NvFielddropdownitem, typeof i1.NvFielddropdownitemcheck, typeof i1.NvFieldmultiselect, typeof i1.NvFieldnumber, typeof i1.NvFieldpassword, typeof i1.NvFieldradio, typeof i1.NvFieldselect, typeof i1.NvFieldslider, typeof i1.NvFieldtext, typeof i1.NvFieldtextarea, typeof i1.NvFieldtime, typeof i1.NvIcon, typeof i1.NvIconbutton, typeof i1.NvLoader, typeof i1.NvMenu, typeof i1.NvMenuitem, typeof i1.NvNotification, typeof i1.NvNotificationcontainer, typeof i1.NvPopover, typeof i1.NvRow, typeof i1.NvSplit, typeof i1.NvStack, typeof i1.NvTable, typeof i1.NvToggle, typeof i1.NvTogglebutton, typeof i1.NvTogglebuttongroup, typeof i1.NvTooltip], [typeof i2.NvDatatable], [typeof i1.NvAccordion, typeof i1.NvAccordionItem, typeof i1.NvAlert, typeof i1.NvAvatar, typeof i1.NvBadge, typeof i1.NvBreadcrumb, typeof i1.NvBreadcrumbs, typeof i1.NvButton, typeof i1.NvButtongroup, typeof i1.NvCalendar, typeof i1.NvCol, typeof i1.NvDatagrid, typeof i1.NvDatagridcolumn, typeof i1.NvDialog, typeof i1.NvDialogfooter, typeof i1.NvDialogheader, typeof i1.NvFieldcheckbox, typeof i1.NvFielddate, typeof i1.NvFielddaterange, typeof i1.NvFielddropdown, typeof i1.NvFielddropdownitem, typeof i1.NvFielddropdownitemcheck, typeof i1.NvFieldmultiselect, typeof i1.NvFieldnumber, typeof i1.NvFieldpassword, typeof i1.NvFieldradio, typeof i1.NvFieldselect, typeof i1.NvFieldslider, typeof i1.NvFieldtext, typeof i1.NvFieldtextarea, typeof i1.NvFieldtime, typeof i1.NvIcon, typeof i1.NvIconbutton, typeof i1.NvLoader, typeof i1.NvMenu, typeof i1.NvMenuitem, typeof i1.NvNotification, typeof i1.NvNotificationcontainer, typeof i1.NvPopover, typeof i1.NvRow, typeof i1.NvSplit, typeof i1.NvStack, typeof i1.NvTable, typeof i1.NvToggle, typeof i1.NvTogglebutton, typeof i1.NvTogglebuttongroup, typeof i1.NvTooltip, typeof i2.NvDatatable]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<NovaComponentsModule, [typeof i1.NvAccordion, typeof i1.NvAccordionItem, typeof i1.NvAlert, typeof i1.NvAvatar, typeof i1.NvBadge, typeof i1.NvBreadcrumb, typeof i1.NvBreadcrumbs, typeof i1.NvButton, typeof i1.NvButtongroup, typeof i1.NvCalendar, typeof i1.NvCol, typeof i1.NvDatagrid, typeof i1.NvDatagridcolumn, typeof i1.NvDialog, typeof i1.NvDialogfooter, typeof i1.NvDialogheader, typeof i1.NvFieldcheckbox, typeof i1.NvFielddate, typeof i1.NvFielddaterange, typeof i1.NvFielddropdown, typeof i1.NvFielddropdownitem, typeof i1.NvFielddropdownitemcheck, typeof i1.NvFieldmultiselect, typeof i1.NvFieldnumber, typeof i1.NvFieldpassword, typeof i1.NvFieldradio, typeof i1.NvFieldselect, typeof i1.NvFieldslider, typeof i1.NvFieldtext, typeof i1.NvFieldtextarea, typeof i1.NvFieldtime, typeof i1.NvIcon, typeof i1.NvIconbutton, typeof i1.NvLoader, typeof i1.NvMenu, typeof i1.NvMenuitem, typeof i1.NvNotification, typeof i1.NvNotificationcontainer, typeof i1.NvPopover, typeof i1.NvRow, typeof i1.NvSplit, typeof i1.NvStack, typeof i1.NvTable, typeof i1.NvTableheader, typeof i1.NvToggle, typeof i1.NvTogglebutton, typeof i1.NvTogglebuttongroup, typeof i1.NvTooltip], [typeof i2.NvDatatable], [typeof i1.NvAccordion, typeof i1.NvAccordionItem, typeof i1.NvAlert, typeof i1.NvAvatar, typeof i1.NvBadge, typeof i1.NvBreadcrumb, typeof i1.NvBreadcrumbs, typeof i1.NvButton, typeof i1.NvButtongroup, typeof i1.NvCalendar, typeof i1.NvCol, typeof i1.NvDatagrid, typeof i1.NvDatagridcolumn, typeof i1.NvDialog, typeof i1.NvDialogfooter, typeof i1.NvDialogheader, typeof i1.NvFieldcheckbox, typeof i1.NvFielddate, typeof i1.NvFielddaterange, typeof i1.NvFielddropdown, typeof i1.NvFielddropdownitem, typeof i1.NvFielddropdownitemcheck, typeof i1.NvFieldmultiselect, typeof i1.NvFieldnumber, typeof i1.NvFieldpassword, typeof i1.NvFieldradio, typeof i1.NvFieldselect, typeof i1.NvFieldslider, typeof i1.NvFieldtext, typeof i1.NvFieldtextarea, typeof i1.NvFieldtime, typeof i1.NvIcon, typeof i1.NvIconbutton, typeof i1.NvLoader, typeof i1.NvMenu, typeof i1.NvMenuitem, typeof i1.NvNotification, typeof i1.NvNotificationcontainer, typeof i1.NvPopover, typeof i1.NvRow, typeof i1.NvSplit, typeof i1.NvStack, typeof i1.NvTable, typeof i1.NvTableheader, typeof i1.NvToggle, typeof i1.NvTogglebutton, typeof i1.NvTogglebuttongroup, typeof i1.NvTooltip, typeof i2.NvDatatable]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<NovaComponentsModule>;
 }
 export declare class NovaComponentsValueAccessorModule {

package/dist/nova-components/lib/providers/notification.service.d.ts

@@ -35,6 +35,8 @@ export interface NotificationOptions {
     actions?: NotificationAction[];
     /** Custom components for the notification actions. */
     actionSlot?: Type<unknown>;
+    /** Duration in milliseconds before auto-dismissing. 0 = sticky (no auto-dismiss). Default: 0 */
+    duration?: number;
 }
 /**
  * A notification with all required fields populated.
@@ -60,6 +62,7 @@ export interface NotificationServiceConfig {
 export declare class NotificationService {
     private readonly _notifications;
     private readonly _config;
+    private readonly timers;
     /**
      * Observable stream of active notifications.
      */
@@ -87,6 +90,10 @@ export declare class NotificationService {
     registerRef(id: string, el: HTMLNvNotificationElement): void;
     unregisterRef(id: string): void;
     clearRefs(): void;
+    /**
+     * Clean up all timers and references.
+     */
+    ngOnDestroy(): void;
     /**
      * Show a new notification.
      *

package/dist/nova-components/lib/stencil-generated/components.d.ts

@@ -103,7 +103,7 @@ export declare class NvButton {
     protected el: HTMLNvButtonElement;
     constructor(c: ChangeDetectorRef, r: ElementRef, z: NgZone);
     static ɵfac: i0.ɵɵFactoryDeclaration<NvButton, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<NvButton, "nv-button", never, { "active": { "alias": "active"; "required": false; }; "danger": { "alias": "danger"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "emphasis": { "alias": "emphasis"; "required": false; }; "fluid": { "alias": "fluid"; "required": false; }; "form": { "alias": "form"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "size": { "alias": "size"; "required": false; }; "type": { "alias": "type"; "required": false; }; }, {}, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NvButton, "nv-button", never, { "active": { "alias": "active"; "required": false; }; "danger": { "alias": "danger"; "required": false; }; "disableTabindex": { "alias": "disableTabindex"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "emphasis": { "alias": "emphasis"; "required": false; }; "fluid": { "alias": "fluid"; "required": false; }; "form": { "alias": "form"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "size": { "alias": "size"; "required": false; }; "type": { "alias": "type"; "required": false; }; }, {}, never, ["*"], false, never>;
 }
 export declare interface NvButton extends Components.NvButton {
 }
@@ -468,7 +468,7 @@ export declare class NvIconbutton {
     protected el: HTMLNvIconbuttonElement;
     constructor(c: ChangeDetectorRef, r: ElementRef, z: NgZone);
     static ɵfac: i0.ɵɵFactoryDeclaration<NvIconbutton, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<NvIconbutton, "nv-iconbutton", never, { "active": { "alias": "active"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "emphasis": { "alias": "emphasis"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "name": { "alias": "name"; "required": false; }; "shape": { "alias": "shape"; "required": false; }; "size": { "alias": "size"; "required": false; }; "type": { "alias": "type"; "required": false; }; }, {}, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NvIconbutton, "nv-iconbutton", never, { "active": { "alias": "active"; "required": false; }; "disableTabindex": { "alias": "disableTabindex"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "emphasis": { "alias": "emphasis"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "name": { "alias": "name"; "required": false; }; "shape": { "alias": "shape"; "required": false; }; "size": { "alias": "size"; "required": false; }; "type": { "alias": "type"; "required": false; }; }, {}, never, ["*"], false, never>;
 }
 export declare interface NvIconbutton extends Components.NvIconbutton {
 }
@@ -590,6 +590,20 @@ export declare class NvTable {
 }
 export declare interface NvTable extends Components.NvTable {
 }
+export declare class NvTableheader {
+    protected z: NgZone;
+    protected el: HTMLNvTableheaderElement;
+    constructor(c: ChangeDetectorRef, r: ElementRef, z: NgZone);
+    static ɵfac: i0.ɵɵFactoryDeclaration<NvTableheader, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NvTableheader, "nv-tableheader", never, { "sortDirection": { "alias": "sortDirection"; "required": false; }; "sortable": { "alias": "sortable"; "required": false; }; }, {}, never, ["*"], false, never>;
+}
+export declare interface NvTableheader extends Components.NvTableheader {
+    /**
+     * Event emitted when the sort direction changes. Payload is the new sort
+  direction.
+     */
+    sortDirectionChanged: EventEmitter<CustomEvent<string>>;
+}
 export declare class NvToggle {
     protected z: NgZone;
     protected el: HTMLNvToggleElement;

package/dist/nova-components/lib/stencil-generated/index.d.ts

@@ -1,2 +1,2 @@
 import * as d from './components';
-export declare const DIRECTIVES: (typeof d.NvAccordion | typeof d.NvAccordionItem | typeof d.NvAlert | typeof d.NvAvatar | typeof d.NvBadge | typeof d.NvBreadcrumb | typeof d.NvBreadcrumbs | typeof d.NvButton | typeof d.NvButtongroup | typeof d.NvCalendar | typeof d.NvCol | typeof d.NvDatagrid | typeof d.NvDatagridcolumn | typeof d.NvDialog | typeof d.NvDialogfooter | typeof d.NvDialogheader | typeof d.NvFieldcheckbox | typeof d.NvFielddate | typeof d.NvFielddaterange | typeof d.NvFielddropdown | typeof d.NvFielddropdownitem | typeof d.NvFielddropdownitemcheck | typeof d.NvFieldmultiselect | typeof d.NvFieldnumber | typeof d.NvFieldpassword | typeof d.NvFieldradio | typeof d.NvFieldselect | typeof d.NvFieldslider | typeof d.NvFieldtext | typeof d.NvFieldtextarea | typeof d.NvFieldtime | typeof d.NvIcon | typeof d.NvIconbutton | typeof d.NvLoader | typeof d.NvMenu | typeof d.NvMenuitem | typeof d.NvNotification | typeof d.NvNotificationcontainer | typeof d.NvPopover | typeof d.NvRow | typeof d.NvSplit | typeof d.NvStack | typeof d.NvTable | typeof d.NvToggle | typeof d.NvTogglebutton | typeof d.NvTogglebuttongroup | typeof d.NvTooltip)[];
+export declare const DIRECTIVES: (typeof d.NvAccordion | typeof d.NvAccordionItem | typeof d.NvAlert | typeof d.NvAvatar | typeof d.NvBadge | typeof d.NvBreadcrumb | typeof d.NvBreadcrumbs | typeof d.NvButton | typeof d.NvButtongroup | typeof d.NvCalendar | typeof d.NvCol | typeof d.NvDatagrid | typeof d.NvDatagridcolumn | typeof d.NvDialog | typeof d.NvDialogfooter | typeof d.NvDialogheader | typeof d.NvFieldcheckbox | typeof d.NvFielddate | typeof d.NvFielddaterange | typeof d.NvFielddropdown | typeof d.NvFielddropdownitem | typeof d.NvFielddropdownitemcheck | typeof d.NvFieldmultiselect | typeof d.NvFieldnumber | typeof d.NvFieldpassword | typeof d.NvFieldradio | typeof d.NvFieldselect | typeof d.NvFieldslider | typeof d.NvFieldtext | typeof d.NvFieldtextarea | typeof d.NvFieldtime | typeof d.NvIcon | typeof d.NvIconbutton | typeof d.NvLoader | typeof d.NvMenu | typeof d.NvMenuitem | typeof d.NvNotification | typeof d.NvNotificationcontainer | typeof d.NvPopover | typeof d.NvRow | typeof d.NvSplit | typeof d.NvStack | typeof d.NvTable | typeof d.NvTableheader | typeof d.NvToggle | typeof d.NvTogglebutton | typeof d.NvTogglebuttongroup | typeof d.NvTooltip)[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nova-design-system/nova-angular",
-  "version": "3.20.0",
+  "version": "3.21.0",
   "description": "Nova is a design system created by Elia Group to empower creators to efficiently build solutions that people love to use.",
   "author": "Elia Group",
   "homepage": "https://nova.eliagroup.io",