structra-ui 0.2.49 → 0.2.51

package/package.json

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

package/types/structra-ui.d.ts

@@ -3104,11 +3104,17 @@ declare class MenuListComponent<T = string> implements OnChanges {
     groupCollapsible: boolean;
     /** Repasse para {@link MenuListBodyComponent.groupDefaultExpansion}. */
     groupDefaultExpansion: 'all' | 'first';
+    /**
+     * Quando `true` (omissão), abrir/fechar grupos colapsáveis persiste em `sessionStorage`
+     * até ao refresh da página — útil na navegação SPA da sidebar.
+     */
+    persistGroupExpansion: boolean;
     searchable: boolean;
     searchPlaceholder: string;
     readonly itemSelect: EventEmitter<T>;
     readonly closeRequest: EventEmitter<void>;
     readonly submenuBack: EventEmitter<void>;
+    readonly groupToggled: i0.OutputEmitterRef<number>;
     private body?;
     searchQuery: string;
     displayItems: MenuNodeItem<T>[];
@@ -3121,11 +3127,12 @@ declare class MenuListComponent<T = string> implements OnChanges {
     focusFirstOption(): 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; }; "searchable": { "alias": "searchable"; "required": false; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; }; }, { "itemSelect": "itemSelect"; "closeRequest": "closeRequest"; "submenuBack": "submenuBack"; }, 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"; }, never, never, true, [{ directive: typeof i1.CdkScrollable; inputs: {}; outputs: {}; }]>;
     static ngAcceptInputType_dense: unknown;
     static ngAcceptInputType_nested: unknown;
     static ngAcceptInputType_compressText: unknown;
     static ngAcceptInputType_groupCollapsible: unknown;
+    static ngAcceptInputType_persistGroupExpansion: unknown;
     static ngAcceptInputType_searchable: unknown;
 }
 
@@ -3457,9 +3464,22 @@ declare class AppSidebarComponent<T extends string = string> implements OnChange
      */
     readonly listCompressText: i0.WritableSignal<boolean>;
     private listRevealTimeoutId;
+    private scrollRestoreTimeoutId;
     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.
+     */
+    private scrollSidebarToSelectedItem;
+    /** 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;
+    private scrollSidebarScrollAreaToElement;
+    /**
+     * Metade da altura da linha vizinha (opção ou cabeçalho de grupo) na mesma lista (fallback em px).
+     */
+    private getMenuNeighborPeekHalfHeights;
     private clearListRevealTimeout;
     private scheduleSidebarHeadLayoutGuards;
     private applySidebarHeadLayoutGuards;