structra-ui 0.2.54 → 0.2.55

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "structra-ui",
-  "version": "0.2.54",
+  "version": "0.2.55",
   "description": "Biblioteca de componentes Angular da StructraLab (UI reutilizável).",
   "homepage": "https://structralab.com/",
   "license": "MIT",

package/types/structra-ui.d.ts

@@ -3090,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;
@@ -3114,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, 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"; "selectionScrollHint": "selectionScrollHint"; }, never, never, true, never>;
     static ngAcceptInputType_dense: unknown;
     static ngAcceptInputType_nested: unknown;
     static ngAcceptInputType_compressText: unknown;
@@ -3429,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>;
@@ -3438,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;
     /**
@@ -3455,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).
@@ -3464,14 +3489,29 @@ 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. */
@@ -3485,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;
 }