@randstad-uca/design-system 1.0.64 → 1.0.66

package/dist/components/CalendarOverlay.d.ts

@@ -19,14 +19,24 @@ export declare class CalendarOverlay extends LitElement {
       * Determina qué cuadrícula se renderiza en el overlay.
     */
     private currentView;
+    private initialFocusElement;
     static styles: (import("lit").CSSResult | CSSStyleSheet)[];
+    /**
+      * Ciclo de vida: se llama después de la primera actualización del componente.
+     
+      * Agrega un 'keydown' listener al shadowRoot para capturar todas las pulsaciones
+      * de teclado dentro del calendario (días, meses, navegación) y centralizar la
+      * lógica de accesibilidad (ARIA) en 'handleCalendarKeydown'.
+    */
+    firstUpdated(): void;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    private handleFocusInput;
     /**
       * Cierra el overlay del calendario si el clic se produce fuera de sus límites.
       * Se utiliza un `event listener` en el documento para detectar clics en cualquier lugar de la página.
       
-      * @param e - Objeto de evento del clic.
+      * @param event - Objeto de evento del clic.
     */
     private handleOutsideClick;
     /**
@@ -71,6 +81,39 @@ export declare class CalendarOverlay extends LitElement {
     private getFullMonthNames;
     private getShortMonthNames;
     private getShortWeekdays;
+    /**
+      * Enfoca el elemento inicial del calendario (típicamente el botón de Mes/Año).
+     
+      * Se llama desde el DatePickerComponent cuando el calendario se abre
+      * mediante teclado (tecla ArrowDown o Enter). El 'updateComplete' asegura
+      * que el foco se aplica después de que el overlay esté completamente renderizado.
+    */
+    focusCalendar(): void;
+    /**
+      * Encuentra el botón de día en el calendario que está `offset` días
+      * de la fecha del día enfocado actualmente.
+    */
+    private _findAndFocusDayButton;
+    /**
+      * Enfoca el primer o último día de la semana actual.
+    */
+    private _focusDayOfWeekEdge;
+    /**
+      * Centraliza el manejo de todos los eventos de teclado (keydown) dentro del CalendarOverlay.
+    
+      * Implementa la navegación completa del teclado (flechas, Enter/Space, Escape) para
+      * todas las vistas y elementos enfocables (botones de encabezado, días, meses, años),
+      * asegurando la conformidad con ARIA.
+     
+      * La lógica se divide en secciones basadas en el elemento que tiene el foco activo:
+      * 1. Escape (Cerrar).
+      * 2. Encabezado (Botones de Mes/Año y Navegación Anterior/Siguiente).
+      * 3. Cuadrícula de Días.
+      * 4. Cuadrículas de Meses/Años.
+     
+      * @param event - El objeto KeyboardEvent.
+    */
+    private handleCalendarKeydown;
     /**
       * Renderiza el encabezado del calendario, mostrando el mes y el año actuales.
       * Incluye botones de navegación y un botón para cambiar la vista (a meses/años).

package/dist/components/Checkbox.d.ts

@@ -5,5 +5,6 @@ export declare class Checkbox extends LitElement {
     disabled: boolean;
     static styles: import("lit").CSSResult;
     private toggleCheck;
+    private handleKeyDown;
     render(): import("lit-html").TemplateResult<1>;
 }

package/dist/components/DatePicker.d.ts

@@ -15,6 +15,11 @@ export declare class DatePickerComponent extends BaseControl {
     private inputContainer;
     static styles: import("lit").CSSResult;
     private setMessageErrorFormatInvalid;
+    /**
+      * Devuelve el foco al input principal del DatePicker.
+      * Se utiliza cuando el usuario sale del CalendarOverlay (ej. tecla ArrowUp).
+    */
+    private handleFocusInput;
     /**
       * Ciclo de vida: se ejecuta al conectar el componente al DOM.
       * Inicializa el modo responsivo y listeners globales.
@@ -65,7 +70,7 @@ export declare class DatePickerComponent extends BaseControl {
       
       * @param e - Objeto de evento del clic.
     */
-    handleCalendarButtonClick(e: Event): void;
+    handleCalendarButtonClick(event: Event): void;
     /**
       * Borra la fecha seleccionada y cierra el calendario.
     */
@@ -147,6 +152,20 @@ export declare class DatePickerComponent extends BaseControl {
       * @returns Verdadero si la fecha está dentro de los límites, de lo contrario, falso.
     */
     private _isWithinBounds;
+    /**
+      * Maneja eventos de teclado en el input principal.
+  
+      @param event El objeto KeyboardEvent.
+    */
+    handleKeyDown(event: KeyboardEvent): void;
+    /**
+      * Maneja los eventos de teclado en el botón de borrar (Close/Clear).
+    */
+    handleClearButtonKeydown(event: KeyboardEvent): void;
+    /**
+      * Maneja los eventos de teclado en el botón del calendario.
+    */
+    handleCalendarButtonKeydown(event: KeyboardEvent): void;
     /**
       * Renderiza el componente DatePicker, incluyendo el input, botones y el overlay del calendario.
     */

package/dist/components/File.d.ts

@@ -14,5 +14,6 @@ export declare class UploadFile extends BaseUpload {
     updated(changedProperties: Map<string, any>): void;
     private applyWidth;
     private onFileInputChange;
+    willUpdate(changedProperties: Map<string | number | symbol, unknown>): void;
     render(): TemplateResult<1>;
 }

package/dist/components/Form.d.ts

@@ -21,6 +21,13 @@ export declare class RandstadForm extends BaseControl {
     handleInputCustom(event: Event): void;
     onlyNumeric(event: Event): void;
     onlyText(event: Event): void;
+    private handleInputKeyDown;
+    /**
+      * Calcula si el botón de limpieza (X) debe estar visible
+    */
+    private get _isCleanButtonVisible();
     private handleKeyDown;
+    private handleInputArrowKey;
+    private handleButtonArrowKey;
     render(): TemplateResult<1>;
 }

package/dist/components/Radio.d.ts

@@ -1,10 +1,14 @@
 import { LitElement } from 'lit';
-import '@material/web/radio/radio.js';
 export declare class CustomRadio extends LitElement {
     name: string;
     checked: boolean;
     disabled: boolean;
     error: boolean;
+    label: string;
+    value: string;
     static styles: import("lit").CSSResult;
+    private handleSelect;
+    private handleKeyDown;
+    private handleClick;
     render(): import("lit-html").TemplateResult<1>;
 }

package/dist/components/Select.d.ts

@@ -12,6 +12,7 @@ export declare class FilterableSelect extends BaseControl {
     options: SelectOption[];
     filterable: boolean;
     maxLength?: number;
+    isRenderClearButton: boolean;
     private isMobile;
     private highlightedIndex;
     private _isCleared;
@@ -26,15 +27,33 @@ export declare class FilterableSelect extends BaseControl {
     disconnectedCallback(): void;
     private updateResponsiveModeBound;
     private updateResponsiveMode;
-    handleInputClick(e: Event): void;
-    handleInput(e: Event): void;
-    handleMobileInput(e: Event): void;
+    handleInputClick(event: Event): void;
+    handleInput(event: Event): void;
+    handleMobileInput(event: Event): void;
     handleSelect(option: SelectOption): void;
     handleIconClick(): void;
-    handleClickOutside(e: Event): void;
-    handleKeyDown(e: KeyboardEvent): void;
+    handleClickOutside(event: Event): void;
+    /**
+      * Maneja los eventos de teclado cuando el foco está en el input o el filter-fake (combobox).
+    */
+    handleKeyDown(event: KeyboardEvent): void;
+    /**
+      * Maneja los eventos de teclado cuando el foco está en el botón de toggle/clear.
+      * Su única responsabilidad es:
+      * 1. Abrir/cerrar la lista con Enter/Space.
+      * 2. Transferir el foco al input/fake para que 'handleKeyDown' tome el control de las flechas.
+      * 3. Cerrar la lista al presionar Tab.
+    */
+    handleButtonKeyDown(event: KeyboardEvent): void;
+    /**
+      * Limpia el valor visible del input (filterValue) si no hay un valor de opción válido seleccionado (this.value).
+      * Se llama al perder el foco.
+    */
+    handleBlur(): void;
+    private scrollHighlightedIntoView;
     private renderSelectedIcon;
     private renderOptionIcon;
+    private _getFilteredOptions;
     render(): TemplateResult<1>;
 }
 export {};

package/dist/components/Upload.d.ts

@@ -4,6 +4,7 @@ export declare class UploadImage extends BaseUpload {
     acceptedFileTypes: string[];
     maxFiles: number;
     maxFileSize: number;
+    isShowInfoSize: boolean;
     private isDragging;
     private imageUrls;
     private isMaxFilesReached;

package/dist/helpers/BaseUpload.d.ts

@@ -11,10 +11,24 @@ export interface FileHandlerConfig {
 export declare class BaseUpload extends BaseControl {
     files: File[];
     simulatedDelay: number;
+    showAlertInError: boolean;
+    typeTextFile: string;
     protected loading: boolean;
     protected progress: number;
     protected errorTextMessage: string | null;
     protected fileInput: HTMLInputElement;
+    isMultiple: boolean;
+    private readonly TEXT_SNACKBAR_ERROR_TYPE;
+    private readonly TEXT_SNACKBAR_ERROR_SIZE;
+    private readonly TEXT_SNACKBAR_ERROR_DELETE;
+    /**
+        * Muestra el componente de randstad-snackbar globalmente.
+        * Asume que el componente existe en el DOM principal.
+        
+        @param message El mensaje de error a mostrar.
+        @param duration El tiempo en milisegundos que el snackbar debe permanecer abierto.
+    */
+    protected showSnackbar(message: string, duration: number | undefined, type: 'success' | 'error'): void;
     /**
         Convierte el tamaño máximo de archivo de bytes a megabytes (MB) para mostrar en la interfaz de usuario.
     
@@ -22,7 +36,7 @@ export declare class BaseUpload extends BaseControl {
 
         @returns El tamaño máximo del archivo en megabytes.
     */
-    protected baseGetTextMaxFileSize(maxFileSize: number): number;
+    protected baseGetTextMaxFileSize(maxFileSize: number): string;
     /**
         * Convierte una lista de tipos MIME en un string de nombres de archivos legibles.
         * Por ejemplo, 'application/pdf' se convierte en 'PDF'.
@@ -65,7 +79,7 @@ export declare class BaseUpload extends BaseControl {
     protected baseOnFileInputChange(event: Event, config: FileHandlerConfig): void;
     /**
         * Elimina un archivo de la lista de archivos seleccionados.
-
+        
         @param index El índice del archivo a eliminar.
         @param typeError El tipo de error que se está manejando ('image' o 'file').
     */