structra-ui 0.2.53 → 0.2.55

package/types/structra-ui.d.ts

@@ -9,7 +9,6 @@ import { ICellRendererParams, ColDef, GetRowIdParams, GridReadyEvent } from 'ag-
 import { ICellRendererAngularComp } from 'ag-grid-angular';
 import { DialogRef } from '@angular/cdk/dialog';
 import { Observable } from 'rxjs';
-import * as i1 from '@angular/cdk/scrolling';
 
 /** Marcador de pacote publicado como `structra-ui`. */
 declare const STRUCTRA_UI: "structra-ui";
@@ -3091,9 +3090,12 @@ declare class DrawerComponent implements OnChanges, OnDestroy {
     static ngAcceptInputType_showCloseButton: unknown;
 }
 
-declare class MenuListComponent<T = string> implements OnChanges {
+declare class MenuListComponent<T = string> implements OnChanges, AfterViewInit {
     private readonly cdr;
+    private readonly injector;
+    private readonly destroyRef;
     readonly appTheme: i0.InputSignal<"blue" | "green" | "purple" | "orange" | "white" | "gray" | "sepia" | "black" | AppTheme | undefined>;
+    private bodyRouteSyncGen;
     items: readonly MenuNodeItem<T>[];
     menuId: string;
     dense: boolean;
@@ -3115,19 +3117,33 @@ declare class MenuListComponent<T = string> implements OnChanges {
     readonly closeRequest: EventEmitter<void>;
     readonly submenuBack: EventEmitter<void>;
     readonly groupToggled: i0.OutputEmitterRef<number>;
+    /** Ver {@link MenuListBodyComponent.selectionScrollHint}. */
+    readonly selectionScrollHint: i0.OutputEmitterRef<void>;
     private body?;
     searchQuery: string;
+    constructor();
+    ngAfterViewInit(): void;
     displayItems: MenuNodeItem<T>[];
     get showSearchField(): boolean;
     get expandAllGroupsWhenSearching(): boolean;
     get showSearchNoResults(): boolean;
     ngOnChanges(changes: SimpleChanges): void;
+    /**
+     * O corpo do menu só existe após o primeiro render; no drawer mobile isso atrasa `ensureExpanded`
+     * relativamente ao `ngOnChanges` do corpo — repetimos após `afterNextRender`.
+     */
+    private scheduleBodyRouteSelectionSync;
     onSearchQueryInput(value: string | null): void;
     resetHighlight(): void;
     focusFirstOption(): void;
+    /**
+     * Usado pela `app-sidebar` ao abrir o drawer móvel: garante {@link MenuListBodyComponent.syncRouteSelectionExpansion}
+     * antes do scroll (grupos fechados em `sessionStorage` passam a abrir no caminho do item activo).
+     */
+    syncSelectionForMobileDrawerOpen(): void;
     private syncDisplayItems;
     static ɵfac: i0.ɵɵFactoryDeclaration<MenuListComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MenuListComponent<any>, "app-menu-list", never, { "appTheme": { "alias": "appTheme"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": true; }; "menuId": { "alias": "menuId"; "required": false; }; "dense": { "alias": "dense"; "required": false; }; "nested": { "alias": "nested"; "required": false; }; "selectedItemId": { "alias": "selectedItemId"; "required": false; }; "compressText": { "alias": "compressText"; "required": false; }; "clickToOpen": { "alias": "clickToOpen"; "required": false; }; "groupCollapsible": { "alias": "groupCollapsible"; "required": false; }; "groupDefaultExpansion": { "alias": "groupDefaultExpansion"; "required": false; }; "persistGroupExpansion": { "alias": "persistGroupExpansion"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; }; }, { "itemSelect": "itemSelect"; "closeRequest": "closeRequest"; "submenuBack": "submenuBack"; "groupToggled": "groupToggled"; }, never, never, true, [{ directive: typeof i1.CdkScrollable; inputs: {}; outputs: {}; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MenuListComponent<any>, "app-menu-list", never, { "appTheme": { "alias": "appTheme"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": true; }; "menuId": { "alias": "menuId"; "required": false; }; "dense": { "alias": "dense"; "required": false; }; "nested": { "alias": "nested"; "required": false; }; "selectedItemId": { "alias": "selectedItemId"; "required": false; }; "compressText": { "alias": "compressText"; "required": false; }; "clickToOpen": { "alias": "clickToOpen"; "required": false; }; "groupCollapsible": { "alias": "groupCollapsible"; "required": false; }; "groupDefaultExpansion": { "alias": "groupDefaultExpansion"; "required": false; }; "persistGroupExpansion": { "alias": "persistGroupExpansion"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; }; }, { "itemSelect": "itemSelect"; "closeRequest": "closeRequest"; "submenuBack": "submenuBack"; "groupToggled": "groupToggled"; "selectionScrollHint": "selectionScrollHint"; }, never, never, true, never>;
     static ngAcceptInputType_dense: unknown;
     static ngAcceptInputType_nested: unknown;
     static ngAcceptInputType_compressText: unknown;
@@ -3430,6 +3446,7 @@ declare class AppSidebarComponent<T extends string = string> implements OnChange
     private readonly cdr;
     private readonly destroyRef;
     private readonly hostEl;
+    private readonly injector;
     private readonly renderer;
     /** Igual a `[appTheme]` / {@link ThemeDirective}: paleta explícita no host; omitir = herdar / serviço. */
     readonly appTheme: i0.InputSignal<"blue" | "green" | "purple" | "orange" | "white" | "gray" | "sepia" | "black" | AppTheme | undefined>;
@@ -3439,6 +3456,12 @@ declare class AppSidebarComponent<T extends string = string> implements OnChange
     selectedItemId: T | null;
     /** Modo estreito: só ícones + `compressText` na lista (rótulos via `title` / `aria-label`). */
     collapsed: boolean;
+    /**
+     * Ligado ao estado do drawer no telemóvel (ex.: `mobileNavOpen` do `app-shell`).
+     * Em cada transição para `true`, volta a agendar o scroll até ao item activo — útil porque `selectedItemId`
+     * pode não mudar entre aberturas e o menu pode ser recriado dentro do `@if (open)` do drawer.
+     */
+    mobileNavOpenPulse: boolean;
     /** Repassado a {@link MenuListComponent.searchable}: campo de pesquisa na lista da lateral. */
     searchable: boolean;
     /**
@@ -3456,6 +3479,7 @@ declare class AppSidebarComponent<T extends string = string> implements OnChange
      */
     groupDefaultExpansion: 'all' | 'first';
     readonly itemSelect: EventEmitter<T>;
+    private menuList?;
     /**
      * Valor efectivo de `compressText` em `app-menu-list`: ao expandir a partir do modo rail,
      * mantém-se comprimido até a animação de largura terminar (evita flicker de texto).
@@ -3465,16 +3489,33 @@ declare class AppSidebarComponent<T extends string = string> implements OnChange
     readonly listCompressText: i0.WritableSignal<boolean>;
     private listRevealTimeoutId;
     private scrollRestoreTimeoutId;
+    /** Invalida tentativas de scroll pendentes (ex.: novo agendamento ou destroy). */
+    private scrollToSelectedGeneration;
+    /** `setTimeout` extra ao abrir o drawer — animação (~240ms) e flex podem atrasar métricas do scroll. */
+    private drawerScrollAssistTimeouts;
     constructor();
     ngAfterViewInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     /**
-     * Garante que o item `--selected` fica inteiro na área útil (margem + cabeçalho sticky),
-     * com ~½ da opção vizinha visível quando há scroll, e movimento suave.
+     * Agenda scroll até ao `--selected` depois do próximo render (filhos OnPush) e reintenta em `rAF`
+     * até o elemento existir — necessário no drawer mobile, onde o menu acaba de montar.
+     */
+    /**
+     * Repete o scroll quando o utilizador clica num item já activo mas «cortado» (`selectedItemId` não muda).
      */
-    private scrollSidebarToSelectedItem;
+    onSidebarItemSelect(id: T): void;
+    /** Também ligado a `(selectionScrollHint)` em `app-menu-list` para o drawer mobile. */
+    scheduleScrollToSelected(): void;
+    private static readonly SCROLL_TO_SELECTED_MAX_ATTEMPTS;
+    private static readonly SCROLL_TO_SELECTED_MAX_ATTEMPTS_DRAWER;
+    /** Sidebar projectada em `.app-drawer__body` — animação do painel e `overflow` do shell afectam o layout. */
+    private isInsideMobileDrawer;
+    private clearDrawerScrollAssistTimeouts;
+    private runScrollToSelectedRetry;
     /** Após clicar num grupo colapsável: leva o cabeçalho do grupo para a zona visível (como o item seleccionado). */
     onMenuGroupToggled(groupId: number): void;
+    /** Área com scroll dos itens (`cdkScrollable`), não o cabeçalho nem a pesquisa. */
+    private getSidebarMenuListViewport;
     private scrollSidebarScrollAreaToElement;
     /**
      * Metade da altura da linha vizinha (opção ou cabeçalho de grupo) na mesma lista (fallback em px).
@@ -3484,8 +3525,9 @@ declare class AppSidebarComponent<T extends string = string> implements OnChange
     private scheduleSidebarHeadLayoutGuards;
     private applySidebarHeadLayoutGuards;
     static ɵfac: i0.ɵɵFactoryDeclaration<AppSidebarComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AppSidebarComponent<any>, "app-sidebar", never, { "appTheme": { "alias": "appTheme"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": true; }; "menuId": { "alias": "menuId"; "required": false; }; "selectedItemId": { "alias": "selectedItemId"; "required": false; }; "collapsed": { "alias": "collapsed"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "clickToOpen": { "alias": "clickToOpen"; "required": false; }; "groupCollapsible": { "alias": "groupCollapsible"; "required": false; }; "groupDefaultExpansion": { "alias": "groupDefaultExpansion"; "required": false; }; }, { "itemSelect": "itemSelect"; }, never, ["[appSidebarBrand]", "[appSidebarToolbar]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AppSidebarComponent<any>, "app-sidebar", never, { "appTheme": { "alias": "appTheme"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": true; }; "menuId": { "alias": "menuId"; "required": false; }; "selectedItemId": { "alias": "selectedItemId"; "required": false; }; "collapsed": { "alias": "collapsed"; "required": false; }; "mobileNavOpenPulse": { "alias": "mobileNavOpenPulse"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "clickToOpen": { "alias": "clickToOpen"; "required": false; }; "groupCollapsible": { "alias": "groupCollapsible"; "required": false; }; "groupDefaultExpansion": { "alias": "groupDefaultExpansion"; "required": false; }; }, { "itemSelect": "itemSelect"; }, never, ["[appSidebarBrand]", "[appSidebarToolbar]"], true, never>;
     static ngAcceptInputType_collapsed: unknown;
+    static ngAcceptInputType_mobileNavOpenPulse: unknown;
     static ngAcceptInputType_searchable: unknown;
     static ngAcceptInputType_groupCollapsible: unknown;
 }