@devjuliovilla/jv-ui 1.13.0 → 1.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devjuliovilla/jv-ui",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "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

@@ -8,7 +8,7 @@ type JvIntent = 'primary' | 'secondary' | 'outline' | 'ghost' | 'danger' | 'succ
 type JvTone = 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'info' | 'neutral';
 
 declare class JvButtonComponent {
-    readonly type: _angular_core.InputSignal<"button" | "submit" | "reset">;
+    readonly type: _angular_core.InputSignal<"button" | "reset" | "submit">;
     readonly variant: _angular_core.InputSignal<JvIntent>;
     readonly icon: _angular_core.InputSignal<string | null>;
     readonly iconPosition: _angular_core.InputSignal<"start" | "end">;
@@ -571,7 +571,7 @@ declare class JvFormContainerComponent {
 }
 
 declare class JvInputComponent implements ControlValueAccessor {
-    readonly type: _angular_core.InputSignal<"number" | "search" | "text" | "email" | "password">;
+    readonly type: _angular_core.InputSignal<"number" | "text" | "search" | "email" | "password">;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly required: _angular_core.InputSignal<boolean>;
     readonly invalid: _angular_core.InputSignal<boolean>;
@@ -1324,6 +1324,7 @@ interface JvGridSortState {
     direction: JvGridSortDirection;
 }
 type JvGridColumnType = 'text' | 'integer' | 'number' | 'currency' | 'percent' | 'date' | 'time' | 'datetime' | 'boolean';
+type JvGridEditType = 'text' | 'number' | 'date' | 'time' | 'datetime' | 'select' | 'boolean';
 type JvGridColumnFormatOptions = Intl.NumberFormatOptions & Intl.DateTimeFormatOptions;
 interface JvGridColumn<T = any> {
     key: keyof T | string;
@@ -1344,7 +1345,7 @@ interface JvGridColumn<T = any> {
     cellClass?: string;
     headerClass?: string;
     format?: (value: unknown, row: T) => string;
-    editType?: 'text' | 'number' | 'select' | 'boolean';
+    editType?: JvGridEditType;
     editOptions?: {
         label: string;
         value: unknown;
@@ -1389,6 +1390,7 @@ interface JvGridOptions {
     exportFileName?: string;
     columnFilters?: boolean;
     rowDoubleClick?: boolean;
+    keyboardNavigation?: boolean;
 }
 interface JvGridPageEvent {
     pageIndex: number;
@@ -1418,6 +1420,8 @@ declare const JV_GRID_DEFAULT_OPTIONS: JvGridOptions;
 declare class JvGridComponent<T = any> {
     private readonly gridId;
     protected readonly gridSearchInputId: string;
+    private readonly destroyRef;
+    private readonly document;
     private readonly formatService;
     private readonly translationService;
     readonly data: _angular_core.InputSignal<T[]>;
@@ -1425,7 +1429,7 @@ declare class JvGridComponent<T = any> {
     readonly actions: _angular_core.InputSignal<JvGridAction<T>[]>;
     readonly options: _angular_core.InputSignal<Partial<JvGridOptions>>;
     readonly trackBy: _angular_core.InputSignal<keyof T | ((row: T, index: number) => JvGridRowId) | null>;
-    readonly selectedIds: _angular_core.InputSignal<JvGridRowId[]>;
+    readonly selectedIds: _angular_core.InputSignal<JvGridRowId[] | null>;
     readonly rowClick: _angular_core.OutputEmitterRef<T>;
     readonly rowDoubleClick: _angular_core.OutputEmitterRef<T>;
     readonly actionClick: _angular_core.OutputEmitterRef<{
@@ -1471,19 +1475,32 @@ declare class JvGridComponent<T = any> {
         exportFileName?: string;
         columnFilters?: boolean;
         rowDoubleClick?: boolean;
+        keyboardNavigation?: 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 activeCell: _angular_core.WritableSignal<{
+        row: number;
+        column: number;
+    }>;
     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>;
     readonly pageIndex: _angular_core.WritableSignal<number>;
+    private readonly internalPageSize;
     protected readonly pageSize: _angular_core.Signal<number>;
+    protected readonly pageSizeStr: _angular_core.Signal<string>;
+    protected readonly pageSizeOptions: _angular_core.Signal<{
+        label: string;
+        value: string;
+    }[]>;
+    private readonly pageSizeInputSync;
     private readonly searchPageResetter;
+    private readonly pageBoundsGuard;
     private readonly selectedIdSet;
     protected readonly hasActiveFilters: _angular_core.Signal<boolean>;
     protected readonly filteredData: _angular_core.Signal<T[]>;
@@ -1491,9 +1508,10 @@ declare class JvGridComponent<T = any> {
     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 virtualScrollEnabled: _angular_core.Signal<boolean | undefined>;
     protected readonly virtualStartIndex: _angular_core.WritableSignal<number>;
     protected readonly virtualEndIndex: _angular_core.WritableSignal<number>;
+    private readonly virtualRangeResetter;
     protected readonly virtualDisplayData: _angular_core.Signal<T[]>;
     protected readonly virtualTotalHeight: _angular_core.Signal<number>;
     protected readonly virtualOffsetY: _angular_core.Signal<number>;
@@ -1504,6 +1522,13 @@ 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 cellTabIndex(rowIndex: number, columnIndex: number, col: JvGridColumn<T>): number | null;
+    private flattenColumns;
+    protected onCellFocus(rowIndex: number, columnIndex: number): void;
+    protected onCellKeydown(event: KeyboardEvent, rowIndex: number, columnIndex: number): void;
+    protected onCellF2(event: Event, rowIndex: number, columnIndex: number): void;
+    protected onHeaderFocus(columnIndex: number): void;
+    protected onHeaderKeydown(event: KeyboardEvent, columnIndex: number): void;
     protected editState: _angular_core.WritableSignal<{
         rowId: JvGridRowId;
         colKey: string;
@@ -1514,6 +1539,14 @@ declare class JvGridComponent<T = any> {
     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 getBooleanEditValue(row: T, col: JvGridColumn<T>): boolean;
+    protected isBooleanTrue(value: unknown): boolean;
+    protected editType(col: JvGridColumn<T>): JvGridEditType;
+    protected inputType(col: JvGridColumn<T>): 'text' | 'number' | 'date' | 'time' | 'datetime-local';
+    protected normalizeEditValue(col: JvGridColumn<T>, value: unknown): unknown;
+    private toDateInputValue;
+    private toDateTimeInputValue;
+    private toTimeInputValue;
     protected formatValue(value: unknown, col: JvGridColumn<T>, _row: T): string;
     protected getComparableValue(value: unknown, col: JvGridColumn<T>): string | number | boolean | null;
     protected getSearchValue(value: unknown, col: JvGridColumn<T>): string;
@@ -1538,6 +1571,7 @@ declare class JvGridComponent<T = any> {
     protected goToPage(page: number): void;
     protected isSelected(row: T): boolean;
     protected toggleRow(row: T): void;
+    protected onPageSizeChange(value: string): void;
     protected toggleSelectAll(checked: boolean): void;
     protected onRowClick(event: Event | T, row?: T): void;
     protected onRowDblClick(row: T): void;
@@ -1546,9 +1580,11 @@ declare class JvGridComponent<T = any> {
     protected getRowLabel(row: T, index: number): string;
     protected startEdit(row: T, col: JvGridColumn<T>, event: Event): void;
     protected commitEdit(row: T, col: JvGridColumn<T>, value: unknown): void;
+    protected commitEditFromKeyboard(event: Event, row: T, col: JvGridColumn<T>, value: unknown): void;
     protected cancelEdit(): void;
     protected onEditValueChange(row: T, col: JvGridColumn<T>, value: string): void;
     private resizeData;
+    constructor();
     protected onResizeStart(event: MouseEvent, col: JvGridColumn<T>, _colIdx: number): void;
     private readonly onResizeMove;
     private readonly onResizeEnd;
@@ -1592,4 +1628,4 @@ declare class JvPaginationComponent {
 }
 
 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, JvAccordionComponent, JvAccordionPanelDirective, JvAlertComponent, JvAnnouncementService, JvBadgeComponent, JvBreadcrumbComponent, JvButtonComponent, JvButtonGroupComponent, JvCardComponent, JvChangePasswordPageComponent, JvCheckboxComponent, JvCodeComponent, JvCollapsiblePanelComponent, JvConfirmDialogComponent, JvDashboardShellComponent, JvDatePickerComponent, JvDayPlannerComponent, JvDayPlannerDetailDirective, JvDayPlannerItemDirective, JvDialogComponent, JvDialogService, JvDividerComponent, JvFileInputComponent, JvForgotPasswordPageComponent, JvFormContainerComponent, JvFormatService, JvGridComponent, JvIconButtonComponent, JvIconComponent, JvImageGalleryComponent, JvImageSliderComponent, JvInputComponent, JvListComponent, JvListItemComponent, JvLoaderComponent, JvLoaderService, JvLoginPageComponent, JvModalSelectorComponent, JvMonthCalendarComponent, JvMonthCalendarDayDirective, JvPageComponent, JvPaginationComponent, JvRadioComponent, JvSectionComponent, JvSelectComponent, JvSidebarComponent, JvSwitchComponent, JvTabPanelDirective, JvTabsComponent, JvTextareaComponent, JvThemeService, JvToastComponent, JvToastService, JvTooltipDirective, JvTopbarComponent, JvTranslationService, JvWindowModalComponent, provideJvUi };
-export type { JvAccordionItem, JvActiveConfirmDialog, JvBreadcrumbItem, JvChangePasswordSubmitEvent, JvCodeFont, JvCollapsiblePanelVariant, JvConfirmOptions, JvDayPlannerDetailContext, JvDayPlannerItem, JvDayPlannerItemContext, JvDensity, JvFileInputRejection, JvForgotPasswordSubmitEvent, JvFormatKind, JvFormatOverrides, JvGalleryAction, JvGalleryImage, JvGridAction, JvGridColumn, JvGridColumnFilter, JvGridColumnFormatOptions, JvGridColumnReorderEvent, JvGridColumnResizeEvent, JvGridColumnType, JvGridColumnWidth, JvGridFilterOperator, JvGridOptions, JvGridPageEvent, JvGridRowEditEvent, JvGridRowId, JvGridSortDirection, JvGridSortState, JvGridTrackBy, JvIconDefinition, JvIconElement, JvIntent, JvListItemModel, JvLoaderState, JvLocale, JvLoginSubmitEvent, JvMessagesLocale, JvModalSelectorOption, JvMonthCalendarCell, JvMonthCalendarDayContext, JvMonthCalendarDayMeta, JvMonthCalendarNavigation, JvMonthCalendarResolvedMeta, JvNavItem, JvPaginationEvent, JvSelectOption, JvSliderImage, JvTabItem, JvTabTransition, JvTheme, JvThemeOption, JvToastItem, JvToastPosition, JvToastViewport, JvTone, JvTooltipPosition, JvTopbarAction, JvUiConfig, JvUiConfigInput, JvUiFormats };
+export type { JvAccordionItem, JvActiveConfirmDialog, JvBreadcrumbItem, JvChangePasswordSubmitEvent, JvCodeFont, JvCollapsiblePanelVariant, JvConfirmOptions, JvDayPlannerDetailContext, JvDayPlannerItem, JvDayPlannerItemContext, JvDensity, JvFileInputRejection, JvForgotPasswordSubmitEvent, JvFormatKind, JvFormatOverrides, JvGalleryAction, JvGalleryImage, JvGridAction, JvGridColumn, JvGridColumnFilter, JvGridColumnFormatOptions, JvGridColumnReorderEvent, JvGridColumnResizeEvent, JvGridColumnType, JvGridColumnWidth, JvGridEditType, JvGridFilterOperator, JvGridOptions, JvGridPageEvent, JvGridRowEditEvent, JvGridRowId, JvGridSortDirection, JvGridSortState, JvGridTrackBy, JvIconDefinition, JvIconElement, JvIntent, JvListItemModel, JvLoaderState, JvLocale, JvLoginSubmitEvent, JvMessagesLocale, JvModalSelectorOption, JvMonthCalendarCell, JvMonthCalendarDayContext, JvMonthCalendarDayMeta, JvMonthCalendarNavigation, JvMonthCalendarResolvedMeta, JvNavItem, JvPaginationEvent, JvSelectOption, JvSliderImage, JvTabItem, JvTabTransition, JvTheme, JvThemeOption, JvToastItem, JvToastPosition, JvToastViewport, JvTone, JvTooltipPosition, JvTopbarAction, JvUiConfig, JvUiConfigInput, JvUiFormats };