shirkasoft-ui-components 1.1.3 → 1.2.0

package/types/shirkasoft-ui-components.d.ts

@@ -3,203 +3,464 @@ import { ElementRef, OnDestroy, Type, ViewContainerRef, ComponentRef, AfterViewI
 import { ControlValueAccessor, FormGroup, FormControl } from '@angular/forms';
 import { Observable } from 'rxjs';
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Text input (or textarea) that implements ControlValueAccessor with built-in
+ * validation messages, card/number formatting, password reveal and search mode.
+ */
 declare class TextFieldComponent implements ControlValueAccessor {
     private cdr;
+    /** id attribute applied to the native input. */
     id: _angular_core.InputSignal<string>;
+    /** Formats the value as a credit card number (XXXX-XXXX-XXXX-XXXX). */
     formatCard: _angular_core.InputSignal<boolean>;
+    /** Blocks the minus sign from being typed. */
     preventNegative: _angular_core.InputSignal<boolean>;
+    /** Label rendered above the field. */
     label: _angular_core.InputSignal<string>;
+    /** Native input type ('text', 'password', 'number', etc.). */
     type: _angular_core.InputSignal<string>;
+    /** Allows digits only, stripping any other character. */
     numbersOnly: _angular_core.InputSignal<boolean>;
+    /** When true, allows decimals and normalizes ',' to '.'. */
     allowDecimals: _angular_core.InputSignal<boolean>;
+    /** Maximum number of characters the user can type. */
     maxLength: _angular_core.InputSignal<number | undefined>;
+    /** Placeholder text of the native input. */
     placeholder: _angular_core.InputSignal<string>;
+    /** Custom messages keyed by validation error name. */
     errorMessages: _angular_core.InputSignal<{
         [key: string]: string;
     }>;
+    /** Parent reactive form used to resolve the control by label. */
     formGroup: _angular_core.InputSignal<FormGroup<any> | undefined>;
+    /** Reactive control bound directly to this field. */
     control: _angular_core.InputSignal<FormControl<any> | undefined>;
+    /** Disables the field. */
     disabled: _angular_core.InputSignal<boolean>;
+    /** Custom error message shown regardless of validation errors. */
     errorMessage: _angular_core.InputSignal<string>;
+    /** Renders a textarea instead of an input. */
     isTextArea: _angular_core.InputSignal<boolean>;
+    /** Height classes applied when `isTextArea` is true. */
     textAreaHeight: _angular_core.InputSignal<string>;
+    /** Renders the field as a read-only search trigger. */
     searchMode: _angular_core.InputSignal<boolean>;
+    /** Value shown when `searchMode` is enabled. */
     displayValue: _angular_core.InputSignal<string>;
+    /** Native autocomplete attribute. */
     autocomplete: _angular_core.InputSignal<string>;
+    /** Emitted when the search button is clicked (search mode). */
     searchButtonClick: _angular_core.OutputEmitterRef<void>;
-    protected readonly getIcon: (name: string) => any;
+    protected readonly getIcon: (name: any) => any;
+    /** Reference to the native input element. */
     inputElement: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
+    /** Reference to the native textarea element. */
     textareaElement: _angular_core.Signal<ElementRef<HTMLTextAreaElement> | undefined>;
+    /** Internal raw value of the field. */
     private _value;
+    /** Reactive disabled state from the form control. */
     private _disabledState;
+    /** Whether the password is currently revealed. */
     showPassword: _angular_core.WritableSignal<boolean>;
+    /** Tracks whether the control was in error at some point (for "was fixed" UX). */
     hadError: _angular_core.WritableSignal<boolean>;
+    /** Counter bumped to trigger recomputation of derived error signals. */
     private errorTracker;
+    /** Text displayed in search mode when `displayValue` is set. */
     displayLabel: _angular_core.Signal<string>;
+    /** Prevents re-subscribing to the same form control. */
     private subscribed;
+    /** Effective disabled state combining the input and the form binding. */
     isDisabled: _angular_core.Signal<boolean>;
+    /** Current field value. */
     value: _angular_core.Signal<any>;
+    /** Resolves the reactive control: explicit `control` or `formGroup.get(label)`. */
     actualControl: _angular_core.Signal<FormControl<any> | undefined>;
+    /** True when the resolved control is invalid and dirty or touched. */
     shouldShowError: _angular_core.Signal<boolean | undefined>;
+    /** True when the control had an error before and is now valid (success state). */
     wasFixedError: _angular_core.Signal<boolean | undefined>;
+    /** Resolved list of error messages for the current control state. */
     getErrorMessages: _angular_core.Signal<string[]>;
+    /** Effective input type (handles textarea and password reveal). */
     effectiveType: _angular_core.Signal<string>;
     private transloco;
+    /** Callback notified with the new value (ControlValueAccessor). */
     private onChange;
+    /** Callback notified when the field is touched (ControlValueAccessor). */
     private onTouched;
     private destroyRef;
     constructor();
+    /** Prevents disallowed characters based on the `numbersOnly`/`allowDecimals` config. */
     numberValidation(event: KeyboardEvent): void;
+    /** Marks the field as touched and refreshes the error state. */
     onBlur(): void;
+    /** Formats the raw input as a credit card number and notifies the control. */
     onCardInput(event: Event): void;
+    /** Handles raw input: applies number/card/max-length formatting and notifies the control. */
     onInput(event: Event): void;
+    /** Toggles the visibility of a password field. */
     togglePasswordVisibility(): void;
+    /** Sets the value from the form control applying the same formatting rules. */
     writeValue(value: any): void;
+    /** Registers the callback invoked on value changes (ControlValueAccessor). */
     registerOnChange(fn: any): void;
+    /** Registers the callback invoked when the field is touched. */
     registerOnTouched(fn: any): void;
+    /** Reflects the disabled state of the form control. */
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextFieldComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextFieldComponent, "shk-text-field", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "formatCard": { "alias": "formatCard"; "required": false; "isSignal": true; }; "preventNegative": { "alias": "preventNegative"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "numbersOnly": { "alias": "numbersOnly"; "required": false; "isSignal": true; }; "allowDecimals": { "alias": "allowDecimals"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "formGroup": { "alias": "formGroup"; "required": false; "isSignal": true; }; "control": { "alias": "control"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "isTextArea": { "alias": "isTextArea"; "required": false; "isSignal": true; }; "textAreaHeight": { "alias": "textAreaHeight"; "required": false; "isSignal": true; }; "searchMode": { "alias": "searchMode"; "required": false; "isSignal": true; }; "displayValue": { "alias": "displayValue"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; }, { "searchButtonClick": "searchButtonClick"; }, never, never, true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Toast-style notification entry. */
 interface Notification {
     id: string;
     message: string;
     type: 'success' | 'error' | 'warning' | 'info';
+    /** Current progress 0-100 when `showProgress` is true. */
     progress?: number;
+    /** Whether the notification renders a progress indicator. */
     showProgress?: boolean;
 }
+/**
+ * Central notification store. Components push/update/remove notifications
+ * reactively through signals for the notification component to render.
+ */
 declare class NotificationService {
+    /** Reactive list of visible notifications. */
     private notificationsSignal;
+    /** Monotonic id counter for new notifications. */
     private currentId;
+    /** Readonly reactive list of visible notifications. */
     notifications: _angular_core.Signal<Notification[]>;
+    /**
+     * Adds a notification and returns its id. When `showProgress` is false and
+     * `duration` is positive, it auto-removes after that many ms.
+     */
     addNotification(message: string, type?: Notification['type'], showProgress?: boolean, duration?: number): string;
+    /** Updates a progress notification; auto-removes when progress hits 100. */
     updateProgress(notificationId: string, progress: number): void;
+    /** Removes the given notification. */
     removeNotification(notification: Notification): void;
+    /** Removes the notification with the given id. */
     removeNotificationById(notificationId: string): void;
+    /** Removes every visible notification. */
     clearAll(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NotificationService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<NotificationService>;
 }
 
 type NotificationPosition = 'center-top' | 'right-top' | 'left-top';
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Toast notification host that renders the notifications pushed through the
+ * NotificationService in the configured position.
+ */
 declare class NotificationComponent {
+    /** Position of the notification stack: center, right or left top. */
     position: _angular_core.InputSignal<NotificationPosition>;
     private notificationService;
-    protected getIcon: (name: string) => any;
+    protected getIcon: (name: any) => any;
+    /** Maps each notification type to its internal icon name. */
     private readonly iconMap;
+    /** Resolves the icon name for a notification type. */
     getNotificationIcon(type: string): string;
+    /** Live list of active notifications. */
     notifications: _angular_core.Signal<Notification[]>;
+    /** Notifications sorted with the newest first. */
     sortedNotifications: _angular_core.Signal<Notification[]>;
+    /** Removes a notification through the service. */
     removeNotification(notification: Notification): void;
+    /** Rounds the progress value of a notification. */
     roundProgress(progress: number | undefined): number;
+    /** Whether there are notifications to show. */
     hasNotifications: _angular_core.Signal<boolean>;
+    /** CSS classes positioning the stack according to `position`. */
     positionClass: _angular_core.Signal<"fixed top-4 z-[9999] space-y-4 sm:space-y-6 sm:top-6 lg:top-8 right-4" | "fixed top-4 z-[9999] space-y-4 sm:space-y-6 sm:top-6 lg:top-8 left-4" | "fixed top-4 z-[9999] space-y-4 sm:space-y-6 sm:top-6 lg:top-8 left-1/2 -translate-x-1/2">;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NotificationComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NotificationComponent, "shk-notification", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Switch / checkbox component that implements ControlValueAccessor so it can
+ * be used with reactive and template-driven forms.
+ */
 declare class ToggleComponent implements ControlValueAccessor {
+    /** Text displayed next to the control. */
     label: _angular_core.InputSignal<string>;
+    /** Visual style: 'toggle' (switch) or 'checkbox'. Defaults to 'toggle'. */
     mode: _angular_core.InputSignal<"toggle" | "checkbox">;
+    /** Manually controlled checked state (supports one-way binding). */
     checked: _angular_core.InputSignal<boolean | undefined>;
+    /** Emitted with the new value when the user toggles the control. */
     checkedChange: _angular_core.OutputEmitterRef<boolean>;
+    /** Internal controlled/reactive value. */
     _value: _angular_core.WritableSignal<boolean>;
+    /** Reactive disabled state. */
     _disabled: _angular_core.WritableSignal<boolean>;
+    /** Callback notified with the new value on change (ControlValueAccessor). */
     private onChange;
+    /** Callback notified when the control loses focus or is touched. */
     private onTouched;
     constructor();
+    /** Sets the value from the form control. */
     writeValue(value: any): void;
+    /** Registers the callback invoked on value changes (ControlValueAccessor). */
     registerOnChange(fn: any): void;
+    /** Registers the callback invoked when the control is touched. */
     registerOnTouched(fn: any): void;
+    /** Reflects the disabled state of the form control. */
     setDisabledState(isDisabled: boolean): void;
+    /**
+     * Inverts the current value (unless disabled), notifies the form control,
+     * marks the control as touched and emits `checkedChange`.
+     */
     toggle(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToggleComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToggleComponent, "shk-toggle", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; }, { "checkedChange": "checkedChange"; }, never, never, true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Numeric input tailored for currency values with a optional percentage mode.
+ * Uses two-way bindable models: `value` and `isPercentage`.
+ */
 declare class PriceInputComponent {
+    /** Numeric value, bindable with [(value)]. */
     value: _angular_core.ModelSignal<number>;
+    /** Whether the input works as a percentage, bindable with [(isPercentage)]. */
     isPercentage: _angular_core.ModelSignal<boolean>;
+    /** Label displayed above the field. */
     label: _angular_core.InputSignal<string>;
+    /** id attribute applied to the native input. */
     inputId: _angular_core.InputSignal<string>;
+    /** Marks the field as required. */
     required: _angular_core.InputSignal<boolean>;
+    /** Disables the input. */
     disabled: _angular_core.InputSignal<boolean>;
+    /** Minimum allowed value. */
     min: _angular_core.InputSignal<number>;
+    /** Maximum allowed value. */
     max: _angular_core.InputSignal<number>;
+    /** Shows the error styling on the field. */
     showError: _angular_core.InputSignal<boolean>;
+    /** Message rendered when the field is in error state. */
     errorMessage: _angular_core.InputSignal<string>;
+    /** Toggles between amount and percentage modes (unless disabled). */
     toggleMode(): void;
+    /** Parses the user input and updates the bound `value`. */
     onInput(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PriceInputComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PriceInputComponent, "shk-price-input", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "isPercentage": { "alias": "isPercentage"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "showError": { "alias": "showError"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "isPercentage": "isPercentageChange"; }, never, never, true, never>;
 }
 
+/** Which granularity the picker edits: a day, a month or a year. */
 type DatePickerView = 'date' | 'month' | 'year';
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Date/time picker implemented as a ControlValueAccessor. Supports choosing a
+ * day, month or year, optional time selection (with seconds/12-hour format),
+ * min/max constraints and locale-aware labels.
+ */
 declare class DatePickerComponent implements ControlValueAccessor {
     private elementRef;
     private cdr;
     private destroyRef;
     private transloco;
+    /** HTML id for the input (for label/for pairing). */
     id: _angular_core.InputSignal<string>;
+    /** Granularity of the picker ('date' | 'month' | 'year'). */
     view: _angular_core.InputSignal<DatePickerView>;
+    /** Label shown above the input. */
     label: _angular_core.InputSignal<string>;
+    /** Placeholder of the input. */
     placeholder: _angular_core.InputSignal<string>;
+    /** FormGroup used to resolve the control from `label`. */
     formGroup: _angular_core.InputSignal<FormGroup<any> | undefined>;
+    /** Directly bound FormControl. */
     control: _angular_core.InputSignal<FormControl<any> | undefined>;
+    /** Disables the picker. */
     disabled: _angular_core.InputSignal<boolean>;
+    /** Custom error message displayed (overrides translated ones). */
     errorMessage: _angular_core.InputSignal<string>;
+    /** Per-validation-key custom error messages. */
     errorMessages: _angular_core.InputSignal<{
         [key: string]: string;
     }>;
+    /** Minimum allowed date (YYYY-MM-DD) or year/month string. */
     minValue: _angular_core.InputSignal<string>;
+    /** Maximum allowed date (YYYY-MM-DD) or year/month string. */
     maxValue: _angular_core.InputSignal<string>;
+    /** Locale used for month/day names and formatted labels. */
     locale: _angular_core.InputSignal<string>;
+    /** Edits only the time portion of the value. */
+    timeOnly: _angular_core.InputSignal<boolean>;
+    /** Shows the time selectors alongside the date. */
+    showTime: _angular_core.InputSignal<boolean>;
+    /** Hour format: '12' or '24'. */
+    hourFormat: _angular_core.InputSignal<"12" | "24">;
+    /** Whether the seconds selector is shown. */
+    showSeconds: _angular_core.InputSignal<boolean>;
+    /** Step (in minutes) for the minute selector. */
+    minuteStep: _angular_core.InputSignal<number>;
+    /** Whether the dropdown calendar is open. */
     isOpen: _angular_core.WritableSignal<boolean>;
+    /** Year currently displayed in the calendar. */
     viewYear: _angular_core.WritableSignal<number>;
+    /** Month currently displayed in the calendar (0-based). */
     viewMonth: _angular_core.WritableSignal<number>;
+    /** Starting year of the decade shown in year view. */
     viewDecade: _angular_core.WritableSignal<number>;
+    /** Hour selected in the time selectors. */
+    viewHour: _angular_core.WritableSignal<number>;
+    /** Minute selected in the time selectors. */
+    viewMinute: _angular_core.WritableSignal<number>;
+    /** Second selected in the time selectors. */
+    viewSecond: _angular_core.WritableSignal<number>;
+    /** Meridiem selected in 12-hour format. */
+    viewMeridiem: _angular_core.WritableSignal<"AM" | "PM">;
+    /** Date part selected but not yet committed until the time is confirmed. */
+    private pendingDate;
+    /** Underlying value (mirrors the reactive control). */
     private _value;
+    /** Disabled state coming from the reactive form infrastructure. */
     private _disabledState;
+    /** Whether status subscriptions have been attached to the control. */
     private subscribed;
     private valueSubscribed;
+    /** Counter used to recompute the error helpers reactively. */
     private errorTracker;
+    /** Whether an error was displayed at some point. */
     hadError: _angular_core.WritableSignal<boolean>;
+    /** ControlValueAccessor callbacks. */
     private onChange;
     private onTouched;
+    /** Current value of the picker. */
     value: _angular_core.Signal<string | null>;
+    /** Whether the picker is disabled (input or reactive form). */
     isDisabled: _angular_core.Signal<boolean>;
+    /** Resolves the control from `control` input or `formGroup`+`label`. */
     actualControl: _angular_core.Signal<FormControl<any> | undefined>;
+    /** Whether the bound control should show its error message. */
     shouldShowError: _angular_core.Signal<boolean | undefined>;
+    /** Whether an error was fixed (invalid before, now valid and touched). */
     wasFixedError: _angular_core.Signal<boolean | undefined>;
+    /** Validation error messages to display, custom or translated. */
     getErrorMessages: _angular_core.Signal<string[]>;
+    /** Date part displayed in the calendar (pending date or committed value). */
+    displayedDate: _angular_core.Signal<string | null>;
+    /** Human-readable label for the selected value in the input. */
     displayLabel: _angular_core.Signal<string>;
+    /** Localized short month names for the year view. */
     monthNames: _angular_core.Signal<string[]>;
+    /** Localized short weekday names for the calendar header. */
     dayNames: _angular_core.Signal<string[]>;
+    /** Number of days in the currently viewed month. */
     daysInMonth: _angular_core.Signal<number>;
+    /** Weekday index (0=Sunday) of the first day of the viewed month. */
     firstDayOfMonth: _angular_core.Signal<number>;
+    /** Calendar grid: nulls for leading blanks then the days of the month. */
     calendarDays: _angular_core.Signal<(number | null)[]>;
+    /** Whether the prev navigation button is allowed by `minValue`. */
     canGoPrev: _angular_core.Signal<boolean>;
+    /** Whether the next navigation button is allowed by `maxValue`. */
     canGoNext: _angular_core.Signal<boolean>;
+    /** Year of the displayed date, if any. */
     selectedYear: _angular_core.Signal<number | null>;
+    /** Month index (0-based) of the displayed date, if any. */
     selectedMonth: _angular_core.Signal<number | null>;
+    /** Day of the displayed date, if any (date view only). */
     selectedDay: _angular_core.Signal<number | null>;
+    /** 12 years of the viewed decade for the year view. */
     decadeYears: _angular_core.Signal<number[]>;
+    /** (Unused legacy placeholder) plain year list. */
     years: number[];
     constructor();
+    /** Closes the dropdown when clicking outside the component. */
     onDocumentClick(event: MouseEvent): void;
+    /** Closes the dropdown on Escape. */
     onEscape(): void;
+    /** Opens/closes the dropdown, syncing the calendar to the current value. */
     toggle(): void;
+    /** Aligns the calendar view signals with the current value (or today). */
     private syncViewToValue;
+    /** Closes the dropdown, marks the control as touched and refreshes errors. */
     close(): void;
+    /** Navigates the calendar to the previous year/month/decade. */
     prev(): void;
+    /** Navigates the calendar to the next year/month/decade. */
     next(): void;
+    /** Selects a day of the month (pending if time is shown). */
     selectDay(day: number): void;
+    /** Selects a month of the year (pending if time is shown). */
     selectMonth(monthIndex: number): void;
+    /** Selects a year (pending if time is shown). */
     selectYear(year: number): void;
+    /** Commits a value, updates the component, the control and the outputs. */
     private setValue;
+    /** Confirms the selected time and commits the combined date+time value. */
+    confirmTime(): void;
+    /** Reads the hour selected in the time selector. */
+    onHourChange(event: Event): void;
+    /** Reads the minute selected in the time selector. */
+    onMinuteChange(event: Event): void;
+    /** Reads the second selected in the time selector. */
+    onSecondChange(event: Event): void;
+    /** Current meridiem ("AM"/"PM") for the 12-hour format. */
+    meridiem(): 'AM' | 'PM';
+    /** Reads the meridiem selected in the time selector. */
+    onMeridiemChange(event: Event): void;
+    /** Splits the date part from a full ISO "date" or "dateTtime" value. */
+    private datePartOf;
+    /** Formats a raw time string ("HH:mm[:ss]") using the configured format. */
+    private formatTimeFromValue;
+    /** Formats hour/minute/second according to hour format and seconds option. */
+    private formatTime;
+    /** Formats a Date as a YYYY-MM-DD ISO string. */
+    private toISODate;
+    /** Whether the given day matches the currently selected date. */
     isSelectedDay(day: number): boolean;
+    /** Hours available in the time selector ('12' maps to 0..11 or 12..23). */
+    hoursRange(): number[];
+    /** Minutes available in the time selector, stepped by `minuteStep`. */
+    minutesRange(): number[];
+    /** Seconds available in the time selector (0..59). */
+    secondsRange(): number[];
+    /** Formats an hour for display in the selector (12-hour aware). */
+    hourDisplay(hour: number): string;
+    /** Pads a minute value with a leading zero. */
+    minutesLabel(value: number): string;
+    /** Whether the given day is today's date. */
     isToday(day: number): boolean;
+    /** Whether the given month matches the selected month and year. */
     isSelectedMonth(monthIndex: number): boolean;
     isCurrentMonth(monthIndex: number): boolean;
     isSelectedYear(year: number): boolean;
@@ -209,30 +470,60 @@ declare class DatePickerComponent implements ControlValueAccessor {
     registerOnTouched(fn: any): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "shk-date-picker", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "formGroup": { "alias": "formGroup"; "required": false; "isSignal": true; }; "control": { "alias": "control"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "minValue": { "alias": "minValue"; "required": false; "isSignal": true; }; "maxValue": { "alias": "maxValue"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "shk-date-picker", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "formGroup": { "alias": "formGroup"; "required": false; "isSignal": true; }; "control": { "alias": "control"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "minValue": { "alias": "minValue"; "required": false; "isSignal": true; }; "maxValue": { "alias": "maxValue"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "timeOnly": { "alias": "timeOnly"; "required": false; "isSignal": true; }; "showTime": { "alias": "showTime"; "required": false; "isSignal": true; }; "hourFormat": { "alias": "hourFormat"; "required": false; "isSignal": true; }; "showSeconds": { "alias": "showSeconds"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Confirmation dialog opened via `show()` which resolves a Promise<boolean>
+ * with the user's choice.
+ */
 declare class ConfirmDialogComponent implements OnDestroy {
-    protected getIcon: (name: string) => any;
+    protected getIcon: (name: any) => any;
+    /** Title shown in the dialog header. */
     title: _angular_core.InputSignal<string>;
+    /** Message body of the dialog. */
     message: _angular_core.InputSignal<string>;
+    /** Label of the confirm button. */
     confirmLabel: _angular_core.InputSignal<string>;
+    /** Label of the cancel button. */
     cancelLabel: _angular_core.InputSignal<string>;
+    /** Text shown on the confirm button while `loading` is true. */
     loadingText: _angular_core.InputSignal<string>;
-    type: _angular_core.InputSignal<"warning" | "info" | "danger">;
+    /** Visual style: 'danger', 'info' or 'warning'. */
+    type: _angular_core.InputSignal<"info" | "warning" | "danger">;
+    /** Shows a spinner and disables the confirm button. */
     loading: _angular_core.InputSignal<boolean>;
+    /** Whether the cancel button is shown. */
     showCancel: _angular_core.InputSignal<boolean>;
+    /** Controls dialog visibility. */
     visible: _angular_core.WritableSignal<boolean>;
+    /** Resolver of the currently pending confirmation promise. */
     private resolveRef;
+    /** Emitted whenever the dialog is closed (confirm or cancel). */
     closed: _angular_core.OutputEmitterRef<void>;
+    /** Opens the dialog and returns a promise resolving with the user choice. */
     show(): Promise<boolean>;
+    /** Resolves with `true` when the user confirms. */
     onConfirm(): void;
+    /** Resolves with `false` when the user cancels. */
     onCancel(): void;
+    /** Clears the pending resolver on destroy. */
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConfirmDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConfirmDialogComponent, "shk-confirm-dialog", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "confirmLabel": { "alias": "confirmLabel"; "required": false; "isSignal": true; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; "isSignal": true; }; "loadingText": { "alias": "loadingText"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "showCancel": { "alias": "showCancel"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, never, true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Options for opening a confirmation dialog. */
 interface ConfirmConfig {
     title?: string;
     message: string;
@@ -243,172 +534,333 @@ interface ConfirmConfig {
     showCancel?: boolean;
     loading?: boolean;
 }
+/**
+ * Programmatically opens the confirmation dialog and resolves a Promise
+ * with the user's decision (true = confirm, false = cancel).
+ */
 declare class ConfirmDialogService {
+    /** Reference to the currently open dialog, if any. */
     private dialogRef;
     private destroyRef;
     private appRef;
     private injector;
     constructor();
+    /**
+     * Opens a confirmation dialog with the given configuration and returns a
+     * promise resolving with the user's choice.
+     */
     confirm(config: ConfirmConfig): Promise<boolean>;
+    /** Detaches and destroys the mounted dialog if present. */
     private cleanupDialog;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConfirmDialogService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ConfirmDialogService>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Options for opening a modal through the service. */
 interface ModalConfig {
+    /** Title shown in the modal header. */
     title: string;
+    /** Component rendered inside the modal body. */
     component: Type<any>;
+    /** Data passed to the modal component via inputs. */
     data?: Record<string, any>;
+    /** Modal width (CSS value). */
     width?: string;
+    /** Whether the accept/cancel buttons are shown. */
     showButtons?: boolean;
+    /** Whether the expand (fullscreen) button is shown. */
     showExpandButton?: boolean;
+    /** Label of the accept button. */
     acceptLabel?: string;
+    /** Label of the cancel button. */
     cancelLabel?: string;
+    /** Optional callback invoked when the modal closes. */
     onClose?: () => void;
 }
+/**
+ * Global modal manager. Opens modals on a stack, exposing reactive access to
+ * the current modal and the top-most opened config.
+ */
 declare class ModalService {
+    /** Stack of open modals (top-most renders on top). */
     private stackSignal;
+    /** Counter emitted on each close, used to trigger close animations. */
     private closeRequestSignal;
     private router;
     private destroyRef;
     constructor();
+    /** Reactive list of open modals. */
     modalStack: _angular_core.Signal<ModalConfig[]>;
+    /** Top-most modal on the stack, or null. */
     currentModal: _angular_core.Signal<ModalConfig | null>;
+    /** Reactive close-request counter. */
     closeRequest: _angular_core.Signal<number>;
+    /** Opens a new modal on top of the stack. */
     open(config: ModalConfig): void;
+    /** Alias of `close()` used by the accept button. */
     accept(): void;
+    /** Closes the top-most modal, invoking its onClose callback. */
     close(): void;
+    /** Closes all open modals at once. */
     clear(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ModalService>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Modal dialog that renders a dynamically loaded component, tracks its
+ * form validity and submit outputs, and delegates accept/cancel to the
+ * shared ModalService.
+ */
 declare class ModalComponent {
-    protected getIcon: (name: string) => any;
+    protected getIcon: (name: any) => any;
     private notificationSrv;
     private destroyRef;
     private modalSrv;
     private transloco;
     private cdr;
+    /** Reference where the dynamic content is rendered. */
     container: _angular_core.Signal<ViewContainerRef | undefined>;
+    /** Configuration of the modal currently open (from the service). */
     currentConfig: _angular_core.WritableSignal<ModalConfig | null>;
+    /** Modal title. */
     title: _angular_core.WritableSignal<string>;
+    /** Whether the modal is visible. */
     visible: _angular_core.WritableSignal<boolean>;
+    /** Generic loading flag for the footer actions. */
     loading: _angular_core.WritableSignal<boolean>;
+    /** Whether the accept action is being processed. */
     isProcessing: _angular_core.WritableSignal<boolean>;
+    /** Whether the modal is currently expanded to fullscreen. */
     isExpanded: _angular_core.WritableSignal<boolean>;
+    /** True when the dynamic component reports a valid form. */
     isFormValid: _angular_core.WritableSignal<boolean>;
+    /** Reference to the dynamically created component. */
     componentRef: ComponentRef<any> | null;
+    /** Subscriptions to the dynamic component outputs. */
     private subscriptions;
+    /** Width of the modal (fullscreen when expanded). */
     computedModalWidth: _angular_core.Signal<string>;
+    /** Whether the footer buttons should be rendered. */
     modalButtonsVisible: _angular_core.Signal<boolean>;
+    /** Whether the expand/fullscreen button is shown. */
     showExpandButton: _angular_core.Signal<boolean>;
+    /** Resolved cancel button label. */
     cancelLabel: _angular_core.Signal<string>;
+    /** Resolved accept button label. */
     acceptLabel: _angular_core.Signal<string>;
     constructor();
+    /** Updates visibility when the backdrop/close controls change. */
     onVisibleChange(show: boolean): void;
+    /** Creates the dynamic component and wires its form/submit outputs. */
     private loadComponent;
+    /** Subscribes to a dynamic component output if it exists. */
     private subscribeToOutput;
+    /** Finalizes the submit flow, accepting the modal on success. */
     private handleSubmit;
+    /** Closes the modal, calling the dynamic component's `handleCancel` if any. */
     closeModal(): void;
+    /** Performs the actual close sequence and cleanup. */
     doClose(): void;
+    /** Toggles between normal width and fullscreen. */
     toggleExpand(): void;
+    /** Validates the dynamic component form and triggers its `onSubmit`. */
     onAccept(): void;
+    /** Resolves the dynamic component's form (property or getter function). */
     private getForm;
+    /** Recursively checks for real validation errors (ignoring 'warning'). */
     private hasRealErrors;
+    /** Marks a form (and all its descendants) as touched. */
     private markAllAsTouched;
+    /** True when the component exposes both `onSubmit` and a `form`. */
     private isDynamicComponent;
+    /** Unsubscribes outputs and destroys the dynamic component. */
     private cleanup;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "shk-modal", never, {}, {}, never, never, true, never>;
 }
 
+/** Option rendered by the select, optionally prefixed with a "new entry" badge. */
 interface SelectOption {
     label: string;
     value: any;
     custom?: boolean;
 }
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Custom select that works as a ControlValueAccessor: single/multiple
+ * selection, searchable, keyboard navigation, pagination, custom entries and
+ * reactive-form integration.
+ */
 declare class SelectComponent implements ControlValueAccessor {
     private elementRef;
-    protected getIcon: (name: string) => any;
+    /** Resolves icon names to lucide components, falling back to a chevron. */
+    protected getIcon: (name: any) => any;
+    /** Available options. */
     options: _angular_core.InputSignal<SelectOption[]>;
+    /** Enables multi-select mode. */
     multiple: _angular_core.InputSignal<boolean>;
+    /** Restricts multi-selection to the given value combinations. */
     validCombinations: _angular_core.InputSignal<string[][] | undefined>;
+    /** Placeholder shown when there is no selection. */
     placeholder: _angular_core.InputSignal<string>;
+    /** Label used to bind the control inside a `formGroup`. */
     label: _angular_core.InputSignal<string | undefined>;
+    /** Shows a loading state while options are being fetched. */
     isLoading: _angular_core.InputSignal<boolean>;
+    /** Marks that all options have been loaded (used with pagination + search). */
     isAllDataLoaded: _angular_core.InputSignal<boolean>;
+    /** Allows creating new entries from the typed search term. */
     allowCustomEntries: _angular_core.InputSignal<boolean>;
+    /** Parent form group to resolve the control from `label`. */
     formGroup: _angular_core.InputSignal<FormGroup<any> | undefined>;
+    /** Enables the search input inside the dropdown. */
     isSearchable: _angular_core.InputSignal<boolean>;
+    /** Number of options loaded per page when pagination is enabled. */
     itemsPerPage: _angular_core.InputSignal<number>;
+    /** FormControl bound externally (used instead of `formGroup`/`label`). */
     control: _angular_core.InputSignal<FormControl<any> | undefined>;
+    /** Paginates the option list instead of rendering it all at once. */
     usePagination: _angular_core.InputSignal<boolean>;
+    /** Disables the whole select. */
     disabled: _angular_core.InputSignal<boolean>;
+    /** Custom per-validation-error messages shown under the select. */
     errorMessages: _angular_core.InputSignal<{
         [key: string]: string;
     }>;
+    /** Keeps the search term when options reload. */
     preserveSearchOnLoad: _angular_core.InputSignal<boolean>;
+    /** Translation key of the "no records" empty message. */
     emptyMessageKey: _angular_core.InputSignal<string>;
+    /** Opens the dropdown above the trigger instead of below. */
     dropdownUpward: _angular_core.InputSignal<boolean>;
+    /** Shows the "no selection" option in single-select mode. */
     showEmptyOption: _angular_core.InputSignal<boolean>;
+    /** Emits when the selection changes (new value or array in multiple mode). */
     selectionChange: _angular_core.OutputEmitterRef<any>;
+    /** Emits the debounced search term while typing. */
     search: _angular_core.OutputEmitterRef<string>;
+    /** Reference to the filter input inside the dropdown (when searchable). */
     filterInput: _angular_core.Signal<ElementRef<any> | undefined>;
+    /** Reference to the select container element. */
     private selectContainer;
+    /** Reference to the trigger button. */
     private selectTrigger;
+    /** Reference to the dropdown list container. */
     private dropdownContainer;
+    /** Underlying selection value (mirrors the reactive control). */
     private _value;
+    /** Whether the dropdown is open. */
     isOpen: _angular_core.WritableSignal<boolean>;
+    /** Index of the currently focused option for keyboard navigation. */
     focusedIndex: _angular_core.WritableSignal<number>;
+    /** Current search term (searchable mode). */
     searchTerm: _angular_core.WritableSignal<string>;
+    /** Current page of the paginated dropdown. */
     currentPage: _angular_core.WritableSignal<number>;
+    /** Tracks whether the user typed in the search input. */
     private searchTermChanged;
+    /** Internal disabled state from the reactive form (setDisabledState). */
     private _isDisabled;
+    /** Debounce timer handle for the search output. */
     private debounceTimer;
+    /** Error-state counter used to recompute error helpers reactively. */
     private errorTracker;
+    /** Whether an error has been shown at some point (for "fixed" messaging). */
     hadError: _angular_core.WritableSignal<boolean>;
+    /** Whether control status/value subscriptions have been attached. */
     private subscribed;
     private valueSubscribed;
+    /** Current selection value. */
     value: _angular_core.Signal<any>;
+    /** True when the select is disabled via input or by the reactive form. */
     isDisabled: _angular_core.Signal<boolean>;
+    /** Resolves the form control from `control` or from `formGroup`+`label`. */
     actualControl: _angular_core.Signal<FormControl<any> | undefined>;
+    /** Whether the bound control should display its error (invalid + touched/dirty). */
     shouldShowError: _angular_core.Signal<boolean | undefined>;
+    /** Whether an error was shown before and the control is now valid + touched. */
     wasFixedError: _angular_core.Signal<boolean | undefined>;
+    /** Text shown in the trigger: the selected label(s) or the placeholder. */
     displayValue: _angular_core.Signal<any>;
+    /** List of validation error messages for the bound control. */
     getErrorMessages: _angular_core.Signal<string[]>;
+    /** Options filtered by the search term (matches first, then contains). */
     filteredOptions: _angular_core.Signal<SelectOption[]>;
+    /** Options for the current page, with a synthetic custom entry when allowed. */
     paginatedOptions: _angular_core.Signal<SelectOption[]>;
+    /** Non-custom options, including the empty option in single-select mode. */
     regularOptions: _angular_core.Signal<SelectOption[]>;
+    /** Total pages of the filtered option list (1 when pagination is off). */
     totalPages: _angular_core.Signal<number>;
+    /** Whether there is at least one selected value. */
     hasSelectedValues: _angular_core.Signal<any>;
+    /** Whether the custom optional entry should be offered for the current term. */
     showCustomOption: _angular_core.Signal<boolean>;
     private transloco;
+    /** ControlValueAccessor onChange callback. */
     private onChange;
+    /** ControlValueAccessor onTouched callback. */
     private onTouched;
     private destroyRef;
     constructor(elementRef: ElementRef);
+    /** Sets the disabled state coming from the reactive form infrastructure. */
     setDisabledState(isDisabled: boolean): void;
+    /** Marks the control as touched and updates validity and error state. */
     private markAsTouchedAndUpdate;
+    /** Strips accents and lowercases text for accent-insensitive matching. */
     normalizeText(text: string): string;
+    /** Keyboard handler for the trigger element (open/close/navigate/select). */
     onKeydown(event: KeyboardEvent): void;
+    /** Keyboard handler for the search input inside a searchable dropdown. */
     handleKeyDown(event: KeyboardEvent): void;
+    /** Moves the focused option index by `direction`, skipping disabled ones. */
     private moveFocus;
+    /** Index of the currently selected option, or -1. */
     private getSelectedIndex;
+    /** Whether an option is disabled based on the valid combinations rule. */
     isOptionDisabled(option: SelectOption): boolean;
+    /** Whether an option is currently selected. */
     isSelected(option: SelectOption): boolean;
+    /** Goes to the next options page when possible. */
     nextPage(): void;
+    /** Goes to the previous options page when possible. */
     previousPage(): void;
+    /** Closes the dropdown when a click happens outside the component. */
     onClickOutside(event: MouseEvent): void;
+    /** Selects a typed free-text value as a new custom entry. */
     onCustomOptionClick(): void;
+    /** Handles typing in the search input (updates term and emits search). */
     onInputChange(event: Event): void;
+    /** Selects or toggles the clicked option (custom entries included). */
     onOptionClick(option: SelectOption): void;
+    /** Selects a single option and updates the control/outputs. */
     selectOption(option: SelectOption): void;
+    /** Toggles an option in multiple mode, honoring the valid combinations. */
     toggleOption(option: SelectOption): void;
+    /** Opens/closes the dropdown and manages focus/selection state. */
     toggleDropdown(): void;
+    /** trackBy for rendered options so Angular reuses DOM nodes by value. */
     trackByFn(index: number, option: SelectOption): any;
+    /** Writes an external value into the internal signal (ControlValueAccessor). */
     writeValue(value: any): void;
+    /** Stores the onChange callback (ControlValueAccessor). */
     registerOnChange(fn: any): void;
+    /** Stores the onTouched callback (ControlValueAccessor). */
     registerOnTouched(fn: any): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "shk-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "validCombinations": { "alias": "validCombinations"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "isLoading": { "alias": "isLoading"; "required": false; "isSignal": true; }; "isAllDataLoaded": { "alias": "isAllDataLoaded"; "required": false; "isSignal": true; }; "allowCustomEntries": { "alias": "allowCustomEntries"; "required": false; "isSignal": true; }; "formGroup": { "alias": "formGroup"; "required": false; "isSignal": true; }; "isSearchable": { "alias": "isSearchable"; "required": false; "isSignal": true; }; "itemsPerPage": { "alias": "itemsPerPage"; "required": false; "isSignal": true; }; "control": { "alias": "control"; "required": false; "isSignal": true; }; "usePagination": { "alias": "usePagination"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "preserveSearchOnLoad": { "alias": "preserveSearchOnLoad"; "required": false; "isSignal": true; }; "emptyMessageKey": { "alias": "emptyMessageKey"; "required": false; "isSignal": true; }; "dropdownUpward": { "alias": "dropdownUpward"; "required": false; "isSignal": true; }; "showEmptyOption": { "alias": "showEmptyOption"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; "search": "search"; }, never, never, true, never>;
@@ -419,47 +871,95 @@ interface FileUploadError {
     message: string;
     file: File;
 }
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Drag & drop file uploader with file type/size validation, image previews,
+ * multiple files support and localized error messages.
+ */
 declare class FileUploadComponent {
-    protected getIcon: (name: string) => any;
+    protected getIcon: (name: any) => any;
     private transloco;
+    /** Main label of the uploader. */
     label: _angular_core.InputSignal<string>;
+    /** Accepted MIME types/extensions (e.g. 'image/*', '.pdf'). */
     accept: _angular_core.InputSignal<string>;
+    /** Maximum allowed size per file (bytes). */
     maxFileSize: _angular_core.InputSignal<number>;
+    /** Maximum number of files (0 = unlimited). */
     maxFiles: _angular_core.InputSignal<number>;
+    /** Text of the file picker button. */
     fileUploadText: _angular_core.InputSignal<string>;
+    /** Helper text shown next to the label. */
     fileRecommendation: _angular_core.InputSignal<string>;
+    /** Text shown when files are already loaded. */
     changeFilesText: _angular_core.InputSignal<string>;
+    /** Enables selecting more than one file at once. */
     multiple: _angular_core.InputSignal<boolean>;
+    /** Emitted with the currently selected files. */
     fileSelected: _angular_core.OutputEmitterRef<File[]>;
+    /** Emitted when the last selected file is removed. */
     fileRemoved: _angular_core.OutputEmitterRef<void>;
+    /** Emitted when a file fails validation (type/size). */
     fileError: _angular_core.OutputEmitterRef<FileUploadError>;
+    /** Emitted when a file is near the size limit. */
     fileWarning: _angular_core.OutputEmitterRef<FileUploadError>;
+    /** Currently selected files. */
     selectedFiles: _angular_core.WritableSignal<File[]>;
+    /** Localized error message displayed to the user. */
     errorMessage: _angular_core.WritableSignal<string>;
+    /** Whether the user is dragging files over the zone. */
     isDragOver: _angular_core.WritableSignal<boolean>;
+    /** Object URLs used for image previews. */
     private previewUrls;
+    /** Whether another selection is allowed. */
     canAddMore: _angular_core.Signal<boolean>;
+    /** True when the maximum number of files has been reached. */
     maxReached: _angular_core.Signal<boolean>;
+    /** Whether the file is an image (used for previews). */
     isImageFile(file: File): boolean;
+    /** Returns (creating on demand) the object URL for a file preview. */
     previewUrl(file: File): string;
+    /** Marks the drop zone as active while dragging over it. */
     onDragOver(event: DragEvent): void;
+    /** Clears the drag-over state when the drag leaves the zone. */
     onDragLeave(event: DragEvent): void;
+    /** Processes the files dropped on the zone. */
     onDrop(event: DragEvent): void;
+    /** Processes the files picked from the native file input. */
     onFileChange(event: Event): void;
+    /** Validates and appends the received files, emitting errors/warnings. */
     private processFiles;
+    /** Validates a file against `accept` and `maxFileSize`. */
     private validateFile;
+    /** Emits a warning when the file is close to the size limit (>90%). */
     private checkSizeWarning;
+    /** Removes a file, revoking its preview URL. */
     removeFile(file: File): void;
+    /** Clears all selected files and previews. */
     changeFiles(): void;
+    /** Revokes every stored preview object URL. */
     private clearPreviews;
+    /** Human readable size (B/KB/MB). */
     private formatFileSize;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileUploadComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileUploadComponent, "shk-file-upload", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "fileUploadText": { "alias": "fileUploadText"; "required": false; "isSignal": true; }; "fileRecommendation": { "alias": "fileRecommendation"; "required": false; "isSignal": true; }; "changeFilesText": { "alias": "changeFilesText"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; }, { "fileSelected": "fileSelected"; "fileRemoved": "fileRemoved"; "fileError": "fileError"; "fileWarning": "fileWarning"; }, never, never, true, never>;
 }
 
-/** Resolves a lucide icon name to its component. Falls back to a help circle. */
-declare function getIcon$6(name?: string): any;
+/**
+ * Resolves the icon passed to a component into a lucide component.
+ * Accepts a registered string name, an existing lucide component or a LucideIconData object.
+ */
+declare function getIcon(icon?: any, fallback?: any): any;
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 type TagSeverity = 'secondary' | 'success' | 'info' | 'warning' | 'danger' | 'contrast';
 /** Small label used to highlight a value, status or category. */
 declare class TagComponent {
@@ -469,19 +969,18 @@ declare class TagComponent {
     severity: _angular_core.InputSignal<TagSeverity>;
     /** Renders the tag with fully rounded corners (pill). */
     rounded: _angular_core.InputSignal<boolean>;
-    /** Optional leading lucide icon name. */
-    icon: _angular_core.InputSignal<string>;
+    /** Optional leading lucide icon name or component. */
+    icon: _angular_core.InputSignal<any>;
     /** Inline styles applied to the tag. */
     style: _angular_core.InputSignal<Record<string, string | number>>;
     /** Extra CSS classes. */
     styleClass: _angular_core.InputSignal<string>;
-    protected getIcon: typeof getIcon$6;
+    protected getIcon: typeof getIcon;
     protected tagClass: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TagComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TagComponent, "shk-tag", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
-declare function getIcon$5(name: string): any;
 interface Column {
     field: string;
     header: string;
@@ -505,7 +1004,7 @@ interface Column {
 }
 interface TableAction {
     label: string;
-    icon: string;
+    icon: string | any;
     onClick: () => void;
     class?: string;
     isVisible?: () => boolean;
@@ -513,7 +1012,7 @@ interface TableAction {
 }
 interface RowAction {
     label: string | ((data: any) => string);
-    icon: string | ((data: any) => string);
+    icon: string | ((data: any) => any) | any;
     onClick: (rowData: any) => void;
     class?: string | ((data: any) => string);
     isVisible?: (rowData: any) => boolean;
@@ -530,181 +1029,292 @@ interface FilterChangeEvent {
         [key: string]: any;
     };
 }
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Data table with sorting, column filters, global search, pagination,
+ * row/header actions, tag cells and optional server-side mode.
+ */
 declare class TableComponent {
     private fb;
     private cdr;
     private transloco;
     private destroyRef;
-    protected getIcon: typeof getIcon$5;
+    /** Maps icon names to lucide components, falling back to a plus icon. */
+    protected getIcon: (name: any) => any;
     /**
-     * FIX responsive: ancho mínimo que toma cada columna (excepto 'actions',
-     * que ya tiene su propio ancho calculado) SOLO en pantallas angostas
-     * (ver el media query en `styles`). En pantallas anchas esta variable no
-     * se usa: las columnas se estiran normalmente al 100% del contenedor,
-     * igual que antes. Ajustable por columna vía `col.width` si alguna
-     * necesita más o menos espacio en mobile.
+     * Minimum width applied to each column (except `actions`, which keeps its
+     * own computed width) only on narrow screens. On wide screens columns
+     * stretch normally to fill the container width. Can be overridden per
+     * column via `col.width`.
      */
     protected readonly DEFAULT_COLUMN_WIDTH = "140px";
+    /** Returns the effective CSS width for a column ('actions' included). */
     getColumnWidth(col: Column): string;
+    /** Signal with the translated "Actions" header label. */
     private actionsHeaderLabel;
+    /** Signal reacting to language changes so imperative translations are recomputed. */
     private currentLang;
+    /** Reactive signal of loaded translations so pageReport is not stuck with raw keys. */
+    private translations;
+    /** Full dataset. In server-side mode only the current page rows. */
     data: _angular_core.InputSignal<any[]>;
+    /** Column definitions (field, header, filterable, tag cell options, etc.). */
     columns: _angular_core.InputSignal<Column[]>;
+    /** Number of rows displayed per page. */
     rowsPerPage: _angular_core.InputSignal<number>;
+    /** Options shown in the rows-per-page selector. */
     rowsPerPageOptions: _angular_core.InputSignal<number[]>;
+    /** Whether the table is in loading state (shows the overlay/skeleton). */
     loading: _angular_core.InputSignal<boolean>;
+    /** Whether to render the row actions column. */
     showActionRow: _angular_core.InputSignal<boolean>;
+    /** Custom cell/header templates keyed by column field. */
     customTemplates: _angular_core.InputSignal<{
         [key: string]: any;
     }>;
+    /** Actions rendered in the table header. */
     headerActions: _angular_core.InputSignal<TableAction[]>;
+    /** Actions rendered per row (icon, label, class, visibility/disabled). */
     rowActions: _angular_core.InputSignal<RowAction[]>;
+    /** Whether the table container renders a drop shadow. */
     hasShadow: _angular_core.InputSignal<boolean>;
+    /** Field used as the default initial sort. */
     defaultSortField: _angular_core.InputSignal<string>;
+    /** Order used by the default initial sort (1 asc, -1 desc). */
     defaultSortOrder: _angular_core.InputSignal<number>;
+    /** Whether the global search input is shown. */
     showSearch: _angular_core.InputSignal<boolean>;
+    /** Placeholder for the global search input. */
     searchPlaceholder: _angular_core.InputSignal<string>;
+    /** Message shown when there are no rows. */
     emptyMessage: _angular_core.InputSignal<string>;
+    /** Enables server-side pagination/filtering/sorting mode. */
     serverSide: _angular_core.InputSignal<boolean>;
+    /** Total number of records in server-side mode (for pagination math). */
     totalRecords: _angular_core.InputSignal<number>;
+    /** Optional prebuilt filter chips (label + value) shown above the table. */
     filters: _angular_core.InputSignal<{
         label: string;
         value: string;
     }[]>;
+    /** Currently active filter chip value. */
     activeFilter: _angular_core.InputSignal<string>;
+    /** Emits when the user clicks the refresh button. */
     refresh: _angular_core.OutputEmitterRef<void>;
+    /** Emits page changes (server-side mode) with first/rows/page info. */
     pageChange: _angular_core.OutputEmitterRef<PageChangeEvent>;
+    /** Emits the active column filters. */
     filterChange: _angular_core.OutputEmitterRef<FilterChangeEvent>;
+    /** Emits the debounced global search term. */
     searchChange: _angular_core.OutputEmitterRef<string>;
+    /** Emits when a filter chip is clicked. */
     filterClick: _angular_core.OutputEmitterRef<string>;
+    /** Internal copy of the input data used as the base for search/filter. */
     private originalData;
+    /** Rows after the global search is applied. */
     searchedData: _angular_core.WritableSignal<any[]>;
+    /** Rows after column filters are applied. */
     filteredData: _angular_core.WritableSignal<any[]>;
+    /** Rows belonging to the current page (after slicing). */
     displayedData: _angular_core.WritableSignal<any[]>;
+    /** Local total records after filtering (client mode). */
     localTotalRecords: _angular_core.WritableSignal<number>;
+    /** Index of the first row of the current page. */
     first: _angular_core.WritableSignal<number>;
+    /** Visibility map for each column filter input. */
     showFilterInput: _angular_core.WritableSignal<{
         [key: string]: boolean;
     }>;
+    /** Current global search term. */
     searchQuery: _angular_core.WritableSignal<string>;
+    /** Currently sorted field. */
     sortField: _angular_core.WritableSignal<string>;
+    /** Current sort direction (1 asc, -1 desc). */
     sortOrder: _angular_core.WritableSignal<number>;
+    /** Local rows per page, kept in sync with the `rowsPerPage` input. */
     rowsPerPageLocal: _angular_core.WritableSignal<number>;
+    /** Total number of pages based on the effective record count. */
     totalPages: _angular_core.Signal<number>;
+    /** Current page number (1-based). */
     currentPage: _angular_core.Signal<number>;
+    /** Reactive form holding the value of each column filter. */
     columnFiltersForm: FormGroup;
+    /** Subjects used to debounce column filters (server mode) and search. */
     private filterSubject;
     private searchSubject;
+    /**
+     * Signature of the last built set of filterable fields (+filter type) to
+     * avoid rebuilding the form (and losing user input) on reference changes.
+     */
     private lastFilterFieldsSignature;
     private columnFilterSubscriptions;
+    /** Columns array with the leading `actions` column when row actions exist. */
     columnsWithActions: _angular_core.Signal<Column[]>;
+    /** Total records: server-provided in server mode, locally computed otherwise. */
     effectiveTotalRecords: _angular_core.Signal<number>;
+    /**
+     * Rows rendered by the template: the input data in server-side mode or the
+     * locally sliced/page current rows otherwise.
+     */
     effectiveDisplayedData: _angular_core.Signal<any[]>;
+    /**
+     * Reactive "X to Y of Z" report. Depends on loaded translations and the
+     * active language so it always reflects the translated template.
+     */
     pageReport: _angular_core.Signal<string>;
     constructor();
     /**
-     * FIX crítico: antes se reconstruía el FormGroup completo (perdiendo el
-     * texto escrito por el usuario en los filtros y el estado de visibilidad
-     * de cada filtro) cada vez que `columns()` cambiaba de referencia, aunque
-     * el conjunto de campos filtrables fuera idéntico. Ahora comparamos una
-     * "firma" del set de campos+tipo de filtro y solo reconstruimos si
-     * realmente cambió. Además, las suscripciones previas se limpian antes de
-     * crear las nuevas para no acumular fugas de memoria.
+     * Builds (or keeps) the reactive form with one control per filterable
+     * column. The form is only rebuilt when the set of filterable
+     * fields/filter types changes, preserving the values already typed by the
+     * user otherwise. Previous subscriptions are unsubscribed to avoid leaks.
      */
     private setupColumnFilters;
+    /** Collects the non-empty column filter values and emits them. */
     private emitFilterChange;
+    /** Applies the global search over the original data (client mode). */
     private applySearch;
+    /** Entry point that applies search (which cascades into column filters). */
     private applyFilters;
+    /**
+     * Applies every column filter on top of the searched data using each
+     * column's `filterType` ('select', 'exact' or text contains).
+     */
     private applyColumnFilters;
+    /** Slices the filtered rows for the current page. */
     private updateDisplayedData;
+    /** Emits the filter chip clicked in the template. */
     onFilterClick(value: string): void;
+    /** Toggles the sort direction of a column (first click sorts ascending). */
     toggleSort(field: string): void;
     /**
-     * FIX: se documenta explícitamente el criterio de valores null/undefined.
-     * Se mantienen SIEMPRE al final de la lista, sin importar la dirección del
-     * orden (comportamiento común e intencional en tablas de datos). Si en tu
-     * caso de uso prefieres que "sigan" la dirección del sort, multiplica
-     * ambos returns por `order`.
+     * Sorts the filtered rows by the current field. Rows with null/undefined
+     * values are always kept at the end regardless of sort direction.
      */
     private applySort;
+    /** Handles the global search input (updates query, resets page, debounces server mode). */
     onSearchInput(value: string): void;
+    /** Clears a column filter value and hides its input. */
     clearFilter(field: string): void;
+    /** Toggles the visibility of a column filter input. */
     toggleFilter(field: string): void;
     /**
-     * FIX #5 (falsy zero): antes el template usaba `columnFiltersForm.get(field)?.value`
-     * directamente en un `@if`/`[class]`, lo cual falla cuando el valor es `0`
-     * (número), ya que `0` es falsy en JS. Este helper compara explícitamente
-     * contra null/undefined/''.
+     * Whether a column filter is non-empty. Avoids treating the number 0 as
+     * "no value".
      */
     hasFilterValue(field: string): boolean;
+    /** Returns the reactive page report string (template helper). */
     getPageReport(): string;
+    /** Goes to the first page (emits pageChange in server-side mode). */
     goToFirst(): void;
+    /** Goes to the last page (emits pageChange in server-side mode). */
     goToLast(): void;
+    /** Updates rows-per-page and resets to the first page. */
     onRowsPerPageChange(rows: number): void;
+    /** Emits the refresh output. */
     refreshData(): void;
+    /** Whether the current page is the first one. */
     isFirstPage(): boolean;
+    /** Whether the current page is the last one. */
     isLastPage(): boolean;
+    /** Moves to the next page (emits pageChange in server-side mode). */
     next(): void;
+    /** Moves to the previous page (emits pageChange in server mode). */
     prev(): void;
+    /** Resets the table to the first page. */
     reset(): void;
+    /** Resolves the row action label, static or per-row function. */
     getRowActionLabel(action: RowAction, rowData: any): string;
-    getRowActionIconName(action: RowAction, rowData: any): string;
+    /**
+     * Resolves the row action icon: a lucide component, a function returning
+     * the icon name, or a raw string resolved by the central icon map.
+     */
+    getRowActionIconName(action: RowAction, rowData: any): any;
+    /** Resolves the CSS class of a row action, static or per-row function. */
     getRowActionClass(action: RowAction, rowData: any): string;
+    /** Whether a header action is disabled. */
     isHeaderActionDisabled(action: TableAction): boolean;
+    /** Whether a header action is visible. */
     isHeaderActionVisible(action: TableAction): boolean;
+    /** Whether a row action is disabled for the given row. */
     isRowActionDisabled(action: RowAction, rowData: any): boolean;
+    /** Whether a row action is visible for the given row. */
     isRowActionVisible(action: RowAction, rowData: any): boolean;
+    /** Truncates a value with an ellipsis past the given character limit. */
     truncate(value: any, limit?: number): string;
+    /** Resolves the value displayed inside a tag cell, static or per-row function. */
     getTagValue(col: Column, rowData: any): string;
+    /** Resolves and validates the tag severity, falling back to 'secondary'. */
     getTagSeverity(col: Column, rowData: any): TagSeverity;
+    /** Resolves whether the tag in a cell is rounded, static or per-row function. */
     getTagRounded(col: Column, rowData: any): boolean;
+    /** Resolves the icon shown inside a tag cell, static or per-row function. */
     getTagIcon(col: Column, rowData: any): string;
+    /** Resolves the CSS styles of a tag cell, static or per-row function. */
     getTagStyle(col: Column, rowData: any): Record<string, string | number>;
     /**
-     * FIX #7 (medio): trackBy real por identidad de fila en vez de `$index`.
-     * Si tu dato no tiene `id`/`_id`, cae de vuelta al índice (comportamiento
-     * anterior), pero se recomienda pasar filas con un identificador único.
+     * trackBy for row identity: prefers `id`/`_id` and falls back to the index.
      */
     trackByRow(row: any, index: number): any;
-    /** FIX accesibilidad: soporte de teclado (Enter/Espacio) para ordenar columnas. */
+    /** Keyboard support (Enter/Space) for sorting a column header. */
     onHeaderKeydown(event: KeyboardEvent, col: Column): void;
-    /** FIX accesibilidad: valor aria-sort para el <th> correspondiente. */
+    /** Accessible aria-sort value for a given column header. */
     getAriaSort(col: Column): 'ascending' | 'descending' | 'none';
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent, "shk-table", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "rowsPerPage": { "alias": "rowsPerPage"; "required": false; "isSignal": true; }; "rowsPerPageOptions": { "alias": "rowsPerPageOptions"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "showActionRow": { "alias": "showActionRow"; "required": false; "isSignal": true; }; "customTemplates": { "alias": "customTemplates"; "required": false; "isSignal": true; }; "headerActions": { "alias": "headerActions"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "hasShadow": { "alias": "hasShadow"; "required": false; "isSignal": true; }; "defaultSortField": { "alias": "defaultSortField"; "required": false; "isSignal": true; }; "defaultSortOrder": { "alias": "defaultSortOrder"; "required": false; "isSignal": true; }; "showSearch": { "alias": "showSearch"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "serverSide": { "alias": "serverSide"; "required": false; "isSignal": true; }; "totalRecords": { "alias": "totalRecords"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "activeFilter": { "alias": "activeFilter"; "required": false; "isSignal": true; }; }, { "refresh": "refresh"; "pageChange": "pageChange"; "filterChange": "filterChange"; "searchChange": "searchChange"; "filterClick": "filterClick"; }, never, never, true, never>;
 }
 
 /**
- * Tooltip que se renderiza en `document.body` con `position: fixed`, de modo
- * que siempre flota por encima de cualquier contenedor (tablas con
- * `overflow: hidden`, modales, scroll wrappers, etc.) y nunca queda
- * recortado ni pasa por debajo de su elemento ancla.
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Tooltip rendered in `document.body` with `position: fixed`, so it always
+ * floats above any container (tables with `overflow: hidden`, modals, scroll
+ * wrappers, etc.) and never gets clipped or hidden behind its anchor element.
  */
 declare class TooltipComponent implements OnDestroy {
+    /** Content of the tooltip. */
     readonly text: _angular_core.InputSignal<string>;
+    /** Preferred placement relative to the trigger. */
     readonly position: _angular_core.InputSignal<"top" | "bottom" | "right">;
+    /** 'hover' shows on mouse enter; 'fixed' stays pinned to the content. */
     readonly mode: _angular_core.InputSignal<"fixed" | "hover">;
+    /** Distance (px) between the tooltip and the trigger. */
     readonly offset: _angular_core.InputSignal<number>;
     private readonly host;
     private readonly document;
+    /** The dynamically created tooltip element. */
     private tooltipEl;
+    /** Unsubscribe callbacks for the scroll/resize listeners. */
     private cleanup;
+    /** Shows the tooltip over the host trigger on mouseenter. */
     onMouseEnter(): void;
+    /** Hides the tooltip on mouseleave. */
     onMouseLeave(): void;
+    /** Creates and positions the tooltip element on `document.body`. */
     private show;
+    /** Computes the tooltip position, clamped to the viewport. */
     private computePosition;
+    /** Fades the tooltip out and removes it from the DOM. */
     private hide;
+    /** Removes the tooltip and its listeners. */
     private removeTooltip;
+    /** Cleans up the tooltip on component destroy. */
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TooltipComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TooltipComponent, "shk-tooltip", never, { "text": { "alias": "text"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "offset": { "alias": "offset"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
-declare function getIcon$4(name?: string): any;
 interface SidebarItem {
     id: string;
     label: string;
-    icon?: string;
+    icon?: string | any;
     route?: string;
     children?: SidebarItem[];
     roles?: string[];
@@ -717,54 +1327,96 @@ interface SidebarGroup {
     label?: string;
     items: SidebarItem[];
 }
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Collapsible vertical navigation sidebar with groups, icons, badges,
+ * role-based filtering, responsive mobile drawer and tooltips.
+ */
 declare class SidebarComponent {
     private platformId;
+    /** Flat list of navigation items (used when no groups are provided). */
     items: _angular_core.InputSignal<SidebarItem[]>;
+    /** Grouped navigation items; takes precedence over `items`. */
     groups: _angular_core.InputSignal<SidebarGroup[]>;
+    /** Brand title shown at the top of the sidebar. */
     title: _angular_core.InputSignal<string>;
+    /** Subtitle under the title. */
     subtitle: _angular_core.InputSignal<string>;
+    /** Brand logo image/url shown at the top. */
     logo: _angular_core.InputSignal<string>;
+    /** id of the item currently highlighted as active. */
     activeItemId: _angular_core.InputSignal<string>;
+    /** Role used to filter items that declare `roles`. */
     userRole: _angular_core.InputSignal<string>;
+    /** Whether the sidebar can collapse into a rail. */
     collapsible: _angular_core.InputSignal<boolean>;
+    /** Shows the expand/collapse toggle button. */
     showToggle: _angular_core.InputSignal<boolean>;
+    /** Enables the mobile drawer behaviour below lg breakpoint. */
     responsive: _angular_core.InputSignal<boolean>;
+    /** Keeps the sidebar fixed while the page scrolls. */
     fixed: _angular_core.InputSignal<boolean>;
+    /** Adds a drop shadow to the sidebar. */
     hasShadow: _angular_core.InputSignal<boolean>;
+    /** Width in expanded state. */
     expandedWidth: _angular_core.InputSignal<string>;
+    /** Width when collapsed. */
     collapsedWidth: _angular_core.InputSignal<string>;
+    /** Group ids opened by default on load. */
     defaultExpanded: _angular_core.InputSignal<string[]>;
+    /** Optional transform applied to item labels (e.g. i18n). */
     labelPipe: _angular_core.InputSignal<(label: string) => string>;
+    /** Tooltip for the expand action. */
     expandTooltip: _angular_core.InputSignal<string>;
+    /** Tooltip for the collapse action. */
     collapseTooltip: _angular_core.InputSignal<string>;
+    /** Collapsed state, bindable with [(collapsed)]. */
     collapsed: _angular_core.ModelSignal<boolean>;
+    /** Mobile drawer open state, bindable with [(mobileOpen)]. */
     mobileOpen: _angular_core.ModelSignal<boolean>;
+    /** Emitted when a navigation item is clicked. */
     itemClick: _angular_core.OutputEmitterRef<SidebarItem>;
+    /** Emitted with the new collapsed state after toggling. */
     toggle: _angular_core.OutputEmitterRef<boolean>;
-    protected getIcon: typeof getIcon$4;
+    protected getIcon: (name: any) => any;
+    /** Currently selected item id. */
     protected selectedId: _angular_core.WritableSignal<string>;
+    /** Set of group ids currently expanded. */
     protected expandedGroups: _angular_core.WritableSignal<Set<string>>;
     private isBrowser;
-    constructor(platformId: Object);
+    constructor();
+    /** Current sidebar width depending on the collapsed state. */
     protected width: _angular_core.Signal<string>;
+    /** Navigation items after group flattening and role filtering. */
     protected navItems: _angular_core.Signal<SidebarItem[]>;
+    /** Closes the mobile drawer when the window grows below lg. */
     onResize(_event: Event): void;
+    /** Applies the `labelPipe` transform to an item label. */
     protected label(item: SidebarItem): string;
+    /** Whether the item matches the selected id. */
     protected isItemActive(item: SidebarItem): boolean;
+    /** Whether one of the item's children is currently active. */
     protected isGroupActive(item: SidebarItem): boolean;
+    /** Whether a group is expanded. */
     protected isGroupExpanded(item: SidebarItem): boolean;
+    /** Toggles the expanded state of a group. */
     protected toggleGroup(item: SidebarItem): void;
+    /** Selects an item, emits `itemClick` and closes the mobile drawer when needed. */
     protected onItemClick(item: SidebarItem): void;
+    /** Toggles collapse (desktop) or the mobile drawer (below lg). */
     protected onToggle(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidebarComponent, "shk-sidebar", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "logo": { "alias": "logo"; "required": false; "isSignal": true; }; "activeItemId": { "alias": "activeItemId"; "required": false; "isSignal": true; }; "userRole": { "alias": "userRole"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "showToggle": { "alias": "showToggle"; "required": false; "isSignal": true; }; "responsive": { "alias": "responsive"; "required": false; "isSignal": true; }; "fixed": { "alias": "fixed"; "required": false; "isSignal": true; }; "hasShadow": { "alias": "hasShadow"; "required": false; "isSignal": true; }; "expandedWidth": { "alias": "expandedWidth"; "required": false; "isSignal": true; }; "collapsedWidth": { "alias": "collapsedWidth"; "required": false; "isSignal": true; }; "defaultExpanded": { "alias": "defaultExpanded"; "required": false; "isSignal": true; }; "labelPipe": { "alias": "labelPipe"; "required": false; "isSignal": true; }; "expandTooltip": { "alias": "expandTooltip"; "required": false; "isSignal": true; }; "collapseTooltip": { "alias": "collapseTooltip"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "mobileOpen": { "alias": "mobileOpen"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; "mobileOpen": "mobileOpenChange"; "itemClick": "itemClick"; "toggle": "toggle"; }, never, ["[sidebarHeader]", "[sidebarContent]", "[sidebarFooter]"], true, never>;
 }
 
-declare function getIcon$3(name?: string): any;
 interface RailSidebarItem {
     id: string;
     label: string;
-    icon?: string;
+    icon?: string | any;
     routerLink?: string;
     children?: RailSidebarItem[];
     roles?: string[];
@@ -775,7 +1427,7 @@ interface RailSidebarItem {
 interface RailSidebarSection {
     key: string;
     label: string;
-    icon?: string;
+    icon?: string | any;
     routerLink?: string;
     matchPrefixes?: string[];
     items?: RailSidebarItem[];
@@ -784,85 +1436,169 @@ interface RailSidebarSectionEvent {
     key: string;
     routerLink?: string;
 }
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Narrow "rail" sidebar that expands into sections. Supports sections, roles,
+ * language switching, collapse/expand and responsive tooltips.
+ */
 declare class RailSidebarComponent {
+    /** Sections presented as expandable areas of the rail. */
     sections: _angular_core.InputSignal<RailSidebarSection[]>;
+    /** Current location url used to detect the active section/item. */
     activeUrl: _angular_core.InputSignal<string>;
+    /** Key of the active section, bindable with [(activeSectionKey)]. */
     activeSectionKey: _angular_core.ModelSignal<string>;
+    /** Collapsed (rail only) state, bindable with [(collapsed)]. */
     collapsed: _angular_core.ModelSignal<boolean>;
+    /** Active language code. */
     activeLang: _angular_core.InputSignal<string>;
+    /** Languages available in the language switcher. */
     langs: _angular_core.InputSignal<string[]>;
+    /** Brand logo image/url. */
     logo: _angular_core.InputSignal<string>;
+    /** Application name shown when expanded. */
     appName: _angular_core.InputSignal<string>;
+    /** Role used to filter items that declare `roles`. */
     userRole: _angular_core.InputSignal<string>;
+    /** Optional transform applied to item labels (e.g. i18n). */
     labelPipe: _angular_core.InputSignal<(label: string) => string>;
+    /** Width of the collapsed rail. */
     railWidth: _angular_core.InputSignal<string>;
+    /** Width when a section is expanded. */
     expandedWidth: _angular_core.InputSignal<string>;
+    /** Tooltip for the workspace/home action. */
     workspaceTooltip: _angular_core.InputSignal<string>;
+    /** Tooltip for the logout action. */
     logoutTooltip: _angular_core.InputSignal<string>;
+    /** Tooltip for collapsing the sidebar. */
     collapseTooltip: _angular_core.InputSignal<string>;
+    /** Tooltip for expanding the sidebar. */
     expandTooltip: _angular_core.InputSignal<string>;
+    /** Emitted when a section is selected, with its key and optional route. */
     sectionSelected: _angular_core.OutputEmitterRef<RailSidebarSectionEvent>;
+    /** Emitted when a navigation item is clicked. */
     itemClick: _angular_core.OutputEmitterRef<RailSidebarItem>;
+    /** Emitted with the next language code when the user switches language. */
     setLang: _angular_core.OutputEmitterRef<string>;
+    /** Emitted when the user requests to log out. */
     logoutRequested: _angular_core.OutputEmitterRef<void>;
+    /** Emitted with the new collapsed state after toggling. */
     toggleSidebar: _angular_core.OutputEmitterRef<boolean>;
+    /** Emitted when the workspace/home entry is clicked. */
     workspaceClick: _angular_core.OutputEmitterRef<void>;
-    protected getIcon: typeof getIcon$3;
+    protected getIcon: (name: any) => any;
+    /** Set of group ids currently expanded. */
     protected expandedGroups: _angular_core.WritableSignal<Set<string>>;
     constructor();
+    /** Current sidebar width depending on the collapsed state. */
     protected width: _angular_core.Signal<string>;
+    /** The section currently selected. */
     protected activeSection: _angular_core.Signal<RailSidebarSection | null>;
+    /** Items of the active section, filtered by role. */
     protected navItems: _angular_core.Signal<RailSidebarItem[]>;
+    /** Applies the `labelPipe` transform to a label. */
     protected label(label: string): string;
+    /** Whether the section matches the active key. */
     protected isSectionActive(section: RailSidebarSection): boolean;
+    /** Whether the item is the best route match for the active url. */
     protected isItemActive(item: RailSidebarItem): boolean;
+    /** Whether one of the item's children matches the active url. */
     protected isGroupActive(item: RailSidebarItem): boolean;
+    /** Exact or prefix match between a router link and the active url. */
     private matchesUrl;
+    /** Longest (most specific) item whose route matches the active url. */
     private bestMatchItem;
+    /** Whether a group is expanded. */
     protected isGroupExpanded(item: RailSidebarItem): boolean;
+    /** Toggles the expanded state of a group. */
     protected toggleGroup(item: RailSidebarItem): void;
+    /** Selects a section, emits `sectionSelected` and expands the rail when collapsed. */
     protected onSectionClick(section: RailSidebarSection): void;
+    /** Emits `itemClick` for a navigation item (skipping disabled items). */
     protected onItemClick(item: RailSidebarItem): void;
+    /** Emits `workspaceClick` and expands the sidebar if it was collapsed. */
     protected onWorkspace(): void;
+    /** Cycles to the next language and emits `setLang`. */
     protected onToggleLang(): void;
+    /** Toggles collapse and emits `toggleSidebar`. */
     protected onToggleSidebar(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RailSidebarComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<RailSidebarComponent, "shk-rail-sidebar", never, { "sections": { "alias": "sections"; "required": false; "isSignal": true; }; "activeUrl": { "alias": "activeUrl"; "required": false; "isSignal": true; }; "activeSectionKey": { "alias": "activeSectionKey"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "activeLang": { "alias": "activeLang"; "required": false; "isSignal": true; }; "langs": { "alias": "langs"; "required": false; "isSignal": true; }; "logo": { "alias": "logo"; "required": false; "isSignal": true; }; "appName": { "alias": "appName"; "required": false; "isSignal": true; }; "userRole": { "alias": "userRole"; "required": false; "isSignal": true; }; "labelPipe": { "alias": "labelPipe"; "required": false; "isSignal": true; }; "railWidth": { "alias": "railWidth"; "required": false; "isSignal": true; }; "expandedWidth": { "alias": "expandedWidth"; "required": false; "isSignal": true; }; "workspaceTooltip": { "alias": "workspaceTooltip"; "required": false; "isSignal": true; }; "logoutTooltip": { "alias": "logoutTooltip"; "required": false; "isSignal": true; }; "collapseTooltip": { "alias": "collapseTooltip"; "required": false; "isSignal": true; }; "expandTooltip": { "alias": "expandTooltip"; "required": false; "isSignal": true; }; }, { "activeSectionKey": "activeSectionKeyChange"; "collapsed": "collapsedChange"; "sectionSelected": "sectionSelected"; "itemClick": "itemClick"; "setLang": "setLang"; "logoutRequested": "logoutRequested"; "toggleSidebar": "toggleSidebar"; "workspaceClick": "workspaceClick"; }, never, never, true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Chart.js wrapper that renders line, bar, pie, doughnut or polarArea charts
+ * and updates them reactively as the inputs change.
+ */
 declare class ChartComponent implements AfterViewInit, OnDestroy {
+    /** Guarantees Chart.js plugins are only registered once. */
     private static registered;
+    /** Type of chart to render. */
     type: _angular_core.InputSignal<"line" | "bar" | "pie" | "doughnut" | "polarArea">;
+    /** Chart.js datasets payload. */
     data: _angular_core.InputSignal<any>;
+    /** Chart.js options object. */
     options: _angular_core.InputSignal<any>;
+    /** Reference to the inner canvas element. */
     private canvasRef;
+    /** Live Chart.js instance. */
     private chartInstance;
+    /** Whether the view has been initialized yet. */
     private initialized;
     constructor();
+    /** Creates the initial chart once the canvas is available. */
     ngAfterViewInit(): void;
+    /** Destroys the Chart.js instance. */
     ngOnDestroy(): void;
+    /** Clears the canvas by reassigning its width. */
     private resetCanvas;
+    /** Creates a new Chart.js instance on the canvas. */
     private initChart;
+    /** Deep clones a value to detach it from Angular's reactive objects. */
     private deepClone;
+    /** Applies the new data/options, rebuilding the chart when the type changes. */
     private updateChart;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "shk-chart", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Default dataset colors used by the ChartComponent when no palette is provided. */
 declare const COLOR_PALETTE: {
     bg: string;
     border: string;
 }[];
+/**
+ * Reads the current `--shk-*` CSS variables from the document and returns
+ * the text, muted and border colors used by charts to follow the active theme.
+ */
 declare function readThemeColors(): {
     text: string;
     muted: string;
     border: string;
 };
 
-declare function getIcon$2(name: string): any;
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** A chip shown under a sub item (time, pricing model, quantity, etc). */
 interface TimelineMeta {
-    icon: string;
+    icon: string | any;
     label?: string;
     value: string;
 }
@@ -873,8 +1609,8 @@ interface TimelineSubItem {
     subtitle?: string;
     /** Used to look up icon / color in `iconMap` and `iconColors`. */
     type?: string;
-    /** Overrides the resolved icon name. */
-    icon?: string;
+    /** Overrides the resolved icon (name or component). */
+    icon?: string | any;
     /** Hex background for the icon box (fallback). */
     color?: string;
     /** Hex text color for the icon (fallback). */
@@ -896,7 +1632,7 @@ interface TimelineItem {
     description?: string;
     /** Small pill shown above the title (e.g. "Día 1"). */
     badge?: string | number;
-    badgeIcon?: string;
+    badgeIcon?: string | any;
     /** CSS classes for the marker (falls back to the cycled gradient palette). */
     color?: string;
     subItems?: TimelineSubItem[];
@@ -904,7 +1640,7 @@ interface TimelineItem {
 /** A button rendered in the header. */
 interface TimelineAction {
     label: string;
-    icon: string;
+    icon: string | any;
     onClick: () => void;
     class?: string;
     isVisible?: () => boolean;
@@ -913,7 +1649,7 @@ interface TimelineAction {
 /** An action rendered in the item card footer. */
 interface TimelineItemAction {
     label: string | ((item: TimelineItem) => string);
-    icon: string | ((item: TimelineItem) => string);
+    icon: string | any | ((item: TimelineItem) => string | any);
     onClick: (item: TimelineItem) => void;
     class?: string | ((item: TimelineItem) => string);
     isVisible?: (item: TimelineItem) => boolean;
@@ -922,7 +1658,7 @@ interface TimelineItemAction {
 /** An action rendered on hover over a sub item. */
 interface TimelineSubItemAction {
     label: string | ((item: TimelineItem, subItem: TimelineSubItem) => string);
-    icon: string | ((item: TimelineItem, subItem: TimelineSubItem) => string);
+    icon: string | any | ((item: TimelineItem, subItem: TimelineSubItem) => string | any);
     onClick: (item: TimelineItem, subItem: TimelineSubItem) => void;
     isVisible?: (item: TimelineItem, subItem: TimelineSubItem) => boolean;
     isDisabled?: (item: TimelineItem, subItem: TimelineSubItem) => boolean;
@@ -935,10 +1671,10 @@ declare const DEFAULT_SUPPLIER_ICON_COLORS: Record<string, {
     bg: string;
     text: string;
 }>;
-/** Maps a sub-item `type` to a lucide icon name. */
-declare const DEFAULT_SUPPLIER_TYPE_ICONS: Record<string, string>;
+/** Maps a sub-item `type` to a lucide icon component. */
+declare const DEFAULT_SUPPLIER_TYPE_ICONS: Record<string, any>;
 declare class TimelineComponent {
-    protected getIcon: typeof getIcon$2;
+    protected getIcon: (name: any) => any;
     /** Timeline data. */
     items: _angular_core.InputSignal<TimelineItem[]>;
     /** 'left' = line and markers on the left; 'alternate' = cards alternate around a centered line on lg+. */
@@ -974,9 +1710,9 @@ declare class TimelineComponent {
     addSubItemTooltip: _angular_core.InputSignal<string>;
     itemActions: _angular_core.InputSignal<TimelineItemAction[]>;
     subItemActions: _angular_core.InputSignal<TimelineSubItemAction[]>;
-    /** Maps a sub-item `type` to a lucide icon name. */
+    /** Maps a sub-item `type` to a lucide icon (name or component). */
     iconMap: _angular_core.InputSignal<{
-        [type: string]: string;
+        [type: string]: any;
     }>;
     /** Maps a sub-item `type` to its icon-box colors. */
     iconColors: _angular_core.InputSignal<{
@@ -986,10 +1722,10 @@ declare class TimelineComponent {
         };
     }>;
     /** Icon used when nothing matches. */
-    fallbackIcon: _angular_core.InputSignal<string>;
+    fallbackIcon: _angular_core.InputSignal<any>;
     showEmptyState: _angular_core.InputSignal<boolean>;
     emptyMessage: _angular_core.InputSignal<string>;
-    emptyIcon: _angular_core.InputSignal<string>;
+    emptyIcon: _angular_core.InputSignal<any>;
     editTooltip: _angular_core.InputSignal<string>;
     deleteTooltip: _angular_core.InputSignal<string>;
     optionalLabel: _angular_core.InputSignal<string>;
@@ -1017,30 +1753,38 @@ declare class TimelineComponent {
     isHeaderActionVisible(action: TimelineAction): boolean;
     isHeaderActionDisabled(action: TimelineAction): boolean;
     getItemActionLabel(action: TimelineItemAction, item: TimelineItem): string;
-    getItemActionIconName(action: TimelineItemAction, item: TimelineItem): string;
+    getItemActionIconName(action: TimelineItemAction, item: TimelineItem): any;
     getItemActionClass(action: TimelineItemAction, item: TimelineItem): string;
     isItemActionVisible(action: TimelineItemAction, item: TimelineItem): boolean;
     isItemActionDisabled(action: TimelineItemAction, item: TimelineItem): boolean;
     getSubItemActionLabel(action: TimelineSubItemAction, item: TimelineItem, sub: TimelineSubItem): string;
-    getSubItemActionIconName(action: TimelineSubItemAction, item: TimelineItem, sub: TimelineSubItem): string;
+    getSubItemActionIconName(action: TimelineSubItemAction, item: TimelineItem, sub: TimelineSubItem): any;
     isSubItemActionVisible(action: TimelineSubItemAction, item: TimelineItem, sub: TimelineSubItem): boolean;
     isSubItemActionDisabled(action: TimelineSubItemAction, item: TimelineItem, sub: TimelineSubItem): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimelineComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimelineComponent, "shk-timeline", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "alignment": { "alias": "alignment"; "required": false; "isSignal": true; }; "showLine": { "alias": "showLine"; "required": false; "isSignal": true; }; "markerSize": { "alias": "markerSize"; "required": false; "isSignal": true; }; "markerGradients": { "alias": "markerGradients"; "required": false; "isSignal": true; }; "showOpposite": { "alias": "showOpposite"; "required": false; "isSignal": true; }; "showDescription": { "alias": "showDescription"; "required": false; "isSignal": true; }; "showSubItemMeta": { "alias": "showSubItemMeta"; "required": false; "isSignal": true; }; "showSubItemPrice": { "alias": "showSubItemPrice"; "required": false; "isSignal": true; }; "showSubItemCount": { "alias": "showSubItemCount"; "required": false; "isSignal": true; }; "subItemCountLabel": { "alias": "subItemCountLabel"; "required": false; "isSignal": true; }; "showHeader": { "alias": "showHeader"; "required": false; "isSignal": true; }; "headerTitle": { "alias": "headerTitle"; "required": false; "isSignal": true; }; "showAddItem": { "alias": "showAddItem"; "required": false; "isSignal": true; }; "addItemLabel": { "alias": "addItemLabel"; "required": false; "isSignal": true; }; "addItemIcon": { "alias": "addItemIcon"; "required": false; "isSignal": true; }; "addItemTooltip": { "alias": "addItemTooltip"; "required": false; "isSignal": true; }; "headerActions": { "alias": "headerActions"; "required": false; "isSignal": true; }; "showAddSubItem": { "alias": "showAddSubItem"; "required": false; "isSignal": true; }; "addSubItemLabel": { "alias": "addSubItemLabel"; "required": false; "isSignal": true; }; "addSubItemTooltip": { "alias": "addSubItemTooltip"; "required": false; "isSignal": true; }; "itemActions": { "alias": "itemActions"; "required": false; "isSignal": true; }; "subItemActions": { "alias": "subItemActions"; "required": false; "isSignal": true; }; "iconMap": { "alias": "iconMap"; "required": false; "isSignal": true; }; "iconColors": { "alias": "iconColors"; "required": false; "isSignal": true; }; "fallbackIcon": { "alias": "fallbackIcon"; "required": false; "isSignal": true; }; "showEmptyState": { "alias": "showEmptyState"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "emptyIcon": { "alias": "emptyIcon"; "required": false; "isSignal": true; }; "editTooltip": { "alias": "editTooltip"; "required": false; "isSignal": true; }; "deleteTooltip": { "alias": "deleteTooltip"; "required": false; "isSignal": true; }; "optionalLabel": { "alias": "optionalLabel"; "required": false; "isSignal": true; }; "noSubItemsMessage": { "alias": "noSubItemsMessage"; "required": false; "isSignal": true; }; "customTemplates": { "alias": "customTemplates"; "required": false; "isSignal": true; }; }, { "addItem": "addItem"; "addSubItem": "addSubItem"; "itemClick": "itemClick"; "subItemClick": "subItemClick"; }, never, never, true, never>;
 }
 
-declare function getIcon$1(name: string): any;
 /** An action button rendered on the right side of the fieldset header. */
 interface FieldsetHeaderAction {
     label: string;
-    icon: string;
+    icon: string | any;
     onClick: () => void;
     class?: string;
     isVisible?: () => boolean;
     isDisabled?: () => boolean;
 }
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Collapsible content group with a legend header, optional leading icon,
+ * badge and action buttons on the right side.
+ */
 declare class FieldsetComponent {
-    protected getIcon: typeof getIcon$1;
+    protected getIcon: (name: any) => any;
     /** Title shown in the header. */
     legend: _angular_core.InputSignal<string>;
     /** Collapsed state (default: collapsed). Two-way bindable with [(collapsed)]. */
@@ -1050,7 +1794,7 @@ declare class FieldsetComponent {
     /** Shows the expand/collapse icon button. */
     showToggleIcon: _angular_core.InputSignal<boolean>;
     /** Optional leading icon shown next to the legend. */
-    icon: _angular_core.InputSignal<string>;
+    icon: _angular_core.InputSignal<any>;
     /** Optional badge/count shown after the legend. */
     badge: _angular_core.InputSignal<string | number>;
     /** CSS classes for the badge (override). */
@@ -1065,22 +1809,30 @@ declare class FieldsetComponent {
     customTemplates: _angular_core.InputSignal<{
         [key: string]: any;
     }>;
+    /** CSS classes for the extra shadow styling of the panel. */
     hasShadow: _angular_core.InputSignal<boolean>;
+    /** Accessible label for the expand action. */
     expandLabel: _angular_core.InputSignal<string>;
+    /** Accessible label for the collapse action. */
     collapseLabel: _angular_core.InputSignal<string>;
     /** Emits the new expanded state when toggled. */
     toggle: _angular_core.OutputEmitterRef<boolean>;
+    /** Emitted when the fieldset is expanded. */
     expand: _angular_core.OutputEmitterRef<void>;
+    /** Emitted when the fieldset is collapsed. */
     collapse: _angular_core.OutputEmitterRef<void>;
+    /** Stable id linking the header button and the content region. */
     contentId: string;
+    /** Toggles the collapsed state and emits the new state (unless not toggleable). */
     onToggle(): void;
+    /** Whether a header action can be rendered. */
     isHeaderActionVisible(action: FieldsetHeaderAction): boolean;
+    /** Whether a header action should be disabled. */
     isHeaderActionDisabled(action: FieldsetHeaderAction): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldsetComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldsetComponent, "shk-fieldset", never, { "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "showToggleIcon": { "alias": "showToggleIcon"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "badgeClass": { "alias": "badgeClass"; "required": false; "isSignal": true; }; "collapsedIcon": { "alias": "collapsedIcon"; "required": false; "isSignal": true; }; "expandedIcon": { "alias": "expandedIcon"; "required": false; "isSignal": true; }; "headerActions": { "alias": "headerActions"; "required": false; "isSignal": true; }; "customTemplates": { "alias": "customTemplates"; "required": false; "isSignal": true; }; "hasShadow": { "alias": "hasShadow"; "required": false; "isSignal": true; }; "expandLabel": { "alias": "expandLabel"; "required": false; "isSignal": true; }; "collapseLabel": { "alias": "collapseLabel"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; "toggle": "toggle"; "expand": "expand"; "collapse": "collapse"; }, never, ["*"], true, never>;
 }
 
-declare function getIcon(name: string): any;
 /** A step of the wizard shown in the stepper. */
 interface WizardStep {
     id: string | number;
@@ -1100,8 +1852,17 @@ declare class ShkWizardStepContent {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ShkWizardStepContent, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ShkWizardStepContent, "ng-template[shkWizardStepContent]", never, { "stepId": { "alias": "shkWizardStepContent"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Multi-step wizard with a progress stepper, header, footer actions and
+ * content templates declared with `shkWizardStepContent`.
+ */
 declare class WizardComponent {
-    protected getIcon: typeof getIcon;
+    protected getIcon: (name: any) => any;
     /** Steps definition shown in the stepper and used to resolve step content. */
     steps: _angular_core.InputSignal<WizardStep[]>;
     /** Active step id. Two-way bindable with [(currentStep)]. Null resolves to the first step. */
@@ -1170,6 +1931,11 @@ declare class WizardComponent {
 
 type SkeletonShape = 'rectangle' | 'circle';
 type SkeletonAnimation = 'wave' | 'pulse' | 'none';
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** Placeholder block shown while content is loading. */
 declare class SkeletonComponent {
     /** Shape of the skeleton: rectangle (default) or circle. */
@@ -1198,12 +1964,17 @@ declare class SkeletonComponent {
 type ButtonSeverity = 'primary' | 'secondary' | 'success' | 'info' | 'warning' | 'danger' | 'help' | 'contrast';
 type ButtonSize = 'small' | 'large';
 type ButtonIconPosition = 'left' | 'right' | 'top' | 'bottom';
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** Generic button with icon, severity variants, loading state and sizes. */
 declare class ButtonComponent {
     /** Text shown inside the button. */
     label: _angular_core.InputSignal<string>;
-    /** Optional leading lucide icon name. */
-    icon: _angular_core.InputSignal<string>;
+    /** Optional leading lucide icon name or component. */
+    icon: _angular_core.InputSignal<any>;
     /** Position of the icon relative to the label. */
     iconPos: _angular_core.InputSignal<ButtonIconPosition>;
     /** Color variant. Defaults to 'primary'. */
@@ -1238,12 +2009,17 @@ declare class ButtonComponent {
     styleClass: _angular_core.InputSignal<string>;
     /** Emitted on click with the original MouseEvent. */
     onClick: _angular_core.OutputEmitterRef<MouseEvent>;
-    protected getIcon: typeof getIcon$6;
+    protected getIcon: typeof getIcon;
     protected iconOnly: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "shk-button", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconPos": { "alias": "iconPos"; "required": false; "isSignal": true; }; "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "outlined": { "alias": "outlined"; "required": false; "isSignal": true; }; "text": { "alias": "text"; "required": false; "isSignal": true; }; "raised": { "alias": "raised"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingIcon": { "alias": "loadingIcon"; "required": false; "isSignal": true; }; "loadingText": { "alias": "loadingText"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; }, { "onClick": "onClick"; }, never, ["*"], true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** SVG radial knob with drag and keyboard support. Implements ControlValueAccessor. */
 declare class KnobComponent implements ControlValueAccessor {
     /** Current value. Two-way bindable with [(value)]. */
@@ -1303,6 +2079,11 @@ declare class KnobComponent implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KnobComponent, "shk-knob", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "valueColor": { "alias": "valueColor"; "required": false; "isSignal": true; }; "rangeColor": { "alias": "rangeColor"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "change": "change"; "end": "end"; }, never, never, true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** Circular indeterminate spinner. */
 declare class LoadingSpinnerComponent {
     /** Diameter of the spinner. */
@@ -1317,6 +2098,11 @@ declare class LoadingSpinnerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingSpinnerComponent, "shk-loading-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "thickness": { "alias": "thickness"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** Progress bar with an indeterminate sweep or a determinate percentage. */
 declare class LoadingBarComponent {
     /** Height of the bar. */
@@ -1329,6 +2115,7 @@ declare class LoadingBarComponent {
     color: _angular_core.InputSignal<string>;
     /** Renders fully rounded ends. */
     rounded: _angular_core.InputSignal<boolean>;
+    /** Fill width/style for the determinate mode, empty for indeterminate. */
     protected fillStyle: _angular_core.Signal<{
         width?: undefined;
     } | {
@@ -1338,7 +2125,13 @@ declare class LoadingBarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingBarComponent, "shk-loading-bar", never, { "height": { "alias": "height"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Backdrop style behind the overlay: none, light or dark. */
 type LoadingOverlayBackdrop = 'transparent' | 'light' | 'dark';
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** Wraps content and shows a centered spinner over it while `visible` is true. */
 declare class LoadingOverlayComponent {
     /** Controls whether the spinner layer is shown. */
@@ -1355,6 +2148,11 @@ declare class LoadingOverlayComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingOverlayComponent, "shk-loading-overlay", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "spinnerSize": { "alias": "spinnerSize"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "backdrop": { "alias": "backdrop"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** Bouncing dots loading indicator. */
 declare class LoadingDotsComponent {
     /** Diameter of each dot. */
@@ -1365,31 +2163,50 @@ declare class LoadingDotsComponent {
     count: _angular_core.InputSignal<number>;
     /** Optional text shown next to the dots. */
     label: _angular_core.InputSignal<string>;
+    /** Array of dot indices to render based on the `count` input. */
     protected dots: _angular_core.Signal<unknown[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingDotsComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingDotsComponent, "shk-loading-dots", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "count": { "alias": "count"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-/** Shared state between shk-tabs and its projected tab/tabpanel children. */
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Shared state between shk-abs and its tab/tabpanel children. */
 declare class TabsService {
+    /** Currently active tab value. */
     readonly active: _angular_core.WritableSignal<any>;
+    /** Sets the active tab to the given value. */
     select(value: any): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<TabsService>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** Container for tab panels. Renders its projected shk-tablist/shh-tab content. */
 declare class TabsComponent {
     /** Currently active tab value. Two-way bindable with [(value)]. */
     value: _angular_core.ModelSignal<any>;
     /** Allows the tab header to scroll horizontally when it overflows. */
     scrollable: _angular_core.InputSignal<boolean>;
+    /** Shared service used to sync the active tab with the children. */
     protected tabsSvc: TabsService;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "shk-tabs", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, ["*"], true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** Horizontal bar that contains the shk-tab headers. */
 declare class TablistComponent {
     /** Allows the header to scroll horizontally when it overflows. */
@@ -1400,6 +2217,11 @@ declare class TablistComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TablistComponent, "shk-tablist", never, { "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** A single tab header. Clicking it activates the matching panel. */
 declare class TabComponent {
     /** Value that links this tab to its panel. */
@@ -1408,54 +2230,101 @@ declare class TabComponent {
     disabled: _angular_core.InputSignal<boolean>;
     /** Extra CSS classes. */
     styleClass: _angular_core.InputSignal<string>;
+    /** Shared service used to read the active tab value. */
     protected tabsSvc: TabsService;
+    /** Whether this tab is the active one. */
     protected active: _angular_core.Signal<boolean>;
+    /** Activates this tab through the shared service. */
     select(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabComponent, "shk-tab", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** Container that groups the shk-tabpanel content sections. */
 declare class TabpanelsComponent {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabpanelsComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabpanelsComponent, "shk-tabpanels", never, {}, {}, never, ["*"], true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
 /** Content section shown only while its value is the active tab. */
 declare class TabPanelComponent {
     /** Value that links this panel to its tab. */
     value: _angular_core.InputSignal<any>;
+    /** Shared service used to read the active tab value. */
     protected tabsSvc: TabsService;
+    /** Whether this panel is the active one. */
     protected active: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabPanelComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabPanelComponent, "shk-tabpanel", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** A single breadcrumb entry with an optional navigation route. */
 interface BreadcrumbItem {
     label: string;
     route?: string;
 }
+/**
+ * Global breadcrumb state. Components and pages write the current trail via
+ * `set()` and observatories read it through `breadcrumbs$`.
+ */
 declare class BreadcrumbService {
+    /** Internal buffer holding the current breadcrumb trail. */
     private breadcrumbsSubject;
+    /** Observable emitted with the latest breadcrumb trail. */
     breadcrumbs$: Observable<BreadcrumbItem[]>;
+    /** Replaces the whole breadcrumb trail. */
     set(items: BreadcrumbItem[]): void;
+    /** Empties the breadcrumb trail. */
     clear(): void;
+    /** Returns the breadcrumb trail currently held (snapshot). */
     getCurrent(): BreadcrumbItem[];
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BreadcrumbService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<BreadcrumbService>;
 }
 
 type BreadcrumbSeparator = 'chevron' | 'slash' | 'arrow';
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Navigation breadcrumb showing the current page hierarchy. Can be fed with
+ * static items or driven by the shared BreadcrumbService.
+ */
 declare class BreadcrumbComponent implements OnInit, OnDestroy {
     private readonly breadcrumbService;
+    /** Static list of breadcrumb items. Takes precedence over the service items. */
     items: _angular_core.InputSignal<BreadcrumbItem[]>;
+    /** Visual separator between items: 'chevron', 'slash' or 'arrow'. */
     separator: _angular_core.InputSignal<BreadcrumbSeparator>;
+    /** When true, subscribes to the BreadcrumbService to resolve items. */
     useService: _angular_core.InputSignal<boolean>;
+    /** Items received from the BreadcrumbService. */
     protected serviceItems: _angular_core.WritableSignal<BreadcrumbItem[]>;
+    /** Final items: static `items` if provided, otherwise the service items. */
     protected resolvedItems: _angular_core.Signal<BreadcrumbItem[]>;
+    /** Active subscription to the breadcrumb stream. */
     private serviceSub;
     constructor();
+    /** Subscribes to the BreadcrumbService when `useService` is enabled. */
     ngOnInit(): void;
+    /** Unsubscribes from the breadcrumb stream to avoid leaks. */
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BreadcrumbComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<BreadcrumbComponent, "shk-breadcrumb", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; "useService": { "alias": "useService"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;