@arsedizioni/ars-utils 22.7.3 → 22.7.5

package/types/arsedizioni-ars-utils-ui.navigation.d.ts

@@ -329,7 +329,14 @@ export declare class NavigationBarComponent {
   readonly variant: import("@angular/core").InputSignal<NavigationVariant>;
   /** Breakpoint → variant map used when `variant` is `auto`. Missing entries fall back to the M3 defaults. */
   readonly autoVariants: import("@angular/core").InputSignal<Partial<Record<"xs" | "sm" | "md" | "lg" | "xl", ResolvedNavigationVariant>>>;
-  /** Two-way bound id of the selected destination. The router, when active, takes precedence. */
+  /**
+   * Two-way bound id of the selected destination.
+   *
+   * While {@link routerSync} is on, a routed destination is lit by the URL alone: this id only
+   * lights a destination with no `route` (an action, an external `href`). So when the URL matches
+   * no destination — a page the menu does not map — nothing is lit, even though the id still
+   * names the destination clicked last.
+   */
   readonly selectedId: import("@angular/core").ModelSignal<string>;
   /**
    * Two-way bound ids of the expanded parent destinations.
@@ -453,6 +460,12 @@ export declare class NavigationBarComponent {
   private readonly panelElements;
   /** Current router URL, kept in a signal so the template stays zoneless-friendly. */
   private readonly routerUrl;
+  /**
+   * Routed destination just clicked, while the navigation it started has not settled yet. It lights
+   * the destination at once, without waiting for a lazy route to load, and it is dropped as soon as
+   * the navigation ends, is cancelled, fails or is skipped: from then on the URL decides.
+   */
+  private readonly pendingId;
   /**
    * Ticks whenever the application theme moves. The emitted value is ignored on
    * purpose: it is a change notification, not the answer.
@@ -543,9 +556,25 @@ export declare class NavigationBarComponent {
    * per theme, and the frames are baked into the inline style of the icon.
    */
   private readonly renderGroups;
+  /** `true` when the URL decides which routed destination is lit: {@link routerSync} is on and there is a router. */
+  private readonly routerDriven;
+  /**
+   * The destinations the router drives — a `route`, no `href`, and a URL the router could
+   * build — each with that URL.
+   */
+  private readonly routedTargets;
+  /** Ids of the destinations in {@link routedTargets}. */
+  private readonly routedIds;
   /** Id of the destination matching the current router URL, using longest-prefix matching. */
   private readonly routerActiveId;
-  /** Id of the currently active destination: router URL first, explicit selection as fallback. */
+  /**
+   * Id of the currently active destination: the routed one just clicked, while its navigation is
+   * under way; then the one matching the URL; then the explicit selection.
+   *
+   * The selection is NOT a fallback for a routed destination while the router drives: on a URL
+   * that matches nothing it would keep the destination clicked last lit over a page that has
+   * nothing to do with it. There, nothing is lit.
+   */
   protected readonly activeId: import("@angular/core").Signal<string>;
   /**
    * Expansion state used when `expandedIds` is left unbound: the destinations