@litigiovirtual/ius-design-components 2.2.11 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litigiovirtual/ius-design-components",
-  "version": "2.2.11",
+  "version": "2.3.0",
   "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

@@ -36,6 +36,11 @@ interface SizePreset$2 {
  * idle. Una excepción de `action` cae a `error`; resolver sin valor es
  * `success`. `dynamic` ignora los inputs manuales `loading`/`status`.
  *
+ * En loading/success/error el contenido (prefixIcon + label + sufixIcon) sigue
+ * en el flujo con `visibility:hidden` para conservar el ancho natural, y el
+ * spinner o el ícono `check_circle`/`error` se superpone centrado en
+ * `.ius-btn__overlay` (§4/§7).
+ *
  * Nota: el `state` de la spec ("solo demos") se omite de la API pública —
  * mismo criterio que TextField. El playground congela hover/pressed con el
  * atributo `data-force` en el host (solo CSS); loading/success/error/disabled
@@ -893,7 +898,7 @@ declare class AlertComponent {
     /** Divisor sobre la fila de acciones. */
     readonly actionsDivider: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Alineación (auto: `center` si hay `trailing` sin `actions`). */
-    readonly align: _angular_core.InputSignal<"start" | "center" | undefined>;
+    readonly align: _angular_core.InputSignal<"center" | "start" | undefined>;
     /** `status` (default, no interrumpe) o `alert` (asertivo). */
     readonly role: _angular_core.InputSignal<"alert" | "status">;
     /** Al pulsar × (original: `onClose`). */
@@ -904,7 +909,7 @@ declare class AlertComponent {
     protected readonly hasTrailing: _angular_core.Signal<boolean>;
     /** trailing y actions son excluyentes: si hay ambos, gana actions. */
     protected readonly showTrailing: _angular_core.Signal<boolean>;
-    protected readonly computedAlign: _angular_core.Signal<"start" | "center">;
+    protected readonly computedAlign: _angular_core.Signal<"center" | "start">;
     protected readonly iconName: _angular_core.Signal<string | null>;
     protected readonly chip: _angular_core.Signal<boolean>;
     protected readonly showHead: _angular_core.Signal<boolean>;
@@ -4939,6 +4944,14 @@ interface WizardApi {
     back(): void;
     /** Salta a un paso (1-based), o función `(prev) => next`. */
     goTo(next: number | ((prev: number) => number)): void;
+    /**
+     * `true` mientras el botón final dinámico de `ius-wizard-nav`
+     * (`finishDynamic`) no está en reposo (loading · success · error). Sirve para
+     * bloquear otras salidas (p. ej. `backDisabled` del PageHeader). Lo expone
+     * `createWizard`; una api armada a mano puede omitirlo y escuchar el output
+     * `finishingChange` del nav. `back()` llamado directo no se bloquea.
+     */
+    readonly finishing?: boolean;
 }
 interface UseWizardOptions {
     /**
@@ -4977,6 +4990,8 @@ declare class WizardController implements WizardApi {
     private readonly internal?;
     /** Señal de solo lectura del paso (1-based, acotado al total). */
     readonly step$: Signal<number>;
+    /** Espera del botón final; la escribe `ius-wizard-nav` (golden `_setFinishing`). */
+    private readonly finishingSource;
     private readonly onStepChange?;
     private readonly onFinish?;
     constructor(options: UseWizardOptions);
@@ -4987,6 +5002,12 @@ declare class WizardController implements WizardApi {
     get current(): WizardStep | null;
     get isFirst(): boolean;
     get isLast(): boolean;
+    get finishing(): boolean;
+    /**
+     * Lo llama `ius-wizard-nav` al entrar en la espera del botón final y al
+     * volver a reposo. No es para el consumidor: este lee `finishing`.
+     */
+    setFinishing(finishing: boolean): void;
     goTo: (next: number | ((prev: number) => number)) => void;
     next: () => void;
     back: () => void;
@@ -5043,8 +5064,16 @@ declare class WizardComponent {
  * El handler final se pasa como `finishAction` (con `finishDynamic` debe
  * devolver una `Promise` para integrarse con el modo dynamic del Button);
  * además se emite el output `finish` (ng-spec §4).
+ *
+ * Espera del botón final (`finishDynamic`): mientras está en loading · success ·
+ * error, «Atrás» queda deshabilitado, `api.finishing` es `true` (api de
+ * `createWizard`) y `finishingChange` avisa `true` al entrar y `false` al volver
+ * a reposo. El nav espeja la fase del Button con sus mismos tiempos, como el
+ * golden. Si el nav se destruye en plena espera limpia sus timers sin avisar
+ * (igual que el golden) y libera `api.finishing`, para que una api que
+ * sobrevive no quede bloqueada.
  */
-declare class WizardNavComponent {
+declare class WizardNavComponent implements OnDestroy {
     /** API de `createWizard(...)`. */
     api: WizardApi;
     /** Etiqueta del botón atrás. */
@@ -5055,12 +5084,17 @@ declare class WizardNavComponent {
     finishLabel: string;
     /** Ícono al final del botón siguiente. */
     nextIcon: string;
-    /** El botón final usa el modo `dynamic` del Button (loading → success). */
+    /**
+     * El botón final usa el modo `dynamic` del Button (loading → success/error).
+     * Mientras no está en reposo, «Atrás» se deshabilita solo.
+     */
     finishDynamic: boolean;
     /** Deshabilita "siguiente" (p. ej. validación del paso pendiente). */
     nextDisabled: boolean;
     /** Oculta el botón atrás en el primer paso (en vez de deshabilitarlo). */
     hideBackOnFirst: boolean;
+    /** Deshabilita «Atrás» a mano (con `finishDynamic` ya lo hace solo durante la espera). */
+    backDisabled: boolean;
     /**
      * Handler del botón final. Con `finishDynamic` debe devolver una `Promise`
      * (su resolución decide success/error del Button).
@@ -5068,15 +5102,30 @@ declare class WizardNavComponent {
     finishAction?: () => void | IusButtonActionResult | Promise<IusButtonActionResult | void>;
     /** Se dispara al pulsar el botón final (original `onFinish`). */
     readonly finish: EventEmitter<void>;
+    /**
+     * Espera del botón final (`finishDynamic`, original `onFinishingChange`):
+     * `true` al entrar en loading y `false` al volver a reposo tras success/error.
+     * Mismo dato que `api.finishing`, para quien arma la api a mano.
+     */
+    readonly finishingChange: EventEmitter<boolean>;
+    /** Espejo de la fase del Button dinámico: `true` desde loading hasta volver a idle. */
+    protected readonly busy: _angular_core.WritableSignal<boolean>;
+    private timers;
+    private destroyed;
     /** `action` para el modo dynamic del Button: emite `finish` y espera el handler. */
     protected readonly runFinish: () => Promise<IusButtonActionResult | void>;
+    ngOnDestroy(): void;
     /** Click del botón final en modo NO dynamic. */
     protected onFinishClick(): void;
+    /** Solo en los cambios reposo ↔ espera: nunca en cada fase intermedia. */
+    private setBusy;
+    private later;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WizardNavComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WizardNavComponent, "ius-wizard-nav", never, { "api": { "alias": "api"; "required": true; }; "backLabel": { "alias": "backLabel"; "required": false; }; "nextLabel": { "alias": "nextLabel"; "required": false; }; "finishLabel": { "alias": "finishLabel"; "required": false; }; "nextIcon": { "alias": "nextIcon"; "required": false; }; "finishDynamic": { "alias": "finishDynamic"; "required": false; }; "nextDisabled": { "alias": "nextDisabled"; "required": false; }; "hideBackOnFirst": { "alias": "hideBackOnFirst"; "required": false; }; "finishAction": { "alias": "finishAction"; "required": false; }; }, { "finish": "finish"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WizardNavComponent, "ius-wizard-nav", never, { "api": { "alias": "api"; "required": true; }; "backLabel": { "alias": "backLabel"; "required": false; }; "nextLabel": { "alias": "nextLabel"; "required": false; }; "finishLabel": { "alias": "finishLabel"; "required": false; }; "nextIcon": { "alias": "nextIcon"; "required": false; }; "finishDynamic": { "alias": "finishDynamic"; "required": false; }; "nextDisabled": { "alias": "nextDisabled"; "required": false; }; "hideBackOnFirst": { "alias": "hideBackOnFirst"; "required": false; }; "backDisabled": { "alias": "backDisabled"; "required": false; }; "finishAction": { "alias": "finishAction"; "required": false; }; }, { "finish": "finish"; "finishingChange": "finishingChange"; }, never, never, true, never>;
     static ngAcceptInputType_finishDynamic: unknown;
     static ngAcceptInputType_nextDisabled: unknown;
     static ngAcceptInputType_hideBackOnFirst: unknown;
+    static ngAcceptInputType_backDisabled: unknown;
 }
 
 /** Eje con scroll. */
@@ -8171,6 +8220,12 @@ declare class PageHeaderComponent {
     readonly showBack: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Texto accesible de la flecha de volver. */
     readonly backLabel: _angular_core.InputSignal<string>;
+    /**
+     * Flecha de volver desactivada en su sitio (`ius-icon-button` disabled): no se
+     * mueve ni desaparece y no emite `back`. Caso: asistente cuyo botón final
+     * espera (`api.finishing` / `finishingChange` de `ius-wizard-nav`).
+     */
+    readonly backDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Separador inferior. */
     readonly divider: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Fondo blanco + borde + radio. */
@@ -8194,7 +8249,7 @@ declare class PageHeaderComponent {
     /** Volver es leading: si hay breadcrumb, encabeza esa fila. */
     protected readonly backInBreadcrumb: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PageHeaderComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageHeaderComponent, "ius-page-header", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "overline": { "alias": "overline"; "required": false; "isSignal": true; }; "titleLevel": { "alias": "titleLevel"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "showBack": { "alias": "showBack"; "required": false; "isSignal": true; }; "backLabel": { "alias": "backLabel"; "required": false; "isSignal": true; }; "divider": { "alias": "divider"; "required": false; "isSignal": true; }; "surface": { "alias": "surface"; "required": false; "isSignal": true; }; }, { "back": "back"; }, ["breadcrumbRef", "actionsRef", "toolbarRef", "overlineRef", "titleRef", "subtitleRef"], ["[iusPageHeaderBreadcrumb]", "[iusPageHeaderOverline]", "[iusPageHeaderTitle]", "[iusPageHeaderSubtitle]", "[iusPageHeaderActions]", "[iusPageHeaderToolbar]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageHeaderComponent, "ius-page-header", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "overline": { "alias": "overline"; "required": false; "isSignal": true; }; "titleLevel": { "alias": "titleLevel"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "showBack": { "alias": "showBack"; "required": false; "isSignal": true; }; "backLabel": { "alias": "backLabel"; "required": false; "isSignal": true; }; "backDisabled": { "alias": "backDisabled"; "required": false; "isSignal": true; }; "divider": { "alias": "divider"; "required": false; "isSignal": true; }; "surface": { "alias": "surface"; "required": false; "isSignal": true; }; }, { "back": "back"; }, ["breadcrumbRef", "actionsRef", "toolbarRef", "overlineRef", "titleRef", "subtitleRef"], ["[iusPageHeaderBreadcrumb]", "[iusPageHeaderOverline]", "[iusPageHeaderTitle]", "[iusPageHeaderSubtitle]", "[iusPageHeaderActions]", "[iusPageHeaderToolbar]"], true, never>;
 }
 
 /**
@@ -8512,6 +8567,12 @@ interface IusBreadcrumbItem {
     href?: string;
     /** Ícono Material Symbols a la izquierda del label (p. ej. `person`, `folder_open`, `gavel`). */
     icon?: string;
+    /**
+     * Desactiva el crumb: texto sin enlace (`aria-disabled`, `text-disabled`) que no
+     * emite `navigate`; en el menú "…" la opción queda deshabilitada. Caso: bloquear
+     * la salida de un asistente mientras su botón final espera.
+     */
+    disabled?: boolean;
 }
 type IusBreadcrumbSeparator = 'chevron' | 'slash';
 type IusBreadcrumbSize = 'small' | 'medium';