@litigiovirtual/ius-design-components 2.2.1 → 2.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litigiovirtual/ius-design-components",
-  "version": "2.2.1",
+  "version": "2.2.3",
   "peerDependencies": {
     "@angular/cdk": ">=22.0.0 <23.0.0",
     "@angular/common": ">=22.0.0 <23.0.0",

package/types/litigiovirtual-ius-design-components.d.ts

@@ -8567,6 +8567,13 @@ declare class EntityNavigatorComponent {
     readonly createIcon: _angular_core.InputSignal<string>;
     readonly groupLimit: _angular_core.InputSignal<number | undefined>;
     readonly collapsibleGroups: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Grupos plegados **controlado** (keys). Presente → el consumidor gobierna el
+     * plegado; el navegador refleja este set y emite `groupCollapse(next)` en cada
+     * cambio — incluido el auto-despliegue del salto por letra sobre un grupo
+     * plegado. Sin él, el plegado es estado interno. Requiere `collapsibleGroups`.
+     */
+    readonly collapsedGroups: _angular_core.InputSignal<readonly string[] | undefined>;
     readonly stickyHeaders: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly pinnableGroups: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly defaultPinnedGroup: _angular_core.InputSignal<string | null>;
@@ -8614,6 +8621,8 @@ declare class EntityNavigatorComponent {
     }>;
     readonly create: EventEmitter<MouseEvent>;
     readonly pinGroup: EventEmitter<string | null>;
+    /** Par two-way de `collapsedGroups`. */
+    readonly groupCollapse: EventEmitter<string[]>;
     readonly more: EventEmitter<MouseEvent>;
     /** Par two-way de `collapsed`. */
     readonly collapsedChange: EventEmitter<boolean>;
@@ -8626,6 +8635,7 @@ declare class EntityNavigatorComponent {
     private readonly sentinels;
     private readonly letterAnchors;
     private readonly doc;
+    private readonly injector;
     private readonly zone;
     private readonly destroyRef;
     private readonly internalCollapsed;
@@ -8655,12 +8665,14 @@ declare class EntityNavigatorComponent {
     private readonly lmBusy;
     private readonly lmCounts;
     private pendingLetter;
+    private pendingDesde;
     private io;
-    private vRaf;
     constructor();
     /** Siembra el estado interno con los `default*` la primera vez que se leen. */
     private sembrarEstadoInicial;
     protected readonly isCollapsed: _angular_core.Signal<boolean>;
+    /** Grupos plegados efectivos: el input controlado manda sobre el interno. */
+    protected readonly plegados: _angular_core.Signal<ReadonlySet<string>>;
     protected readonly activeKeys: _angular_core.Signal<ReadonlySet<string>>;
     protected readonly stateVal: _angular_core.Signal<string | undefined>;
     /** SegmentedControl pide un array mutable; el input del contrato es readonly. */
@@ -8715,6 +8727,12 @@ declare class EntityNavigatorComponent {
     protected alternarPinGrupo(key: string): void;
     protected alternarShowMore(key: string): void;
     protected alternarPlegadoGrupo(key: string): void;
+    /**
+     * Camino único del plegado: si `collapsedGroups` es controlado solo emite
+     * (el consumidor manda el set); si no, muta el estado interno. Lo usan tanto
+     * el chevron del encabezado como el auto-despliegue del salto por letra.
+     */
+    private aplicarPlegado;
     protected alternarColapso(): void;
     private readonly alturas;
     /** `stickyHeaders` es incompatible con la ventana de render: con `virtualized` se ignora. */
@@ -8750,6 +8768,13 @@ declare class EntityNavigatorComponent {
     private readonly hayMasLotes;
     /** (Re)observa los centinelas presentes tras cada render. */
     private registrarCentinelas;
+    /**
+     * Barrido único del nivel superior: las letras presentes (en orden de
+     * aparición) y el grupo donde cae cada una. Recorre `g.items` **crudo**, así
+     * que ve también los grupos plegados — de ahí sale el auto-despliegue del
+     * salto. Primera aparición gana, igual que el ancla del DOM.
+     */
+    private readonly barridoDeLetras;
     /** Letras realmente presentes en el nivel superior, en orden de aparición. */
     protected readonly letrasPresentes: _angular_core.Signal<string[]>;
     private readonly setPresentes;
@@ -8762,12 +8787,42 @@ declare class EntityNavigatorComponent {
     /** Roving tabindex: el único tab-stop del rail. */
     protected readonly alphaTabStop: _angular_core.Signal<string | undefined>;
     protected saltarALetra(letter: string): void;
+    /** Deja el salto en espera de su destino, con el sello para acotar la espera. */
+    private dejarSaltoPendiente;
+    /**
+     * Despliega el grupo que contiene `letter` si está plegado. Va por el mismo
+     * camino que el chevron (`aplicarPlegado`): con `collapsedGroups` controlado
+     * emite `groupCollapse` para sincronizar al consumidor, si no muta el estado
+     * interno. Devuelve `true` si hubo que desplegar (el salto queda pendiente).
+     */
+    private desplegarGrupoDeLetra;
+    /**
+     * ¿El cuerpo ya pintó las filas del grupo al que pertenece `letter`? Es lo que
+     * distingue «el destino todavía no tiene layout» de «el destino no existe».
+     */
+    private vistaAlDia;
     private anclaDeLetra;
     /** Descuenta el alto del encabezado sticky (salto por scrollTop, no scrollIntoView). */
     private topDeAncla;
     private prefiereMenosMovimiento;
-    /** Resuelve el salto pendiente cuando el ancla aparece tras cargar lotes. */
+    /**
+     * Reintenta el salto pendiente cada vez que cambian las anclas o el modelo —
+     * el destino puede aparecer tras cargar lotes o tras desplegar su grupo.
+     */
     private registrarAnclasDeLetra;
+    /**
+     * Desplaza hasta el destino del salto pendiente si ya se puede: con ventana de
+     * render sale del offset declarado, si no del ancla en el DOM.
+     *
+     * Mientras no se pueda, el salto se CONSERVA: el destino puede estar a un
+     * render de distancia (grupo recién desplegado), a un lote de distancia, o a
+     * la espera de que el consumidor aplique el `collapsedGroups` que se le emitió.
+     * Descartarlo en el primer intento fallido era el bug: el ancla llegaba un
+     * turno después y el salto ya no existía. La espera va acotada por
+     * `SALTO_PENDIENTE_TTL` para no dejarlo colgado ni desplazar por sorpresa
+     * mucho después (p. ej. si el ancla nunca se pinta por `groupLimit`).
+     */
+    private resolverSaltoPendiente;
     /** Teclado del rail: ↑/↓/Inicio/Fin mueven el foco entre letras habilitadas. */
     protected onRailKey(event: KeyboardEvent): void;
     private registrarObservadores;
@@ -8786,7 +8841,7 @@ declare class EntityNavigatorComponent {
     protected padAddChild(level: number): number;
     protected etiquetaPinGrupo(fijada: boolean): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EntityNavigatorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityNavigatorComponent, "ius-entity-navigator", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "titleIcon": { "alias": "titleIcon"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "searchThreshold": { "alias": "searchThreshold"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchValue": { "alias": "searchValue"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "selectedFilters": { "alias": "selectedFilters"; "required": false; "isSignal": true; }; "availableFilters": { "alias": "availableFilters"; "required": false; "isSignal": true; }; "activeFacets": { "alias": "activeFacets"; "required": false; "isSignal": true; }; "stateSegments": { "alias": "stateSegments"; "required": false; "isSignal": true; }; "stateValue": { "alias": "stateValue"; "required": false; "isSignal": true; }; "sortLabel": { "alias": "sortLabel"; "required": false; "isSignal": true; }; "sortOptions": { "alias": "sortOptions"; "required": false; "isSignal": true; }; "sortValue": { "alias": "sortValue"; "required": false; "isSignal": true; }; "metaLabel": { "alias": "metaLabel"; "required": false; "isSignal": true; }; "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "accent": { "alias": "accent"; "required": false; "isSignal": true; }; "defaultExpanded": { "alias": "defaultExpanded"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "autoExpandOnFilter": { "alias": "autoExpandOnFilter"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "defaultSelected": { "alias": "defaultSelected"; "required": false; "isSignal": true; }; "emptyStateTemplate": { "alias": "emptyStateTemplate"; "required": false; "isSignal": true; }; "noResultsLabel": { "alias": "noResultsLabel"; "required": false; "isSignal": true; }; "createLabel": { "alias": "createLabel"; "required": false; "isSignal": true; }; "createIcon": { "alias": "createIcon"; "required": false; "isSignal": true; }; "groupLimit": { "alias": "groupLimit"; "required": false; "isSignal": true; }; "collapsibleGroups": { "alias": "collapsibleGroups"; "required": false; "isSignal": true; }; "stickyHeaders": { "alias": "stickyHeaders"; "required": false; "isSignal": true; }; "pinnableGroups": { "alias": "pinnableGroups"; "required": false; "isSignal": true; }; "defaultPinnedGroup": { "alias": "defaultPinnedGroup"; "required": false; "isSignal": true; }; "moreLabel": { "alias": "moreLabel"; "required": false; "isSignal": true; }; "alphaIndex": { "alias": "alphaIndex"; "required": false; "isSignal": true; }; "alphaIndexLetters": { "alias": "alphaIndexLetters"; "required": false; "isSignal": true; }; "loadMoreLabel": { "alias": "loadMoreLabel"; "required": false; "isSignal": true; }; "virtualized": { "alias": "virtualized"; "required": false; "isSignal": true; }; "virtualizeThreshold": { "alias": "virtualizeThreshold"; "required": false; "isSignal": true; }; "itemHeights": { "alias": "itemHeights"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "defaultCollapsed": { "alias": "defaultCollapsed"; "required": false; "isSignal": true; }; "fluidWidth": { "alias": "fluidWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "search": "search"; "searchChange": "searchChange"; "searchClear": "searchClear"; "filter": "filter"; "filterRemove": "filterRemove"; "addFilter": "addFilter"; "stateChange": "stateChange"; "facetAdd": "facetAdd"; "facetRemove": "facetRemove"; "sort": "sort"; "select": "select"; "selectedChange": "selectedChange"; "expandedChange": "expandedChange"; "togglePin": "togglePin"; "create": "create"; "pinGroup": "pinGroup"; "more": "more"; "collapsedChange": "collapsedChange"; "jumpToLetter": "jumpToLetter"; "loadMore": "loadMore"; "expandLoad": "expandLoad"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityNavigatorComponent, "ius-entity-navigator", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "titleIcon": { "alias": "titleIcon"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "searchThreshold": { "alias": "searchThreshold"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchValue": { "alias": "searchValue"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "selectedFilters": { "alias": "selectedFilters"; "required": false; "isSignal": true; }; "availableFilters": { "alias": "availableFilters"; "required": false; "isSignal": true; }; "activeFacets": { "alias": "activeFacets"; "required": false; "isSignal": true; }; "stateSegments": { "alias": "stateSegments"; "required": false; "isSignal": true; }; "stateValue": { "alias": "stateValue"; "required": false; "isSignal": true; }; "sortLabel": { "alias": "sortLabel"; "required": false; "isSignal": true; }; "sortOptions": { "alias": "sortOptions"; "required": false; "isSignal": true; }; "sortValue": { "alias": "sortValue"; "required": false; "isSignal": true; }; "metaLabel": { "alias": "metaLabel"; "required": false; "isSignal": true; }; "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "accent": { "alias": "accent"; "required": false; "isSignal": true; }; "defaultExpanded": { "alias": "defaultExpanded"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "autoExpandOnFilter": { "alias": "autoExpandOnFilter"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "defaultSelected": { "alias": "defaultSelected"; "required": false; "isSignal": true; }; "emptyStateTemplate": { "alias": "emptyStateTemplate"; "required": false; "isSignal": true; }; "noResultsLabel": { "alias": "noResultsLabel"; "required": false; "isSignal": true; }; "createLabel": { "alias": "createLabel"; "required": false; "isSignal": true; }; "createIcon": { "alias": "createIcon"; "required": false; "isSignal": true; }; "groupLimit": { "alias": "groupLimit"; "required": false; "isSignal": true; }; "collapsibleGroups": { "alias": "collapsibleGroups"; "required": false; "isSignal": true; }; "collapsedGroups": { "alias": "collapsedGroups"; "required": false; "isSignal": true; }; "stickyHeaders": { "alias": "stickyHeaders"; "required": false; "isSignal": true; }; "pinnableGroups": { "alias": "pinnableGroups"; "required": false; "isSignal": true; }; "defaultPinnedGroup": { "alias": "defaultPinnedGroup"; "required": false; "isSignal": true; }; "moreLabel": { "alias": "moreLabel"; "required": false; "isSignal": true; }; "alphaIndex": { "alias": "alphaIndex"; "required": false; "isSignal": true; }; "alphaIndexLetters": { "alias": "alphaIndexLetters"; "required": false; "isSignal": true; }; "loadMoreLabel": { "alias": "loadMoreLabel"; "required": false; "isSignal": true; }; "virtualized": { "alias": "virtualized"; "required": false; "isSignal": true; }; "virtualizeThreshold": { "alias": "virtualizeThreshold"; "required": false; "isSignal": true; }; "itemHeights": { "alias": "itemHeights"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "defaultCollapsed": { "alias": "defaultCollapsed"; "required": false; "isSignal": true; }; "fluidWidth": { "alias": "fluidWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "search": "search"; "searchChange": "searchChange"; "searchClear": "searchClear"; "filter": "filter"; "filterRemove": "filterRemove"; "addFilter": "addFilter"; "stateChange": "stateChange"; "facetAdd": "facetAdd"; "facetRemove": "facetRemove"; "sort": "sort"; "select": "select"; "selectedChange": "selectedChange"; "expandedChange": "expandedChange"; "togglePin": "togglePin"; "create": "create"; "pinGroup": "pinGroup"; "groupCollapse": "groupCollapse"; "more": "more"; "collapsedChange": "collapsedChange"; "jumpToLetter": "jumpToLetter"; "loadMore": "loadMore"; "expandLoad": "expandLoad"; }, never, never, true, never>;
 }
 
 /**