@zambon-dev/library 1.4.0 → 1.5.0

package/lib/components/catalog-select/catalog-select.component.d.ts

@@ -98,7 +98,17 @@ export declare class CatalogSelectComponent extends BaseComponent implements OnI
     private openDropdownOverlay;
     private refreshSearch;
     private resetMessages;
+    private resolveDisplay;
     private syncDisplayFromCurrentValue;
+    /**
+     * Decides whether the display control has to be written again.
+     *
+     * The value on its own is not enough. Resetting a form clears the display control and then
+     * patches the same value back, so an unchanged value can still leave the display empty. That
+     * only happens when the stored value equals the control's initial value, which is why it used
+     * to show up on the default entry alone.
+     */
+    private shouldRefreshDisplay;
     private syncFormControlsEnabledDisabled;
     private tryFilterFromDataset;
     private updateFilters;

package/lib/components/sidebar/sidebar.component.d.ts

@@ -24,7 +24,16 @@ export declare class SidebarComponent extends BaseComponent implements AfterView
     collapse(): void;
     protected trackByFn(_index: number, item: SidebarMenu): number;
     protected trackByRegion(_index: number, region: SidebarRegion): string;
+    /** Whether this top-level menu stands for an area rather than a destination of its own. */
+    private isArea;
+    private groupByRegionLabel;
+    private groupByRootMenus;
     private groupIntoRegions;
+    /**
+     * Fetches the children of every area up front, because they are rendered flat rather than
+     * behind a click, so the lazy load a collapsible parent relies on would never be triggered.
+     */
+    private loadAreaChildren;
     private deactivate;
     private updateShouldActivate;
     static ɵfac: i0.ɵɵFactoryDeclaration<SidebarComponent, never>;

package/lib/models/sidebar/sidebar-configs.d.ts

@@ -5,6 +5,17 @@ export declare class SidebarConfigs {
     /** Tooltip for items that open in a new browser tab. Rendered as-is, like {@link errorText}. */
     externalLinkText: string;
     loadingText: string;
+    /**
+     * Derive region headers from the menu tree instead of from {@link SidebarMenu.region}.
+     *
+     * With this on, a top-level menu that has children and no URL stops being a collapsible node
+     * and becomes an area header, with its children rendered flat beneath it as top-level items --
+     * icons included. The area is then a real menu row, so it carries its own translated label and
+     * its own order, and no `region` label has to be repeated across every item that belongs to it.
+     *
+     * Off by default: without it a top-level parent stays the collapsible group it has always been.
+     */
+    shouldDeriveAreasFromRootMenus: boolean;
     logoCollapsedPath?: string;
     logoExpandedPath?: string;
     constructor(options?: Partial<SidebarConfigs>);

package/lib/services/sidebar.service.d.ts

@@ -16,6 +16,12 @@ export declare abstract class SidebarService {
     private selectedMenu;
     deselectAll(): void;
     loadChildren(parentMenu: SidebarMenu): void;
+    /**
+     * Loads a parent's children and hands them back, for callers that need them before the user
+     * clicks -- a sidebar rendering areas flat has to have them up front. {@link loadChildren} is
+     * the fire-and-forget variant that also raises the loading and failure events.
+     */
+    loadChildrenFor(parentMenu: SidebarMenu): Observable<SidebarMenu[]>;
     loadRoot(): Observable<SidebarMenu[]>;
     select(menu: SidebarMenu): void;
     private deselectMenu;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zambon-dev/library",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Angular UI components and shared presentation utilities for Zambon applications.",
   "keywords": [
     "angular",