@devjuliovilla/jv-ui 1.9.0 → 1.10.0

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@devjuliovilla/jv-ui",
-  "version": "1.9.0",
+  "version": "1.10.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",
+  "publishConfig": {
+    "access": "public"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/devjuliovilla/JV_UI.git"

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

@@ -214,14 +214,30 @@ declare class JvBadgeComponent {
 
 type JvTheme = 'light' | 'dark' | 'high-contrast';
 type JvDensity = 'compact' | 'normal' | 'comfortable';
+type JvMessagesLocale = 'es' | 'en';
+interface JvUiFormats {
+    date: Intl.DateTimeFormatOptions;
+    time: Intl.DateTimeFormatOptions;
+    datetime: Intl.DateTimeFormatOptions;
+    integer: Intl.NumberFormatOptions;
+    number: Intl.NumberFormatOptions;
+    currency: Intl.NumberFormatOptions;
+    percent: Intl.NumberFormatOptions;
+}
 type JvToastPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
 interface JvUiConfig {
     theme: JvTheme;
     density: JvDensity;
     language: string;
-    locale: string;
+    locale?: string;
+    messagesLocale: JvMessagesLocale;
+    formatLocale: string;
+    formats: JvUiFormats;
     toastPosition: JvToastPosition;
 }
+type JvUiConfigInput = Omit<Partial<JvUiConfig>, 'formats'> & {
+    formats?: Partial<JvUiFormats>;
+};
 declare const JV_UI_DEFAULT_CONFIG: JvUiConfig;
 
 interface JvToastItem {
@@ -398,6 +414,7 @@ declare class JvTranslationService {
     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>;
@@ -411,6 +428,7 @@ interface JvDatePickerCell {
 }
 declare class JvDatePickerComponent implements ControlValueAccessor {
     readonly translation: JvTranslationService;
+    private readonly formatService;
     private readonly announcementService;
     private readonly instanceId;
     private readonly calendarRootRef;
@@ -467,6 +485,51 @@ declare class JvDatePickerComponent implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvDatePickerComponent, "jv-date-picker", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "dialogTitle": { "alias": "dialogTitle"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "describedBy": { "alias": "describedBy"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, never, never, true, never>;
 }
 
+interface JvFileInputRejection {
+    files: File[];
+    reason: 'accept' | 'maxFiles';
+}
+declare class JvFileInputComponent {
+    protected readonly translation: JvTranslationService;
+    private readonly instanceId;
+    private readonly nativeInputRef;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly hint: _angular_core.InputSignal<string>;
+    readonly error: _angular_core.InputSignal<string>;
+    readonly describedBy: _angular_core.InputSignal<string>;
+    readonly inputId: _angular_core.InputSignal<string>;
+    readonly accept: _angular_core.InputSignal<string>;
+    readonly multiple: _angular_core.InputSignal<boolean>;
+    readonly maxFiles: _angular_core.InputSignal<number>;
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly required: _angular_core.InputSignal<boolean>;
+    readonly invalid: _angular_core.InputSignal<boolean>;
+    readonly filesInput: _angular_core.InputSignal<readonly File[] | null | undefined>;
+    readonly filesChange: _angular_core.OutputEmitterRef<File[]>;
+    readonly filesRejected: _angular_core.OutputEmitterRef<JvFileInputRejection>;
+    protected readonly dragActive: _angular_core.WritableSignal<boolean>;
+    protected readonly rejectionMessage: _angular_core.WritableSignal<string>;
+    private readonly internalFiles;
+    protected readonly currentFiles: _angular_core.Signal<File[]>;
+    protected readonly selectionSummary: _angular_core.Signal<string>;
+    protected readonly dropzoneAriaLabel: _angular_core.Signal<string>;
+    protected openFileDialog(): void;
+    protected handleDropzoneKeydown(event: KeyboardEvent): void;
+    protected onNativeInputChange(fileList: FileList | null): void;
+    protected onDragEnter(event: DragEvent): void;
+    protected onDragOver(event: DragEvent): void;
+    protected onDragLeave(event: DragEvent): void;
+    protected onDrop(event: DragEvent): void;
+    protected removeFile(index: number): void;
+    protected trackFile(index: number, file: File): string;
+    protected formatBytes(size: number): string;
+    private consumeFiles;
+    private updateFiles;
+    private matchesAccept;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvFileInputComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<JvFileInputComponent, "jv-file-input", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "describedBy": { "alias": "describedBy"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "filesInput": { "alias": "files"; "required": false; "isSignal": true; }; }, { "filesChange": "filesChange"; "filesRejected": "filesRejected"; }, never, never, true, never>;
+}
+
 declare class JvModalSelectorComponent implements ControlValueAccessor {
     private readonly announcementService;
     protected readonly translation: JvTranslationService;
@@ -636,9 +699,9 @@ interface JvIconDefinition {
 declare const JV_FALLBACK_ICON_NAME = "circle-alert";
 declare const JV_LUCIDE_ICON_REGISTRY: Record<string, JvIconDefinition>;
 
-declare const JV_UI_CONFIG: InjectionToken<Partial<JvUiConfig>[]>;
+declare const JV_UI_CONFIG: InjectionToken<JvUiConfigInput[]>;
 declare const JV_UI_CONFIG_DEFAULTS: InjectionToken<JvUiConfig>;
-declare function provideJvUi(config?: Partial<JvUiConfig>): _angular_core.EnvironmentProviders;
+declare function provideJvUi(config?: JvUiConfigInput): _angular_core.EnvironmentProviders;
 
 declare class JvDialogService {
     private readonly announcementService;
@@ -827,6 +890,29 @@ declare class JvAnnouncementService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<JvAnnouncementService>;
 }
 
+type JvFormatKind = keyof JvUiFormats;
+type JvFormatOverrides = Intl.DateTimeFormatOptions & Intl.NumberFormatOptions;
+declare class JvFormatService {
+    private readonly config;
+    readonly formatLocale: _angular_core.WritableSignal<string>;
+    readonly formats: _angular_core.WritableSignal<JvUiFormats>;
+    readonly firstDayOfWeek: _angular_core.Signal<number>;
+    initialize(): void;
+    setFormatLocale(locale: string): void;
+    setFormats(formats: Partial<JvUiFormats>): void;
+    format(kind: JvFormatKind, value: unknown, overrides?: JvFormatOverrides): string;
+    toComparable(kind: JvFormatKind, value: unknown): string | number | boolean | null;
+    toDate(value: unknown): Date | null;
+    toNumber(value: unknown): number | null;
+    toSearchValue(kind: JvFormatKind, value: unknown): string;
+    private resolveFormats;
+    private resolveDateOptions;
+    private resolveNumberOptions;
+    private resolveFirstDayOfWeek;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JvFormatService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<JvFormatService>;
+}
+
 declare class JvListComponent {
     readonly role: _angular_core.InputSignal<"list" | "navigation">;
     readonly ariaRole: _angular_core.InputSignal<string | null>;
@@ -937,6 +1023,8 @@ interface JvGridSortState {
     columnKey: string;
     direction: JvGridSortDirection;
 }
+type JvGridColumnType = 'text' | 'integer' | 'number' | 'currency' | 'percent' | 'date' | 'time' | 'datetime' | 'boolean';
+type JvGridColumnFormatOptions = Intl.NumberFormatOptions & Intl.DateTimeFormatOptions;
 interface JvGridColumn<T = any> {
     key: keyof T | string;
     header: string;
@@ -951,7 +1039,8 @@ interface JvGridColumn<T = any> {
     minWidth?: string;
     maxWidth?: string;
     align?: 'start' | 'center' | 'end';
-    type?: 'text' | 'number' | 'currency' | 'date' | 'datetime' | 'boolean';
+    type?: JvGridColumnType;
+    formatOptions?: JvGridColumnFormatOptions;
     cellClass?: string;
     headerClass?: string;
     format?: (value: unknown, row: T) => string;
@@ -1027,6 +1116,7 @@ declare const JV_GRID_DEFAULT_OPTIONS: JvGridOptions;
 
 declare class JvGridComponent<T = any> {
     private readonly gridId;
+    private readonly formatService;
     private readonly translationService;
     readonly data: _angular_core.InputSignal<T[]>;
     readonly columns: _angular_core.InputSignal<JvGridColumn<T>[]>;
@@ -1121,7 +1211,12 @@ 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 formatValue(value: unknown, col: JvGridColumn<T>): string;
+    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;
+    protected getExportValue(value: unknown, col: JvGridColumn<T>): string;
+    protected resolveColumnType(col: JvGridColumn<T>): JvGridColumnType;
+    protected getFormatOverrides(col: JvGridColumn<T>): JvFormatOverrides | undefined;
     protected getAriaSort(col: JvGridColumn<T>): 'ascending' | 'descending' | 'none' | null;
     protected getSortLabel(col: JvGridColumn<T>): string;
     protected getColumnWidth(col: JvGridColumn<T>): string | undefined;
@@ -1191,5 +1286,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, JvForgotPasswordPageComponent, JvFormContainerComponent, JvGridComponent, JvIconButtonComponent, JvIconComponent, 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, JvForgotPasswordSubmitEvent, JvGridAction, JvGridColumn, JvGridColumnFilter, JvGridColumnReorderEvent, JvGridColumnResizeEvent, JvGridColumnWidth, JvGridFilterOperator, JvGridOptions, JvGridPageEvent, JvGridRowEditEvent, JvGridRowId, JvGridSortDirection, JvGridSortState, JvGridTrackBy, JvIconDefinition, JvIconElement, JvIntent, JvListItemModel, JvLoaderState, JvLocale, JvLoginSubmitEvent, JvModalSelectorOption, JvNavItem, JvPaginationEvent, JvSelectOption, JvTabItem, JvTheme, JvThemeOption, JvToastItem, JvToastPosition, JvToastViewport, JvTone, JvTooltipPosition, 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, 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, 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, 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, JvTabItem, JvTheme, JvThemeOption, JvToastItem, JvToastPosition, JvToastViewport, JvTone, JvTooltipPosition, JvTopbarAction, JvUiConfig, JvUiConfigInput, JvUiFormats };