shirkasoft-ui-components 1.1.1 → 1.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shirkasoft-ui-components",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Angular UI Components Library — themeable via CSS custom properties",
   "keywords": [
     "angular",

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

@@ -509,8 +509,20 @@ declare class TableComponent {
     private fb;
     private cdr;
     private transloco;
+    private destroyRef;
     protected getIcon: typeof getIcon$5;
+    /**
+     * 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.
+     */
+    protected readonly DEFAULT_COLUMN_WIDTH = "140px";
+    getColumnWidth(col: Column): string;
     private actionsHeaderLabel;
+    private currentLang;
     data: _angular_core.InputSignal<any[]>;
     columns: _angular_core.InputSignal<Column[]>;
     rowsPerPage: _angular_core.InputSignal<number>;
@@ -557,13 +569,23 @@ declare class TableComponent {
     currentPage: _angular_core.Signal<number>;
     columnFiltersForm: FormGroup;
     private filterSubject;
+    private searchSubject;
+    private lastFilterFieldsSignature;
+    private columnFilterSubscriptions;
     columnsWithActions: _angular_core.Signal<Column[]>;
     effectiveTotalRecords: _angular_core.Signal<number>;
     effectiveDisplayedData: _angular_core.Signal<any[]>;
-    activeFilters: _angular_core.Signal<{
-        [key: string]: any;
-    }>;
+    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.
+     */
     private setupColumnFilters;
     private emitFilterChange;
     private applySearch;
@@ -572,10 +594,24 @@ declare class TableComponent {
     private updateDisplayedData;
     onFilterClick(value: string): void;
     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`.
+     */
     private applySort;
     onSearchInput(value: string): void;
     clearFilter(field: string): void;
     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/''.
+     */
+    hasFilterValue(field: string): boolean;
     getPageReport(): string;
     goToFirst(): void;
     goToLast(): void;
@@ -595,6 +631,16 @@ declare class TableComponent {
     isRowActionVisible(action: RowAction, rowData: any): boolean;
     truncate(value: any, limit?: number): string;
     getTagClass(severity?: string): string;
+    /**
+     * 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.
+     */
+    trackByRow(row: any, index: number): any;
+    /** FIX accesibilidad: soporte de teclado (Enter/Espacio) para ordenar columnas. */
+    onHeaderKeydown(event: KeyboardEvent, col: Column): void;
+    /** FIX accesibilidad: valor aria-sort para el <th> correspondiente. */
+    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>;
 }