structra-ui 0.2.31 → 0.2.32

package/types/structra-ui.d.ts

@@ -173,6 +173,11 @@ interface MenuItemGroup<T = string> {
     label?: string;
     /** Itens e submenus aninhados dentro do grupo. */
     items: readonly MenuNodeItem<T>[];
+    /**
+     * Se `true`, o grupo não recolhe e não mostra controlo de expandir — útil para a secção principal
+     * em relação a grupos secundários colapsáveis.
+     */
+    alwaysExpanded?: boolean;
 }
 /** Folha: ação ou divisor. */
 type MenuLeafItem<T = string> = MenuItemAction<T> | MenuItemDivider;
@@ -3061,18 +3066,25 @@ interface MenuRowAction<T = string> {
     item: MenuItemAction<T>;
     /** Índice na navegação por teclado; `null` se desabilitado. */
     focusIndex: number | null;
+    /** `null` = fora de grupo; caso contrário, pertence a este grupo (oculto se o grupo estiver fechado). */
+    containingGroupId?: number | null;
 }
 interface MenuRowDivider {
     kind: 'divider';
+    containingGroupId?: number | null;
 }
 interface MenuRowGroup {
     kind: 'group';
     label?: string;
+    groupId: number;
+    /** Eco de {@link MenuItemGroup.alwaysExpanded}. */
+    alwaysExpanded?: boolean;
 }
 interface MenuRowSubmenu<T = string> {
     kind: 'submenu';
     item: MenuItemSubmenu<T>;
     focusIndex: number | null;
+    containingGroupId?: number | null;
 }
 type MenuRow<T = string> = MenuRowAction<T> | MenuRowDivider | MenuRowGroup | MenuRowSubmenu<T>;
 
@@ -3103,11 +3115,25 @@ declare class MenuListComponent<T = string> implements OnChanges {
      * - **`false`** — igual ao comportamento anterior: abre **só com hover** (com atraso), sem alternar ao clicar na linha.
      */
     clickToOpen: boolean;
+    /**
+     * Grupos (`kind: 'group'`): quando `false`, cabeçalhos sem seta e itens sempre visíveis (não recolhe).
+     */
+    groupCollapsible: boolean;
+    /**
+     * Com {@link groupCollapsible}: estado inicial ao receber `items`.
+     * - `'all'` — todos os grupos expandidos (omissão).
+     * - `'first'` — só o primeiro grupo expandível fica aberto; os restantes recolhidos.
+     */
+    groupDefaultExpansion: 'all' | 'first';
     readonly itemSelect: EventEmitter<T>;
     readonly closeRequest: EventEmitter<void>;
     readonly submenuBack: EventEmitter<void>;
     private nestedLists?;
     rows: MenuRow<T>[];
+    /** Filtrado + índices de foco coerentes com grupos recolhidos. */
+    displayRows: MenuRow<T>[];
+    /** Ids de grupo expandidos; ao mudar `items`, todos voltam a abertos. */
+    private readonly expandedGroupIds;
     private focusableCount;
     /** Índice entre `0` e `focusableCount - 1`, ou `-1` = nenhum realce. */
     activeIndex: number;
@@ -3121,11 +3147,26 @@ declare class MenuListComponent<T = string> implements OnChanges {
     }>;
     overlayPanelClasses(): string[];
     onNestedItemSelect(id: T): void;
+    /** Identidade estável para `@for` — `track $index` quebra quando linhas são omitidas por grupo recolhido. */
+    trackDisplayRow(index: number, row: MenuRow<T>): string;
     ngOnChanges(changes: SimpleChanges): void;
+    /** Estado inicial de grupos expandidos (chaveado por {@link groupDefaultExpansion}). */
+    private applyInitialExpandedGroups;
+    private syncDisplayRows;
+    isGroupExpanded(groupId: number): boolean;
+    /** Eco de `MenuItemGroup.alwaysExpanded` para este `groupId`. */
+    private isGroupAlwaysExpanded;
+    private isRowVisible;
+    toggleGroup(groupId: number): void;
     submenuRowKey(row: MenuRow<T>, index: number): string;
     isSubmenuOpen(row: MenuRow<T>, index: number): boolean;
     submenuMenuId(row: MenuRow<T>): string;
     onRowMouseEnter(row: MenuRow<T>): void;
+    /**
+     * Grupo / divisor não são `menuitem` com foco-mãe — ao passar o rato para o cabeçalho do grupo,
+     * limpa o realce da opção anterior (`.menu-list__option--active`).
+     */
+    onNonOptionSurfaceEnter(): void;
     onSubmenuTriggerEnter(row: MenuRow<T>, index: number): void;
     onSubmenuTriggerLeave(_row: MenuRow<T>, index: number): void;
     onSubmenuPanelEnter(): void;
@@ -3151,10 +3192,11 @@ declare class MenuListComponent<T = string> implements OnChanges {
     private focusActiveDom;
     onKeydown(ev: KeyboardEvent): void;
     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; }; }, { "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; }; }, { "itemSelect": "itemSelect"; "closeRequest": "closeRequest"; "submenuBack": "submenuBack"; }, 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;
 }
 
 /**
@@ -3194,9 +3236,15 @@ declare class MenuGroupComponent {
     label?: string;
     /** Quando `true`, não mostra o título (ex.: sidebar colapsada só com ícones). */
     hideLabel: boolean;
+    /** Quando `true`, mostra seta e permite expandir/recolher (controlado pelo `menu-list`). */
+    collapsible: boolean;
+    expanded: boolean;
+    readonly toggleExpand: EventEmitter<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<MenuGroupComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MenuGroupComponent, "app-menu-group", never, { "label": { "alias": "label"; "required": false; }; "hideLabel": { "alias": "hideLabel"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MenuGroupComponent, "app-menu-group", never, { "label": { "alias": "label"; "required": false; }; "hideLabel": { "alias": "hideLabel"; "required": false; }; "collapsible": { "alias": "collapsible"; "required": false; }; "expanded": { "alias": "expanded"; "required": false; }; }, { "toggleExpand": "toggleExpand"; }, never, never, true, never>;
     static ngAcceptInputType_hideLabel: unknown;
+    static ngAcceptInputType_collapsible: unknown;
+    static ngAcceptInputType_expanded: unknown;
 }
 
 /**
@@ -3459,6 +3507,15 @@ declare class AppSidebarComponent<T extends string = string> implements OnChange
      * ou por **hover** (`false`).
      */
     clickToOpen: boolean;
+    /**
+     * Repassado a {@link MenuListComponent.groupCollapsible}: `false` desactiva expandir/recolher nas secções.
+     */
+    groupCollapsible: boolean;
+    /**
+     * Repassado a {@link MenuListComponent.groupDefaultExpansion}: estado inicial dos grupos ao carregar `items`.
+     * Com `'first'` e um primeiro grupo `alwaysExpanded`, os restantes grupos colapsáveis começam fechados.
+     */
+    groupDefaultExpansion: 'all' | 'first';
     readonly itemSelect: EventEmitter<T>;
     /**
      * Valor efectivo de `compressText` em `app-menu-list`: ao expandir, mantém-se comprimido
@@ -3473,8 +3530,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; }; "clickToOpen": { "alias": "clickToOpen"; "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; }; "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_groupCollapsible: unknown;
 }
 
 /**