@flusys/ng-layout 1.0.0-beta → 1.0.0

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@flusys/ng-layout",
-  "version": "1.0.0-beta",
+  "version": "1.0.0",
   "description": "Layout components for FLUSYS Angular applications",
   "license": "MIT",
   "peerDependencies": {
-    "@angular/common": "^21.0.0",
-    "@angular/core": "^21.0.0",
-    "@angular/router": "^21.0.0",
-    "@flusys/ng-core": "^1.0.0-beta",
-    "@flusys/ng-shared": "^1.0.0-beta",
-    "@primeuix/themes": "^1.0.0",
-    "primeicons": "^7.0.0",
-    "primeng": "^21.0.0",
-    "tailwindcss": "^4.0.0",
-    "tailwindcss-primeui": "^0.6.0"
+    "@angular/common": ">=21.0.0",
+    "@angular/core": ">=21.0.0",
+    "@angular/router": ">=21.0.0",
+    "@flusys/ng-core": ">=1.0.0",
+    "@flusys/ng-shared": ">=1.0.0",
+    "@primeuix/themes": ">=1.0.0",
+    "primeicons": ">=7.0.0",
+    "primeng": ">=21.0.0",
+    "tailwindcss": ">=4.0.0",
+    "tailwindcss-primeui": ">=0.6.0"
   },
   "sideEffects": false,
   "module": "fesm2022/flusys-ng-layout.mjs",

package/types/flusys-ng-layout.d.ts

@@ -2,10 +2,19 @@ import * as _angular_core from '@angular/core';
 import { Signal, InjectionToken } from '@angular/core';
 import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
-import { IconTypeEnum, ILogicNode } from '@flusys/ng-shared';
+import { ILogicNode, IconTypeEnum } from '@flusys/ng-shared';
 import * as _flusys_ng_layout from '@flusys/ng-layout';
 import * as _primeuix_themes_types from '@primeuix/themes/types';
 
+declare class AppFooter {
+    private readonly layoutService;
+    readonly appName: string;
+    readonly authorName: string;
+    readonly authorUrl: string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppFooter, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppFooter, "app-footer", never, {}, {}, never, never, true, never>;
+}
+
 interface ILauncherApp {
     id: string;
     name: string;
@@ -82,59 +91,46 @@ interface MenuChangeEvent {
     key: string;
     routeEvent?: boolean;
 }
-/**
- * User profile information for display in layout
- */
 interface UserProfile {
     id: string;
     name: string;
     email: string;
     profilePictureUrl?: string | null;
 }
-/**
- * Company information for display in layout
- */
 interface CompanyProfile {
     id: string;
     name: string;
     slug: string;
     logoUrl?: string | null;
 }
-/**
- * Service managing layout configuration and state.
- * Provides signals for reactive layout updates.
- */
+/** Layout configuration and state management service */
 declare class LayoutService {
     private readonly document;
     private readonly platformId;
     private readonly isBrowser;
     private readonly persistence;
     private readonly appConfig;
-    private readonly defaultConfig;
-    private readonly initialConfig;
-    private readonly defaultState;
-    readonly layoutConfig: _angular_core.WritableSignal<LayoutConfig>;
-    readonly layoutState: _angular_core.WritableSignal<LayoutState>;
-    readonly transitionComplete: _angular_core.WritableSignal<boolean>;
-    readonly userProfile: _angular_core.WritableSignal<UserProfile | null>;
-    readonly companyProfile: _angular_core.WritableSignal<CompanyProfile | null>;
-    readonly appName: _angular_core.WritableSignal<string>;
-    readonly authorName: _angular_core.WritableSignal<string>;
-    readonly authorUrl: _angular_core.WritableSignal<string>;
-    private readonly _rawApps;
-    /**
-     * Filtered launcher apps based on user permissions.
-     * Automatically recomputes when raw apps or permissions change.
-     */
-    readonly apps: _angular_core.Signal<ILauncherApp[]>;
+    private readonly DEFAULT_CONFIG;
+    private readonly DEFAULT_STATE;
+    private readonly _layoutConfig;
+    private readonly _layoutState;
+    private readonly _transitionComplete;
+    readonly layoutConfig: _angular_core.Signal<LayoutConfig>;
+    readonly layoutState: _angular_core.Signal<LayoutState>;
+    readonly transitionComplete: _angular_core.Signal<boolean>;
+    private readonly _userProfile;
+    private readonly _companyProfile;
     private readonly _rawMenu;
+    private readonly _rawApps;
     private readonly permissionValidator;
-    /**
-     * Filtered menu items based on user permissions.
-     * Automatically recomputes when raw menu or permission checker changes.
-     * Role checker is optional - if not set, role-based permissions will be denied.
-     */
+    readonly userProfile: _angular_core.Signal<UserProfile | null>;
+    readonly companyProfile: _angular_core.Signal<CompanyProfile | null>;
+    readonly appName: string;
+    readonly authorName: string;
+    readonly authorUrl: string;
     readonly menu: _angular_core.Signal<IMenuItem[]>;
+    readonly apps: _angular_core.Signal<ILauncherApp[]>;
+    readonly hasApps: _angular_core.Signal<boolean>;
     readonly isSidebarActive: _angular_core.Signal<boolean | undefined>;
     readonly isDarkTheme: _angular_core.Signal<boolean | undefined>;
     readonly getPrimary: _angular_core.Signal<string | undefined>;
@@ -143,10 +139,9 @@ declare class LayoutService {
     readonly userName: _angular_core.Signal<string>;
     readonly userEmail: _angular_core.Signal<string>;
     readonly userProfilePictureUrl: _angular_core.Signal<string | null>;
-    readonly companyName: _angular_core.Signal<string>;
     readonly companyLogoUrl: _angular_core.Signal<string | null>;
     readonly isAuthenticated: _angular_core.Signal<boolean>;
-    readonly hasApps: _angular_core.Signal<boolean>;
+    readonly companyName: _angular_core.Signal<string>;
     private readonly configUpdate;
     private readonly overlayOpen;
     private readonly menuSource;
@@ -157,47 +152,21 @@ declare class LayoutService {
     readonly overlayOpen$: rxjs.Observable<void>;
     private initialized;
     constructor();
-    private handleDarkModeTransition;
-    private startViewTransition;
     toggleDarkMode(config?: LayoutConfig): void;
+    private handleDarkModeTransition;
     private onTransitionEnd;
     onMenuToggle(): void;
     isDesktop(): boolean;
     isMobile(): boolean;
-    onConfigUpdate(): void;
     onMenuStateChange(event: MenuChangeEvent): void;
     reset(): void;
-    /**
-     * Set the current user profile for display in layout.
-     * Called by auth integration to sync user data.
-     */
+    updateLayoutConfig(config: Partial<LayoutConfig>): void;
+    updateLayoutState(state: Partial<LayoutState>): void;
     setUserProfile(profile: UserProfile | null): void;
-    /**
-     * Set the current company profile for display in layout.
-     * Called by auth integration to sync company data.
-     */
     setCompanyProfile(profile: CompanyProfile | null): void;
-    /**
-     * Set the raw menu items (unfiltered).
-     * Menu will be automatically filtered based on permission checker.
-     * Called by app initialization to set menu from IAM or other source.
-     */
     setMenu(items: IMenuItem[]): void;
-    /**
-     * Clear menu and permission/role checkers.
-     * Called on logout.
-     */
     clearMenu(): void;
-    /**
-     * Set launcher apps for display in header.
-     * Apps will be automatically filtered based on user permissions.
-     * If empty after filtering, the app launcher button is hidden.
-     */
     setApps(apps: ILauncherApp[]): void;
-    /**
-     * Clear launcher apps.
-     * Called on logout.
-     */
     clearApps(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutService>;
@@ -277,22 +246,20 @@ declare type SurfacesType = {
 };
 declare class AppConfigurator {
     private readonly router;
-    private readonly primeng;
     readonly layoutService: LayoutService;
-    private readonly platformService;
-    presets: string[];
-    showMenuModeButton: _angular_core.WritableSignal<boolean>;
-    menuModeOptions: {
+    readonly presets: string[];
+    readonly showMenuModeButton: _angular_core.WritableSignal<boolean>;
+    readonly menuModeOptions: {
         label: string;
         value: string;
     }[];
-    ngOnInit(): void;
-    surfaces: SurfacesType[];
-    selectedPrimaryColor: _angular_core.Signal<string | undefined>;
-    selectedSurfaceColor: _angular_core.Signal<string | null | undefined>;
-    selectedPreset: _angular_core.Signal<string | undefined>;
-    menuMode: _angular_core.Signal<"static" | "overlay" | undefined>;
-    primaryColors: _angular_core.Signal<SurfacesType[]>;
+    constructor();
+    readonly surfaces: SurfacesType[];
+    readonly selectedPrimaryColor: _angular_core.Signal<string | undefined>;
+    readonly selectedSurfaceColor: _angular_core.Signal<string | null | undefined>;
+    readonly selectedPreset: _angular_core.Signal<string | undefined>;
+    readonly menuMode: _angular_core.Signal<"static" | "overlay" | undefined>;
+    readonly primaryColors: _angular_core.Signal<SurfacesType[]>;
     getPresetExt(): {
         semantic: {
             primary: {
@@ -341,54 +308,22 @@ declare class AppConfigurator {
             };
         };
     };
-    updateColors(event: any, type: string, color: any): void;
-    applyTheme(type: string, color: any): void;
-    onPresetChange(event: any): void;
+    updateColors(event: MouseEvent, type: string, color: SurfacesType): void;
+    applyTheme(type: string, color: SurfacesType): void;
+    onPresetChange(event: string): void;
     onMenuModeChange(event: 'static' | 'overlay'): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppConfigurator, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppConfigurator, "app-configurator", never, {}, {}, never, never, true, never>;
 }
 
 declare class AppFloatingConfigurator {
-    LayoutService: LayoutService;
-    isDarkTheme: _angular_core.Signal<boolean | undefined>;
+    private readonly layoutService;
+    readonly isDarkTheme: _angular_core.Signal<boolean | undefined>;
     toggleDarkMode(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppFloatingConfigurator, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppFloatingConfigurator, "app-floating-configurator", never, {}, {}, never, never, true, never>;
 }
 
-declare class AppFooter {
-    private readonly layoutService;
-    readonly appName: _angular_core.WritableSignal<string>;
-    readonly authorName: _angular_core.WritableSignal<string>;
-    readonly authorUrl: _angular_core.WritableSignal<string>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppFooter, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppFooter, "app-footer", never, {}, {}, never, never, true, never>;
-}
-
-type ActivePanel = 'config' | null;
-declare class AppTopbar {
-    private readonly appConfig;
-    private readonly document;
-    private readonly destroyRef;
-    readonly layoutService: LayoutService;
-    private readonly configContainer;
-    readonly activePanel: _angular_core.WritableSignal<ActivePanel>;
-    constructor();
-    readonly companyName: _angular_core.Signal<string>;
-    enableCompanyFeature: _angular_core.Signal<boolean>;
-    toggleDarkMode(): void;
-    togglePanel(panel: ActivePanel): void;
-    private handleOutsideClick;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppTopbar, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppTopbar, "app-topbar", never, {}, {}, never, never, true, never>;
-}
-
-declare class AppSidebar {
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppSidebar, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppSidebar, "app-sidebar", never, {}, {}, never, never, true, never>;
-}
-
 declare class AppLayout {
     private readonly destroyRef;
     private readonly document;
@@ -396,20 +331,18 @@ declare class AppLayout {
     private readonly renderer;
     private readonly router;
     private menuOutsideClickListener;
-    appSidebar: AppSidebar;
-    appTopBar: AppTopbar;
     constructor();
     isOutsideClicked(event: MouseEvent): boolean;
     hideMenu(): void;
     blockBodyScroll(): void;
     unblockBodyScroll(): void;
-    get containerClass(): {
+    readonly containerClass: _angular_core.Signal<{
         'layout-overlay': boolean;
         'layout-static': boolean;
         'layout-static-inactive': boolean | undefined;
         'layout-overlay-active': boolean | undefined;
         'layout-mobile-active': boolean | undefined;
-    };
+    }>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppLayout, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppLayout, "app-layout", never, {}, {}, never, never, true, never>;
 }
@@ -432,15 +365,36 @@ declare class AppMenu {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppMenu, "app-menu", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * View Transitions API type definitions
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/View_Transitions_API
+ */
+interface ViewTransition {
+    /** Promise fulfilled when the transition animation is complete */
+    finished: Promise<void>;
+    /** Promise fulfilled when the pseudo-element tree is ready */
+    ready: Promise<void>;
+    /** Promise fulfilled when the callback finishes */
+    updateCallbackDone: Promise<void>;
+    /** Skip the transition animation */
+    skipTransition(): void;
+}
+/**
+ * Extended Document interface with View Transitions API support.
+ * Uses the native Document type with startViewTransition which is now
+ * part of the standard TypeScript DOM library.
+ */
+type DocumentWithViewTransition = Document;
+
 declare class AppMenuitem {
     readonly item: _angular_core.InputSignal<IMenuItem>;
     readonly index: _angular_core.InputSignal<number>;
     readonly parentKey: _angular_core.InputSignal<string>;
     private readonly router;
     private readonly layoutService;
-    private readonly authState;
     private readonly destroyRef;
-    readonly active: _angular_core.WritableSignal<boolean>;
+    private readonly _active;
+    readonly active: _angular_core.Signal<boolean>;
     readonly key: _angular_core.Signal<string>;
     readonly routerLink: _angular_core.Signal<string[]>;
     readonly routerLinkActiveOptions: _angular_core.Signal<{
@@ -456,6 +410,29 @@ declare class AppMenuitem {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppMenuitem, "[app-menuitem]", never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; "index": { "alias": "index"; "required": true; "isSignal": true; }; "parentKey": { "alias": "parentKey"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+declare class AppSidebar {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppSidebar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppSidebar, "app-sidebar", never, {}, {}, never, never, true, never>;
+}
+
+type ActivePanel = 'config' | null;
+declare class AppTopbar {
+    private readonly appConfig;
+    private readonly document;
+    private readonly destroyRef;
+    readonly layoutService: LayoutService;
+    private readonly configContainer;
+    readonly activePanel: _angular_core.WritableSignal<ActivePanel>;
+    constructor();
+    readonly companyName: _angular_core.Signal<string>;
+    readonly enableCompanyFeature: _angular_core.Signal<boolean>;
+    toggleDarkMode(): void;
+    togglePanel(panel: ActivePanel): void;
+    private handleOutsideClick;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppTopbar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppTopbar, "app-topbar", never, {}, {}, never, never, true, never>;
+}
+
 /** Company/branch switcher displayed in top bar */
 declare class AppCompanyBranchSelector {
     private readonly destroyRef;
@@ -464,17 +441,25 @@ declare class AppCompanyBranchSelector {
     private readonly messageService;
     private readonly document;
     private readonly elementRef;
-    readonly isActive: _angular_core.WritableSignal<boolean>;
+    private readonly _isActive;
+    readonly isActive: _angular_core.Signal<boolean>;
     constructor();
     readonly currentCompanyName: _angular_core.Signal<string>;
     readonly currentBranchName: _angular_core.Signal<string | null>;
-    readonly companies: _angular_core.WritableSignal<ICompanyInfo[]>;
-    readonly branches: _angular_core.WritableSignal<IBranchInfo[]>;
-    readonly selectedCompanyId: _angular_core.WritableSignal<string | null>;
-    readonly selectedBranchId: _angular_core.WritableSignal<string | null>;
-    readonly isLoadingCompanies: _angular_core.WritableSignal<boolean>;
-    readonly isLoadingBranches: _angular_core.WritableSignal<boolean>;
-    readonly isSwitching: _angular_core.WritableSignal<boolean>;
+    private readonly _companies;
+    readonly companies: _angular_core.Signal<ICompanyInfo[]>;
+    private readonly _branches;
+    readonly branches: _angular_core.Signal<IBranchInfo[]>;
+    private readonly _selectedCompanyId;
+    readonly selectedCompanyId: _angular_core.Signal<string | null>;
+    private readonly _selectedBranchId;
+    readonly selectedBranchId: _angular_core.Signal<string | null>;
+    private readonly _isLoadingCompanies;
+    readonly isLoadingCompanies: _angular_core.Signal<boolean>;
+    private readonly _isLoadingBranches;
+    readonly isLoadingBranches: _angular_core.Signal<boolean>;
+    private readonly _isSwitching;
+    readonly isSwitching: _angular_core.Signal<boolean>;
     readonly canSwitch: _angular_core.Signal<boolean>;
     onPanelToggle(): void;
     private loadCompanies;
@@ -491,7 +476,8 @@ declare class AppLauncher {
     private readonly document;
     private readonly elementRef;
     readonly layoutService: LayoutService;
-    readonly isActive: _angular_core.WritableSignal<boolean>;
+    private readonly _isActive;
+    readonly isActive: _angular_core.Signal<boolean>;
     constructor();
     togglePanel(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppLauncher, never>;
@@ -502,15 +488,17 @@ declare class AppProfile {
     private readonly destroyRef;
     private readonly authState;
     private readonly authApi;
+    private readonly layoutService;
     private readonly messageService;
     private readonly document;
     private readonly elementRef;
-    readonly isActive: _angular_core.WritableSignal<boolean>;
+    private readonly _isActive;
+    readonly isActive: _angular_core.Signal<boolean>;
     constructor();
     togglePanel(): void;
-    userName: _angular_core.Signal<string>;
-    userEmail: _angular_core.Signal<string>;
-    profilePicture: _angular_core.Signal<string>;
+    readonly userName: _angular_core.Signal<string>;
+    readonly userEmail: _angular_core.Signal<string>;
+    readonly profilePicture: _angular_core.Signal<string>;
     logout(): void;
     copySignUpLink(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppProfile, never>;
@@ -538,9 +526,9 @@ declare function filterAppsByPermissions(apps: ILauncherApp[], permissionCodes:
  */
 declare function filterMenuByPermissions(items: IMenuItem[], permissionCode: string[]): IMenuItem[];
 
-declare const GreenTheme: _primeuix_themes_types.Preset;
-
 declare const NavyBlueTheme: _primeuix_themes_types.Preset;
 
+declare const GreenTheme: _primeuix_themes_types.Preset;
+
 export { AppCompanyBranchSelector, AppConfigurator, AppFloatingConfigurator, AppFooter, AppLauncher, AppLayout, AppMenu, AppMenuitem, AppProfile, AppSidebar, AppTopbar, GreenTheme, LAYOUT_AUTH_API, LAYOUT_AUTH_STATE, LayoutPersistenceService, LayoutService, NavyBlueTheme, filterAppsByPermissions, filterMenuByPermissions };
-export type { CompanyProfile, IBranchInfo, ICompanyInfo, ILauncherApp, ILayoutAuthApi, ILayoutAuthState, IMenuItem, IUserInfo, LayoutConfig, LayoutState, MenuChangeEvent, UserProfile };
+export type { CompanyProfile, DocumentWithViewTransition, IBranchInfo, ICompanyInfo, ILauncherApp, ILayoutAuthApi, ILayoutAuthState, IMenuItem, IUserInfo, LayoutConfig, LayoutState, MenuChangeEvent, UserProfile, ViewTransition };