@devjuliovilla/jv-ui 1.11.2 → 1.12.0

package/package.json

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

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { TemplateRef, ElementRef, InjectionToken, AfterViewInit, OnDestroy } from '@angular/core';
+import { TemplateRef, ElementRef, InjectionToken, OnDestroy, AfterViewInit } from '@angular/core';
 import * as _angular_forms from '@angular/forms';
 import { ControlValueAccessor } from '@angular/forms';
 import * as _devjuliovilla_jv_ui from '@devjuliovilla/jv-ui';
@@ -33,6 +33,188 @@ declare class JvIconButtonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvIconButtonComponent, "jv-icon-button", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": true; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+declare const ES: Record<string, string>;
+
+declare const EN: Record<string, string>;
+
+type JvLocale = 'es' | 'en';
+declare const JV_LOCALE_DICTIONARIES: Record<JvLocale, Record<string, string>>;
+declare const JV_DEFAULT_LOCALE: JvLocale;
+
+declare class JvTranslationService {
+    private readonly config;
+    readonly locale: _angular_core.WritableSignal<JvLocale>;
+    initialize(): void;
+    setLocale(locale: JvLocale): void;
+    setMessagesLocale(locale: JvLocale): void;
+    translate(key: string, params?: Record<string, string | number>): string;
+    private resolveLocale;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvTranslationService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<JvTranslationService>;
+}
+
+declare class JvDayPlannerDetailDirective {
+    readonly templateRef: TemplateRef<JvDayPlannerDetailContext>;
+    constructor(templateRef: TemplateRef<JvDayPlannerDetailContext>);
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvDayPlannerDetailDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<JvDayPlannerDetailDirective, "ng-template[jvDayPlannerDetail]", never, {}, {}, never, never, true, never>;
+}
+
+declare class JvDayPlannerItemDirective {
+    readonly templateRef: TemplateRef<JvDayPlannerItemContext>;
+    constructor(templateRef: TemplateRef<JvDayPlannerItemContext>);
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvDayPlannerItemDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<JvDayPlannerItemDirective, "ng-template[jvDayPlannerItem]", never, {}, {}, never, never, true, never>;
+}
+
+interface JvDayPlannerItem {
+    id: string | number;
+    title: string;
+    date?: Date | string | null;
+    start?: Date | string | null;
+    end?: Date | string | null;
+    status?: string;
+    statusTone?: JvTone;
+    type?: string;
+    typeTone?: JvTone;
+    responsible?: string;
+    location?: string;
+    details?: string;
+    completed?: boolean;
+}
+interface JvResolvedPlannerItem {
+    id: string;
+    raw: JvDayPlannerItem;
+    date: Date | null;
+    start: Date | null;
+    end: Date | null;
+    sortValue: number;
+    hasDetails: boolean;
+}
+interface JvPlannerGroup {
+    key: string;
+    label: string;
+    items: JvResolvedPlannerItem[];
+}
+interface JvDayPlannerItemContext {
+    $implicit: JvDayPlannerItem;
+    item: JvDayPlannerItem;
+    expanded: boolean;
+}
+interface JvDayPlannerDetailContext {
+    $implicit: JvDayPlannerItem;
+    item: JvDayPlannerItem;
+}
+declare class JvDayPlannerComponent {
+    readonly translation: JvTranslationService;
+    private readonly formatService;
+    private readonly customItemTemplate;
+    private readonly customDetailTemplate;
+    private readonly expandedIds;
+    readonly items: _angular_core.InputSignal<JvDayPlannerItem[]>;
+    readonly groupByDate: _angular_core.InputSignal<boolean>;
+    readonly emptyMessage: _angular_core.InputSignal<string>;
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly defaultExpandedItemIds: _angular_core.InputSignal<(string | number)[]>;
+    readonly itemSelect: _angular_core.OutputEmitterRef<JvDayPlannerItem>;
+    protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
+    protected readonly resolvedItems: _angular_core.Signal<JvResolvedPlannerItem[]>;
+    protected readonly groupedItems: _angular_core.Signal<JvPlannerGroup[]>;
+    constructor();
+    protected itemTemplate(): JvDayPlannerItemDirective | undefined;
+    protected detailTemplate(): JvDayPlannerDetailDirective | undefined;
+    protected itemContext(item: JvResolvedPlannerItem): JvDayPlannerItemContext;
+    protected detailContext(item: JvResolvedPlannerItem): JvDayPlannerDetailContext;
+    protected selectItem(item: JvDayPlannerItem): void;
+    protected toggleExpanded(itemId: string): void;
+    protected isExpanded(itemId: string): boolean;
+    protected timeLabel(item: JvResolvedPlannerItem): string;
+    private formatDateLabel;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvDayPlannerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvDayPlannerComponent, "jv-day-planner", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "groupByDate": { "alias": "groupByDate"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "defaultExpandedItemIds": { "alias": "defaultExpandedItemIds"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; }, ["customItemTemplate", "customDetailTemplate"], never, true, never>;
+}
+
+interface JvSelectOption<T = string> {
+    label: string;
+    value: T;
+    disabled?: boolean;
+}
+interface JvModalSelectorOption<T = string> {
+    label: string;
+    value: T;
+    description?: string;
+    keywords?: string[];
+    disabled?: boolean;
+}
+
+declare class JvMonthCalendarDayDirective {
+    readonly templateRef: TemplateRef<JvMonthCalendarDayContext>;
+    constructor(templateRef: TemplateRef<JvMonthCalendarDayContext>);
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvMonthCalendarDayDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<JvMonthCalendarDayDirective, "ng-template[jvMonthCalendarDay]", never, {}, {}, never, never, true, never>;
+}
+
+interface JvMonthCalendarDayMeta {
+    date: Date | string;
+    count?: number;
+    tone?: JvTone;
+    label?: string;
+}
+interface JvMonthCalendarResolvedMeta {
+    count: number;
+    tone: JvTone;
+    label: string;
+}
+interface JvMonthCalendarCell {
+    date: Date;
+    currentMonth: boolean;
+    isToday: boolean;
+    isSelected: boolean;
+    meta: JvMonthCalendarResolvedMeta | null;
+}
+interface JvMonthCalendarDayContext {
+    $implicit: JvMonthCalendarCell;
+    cell: JvMonthCalendarCell;
+}
+declare class JvMonthCalendarComponent {
+    readonly translation: JvTranslationService;
+    private readonly formatService;
+    private readonly gridRootRef;
+    private readonly customDayTemplate;
+    readonly valueInput: _angular_core.InputSignal<string | Date | null | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly dayMeta: _angular_core.InputSignal<JvMonthCalendarDayMeta[]>;
+    readonly selectionChange: _angular_core.OutputEmitterRef<Date>;
+    readonly visibleMonthChange: _angular_core.OutputEmitterRef<Date>;
+    protected readonly visibleMonth: _angular_core.WritableSignal<Date>;
+    protected readonly focusedDate: _angular_core.WritableSignal<Date>;
+    protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
+    protected readonly monthOptions: _angular_core.Signal<JvSelectOption<string>[]>;
+    protected readonly yearOptions: _angular_core.Signal<JvSelectOption<string>[]>;
+    protected readonly weekdayLabels: _angular_core.Signal<string[]>;
+    private readonly metaMap;
+    protected readonly calendarCells: _angular_core.Signal<JvMonthCalendarCell[]>;
+    private readonly selectedDate;
+    constructor();
+    protected dayTemplate(): JvMonthCalendarDayDirective | undefined;
+    protected dayContext(cell: JvMonthCalendarCell): JvMonthCalendarDayContext;
+    protected shiftMonth(offset: number): void;
+    protected handleMonthChange(value: string): void;
+    protected handleYearChange(value: string): void;
+    protected selectToday(): void;
+    protected selectDate(date: Date): void;
+    protected handleDayKeydown(event: KeyboardEvent, date: Date): void;
+    protected isFocusedDate(date: Date): boolean;
+    protected dayAriaLabel(cell: JvMonthCalendarCell): string;
+    protected markerClass(tone: JvTone): string;
+    protected isoDate(date: Date): string;
+    private setVisibleMonth;
+    private focusDateWithinVisibleMonth;
+    private focusDateButton;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvMonthCalendarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvMonthCalendarComponent, "jv-month-calendar", never, { "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "dayMeta": { "alias": "dayMeta"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; "visibleMonthChange": "visibleMonthChange"; }, ["customDayTemplate"], never, true, never>;
+}
+
 interface JvLoginSubmitEvent {
     identifier: string;
     password: string;
@@ -369,19 +551,6 @@ declare class JvFormContainerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvFormContainerComponent, "jv-form-container", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "hintId": { "alias": "hintId"; "required": false; "isSignal": true; }; "errorId": { "alias": "errorId"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
-interface JvSelectOption<T = string> {
-    label: string;
-    value: T;
-    disabled?: boolean;
-}
-interface JvModalSelectorOption<T = string> {
-    label: string;
-    value: T;
-    description?: string;
-    keywords?: string[];
-    disabled?: boolean;
-}
-
 declare class JvInputComponent implements ControlValueAccessor {
     readonly type: _angular_core.InputSignal<"number" | "search" | "text" | "email" | "password">;
     readonly placeholder: _angular_core.InputSignal<string>;
@@ -403,26 +572,6 @@ declare class JvInputComponent implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvInputComponent, "jv-input", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "describedBy": { "alias": "describedBy"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-declare const ES: Record<string, string>;
-
-declare const EN: Record<string, string>;
-
-type JvLocale = 'es' | 'en';
-declare const JV_LOCALE_DICTIONARIES: Record<JvLocale, Record<string, string>>;
-declare const JV_DEFAULT_LOCALE: JvLocale;
-
-declare class JvTranslationService {
-    private readonly config;
-    readonly locale: _angular_core.WritableSignal<JvLocale>;
-    initialize(): void;
-    setLocale(locale: JvLocale): void;
-    setMessagesLocale(locale: JvLocale): void;
-    translate(key: string, params?: Record<string, string | number>): string;
-    private resolveLocale;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvTranslationService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<JvTranslationService>;
-}
-
 interface JvDatePickerCell {
     date: Date;
     currentMonth: boolean;
@@ -832,6 +981,40 @@ declare class JvDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvDialogComponent, "jv-dialog", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[dialog-actions]"], true, never>;
 }
 
+type JvWindowModalMode = 'floating' | 'fullscreen';
+type JvWindowModalSize = 'lg' | 'xl' | 'fullscreen';
+declare class JvWindowModalComponent implements OnDestroy {
+    private readonly document;
+    private readonly panelRef;
+    readonly open: _angular_core.InputSignal<boolean>;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string>;
+    readonly mode: _angular_core.InputSignal<JvWindowModalMode>;
+    readonly size: _angular_core.InputSignal<JvWindowModalSize>;
+    readonly showCloseButton: _angular_core.InputSignal<boolean>;
+    readonly closeOnBackdrop: _angular_core.InputSignal<boolean>;
+    readonly closeOnEscape: _angular_core.InputSignal<boolean>;
+    readonly closeLabel: _angular_core.InputSignal<string>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    readonly close: _angular_core.OutputEmitterRef<void>;
+    protected readonly resolvedMode: _angular_core.Signal<JvWindowModalMode>;
+    protected readonly titleId: string;
+    protected readonly descriptionId: string;
+    private previousFocusedElement;
+    private previousBodyOverflow;
+    private wasOpen;
+    constructor();
+    ngOnDestroy(): void;
+    handleDocumentKeydown(event: KeyboardEvent): void;
+    protected backdropClose(): void;
+    protected requestClose(): void;
+    private focusInitialElement;
+    private trapFocus;
+    private getFocusableElements;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvWindowModalComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvWindowModalComponent, "jv-window-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; }, { "closed": "closed"; "close": "close"; }, never, ["[window-modal-header-actions]", "*", "[window-modal-footer]"], true, never>;
+}
+
 interface JvBreadcrumbItem {
     label: string;
     href?: string;
@@ -1379,5 +1562,5 @@ declare class JvPaginationComponent {
     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, JvAccordionComponent, JvAccordionPanelDirective, JvAlertComponent, JvAnnouncementService, JvBadgeComponent, JvBreadcrumbComponent, JvButtonComponent, JvButtonGroupComponent, JvCardComponent, JvChangePasswordPageComponent, JvCheckboxComponent, JvCodeComponent, JvCollapsiblePanelComponent, JvConfirmDialogComponent, JvDashboardShellComponent, JvDatePickerComponent, JvDialogComponent, JvDialogService, JvDividerComponent, JvFileInputComponent, JvForgotPasswordPageComponent, JvFormContainerComponent, JvFormatService, JvGridComponent, JvIconButtonComponent, JvIconComponent, JvImageGalleryComponent, JvImageSliderComponent, JvInputComponent, JvListComponent, JvListItemComponent, JvLoaderComponent, JvLoaderService, JvLoginPageComponent, JvModalSelectorComponent, JvPageComponent, JvPaginationComponent, JvRadioComponent, JvSectionComponent, JvSelectComponent, JvSidebarComponent, JvSwitchComponent, JvTabPanelDirective, JvTabsComponent, JvTextareaComponent, JvThemeService, JvToastComponent, JvToastService, JvTooltipDirective, JvTopbarComponent, JvTranslationService, provideJvUi };
-export type { JvAccordionItem, JvActiveConfirmDialog, JvBreadcrumbItem, JvChangePasswordSubmitEvent, JvCodeFont, JvCollapsiblePanelVariant, JvConfirmOptions, 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, JvNavItem, JvPaginationEvent, JvSelectOption, JvSliderImage, JvTabItem, JvTabTransition, JvTheme, JvThemeOption, JvToastItem, JvToastPosition, JvToastViewport, JvTone, JvTooltipPosition, JvTopbarAction, JvUiConfig, JvUiConfigInput, JvUiFormats };
+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, JvMonthCalendarResolvedMeta, JvNavItem, JvPaginationEvent, JvSelectOption, JvSliderImage, JvTabItem, JvTabTransition, JvTheme, JvThemeOption, JvToastItem, JvToastPosition, JvToastViewport, JvTone, JvTooltipPosition, JvTopbarAction, JvUiConfig, JvUiConfigInput, JvUiFormats };