@devjuliovilla/jv-ui 1.5.2 → 1.5.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devjuliovilla/jv-ui",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "Accessibility-first Angular component library — components, forms, data grids, dialogs, layout, services, and i18n infrastructure built with signals and standalone APIs.",
   "author": "@devjuliovilla",
   "license": "MIT",

package/types/devjuliovilla-jv-ui.d.ts

@@ -372,9 +372,13 @@ declare class JvIconComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvIconComponent, "jv-icon", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "decorative": { "alias": "decorative"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+interface JvIconElement {
+    tag: 'path' | 'circle' | 'line' | 'polyline' | 'rect' | 'ellipse' | 'polygon';
+    attrs: Record<string, string>;
+}
 interface JvIconDefinition {
     viewBox: string;
-    paths: string[];
+    elements: JvIconElement[];
 }
 declare const JV_FALLBACK_ICON_NAME = "circle-alert";
 declare const JV_LUCIDE_ICON_REGISTRY: Record<string, JvIconDefinition>;
@@ -591,13 +595,26 @@ interface JvGridColumn<T = any> {
     header: string;
     sortable?: boolean;
     searchable?: boolean;
+    filterable?: boolean;
     hidden?: boolean;
+    resizable?: boolean;
+    sticky?: 'left' | 'right' | null;
+    editable?: boolean;
     width?: string;
+    minWidth?: string;
+    maxWidth?: string;
     align?: 'start' | 'center' | 'end';
     type?: 'text' | 'number' | 'currency' | 'date' | 'datetime' | 'boolean';
     cellClass?: string;
     headerClass?: string;
     format?: (value: unknown, row: T) => string;
+    editType?: 'text' | 'number' | 'select' | 'boolean';
+    editOptions?: {
+        label: string;
+        value: unknown;
+    }[];
+    children?: JvGridColumn<T>[];
+    filterValue?: string;
 }
 interface JvGridAction<T = any> {
     id: string;
@@ -606,6 +623,10 @@ interface JvGridAction<T = any> {
     variant?: 'default' | 'primary' | 'danger';
     disabled?: (row: T) => boolean;
 }
+interface JvGridColumnWidth {
+    key: string;
+    width: string;
+}
 interface JvGridOptions {
     searchable?: boolean;
     sortable?: boolean;
@@ -620,11 +641,41 @@ interface JvGridOptions {
     searchPlaceholder?: string;
     ariaLabel?: string;
     trackBy?: JvGridTrackBy<any>;
+    serverSide?: boolean;
+    totalItems?: number;
+    stickyColumns?: boolean;
+    resizableColumns?: boolean;
+    reorderableColumns?: boolean;
+    editable?: boolean;
+    virtualScroll?: boolean;
+    virtualScrollRowHeight?: number;
+    exportable?: boolean;
+    columnFilters?: boolean;
+    rowDoubleClick?: boolean;
 }
 interface JvGridPageEvent {
     pageIndex: number;
     pageSize: number;
 }
+interface JvGridColumnReorderEvent {
+    columnKey: string;
+    newIndex: number;
+}
+interface JvGridColumnResizeEvent {
+    columnKey: string;
+    width: string;
+}
+interface JvGridRowEditEvent<T = any> {
+    row: T;
+    column: JvGridColumn<T>;
+    value: unknown;
+}
+type JvGridFilterOperator = 'contains' | 'equals' | 'startsWith' | 'endsWith' | 'gt' | 'gte' | 'lt' | 'lte' | 'between';
+interface JvGridColumnFilter {
+    key: string;
+    value: string;
+    operator: JvGridFilterOperator;
+}
 declare const JV_GRID_DEFAULT_OPTIONS: JvGridOptions;
 
 declare class JvGridComponent<T = any> {
@@ -637,6 +688,7 @@ declare class JvGridComponent<T = any> {
     readonly trackBy: _angular_core.InputSignal<keyof T | ((row: T, index: number) => JvGridRowId) | null>;
     readonly selectedIds: _angular_core.InputSignal<JvGridRowId[]>;
     readonly rowClick: _angular_core.OutputEmitterRef<T>;
+    readonly rowDoubleClick: _angular_core.OutputEmitterRef<T>;
     readonly actionClick: _angular_core.OutputEmitterRef<{
         actionId: string;
         row: T;
@@ -645,6 +697,13 @@ declare class JvGridComponent<T = any> {
     readonly pageChange: _angular_core.OutputEmitterRef<JvGridPageEvent>;
     readonly searchChange: _angular_core.OutputEmitterRef<string>;
     readonly sortChange: _angular_core.OutputEmitterRef<JvGridSortState>;
+    readonly columnFilter: _angular_core.OutputEmitterRef<{
+        columnKey: string;
+        value: string;
+    }>;
+    readonly columnResize: _angular_core.OutputEmitterRef<JvGridColumnResizeEvent>;
+    readonly columnReorder: _angular_core.OutputEmitterRef<JvGridColumnReorderEvent>;
+    readonly rowEdit: _angular_core.OutputEmitterRef<JvGridRowEditEvent<T>>;
     private readonly effectiveOptions;
     private readonly idKey;
     protected readonly resolvedOptions: _angular_core.Signal<{
@@ -661,9 +720,24 @@ declare class JvGridComponent<T = any> {
         searchPlaceholder?: string;
         ariaLabel?: string;
         trackBy?: _devjuliovilla_jv_ui.JvGridTrackBy<any>;
+        serverSide?: boolean;
+        totalItems?: number;
+        stickyColumns?: boolean;
+        resizableColumns?: boolean;
+        reorderableColumns?: boolean;
+        editable?: boolean;
+        virtualScroll?: boolean;
+        virtualScrollRowHeight?: number;
+        exportable?: boolean;
+        columnFilters?: boolean;
+        rowDoubleClick?: boolean;
     }>;
     protected readonly gridLabel: _angular_core.Signal<string>;
+    protected readonly columnOrder: _angular_core.WritableSignal<string[]>;
+    protected readonly colFilters: _angular_core.WritableSignal<Record<string, JvGridColumnFilter>>;
+    protected readonly columnWidths: _angular_core.WritableSignal<Record<string, string>>;
     protected readonly visibleColumns: _angular_core.Signal<JvGridColumn<T>[]>;
+    protected readonly groupedHeaders: _angular_core.Signal<JvGridColumn<T>[]>;
     private readonly internalSelectedIds;
     readonly searchTerm: _angular_core.WritableSignal<string>;
     readonly sortState: _angular_core.WritableSignal<JvGridSortState>;
@@ -671,11 +745,18 @@ declare class JvGridComponent<T = any> {
     protected readonly pageSize: _angular_core.Signal<number>;
     private readonly searchPageResetter;
     private readonly selectedIdSet;
+    protected readonly hasActiveFilters: _angular_core.Signal<boolean>;
     protected readonly filteredData: _angular_core.Signal<T[]>;
     protected readonly sortedData: _angular_core.Signal<T[]>;
-    protected readonly totalItems: _angular_core.Signal<number>;
-    protected readonly totalPages: _angular_core.Signal<number>;
-    protected readonly pagedData: _angular_core.Signal<T[]>;
+    protected readonly effectiveTotalItems: _angular_core.Signal<number>;
+    protected readonly effectiveTotalPages: _angular_core.Signal<number>;
+    protected readonly displayData: _angular_core.Signal<T[]>;
+    protected readonly virtualScroll: _angular_core.Signal<number | false | undefined>;
+    protected readonly virtualStartIndex: _angular_core.WritableSignal<number>;
+    protected readonly virtualEndIndex: _angular_core.WritableSignal<number>;
+    protected readonly virtualDisplayData: _angular_core.Signal<T[]>;
+    protected readonly virtualTotalHeight: _angular_core.Signal<number>;
+    protected readonly virtualOffsetY: _angular_core.Signal<number>;
     protected readonly pageStart: _angular_core.Signal<number>;
     protected readonly pageEnd: _angular_core.Signal<number>;
     protected readonly pageRange: _angular_core.Signal<number[]>;
@@ -683,14 +764,28 @@ declare class JvGridComponent<T = any> {
     protected readonly someSelected: _angular_core.Signal<boolean>;
     protected readonly colspan: _angular_core.Signal<number>;
     protected readonly densityClass: _angular_core.Signal<string>;
+    protected editState: _angular_core.WritableSignal<{
+        rowId: JvGridRowId;
+        colKey: string;
+    } | null>;
     protected readonly t: (key: string, params?: Record<string, string | number>) => string;
     protected getRowId(row: T, index?: number): JvGridRowId;
     protected colKey(col: JvGridColumn<T>): string;
     protected getRawCellValue(row: T, col: JvGridColumn<T>): unknown;
     protected getCellValue(row: T, col: JvGridColumn<T>): unknown;
+    protected getEditValue(row: T, col: JvGridColumn<T>): string;
     protected formatValue(value: unknown, col: JvGridColumn<T>): string;
     protected getAriaSort(col: JvGridColumn<T>): 'ascending' | 'descending' | 'none' | null;
     protected getSortLabel(col: JvGridColumn<T>): string;
+    protected getColumnWidth(col: JvGridColumn<T>): string | undefined;
+    protected isStickyLeft(col: JvGridColumn<T>): boolean;
+    protected isStickyRight(col: JvGridColumn<T>): boolean;
+    protected isColumnResizable(col: JvGridColumn<T>): boolean;
+    protected isCellEditable(col: JvGridColumn<T>): boolean;
+    protected groupColspan(group: JvGridColumn<T>): number;
+    protected isEditingCell(row: T, col: JvGridColumn<T>): boolean;
+    protected isRowEditing(row: T): boolean;
+    protected getEditOptions(col: JvGridColumn<T>): JvSelectOption<string>[];
     private findColumn;
     protected toggleSort(col: JvGridColumn<T>, event?: Event): void;
     protected readonly actionVariant: (v?: "default" | "primary" | "danger") => JvIntent;
@@ -700,11 +795,54 @@ declare class JvGridComponent<T = any> {
     protected toggleRow(row: T): void;
     protected toggleSelectAll(checked: boolean): void;
     protected onRowClick(event: Event | T, row?: T): void;
+    protected onRowDblClick(row: T): void;
     protected onActionClick(action: JvGridAction<T>, row: T): void;
+    protected onColumnFilterChange(col: JvGridColumn<T>, value: string): void;
     protected getRowLabel(row: T, index: number): string;
+    protected startEdit(row: T, col: JvGridColumn<T>, event: MouseEvent): void;
+    protected commitEdit(row: T, col: JvGridColumn<T>, value: unknown): void;
+    protected cancelEdit(): void;
+    protected onEditValueChange(row: T, col: JvGridColumn<T>, value: string): void;
+    private resizeData;
+    protected onResizeStart(event: MouseEvent, col: JvGridColumn<T>, _colIdx: number): void;
+    private readonly onResizeMove;
+    private readonly onResizeEnd;
+    private dragIndex;
+    protected onDragStart(event: DragEvent, colIdx: number): void;
+    protected onDragOver(event: DragEvent, _colIdx: number): void;
+    protected onDrop(event: DragEvent, targetIdx: number): void;
+    protected onDragEnd(_event: DragEvent): void;
+    protected onVirtualScroll(target: HTMLElement): void;
+    protected exportCsv(): void;
+    protected exportExcel(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvGridComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvGridComponent<any>, "jv-grid", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; }, { "rowClick": "rowClick"; "actionClick": "actionClick"; "selectionChange": "selectionChange"; "pageChange": "pageChange"; "searchChange": "searchChange"; "sortChange": "sortChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvGridComponent<any>, "jv-grid", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; }, { "rowClick": "rowClick"; "rowDoubleClick": "rowDoubleClick"; "actionClick": "actionClick"; "selectionChange": "selectionChange"; "pageChange": "pageChange"; "searchChange": "searchChange"; "sortChange": "sortChange"; "columnFilter": "columnFilter"; "columnResize": "columnResize"; "columnReorder": "columnReorder"; "rowEdit": "rowEdit"; }, never, never, true, never>;
+}
+
+interface JvPaginationEvent {
+    pageIndex: number;
+    pageSize: number;
+}
+declare class JvPaginationComponent {
+    private readonly translationService;
+    readonly totalItems: _angular_core.InputSignal<number>;
+    readonly pageSize: _angular_core.InputSignal<number>;
+    readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
+    readonly pageIndex: _angular_core.InputSignal<number>;
+    readonly maxVisiblePages: _angular_core.InputSignal<number>;
+    readonly pageChange: _angular_core.OutputEmitterRef<JvPaginationEvent>;
+    protected readonly totalPages: _angular_core.Signal<number>;
+    protected readonly pageStart: _angular_core.Signal<number>;
+    protected readonly pageEnd: _angular_core.Signal<number>;
+    protected readonly pageRange: _angular_core.Signal<number[]>;
+    protected readonly pageSizeStr: _angular_core.Signal<string>;
+    protected readonly pageSizeOptionsList: _angular_core.Signal<JvSelectOption<string>[]>;
+    protected readonly t: (key: string, params?: Record<string, string | number>) => string;
+    protected goToPage(page: number): void;
+    protected onPageSizeChange(value: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvPaginationComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvPaginationComponent, "jv-pagination", never, { "totalItems": { "alias": "totalItems"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "pageIndex": { "alias": "pageIndex"; "required": false; "isSignal": true; }; "maxVisiblePages": { "alias": "maxVisiblePages"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
 }
 
-export { EN, ES, JV_DEFAULT_LOCALE, JV_FALLBACK_ICON_NAME, JV_GRID_DEFAULT_OPTIONS, JV_LOCALE_DICTIONARIES, JV_LUCIDE_ICON_REGISTRY, JV_UI_CONFIG, JV_UI_CONFIG_DEFAULTS, JV_UI_DEFAULT_CONFIG, JvAlertComponent, JvAnnouncementService, JvBadgeComponent, JvBreadcrumbComponent, JvButtonComponent, JvButtonGroupComponent, JvCardComponent, JvChangePasswordPageComponent, JvCheckboxComponent, JvConfirmDialogComponent, JvDashboardShellComponent, JvDialogComponent, JvDialogService, JvDividerComponent, JvForgotPasswordPageComponent, JvFormContainerComponent, JvGridComponent, JvIconButtonComponent, JvIconComponent, JvInputComponent, JvLoaderComponent, JvLoaderService, JvLoginPageComponent, JvPageComponent, JvRadioComponent, JvSectionComponent, JvSelectComponent, JvSidebarComponent, JvSwitchComponent, JvThemeService, JvToastComponent, JvToastService, JvTopbarComponent, JvTranslationService, provideJvUi };
-export type { JvActiveConfirmDialog, JvBreadcrumbItem, JvChangePasswordSubmitEvent, JvConfirmOptions, JvDensity, JvForgotPasswordSubmitEvent, JvGridAction, JvGridColumn, JvGridOptions, JvGridPageEvent, JvGridRowId, JvGridSortDirection, JvGridSortState, JvGridTrackBy, JvIconDefinition, JvIntent, JvLoaderState, JvLocale, JvLoginSubmitEvent, JvNavItem, JvSelectOption, JvTheme, JvThemeOption, JvToastItem, JvToastPosition, JvToastViewport, JvTone, JvTopbarAction, JvUiConfig };
+export { EN, ES, JV_DEFAULT_LOCALE, JV_FALLBACK_ICON_NAME, JV_GRID_DEFAULT_OPTIONS, JV_LOCALE_DICTIONARIES, JV_LUCIDE_ICON_REGISTRY, JV_UI_CONFIG, JV_UI_CONFIG_DEFAULTS, JV_UI_DEFAULT_CONFIG, JvAlertComponent, JvAnnouncementService, JvBadgeComponent, JvBreadcrumbComponent, JvButtonComponent, JvButtonGroupComponent, JvCardComponent, JvChangePasswordPageComponent, JvCheckboxComponent, JvConfirmDialogComponent, JvDashboardShellComponent, JvDialogComponent, JvDialogService, JvDividerComponent, JvForgotPasswordPageComponent, JvFormContainerComponent, JvGridComponent, JvIconButtonComponent, JvIconComponent, JvInputComponent, JvLoaderComponent, JvLoaderService, JvLoginPageComponent, JvPageComponent, JvPaginationComponent, JvRadioComponent, JvSectionComponent, JvSelectComponent, JvSidebarComponent, JvSwitchComponent, JvThemeService, JvToastComponent, JvToastService, JvTopbarComponent, JvTranslationService, provideJvUi };
+export type { JvActiveConfirmDialog, JvBreadcrumbItem, JvChangePasswordSubmitEvent, JvConfirmOptions, JvDensity, JvForgotPasswordSubmitEvent, JvGridAction, JvGridColumn, JvGridColumnFilter, JvGridColumnReorderEvent, JvGridColumnResizeEvent, JvGridColumnWidth, JvGridFilterOperator, JvGridOptions, JvGridPageEvent, JvGridRowEditEvent, JvGridRowId, JvGridSortDirection, JvGridSortState, JvGridTrackBy, JvIconDefinition, JvIconElement, JvIntent, JvLoaderState, JvLocale, JvLoginSubmitEvent, JvNavItem, JvPaginationEvent, JvSelectOption, JvTheme, JvThemeOption, JvToastItem, JvToastPosition, JvToastViewport, JvTone, JvTopbarAction, JvUiConfig };