@magmonium/one 0.4.31 → 0.4.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magmonium/one",
-  "version": "0.4.31",
+  "version": "0.4.32",
   "description": "Magmonium One — Angular design-system primitives for mm Apps",
   "author": "magmonium",
   "license": "MIT",

package/types/magmonium-one.d.ts

@@ -867,7 +867,7 @@ export interface NavStoreRef {
   isNavActive?: (navId: string) => boolean;
   /** A mounted Remote announcing itself, and leaving (ADR 0036). */
   registerMount?: (mount: RemoteMount) => void;
-  unregisterMount?: (name: string) => void;
+  unregisterMount?: (name: string, navigate?: RemoteMount['navigate']) => void;
   /**
    * Where a mount's own Router stands, reported on each move; `undefined`
    * forgets it. Optional: a host built before it existed provides none.
@@ -1910,6 +1910,7 @@ export declare abstract class BaseRootWebComponent extends BaseWebComponent {
   query: import("@angular/core").InputSignal<string | undefined>;
   private readonly navWidgetMaps;
   private readonly appBaseHref;
+  private readonly location;
   private readonly injector;
   private readonly wcComponents;
   private readonly defaultNavId;
@@ -12335,6 +12336,7 @@ export declare const ModalStore: import("@angular/core").Type<{
 }>>;
 export type ModalStore = InstanceType<typeof ModalStore>;
 export declare class PanelComponent implements AfterViewInit, OnDestroy {
+  #private;
   readonly component: import("@angular/core").InputSignal<Type<unknown> | undefined>;
   readonly bindings: import("@angular/core").InputSignal<Binding[] | undefined>;
   readonly providers: import("@angular/core").InputSignal<StaticProvider[] | undefined>;
@@ -12380,6 +12382,7 @@ export declare class PanelComponent implements AfterViewInit, OnDestroy {
     panelParentClassName: string;
     activePanel: string | undefined;
   }>;
+  protected readonly navOpen: import("@angular/core").Signal<boolean>;
   private readonly bodyContainer;
   private contentRef;
   ngAfterViewInit(): void;
@@ -12784,10 +12787,14 @@ export declare const ROOT_NAV = "root";
  * the panel's header (see `visibleNavId`).
  */
 export declare const DEFAULT_NAV_SEGMENT = "default";
-/** NavId segment joiner. Flattens both `/` and `|` — see ADR 0014. */
+/** NavId segment joiner. Flattens both `/` and `~` — see ADR 0014. */
 export declare const NAV_ID_SEP = "_";
-/** Address separator for a Murl. */
-export declare const MURL_SEP = "|";
+/**
+ * Address separator for a Murl. URL-unreserved, so no encoder in the chain
+ * rewrites it and the address bar shows it as typed — `|` was, and every
+ * browser displayed it as `%7C` (ADR 0013).
+ */
+export declare const MURL_SEP = "~";
 /** Address separator for a Url. */
 export declare const URL_SEP = "/";
 /**
@@ -12997,6 +13004,11 @@ export declare class FrameComponent {
     navOpenedByUser: import("@angular/core").Signal<boolean>;
     menuNavId: import("@angular/core").Signal<string | undefined>;
     menuParams: import("@angular/core").Signal<Record<string, string | number> | undefined>;
+    browsedApp: import("@ngrx/signals").DeepSignal<{
+      name: string;
+      appNavId: string;
+      slot: "main" | "side";
+    }> | import("@angular/core").Signal<undefined>;
     keepPanelOnPathChange: import("@angular/core").Signal<boolean>;
     panelPushed: import("@angular/core").Signal<boolean>;
     navScrolledDown: import("@angular/core").Signal<boolean>;
@@ -13074,7 +13086,7 @@ export declare class FrameComponent {
     }) => void;
     setAppLink: (appLink: string | undefined, appNavId?: string) => void;
     registerMount: (mount: import("@magmonium/one").RemoteMount) => void;
-    unregisterMount: (name: string) => void;
+    unregisterMount: (name: string, navigate?: import("@magmonium/one").RemoteMount["navigate"]) => void;
     setMountRoute: (name: string, route: import("@magmonium/one").MountRoute | undefined) => void;
     mountOf: (navId: string) => import("@magmonium/one").RemoteMount | undefined;
     setWcConfig: (appLink: string, config: import("dist/libs/cli/src").WebComponentConfig) => void;
@@ -13086,6 +13098,7 @@ export declare class FrameComponent {
     registerWidgets: (appLink: string, entry: NavWidgetRegistryEntry) => void;
     back: () => void;
     browse: (navId: string, params?: Record<string, string | number>) => void;
+    browseApp: (appNavId: string) => void;
     resolveUrl: (url: string) => string;
     setNavScrolledDown: (value: boolean) => void;
     routePathFor: (navId: string) => string;
@@ -13112,6 +13125,11 @@ export declare class FrameComponent {
     navOpenedByUser: boolean;
     menuNavId: string | undefined;
     menuParams: Record<string, string | number> | undefined;
+    browsedApp: {
+      name: string;
+      appNavId: string;
+      slot: "main" | "side";
+    } | undefined;
     keepPanelOnPathChange: boolean;
     panelPushed: boolean;
     navScrolledDown: boolean;
@@ -13123,7 +13141,7 @@ export declare class FrameComponent {
   }>;
   protected readonly device: DeviceService;
   protected readonly isPreview: boolean;
-  protected readonly navPadding: import("@angular/core").Signal<"0px" | "calc(5em + 400px)" | "5em">;
+  protected readonly navPadding: import("@angular/core").Signal<"0px" | "calc(64px + 360px)" | "64px">;
   static ɵfac: i0.ɵɵFactoryDeclaration<FrameComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FrameComponent, "m-frame", never, {}, {}, never, ["*"], true, never>;
 }
@@ -13311,6 +13329,16 @@ interface NavState {
    * `menuNavId` is set.
    */
   menuParams: Record<string, string | number> | undefined;
+  /**
+   * The app whose menu an App Rail AppLogo Browsed onto, and the slot it held
+   * then. That Browse belongs to the app: it survives an Address change that
+   * only moved the app to another slot (CONTEXT.md Browse).
+   */
+  browsedApp: {
+    name: string;
+    appNavId: string;
+    slot: AppSlot;
+  } | undefined;
   /**
    * Next path settle should keep `navOpenedByUser`. Used by the AppLogo when
    * the panel is already open — navigate home but leave the menu showing
@@ -13358,6 +13386,9 @@ declare const routeParamsOf: (root: ActivatedRouteSnapshot) => Record<string, st
  * Router built them in.
  */
 declare const visibilityKey: (navId: string, params: Record<string, string>) => string;
+/** The auxiliary segment names at the URL's root, the primary path aside. */
+/** Where an app on screen stands: the primary path, or its own auxiliary segment. */
+type AppSlot = 'main' | 'side';
 export declare const NavStore: import("@angular/core").Type<{
   path: Signal<string>;
   routeNavId: Signal<string | undefined>;
@@ -13379,6 +13410,11 @@ export declare const NavStore: import("@angular/core").Type<{
   navOpenedByUser: Signal<boolean>;
   menuNavId: Signal<string | undefined>;
   menuParams: Signal<Record<string, string | number> | undefined>;
+  browsedApp: import("@ngrx/signals").DeepSignal<{
+    name: string;
+    appNavId: string;
+    slot: AppSlot;
+  }> | Signal<undefined>;
   keepPanelOnPathChange: Signal<boolean>;
   panelPushed: Signal<boolean>;
   navScrolledDown: Signal<boolean>;
@@ -13456,7 +13492,7 @@ export declare const NavStore: import("@angular/core").Type<{
   }) => void;
   setAppLink: (appLink: string | undefined, appNavId?: string) => void;
   registerMount: (mount: RemoteMount) => void;
-  unregisterMount: (name: string) => void;
+  unregisterMount: (name: string, navigate?: RemoteMount["navigate"]) => void;
   setMountRoute: (name: string, route: MountRoute | undefined) => void;
   mountOf: (navId: string) => RemoteMount | undefined;
   setWcConfig: (appLink: string, config: WebComponentConfig$1) => void;
@@ -13468,6 +13504,7 @@ export declare const NavStore: import("@angular/core").Type<{
   registerWidgets: (appLink: string, entry: NavWidgetRegistryEntry) => void;
   back: () => void;
   browse: (navId: string, params?: Record<string, string | number>) => void;
+  browseApp: (appNavId: string) => void;
   resolveUrl: (url: string) => string;
   setNavScrolledDown: (value: boolean) => void;
   routePathFor: (navId: string) => string;
@@ -13494,6 +13531,11 @@ export declare const NavStore: import("@angular/core").Type<{
   navOpenedByUser: boolean;
   menuNavId: string | undefined;
   menuParams: Record<string, string | number> | undefined;
+  browsedApp: {
+    name: string;
+    appNavId: string;
+    slot: AppSlot;
+  } | undefined;
   keepPanelOnPathChange: boolean;
   panelPushed: boolean;
   navScrolledDown: boolean;
@@ -13565,6 +13607,13 @@ export declare const PLATFORM_ROOT_CHILDREN: string[];
  */
 export declare const PLATFORM_NAV_MAP: NavMap;
 export declare const isPlatformNavId: (navId: string) => boolean;
+/**
+ * A Platform Nav whose panel the library fills — search, notification, user
+ * and the user-settings leaves. Every Remote's widget map carries its own copy
+ * of these (`provideMagWcConfig`), so a mounted Remote is never asked for one:
+ * the host's chrome answers, whatever app is mounted.
+ */
+export declare const isPlatformPanelNavId: (navId: string) => boolean;
 /**
  * The two Platform Navs an app has a stake in — the only ones the editor lets
  * a User hang children under, and so the only ones worth asking an app about.
@@ -13596,17 +13645,18 @@ export declare const unfetchedPlatformNav: (navId: string) => Nav | undefined;
  * re-runs no guard, while still being a real location. See ADR 0013.
  *
  * It never appears in the address bar: this serializer writes it back out as
- * `|`, and reads it back in the same way.
+ * `~`, and reads it back in the same way.
  */
 export declare const MURL_PARAM = "__m";
 /**
- * Serializes the Murl part of an Address as `|` in the path while carrying it
+ * Serializes the Murl part of an Address as `~` in the path while carrying it
  * internally as a query param.
  *
- * `|` is not URL-unreserved — `encodeURI('/a|d')` yields `/a%7Cd` — so links
- * arrive in both forms and parsing accepts both. Serialization always emits the
- * literal `|`, and always keeps a leading `/`: a bare `|search` is a *relative*
- * URL that would resolve against the current directory.
+ * `~` is URL-unreserved, so the address bar shows it as written — the retired
+ * `|` was displayed as `%7C`. Parsing still accepts `|` and `%7C`, so older
+ * links keep working. Serialization always emits the literal `~`, and always
+ * keeps a leading `/`: a bare `~search` is a *relative* URL that would resolve
+ * against the current directory.
  */
 export declare class MurlUrlSerializer implements UrlSerializer {
   #private;
@@ -13659,8 +13709,8 @@ export declare const navIdToRoutePath: (navId: string, navMap: NavMap) => string
  *
  * A Murl opens *over* the page it was opened from, so the Anchor also holds
  * when we stand **below** the target's Url part: `root_search` is anchored at
- * `root`, and clicking it from `/a/b/c` must address `/a/b/c|search` rather
- * than collapsing the location to `/|search` — the panel is chrome over a
+ * `root`, and clicking it from `/a/b/c` must address `/a/b/c~search` rather
+ * than collapsing the location to `/~search` — the panel is chrome over a
  * place, not a place of its own (ADR 0013). Closing it then returns to the
  * page it covered instead of stranding the User on the landing route.
  *
@@ -13688,8 +13738,8 @@ declare const fillParams: (path: string, params?: Record<string, string | number
 declare const fillRoutePath: (navId: string, navMap: NavMap, params?: Record<string, string | number>) => string;
 /**
  * Splits a location into its route path and its Murl segments. Accepts the
- * percent-encoded form too, because `|` is not URL-unreserved and any encoder
- * in the chain will have turned it into `%7C` (ADR 0013).
+ * percent-encoded `%7E` too, and the retired `|` / `%7C` separator, so links
+ * shared before the switch to `~` still open their panel (ADR 0013).
  */
 export declare const parseAddress: (address: string) => {
   path: string;
@@ -13733,6 +13783,25 @@ export declare class NavComponent {
     alt: string;
     app: undefined;
   } | undefined>;
+  /**
+   * The App Rail below the AppLogo (CONTEXT.md App Rail): the Main Slot's App,
+   * standing where the apps button would, then each Side App. Selecting one
+   * opens the panel on that app's menu; the open panel rings whose menu it is.
+   */
+  protected appRail: import("@angular/core").Signal<{
+    key: string;
+    appNavId: string;
+    pending: boolean;
+    src: string | undefined;
+    remote: string | undefined;
+    alt: string;
+    active: boolean;
+  }[]>;
+  /**
+   * The host's AppLogo is rung while the panel shows no rail app's menu —
+   * only when the App Rail has apps to tell it apart from; plain nav stays bare.
+   */
+  protected logoActive: import("@angular/core").Signal<boolean>;
   protected isScrolledDown: import("@angular/core").Signal<boolean>;
   protected currentUser: import("@angular/core").Signal<import("@magmonium/one").AuthUser | null>;
   protected isVertical: import("@angular/core").Signal<boolean>;
@@ -13751,7 +13820,11 @@ export declare class NavComponent {
    * AppLogo in the left corner. Menu open → go to root and keep the panel so
    * the menu shows the route tree; menu closed → navigate to the home page.
    */
+  /** Replays the AppLogo tap pop; cleared on animationend so the next tap restarts it. */
+  protected readonly logoPop: import("@angular/core").WritableSignal<boolean>;
   onLogoClick: () => void;
+  /** An App Rail AppLogo: the panel opens on that app's menu, wherever it stands. */
+  onAppLogoClick: (appNavId: string) => void;
   static ɵfac: i0.ɵɵFactoryDeclaration<NavComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<NavComponent, "m-nav", never, {
     "isHost": {
@@ -13790,6 +13863,11 @@ export declare class NavDetailsComponent {
     navOpenedByUser: import("@angular/core").Signal<boolean>;
     menuNavId: import("@angular/core").Signal<string | undefined>;
     menuParams: import("@angular/core").Signal<Record<string, string | number> | undefined>;
+    browsedApp: import("@ngrx/signals").DeepSignal<{
+      name: string;
+      appNavId: string;
+      slot: "main" | "side";
+    }> | import("@angular/core").Signal<undefined>;
     keepPanelOnPathChange: import("@angular/core").Signal<boolean>;
     panelPushed: import("@angular/core").Signal<boolean>;
     navScrolledDown: import("@angular/core").Signal<boolean>;
@@ -13867,7 +13945,7 @@ export declare class NavDetailsComponent {
     }) => void;
     setAppLink: (appLink: string | undefined, appNavId?: string) => void;
     registerMount: (mount: import("@magmonium/one").RemoteMount) => void;
-    unregisterMount: (name: string) => void;
+    unregisterMount: (name: string, navigate?: import("@magmonium/one").RemoteMount["navigate"]) => void;
     setMountRoute: (name: string, route: import("@magmonium/one").MountRoute | undefined) => void;
     mountOf: (navId: string) => import("@magmonium/one").RemoteMount | undefined;
     setWcConfig: (appLink: string, config: import("dist/libs/cli/src").WebComponentConfig) => void;
@@ -13879,6 +13957,7 @@ export declare class NavDetailsComponent {
     registerWidgets: (appLink: string, entry: NavWidgetRegistryEntry) => void;
     back: () => void;
     browse: (navId: string, params?: Record<string, string | number>) => void;
+    browseApp: (appNavId: string) => void;
     resolveUrl: (url: string) => string;
     setNavScrolledDown: (value: boolean) => void;
     routePathFor: (navId: string) => string;
@@ -13905,6 +13984,11 @@ export declare class NavDetailsComponent {
     navOpenedByUser: boolean;
     menuNavId: string | undefined;
     menuParams: Record<string, string | number> | undefined;
+    browsedApp: {
+      name: string;
+      appNavId: string;
+      slot: "main" | "side";
+    } | undefined;
     keepPanelOnPathChange: boolean;
     panelPushed: boolean;
     navScrolledDown: boolean;
@@ -13994,6 +14078,7 @@ export declare class NavMenuComponent {
   }, {}, never, never, true, never>;
 }
 export declare class NavHeaderComponent {
+  #private;
   _navStore: {
     path: import("@angular/core").Signal<string>;
     routeNavId: import("@angular/core").Signal<string | undefined>;
@@ -14015,6 +14100,11 @@ export declare class NavHeaderComponent {
     navOpenedByUser: import("@angular/core").Signal<boolean>;
     menuNavId: import("@angular/core").Signal<string | undefined>;
     menuParams: import("@angular/core").Signal<Record<string, string | number> | undefined>;
+    browsedApp: import("@ngrx/signals").DeepSignal<{
+      name: string;
+      appNavId: string;
+      slot: "main" | "side";
+    }> | import("@angular/core").Signal<undefined>;
     keepPanelOnPathChange: import("@angular/core").Signal<boolean>;
     panelPushed: import("@angular/core").Signal<boolean>;
     navScrolledDown: import("@angular/core").Signal<boolean>;
@@ -14092,7 +14182,7 @@ export declare class NavHeaderComponent {
     }) => void;
     setAppLink: (appLink: string | undefined, appNavId?: string) => void;
     registerMount: (mount: import("@magmonium/one").RemoteMount) => void;
-    unregisterMount: (name: string) => void;
+    unregisterMount: (name: string, navigate?: import("@magmonium/one").RemoteMount["navigate"]) => void;
     setMountRoute: (name: string, route: import("@magmonium/one").MountRoute | undefined) => void;
     mountOf: (navId: string) => import("@magmonium/one").RemoteMount | undefined;
     setWcConfig: (appLink: string, config: import("dist/libs/cli/src").WebComponentConfig) => void;
@@ -14104,6 +14194,7 @@ export declare class NavHeaderComponent {
     registerWidgets: (appLink: string, entry: NavWidgetRegistryEntry) => void;
     back: () => void;
     browse: (navId: string, params?: Record<string, string | number>) => void;
+    browseApp: (appNavId: string) => void;
     resolveUrl: (url: string) => string;
     setNavScrolledDown: (value: boolean) => void;
     routePathFor: (navId: string) => string;
@@ -14130,6 +14221,11 @@ export declare class NavHeaderComponent {
     navOpenedByUser: boolean;
     menuNavId: string | undefined;
     menuParams: Record<string, string | number> | undefined;
+    browsedApp: {
+      name: string;
+      appNavId: string;
+      slot: "main" | "side";
+    } | undefined;
     keepPanelOnPathChange: boolean;
     panelPushed: boolean;
     navScrolledDown: boolean;
@@ -14160,30 +14256,15 @@ export declare class NavHeaderComponent {
   _isSearch: import("@angular/core").Signal<boolean>;
   _hasParent: import("@angular/core").Signal<boolean>;
   _trail: import("@angular/core").Signal<import("@magmonium/one").BreadcrumbTrail[] | null>;
+  _user: import("@angular/core").Signal<import("@magmonium/one").AuthUser | null>;
   _header: import("@angular/core").Signal<import("@magmonium/one").BreadcrumbTrail | null>;
   static ɵfac: i0.ɵɵFactoryDeclaration<NavHeaderComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<NavHeaderComponent, "m-nav-header", never, {}, {}, never, never, true, never>;
 }
-interface ResolvedUserTab {
-  tabId: string;
-  component?: Type<unknown>;
-  ceSelector?: string;
-  remote?: string;
-}
-export declare const USER_TAB_MAP: InjectionToken<Record<string, Type<unknown>>>;
-export declare const WIN_USER_TAB_HOOK = "__mag_register_user_tabs__";
-export declare const WIN_USER_TAB_KEY = "__mag_user_tabs__";
 export declare class UserNavComponent {
   #private;
-  protected readonly activeTabId: import("@angular/core").WritableSignal<string | undefined>;
   protected readonly currentUser: import("@angular/core").Signal<import("@magmonium/one").AuthUser | null>;
-  protected readonly onUserMenuAction: (item: MenuItem) => void;
-  protected readonly resolvedTabs: import("@angular/core").Signal<ResolvedUserTab[]>;
-  protected readonly showTabs: import("@angular/core").Signal<boolean>;
-  protected readonly activeTabEntry: import("@angular/core").Signal<ResolvedUserTab | undefined>;
-  private readonly tabButtonsResource;
-  protected tabGroupConfig: import("@angular/core").Signal<Partial<TabGroup>>;
-  protected readonly selectTab: (tab: Button) => void;
+  protected readonly onUserAction: (button: Button | undefined) => void;
   static ɵfac: i0.ɵɵFactoryDeclaration<UserNavComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<UserNavComponent, "m-user-nav", never, {}, {}, never, never, true, never>;
 }
@@ -14195,6 +14276,15 @@ export declare class UserNavComponent {
  * at `root_user` instead of going through here.
  */
 export declare function provideUserTabs(tabs: Record<string, Type<unknown>>): Provider[];
+interface ResolvedUserTab {
+  tabId: string;
+  component?: Type<unknown>;
+  ceSelector?: string;
+  remote?: string;
+}
+export declare const USER_TAB_MAP: InjectionToken<Record<string, Type<unknown>>>;
+export declare const WIN_USER_TAB_HOOK = "__mag_register_user_tabs__";
+export declare const WIN_USER_TAB_KEY = "__mag_user_tabs__";
 export interface TextNotification {
   text: string;
 }
@@ -14463,6 +14553,7 @@ export declare class NotificationWidgetComponent {
   protected activeTab: import("@angular/core").WritableSignal<string>;
   protected displayNotifications: import("@angular/core").Signal<Notification[]>;
   protected unreadCount: import("@angular/core").Signal<number>;
+  protected onFilter(button: Button | undefined): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<NotificationWidgetComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<NotificationWidgetComponent, "m-notification-widget", never, {}, {}, never, never, true, never>;
 }
@@ -15498,7 +15589,7 @@ export declare class AuthActivityPageComponent {
     showTerms: import("@angular/core").Signal<boolean | undefined>;
     signUp: import("@angular/core").Signal<boolean | undefined>;
     tokens: import("@angular/core").Signal<undefined> | import("@ngrx/signals").DeepSignal<import("@magmonium/one").Tokens>;
-    user: import("@ngrx/signals").DeepSignal<import("@magmonium/one").AuthUser> | import("@angular/core").Signal<undefined>;
+    user: import("@angular/core").Signal<undefined> | import("@ngrx/signals").DeepSignal<import("@magmonium/one").AuthUser>;
     wrongPassword: import("@angular/core").Signal<boolean | undefined>;
     deployToken: import("@angular/core").Signal<string | undefined>;
     hostUserTabs: Record<string, import("@angular/core").Type<unknown>>;
@@ -15678,7 +15769,7 @@ export declare const AuthStore: Type<{
   showTerms: import("@angular/core").Signal<boolean | undefined>;
   signUp: import("@angular/core").Signal<boolean | undefined>;
   tokens: import("@angular/core").Signal<undefined> | import("@ngrx/signals").DeepSignal<Tokens>;
-  user: import("@ngrx/signals").DeepSignal<import("@magmonium/one").AuthUser> | import("@angular/core").Signal<undefined>;
+  user: import("@angular/core").Signal<undefined> | import("@ngrx/signals").DeepSignal<import("@magmonium/one").AuthUser>;
   wrongPassword: import("@angular/core").Signal<boolean | undefined>;
   deployToken: import("@angular/core").Signal<string | undefined>;
   hostUserTabs: Record<string, Type<unknown>>;

package/assets/menu/user_header.json

@@ -1,27 +0,0 @@
-{
-  "options": [
-    [
-      {
-        "id": "edit_profile",
-        "label": "edit-profile",
-        "icon": "user"
-      },
-      {
-        "id": "settings",
-        "label": "settings",
-        "icon": "gear"
-      }
-    ],
-    [
-      {
-        "id": "logout",
-        "label": "logout",
-        "icon": "lock"
-      }
-    ]
-  ],
-  "icon": {
-    "name": "ellipsis-vertical"
-  },
-  "width": "220px"
-}