@ardimedia/angular-portal-azure 0.3.25 → 0.3.28

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@ardimedia/angular-portal-azure",
-  "version": "0.3.25",
+  "version": "0.3.28",
   "peerDependencies": {
     "@angular/common": "^21.1.0",
-    "@angular/core": "^21.1.0"
+    "@angular/core": "^21.1.0",
+    "@angular/forms": "^21.1.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"

package/types/ardimedia-angular-portal-azure.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { WritableSignal, Type, EnvironmentProviders } from '@angular/core';
+import { WritableSignal, Type, EnvironmentProviders, InjectionToken, AfterContentInit, OnDestroy } from '@angular/core';
 import * as _ardimedia_angular_portal_azure from '@ardimedia/angular-portal-azure';
 
 /**
@@ -117,6 +117,7 @@ interface PortalLabels {
     settings: string;
     language: string;
     appearance: string;
+    unsavedChangesConfirm: string;
 }
 /** Language preset definition for the built-in language registry. */
 interface LanguagePreset {
@@ -186,6 +187,7 @@ interface BladeDataLifecycle<T> {
     onExecuted?: () => void;
     onExecuteError?: (ex: ApiException) => void;
     isFormValid?: () => boolean;
+    isDirty?: () => boolean;
 }
 /**
  * Extended blade definition for data-driven blades with CRUD operations.
@@ -374,10 +376,16 @@ declare function createPanorama(title: string): PanoramaDefinition;
 interface AvatarMenuItem {
     /** Display text */
     label: string;
-    /** Navigation URL */
+    /** Navigation URL. Used when {@link action} is not set; ignored otherwise (use '#'). */
     href: string;
     /** Optional icon CSS class, e.g. 'ti ti-settings' */
     icon?: string;
+    /**
+     * Optional click handler. When set, the item performs this action instead of navigating to
+     * {@link href} (e.g. open a blade). The dropdown closes and the default link navigation is
+     * prevented.
+     */
+    action?: () => void;
 }
 /**
  * Avatar menu definition for the user menu in the portal header.
@@ -510,6 +518,31 @@ declare class PortalService {
 declare class BladeService {
     private readonly portal;
     private readonly registry;
+    /**
+     * Unsaved-changes guard registry: blade path -> predicate returning true when the blade has
+     * unsaved edits. Populated by apa-blade-detail (from the projected NgForm). Consulted before a
+     * blade is closed/replaced or the page is left, so the user can confirm discarding changes.
+     * Message can be localised via PortalLabels.unsavedChangesConfirm; the navigation flow is
+     * synchronous, so a synchronous window.confirm is used.
+     */
+    private readonly dirtyChecks;
+    /** Optional override for the confirmation message (defaults to the de-CH label). */
+    unsavedChangesMessage: string;
+    constructor();
+    /** Register a blade's unsaved-changes predicate (called by apa-blade-detail). */
+    registerDirtyCheck(path: string, isDirty: () => boolean): void;
+    /** Remove a blade's unsaved-changes predicate (called when the detail is destroyed). */
+    unregisterDirtyCheck(path: string): void;
+    private isPathDirty;
+    private anyDirty;
+    /**
+     * Returns true if it's OK to proceed with removing the given blade paths: none of them is dirty,
+     * or the user confirmed discarding the changes. Shows one confirmation regardless of how many
+     * dirty blades are affected.
+     */
+    private mayDiscard;
+    /** Drop dirty-check entries for paths that are no longer open. */
+    private pruneDirtyChecks;
     /**
      * Set the first blade (e.g., when opening a top-level item from a tile).
      * Clears all existing blades, hides panorama, and adds the new blade.
@@ -540,14 +573,14 @@ declare class BladeService {
      *
      * Ported from AreaBlades.clearPath() in v0.2.346.
      */
-    clearPath(path: string): void;
+    clearPath(path: string): boolean;
     /**
      * Remove all blades AFTER a given path (keeps the blade itself).
      * Used for cascade close when a blade opens a child.
      *
      * Ported from AreaBlades.clearChild() in v0.2.346.
      */
-    clearChild(path: string): void;
+    clearChild(path: string): boolean;
     /**
      * Remove blades at and beyond a specific 1-based level.
      * Ported from AreaBlades.clearLevel() in v0.2.346.
@@ -646,6 +679,7 @@ declare class BladeRouterService {
     private readonly portal;
     private readonly registry;
     private readonly destroyRef;
+    private readonly config;
     private _syncingFromUrl;
     private _initialRestoreDone;
     constructor();
@@ -688,6 +722,12 @@ declare class BladeRouterService {
     private extractLegacyBladesParam;
     /** Handle legacy ?blades= URL by redirecting to new path format */
     private handleLegacyUrl;
+    /**
+     * Return the effective route prefix. If a prefix was configured via
+     * `provideBladeRouter({ prefix })`, use it (including empty string).
+     * Otherwise fall back to dynamically reading the first URL segment.
+     */
+    private getEffectivePrefix;
     static ɵfac: i0.ɵɵFactoryDeclaration<BladeRouterService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<BladeRouterService>;
 }
@@ -712,6 +752,19 @@ declare class BladeRouterService {
  */
 declare function providePortalAzure(config: PortalConfig): EnvironmentProviders;
 
+/** Configuration for `provideBladeRouter()`. */
+interface BladeRouterConfig {
+    /**
+     * Fixed URL prefix for blade path segments.
+     *
+     * - When omitted, the prefix is read dynamically from the first URL segment (default).
+     * - When set to a non-empty string (e.g. `'app'`), that string is used as the fixed prefix.
+     * - When set to `''` (empty string), blade paths are encoded directly at the URL root with no prefix.
+     */
+    prefix?: string;
+}
+/** @internal */
+declare const BLADE_ROUTER_CONFIG: InjectionToken<BladeRouterConfig>;
 /**
  * Enables opt-in URL synchronization for the blade stack.
  *
@@ -726,12 +779,15 @@ declare function providePortalAzure(config: PortalConfig): EnvironmentProviders;
  * };
  * ```
  *
- * When enabled, blade paths sync to the URL as a query parameter:
- *   `?blades=customers,customers/list,customers/1`
+ * Optionally pass a config to set a fixed route prefix:
+ * ```typescript
+ * provideBladeRouter({ prefix: 'app' })   // → /app/customers/list
+ * provideBladeRouter({ prefix: '' })       // → /customers/list (no prefix)
+ * ```
  *
  * Without this provider, blade navigation remains purely in-memory.
  */
-declare function provideBladeRouter(): EnvironmentProviders;
+declare function provideBladeRouter(config?: BladeRouterConfig): EnvironmentProviders;
 
 /**
  * Individual dashboard tile.
@@ -809,6 +865,11 @@ declare class PortalLayoutComponent {
         code: string;
         displayName: string;
     }[];
+    /**
+     * Handle an avatar dropdown item click. If the item defines an action (e.g. open a blade), run it
+     * and suppress the default link navigation; otherwise let the href navigate normally.
+     */
+    protected onAvatarItemClick(item: AvatarMenuItem, event: Event): void;
     constructor();
     protected toggleDarkMode(): void;
     protected switchLanguage(code: string): void;
@@ -878,15 +939,21 @@ declare class BladeComponent {
  *
  * Usage:
  * ```html
+ * <!-- Default: each component is wrapped in <apa-blade> -->
  * <apa-blade-host />
+ *
+ * <!-- No wrapper: components render directly (they manage their own blade chrome) -->
+ * <apa-blade-host [wrapBlade]="false" />
  * ```
  */
 declare class BladeHostComponent {
+    /** Whether to wrap each component in an `<apa-blade>` element. Default: true. */
+    readonly wrapBlade: i0.InputSignal<boolean>;
     protected readonly portal: PortalService;
     private readonly registry;
     getComponent(path: string): i0.Type<unknown> | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<BladeHostComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BladeHostComponent, "apa-blade-host", never, {}, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BladeHostComponent, "apa-blade-host", never, { "wrapBlade": { "alias": "wrapBlade"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -973,10 +1040,15 @@ declare class BladeGridComponent {
  * </apa-blade>
  * ```
  */
-declare class BladeDetailComponent {
+declare class BladeDetailComponent implements AfterContentInit, OnDestroy {
     readonly blade: i0.InputSignal<BladeDataDefinition<any>>;
+    private readonly bladeService;
+    /** The template-driven form projected into this detail, if any (auto-discovered). */
+    private readonly form;
+    ngAfterContentInit(): void;
+    ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BladeDetailComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BladeDetailComponent, "apa-blade-detail", never, { "blade": { "alias": "blade"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BladeDetailComponent, "apa-blade-detail", never, { "blade": { "alias": "blade"; "required": true; "isSignal": true; }; }, {}, ["form"], ["*"], true, never>;
 }
 /**
  * Create standard detail blade commands (new, save, delete, cancel).
@@ -1057,5 +1129,5 @@ declare class SidebarComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<SidebarComponent, "apa-sidebar", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "collapsedWidth": { "alias": "collapsedWidth"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { AvatarMenuComponent, BladeComponent, BladeDetailComponent, BladeGridComponent, BladeHostComponent, BladeNavComponent, BladeRegistry, BladeRouterService, BladeService, CommandBarComponent, DEFAULT_LABELS, LABELS_DE_CH, LABELS_DE_DE, LABELS_EN, LABELS_ES, LABELS_FR, LABELS_IT, LANGUAGE_PRESETS, NotificationPanelComponent, PanoramaComponent, PortalLayoutComponent, PortalService, SidebarComponent, TILE_DIMENSIONS, TileComponent, TileSize, clearStatusBar, createAvatarMenu, createBlade, createCommand, createDataBlade, createDetailCommands, createNavItem, createNotificationPanel, createPanorama, createTile, executeDeleteItem, executeLoadItem, executeLoadItems, executeSaveItem, filterItems, getUserDisplayName, layoutTiles, nextBladeUid, provideBladeRouter, providePortalAzure, registerLanguagePreset, statusBarError, statusBarInfo, statusBarSuccess };
-export type { AddBladeEventArgs, ApiException, AvatarMenuDefinition, AvatarMenuItem, BladeCommand, BladeDataDefinition, BladeDataLifecycle, BladeDefinition, BladeNavItem, BladeParameter, BladeRegistryEntry, LanguagePreset, NotificationDefinition, NotificationLifecycle, PanoramaDefinition, PortalConfig, PortalLabels, PositionedTile, StandardCommandKey, StatusBarState, StatusBarStyle, TileDefinition, UserAccount };
+export { AvatarMenuComponent, BLADE_ROUTER_CONFIG, BladeComponent, BladeDetailComponent, BladeGridComponent, BladeHostComponent, BladeNavComponent, BladeRegistry, BladeRouterService, BladeService, CommandBarComponent, DEFAULT_LABELS, LABELS_DE_CH, LABELS_DE_DE, LABELS_EN, LABELS_ES, LABELS_FR, LABELS_IT, LANGUAGE_PRESETS, NotificationPanelComponent, PanoramaComponent, PortalLayoutComponent, PortalService, SidebarComponent, TILE_DIMENSIONS, TileComponent, TileSize, clearStatusBar, createAvatarMenu, createBlade, createCommand, createDataBlade, createDetailCommands, createNavItem, createNotificationPanel, createPanorama, createTile, executeDeleteItem, executeLoadItem, executeLoadItems, executeSaveItem, filterItems, getUserDisplayName, layoutTiles, nextBladeUid, provideBladeRouter, providePortalAzure, registerLanguagePreset, statusBarError, statusBarInfo, statusBarSuccess };
+export type { AddBladeEventArgs, ApiException, AvatarMenuDefinition, AvatarMenuItem, BladeCommand, BladeDataDefinition, BladeDataLifecycle, BladeDefinition, BladeNavItem, BladeParameter, BladeRegistryEntry, BladeRouterConfig, LanguagePreset, NotificationDefinition, NotificationLifecycle, PanoramaDefinition, PortalConfig, PortalLabels, PositionedTile, StandardCommandKey, StatusBarState, StatusBarStyle, TileDefinition, UserAccount };