@sdcorejs/angular 19.0.0 → 20.0.0-rc.2

package/modules/authom/index.d.ts

@@ -1,35 +1,70 @@
-/**
- * Module `authom` — OAuth 2.0 + PKCE authentication client cho AuthOM (Auth0-based).
- *
- * Cách dùng (standalone):
- * ```ts
- * import { provideHttpClient, withInterceptors } from '@angular/common/http';
- * import { provideSdAuthOm, SdAuthOmInterceptor } from '@sdcorejs/angular/modules/authom';
- *
- * export const appConfig: ApplicationConfig = {
- *   providers: [
- *     provideHttpClient(withInterceptors([SdAuthOmInterceptor])),
- *     provideSdAuthOm({
- *       useFactory: () => ({
- *         loadTenantConfig: () => Promise.resolve({
- *           domain: 'login.example.com',
- *           clientId: 'YOUR_CLIENT_ID',
- *           audience: 'https://api.example.com',
- *           organization: 'org_xxx',
- *           scope: 'openid profile email offline_access',
- *           secureRoutes: ['https://api.example.com/*'],
- *         }),
- *       }),
- *     }),
- *   ],
- * };
- * ```
- *
- * Yêu cầu setup thêm:
- * 1. Copy file `silent-authom.html` từ source module này vào thư mục `public/` của app.
- * 2. App phải chạy trên HTTPS (hoặc localhost) — Web Crypto API yêu cầu secure context.
- */
-export * from './authom.configuration';
-export * from './authom.service';
-export * from './authom.interceptor';
-export * from './authom.module';
+import * as i0 from '@angular/core';
+import { InjectionToken, Type, ModuleWithProviders, EnvironmentProviders } from '@angular/core';
+import { HttpInterceptorFn } from '@angular/common/http';
+
+interface SdAuthOmTenantConfig {
+    domain: string;
+    clientId: string;
+    redirectUri?: string;
+    audience?: string;
+    organization?: string;
+    scope?: string;
+    secureRoutes?: string[];
+    silentRefreshRedirectUri?: string;
+    refreshThresholdSeconds?: number;
+    authorizeTimeoutInSeconds?: number;
+}
+interface ISdAuthOmConfiguration {
+    loadTenantConfig: () => Promise<SdAuthOmTenantConfig>;
+}
+declare const SD_AUTHOM_CONFIGURATION: InjectionToken<ISdAuthOmConfiguration>;
+
+declare class SdAuthOmService {
+    private readonly platformId;
+    private readonly isBrowser;
+    readonly accessToken: i0.WritableSignal<string | null>;
+    readonly idTokenClaims: i0.WritableSignal<Record<string, unknown> | null>;
+    readonly isAuthenticated: i0.Signal<boolean>;
+    config: SdAuthOmTenantConfig;
+    private refreshTimer;
+    getAccessToken(): string | null;
+    private base64UrlEncode;
+    private generateCodeVerifier;
+    private generateCodeChallenge;
+    private buildAuthorizeUrl;
+    private getDefaultRedirectUri;
+    private getSilentRedirectUri;
+    private decodeJwtPayload;
+    login(options?: {
+        returnTo?: string;
+    }): Promise<void>;
+    logout(options?: {
+        returnTo?: string;
+    }): void;
+    private exchangeCode;
+    private scheduleRefresh;
+    silentRefresh(): Promise<boolean>;
+    handleCallback(): Promise<boolean>;
+    init(config: SdAuthOmTenantConfig): Promise<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdAuthOmService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdAuthOmService>;
+}
+
+declare const matchGlob: (pattern: string, url: string) => boolean;
+declare const SdAuthOmInterceptor: HttpInterceptorFn;
+
+interface ProvideOptions {
+    useClass?: Type<ISdAuthOmConfiguration>;
+    useFactory?: (...args: any[]) => ISdAuthOmConfiguration;
+    deps?: any[];
+}
+declare function provideSdAuthOm(options: ProvideOptions): EnvironmentProviders;
+declare class SdAuthOmModule {
+    static forRoot(options: ProvideOptions): ModuleWithProviders<SdAuthOmModule>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdAuthOmModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SdAuthOmModule, never, never, never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<SdAuthOmModule>;
+}
+
+export { SD_AUTHOM_CONFIGURATION, SdAuthOmInterceptor, SdAuthOmModule, SdAuthOmService, matchGlob, provideSdAuthOm };
+export type { ISdAuthOmConfiguration, SdAuthOmTenantConfig };

package/modules/keycloak/index.d.ts

@@ -1,4 +1,48 @@
-export * from './keycloak.configuration';
-export * from './keycloak.service';
-export * from './keycloak.interceptor';
-export * from './keycloak.module';
+import * as i0 from '@angular/core';
+import { InjectionToken, Type, ModuleWithProviders, EnvironmentProviders } from '@angular/core';
+import Keycloak from 'keycloak-js';
+import { HttpInterceptorFn } from '@angular/common/http';
+
+interface SdKeycloakTenantConfig {
+    url: string;
+    realm: string;
+    clientId: string;
+    secureRoutes?: string[];
+}
+interface ISdKeycloakConfiguration {
+    loadTenantConfig: () => Promise<SdKeycloakTenantConfig>;
+}
+declare const SD_KEYCLOAK_CONFIGURATION: InjectionToken<ISdKeycloakConfiguration>;
+
+declare class SdKeycloakService {
+    keycloak: Keycloak;
+    config: SdKeycloakTenantConfig;
+    init(config: SdKeycloakTenantConfig): Promise<boolean>;
+    login(): Promise<void>;
+    logout(): Promise<void>;
+    getToken(): string | undefined;
+    getIsAuthenticated(): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdKeycloakService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdKeycloakService>;
+}
+
+declare const SdKeycloakInterceptor: HttpInterceptorFn;
+
+declare function provideSdKeycloak(options: {
+    useClass?: Type<ISdKeycloakConfiguration>;
+    useFactory?: (...args: any[]) => ISdKeycloakConfiguration;
+    deps?: any[];
+}): EnvironmentProviders;
+declare class SdKeycloakModule {
+    static forRoot(options: {
+        useClass?: Type<ISdKeycloakConfiguration>;
+        useFactory?: (...args: any[]) => ISdKeycloakConfiguration;
+        deps?: any[];
+    }): ModuleWithProviders<SdKeycloakModule>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdKeycloakModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SdKeycloakModule, never, never, never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<SdKeycloakModule>;
+}
+
+export { SD_KEYCLOAK_CONFIGURATION, SdKeycloakInterceptor, SdKeycloakModule, SdKeycloakService, provideSdKeycloak };
+export type { ISdKeycloakConfiguration, SdKeycloakTenantConfig };

package/modules/layout/index.d.ts

@@ -1,5 +1,223 @@
-export * from './modules';
-export * from './services';
-export * from './components';
-export * from './configurations';
-export * from './layout.module';
+import * as _angular_core from '@angular/core';
+import { InjectionToken } from '@angular/core';
+import * as i1$1 from '@angular/common';
+import * as i1 from '@angular/router';
+import { Params } from '@angular/router';
+import { SdStorage, SdStorageService } from '@sdcorejs/angular/services';
+import * as _sdcorejs_angular_modules_layout from '@sdcorejs/angular/modules/layout';
+import { MaybeAsync } from '@sdcorejs/utils/models';
+
+declare class HomeRoutingModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<HomeRoutingModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<HomeRoutingModule, never, [typeof i1.RouterModule], [typeof i1.RouterModule]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<HomeRoutingModule>;
+}
+
+declare class HomeModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<HomeModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<HomeModule, never, [typeof i1$1.CommonModule, typeof HomeRoutingModule], never>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<HomeModule>;
+}
+
+declare class NotFoundModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NotFoundModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<NotFoundModule, never, [typeof i1$1.CommonModule, typeof i1.RouterModule], never>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<NotFoundModule>;
+}
+
+declare class ForbiddenModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ForbiddenModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<ForbiddenModule, never, [typeof i1$1.CommonModule, typeof i1.RouterModule], never>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<ForbiddenModule>;
+}
+
+type SdLayoutMenu = SdLayoutRootMenu | SdLayoutChildrenMenu;
+type Menus = SdLayoutMenu[];
+interface SdLayoutRootMenu {
+    id?: string;
+    path: string;
+    queryParams?: Params;
+    icon?: string;
+    iconUrl?: string;
+    title: string;
+    permissionKey?: string;
+    permission: string | string[] | boolean | (() => boolean);
+    level?: number;
+    tooltipTitle?: string;
+}
+interface SdLayoutChildrenMenu {
+    id?: string;
+    icon?: string;
+    iconUrl?: string;
+    title?: string;
+    children?: (SdLayoutRootMenu | SdLayoutChildrenMenu)[];
+    level?: number;
+    tooltipTitle?: string;
+}
+
+declare class SdLayoutStorageService {
+    private sdStorageService;
+    isShowSidebar: SdStorage<boolean>;
+    menuLockStatus: SdStorage<boolean>;
+    lastActiveMenuGroupId: SdStorage<string>;
+    pinnedMenuGroup: SdStorage<SdLayoutChildrenMenu>;
+    constructor(sdStorageService: SdStorageService);
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutStorageService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdLayoutStorageService>;
+}
+
+interface ISdLayoutConfiguration {
+    homeUrl?: string;
+    sidebar: ISdSidebarConfiguration | (() => MaybeAsync<ISdSidebarConfiguration>);
+    userInfo: SdLayoutUserInfo | (() => MaybeAsync<SdLayoutUserInfo>);
+    signout: () => void | Promise<void>;
+    changePassword?: () => void | Promise<void>;
+}
+interface SdLayoutUserInfo {
+    /**
+     * Tên đăng nhập hoặc tên định danh của người dùng.
+     * Thường dùng làm định danh rút gọn hoặc fallback hiển thị nếu user chưa cập nhật fullName.
+     */
+    username?: string;
+    /**
+     * Địa chỉ thư điện tử của người dùng.
+     * Thường được hiển thị bên dưới tên người dùng trong popup/menu thông tin tài khoản.
+     */
+    email?: string;
+    /**
+     * Họ và tên đầy đủ của người dùng.
+     * Đây là thông tin được ưu tiên hiển thị chính trên giao diện (VD: góc phải màn hình, lời chào).
+     */
+    fullName?: string;
+    /**
+     * Hình đại diện (avatar) của người dùng.
+     * Nếu để trống, hệ thống sẽ tự động lấy ký tự đầu tiên của fullName hoặc username để tạo avatar mặc định.
+     * Hỗ trợ các định dạng: URL (http/https), chuỗi base64 (data:image), hoặc đường dẫn nội bộ.
+     */
+    avatar?: string;
+}
+type ISdSidebarConfiguration = SidebarConfigurationV1;
+interface SidebarConfigurationV1 {
+    version: 1;
+    /**
+     * Màu brand chính.
+     * Nên sử dụng mã màu #HEX hoặc rgb để hỗ trợ opacity khi hover.
+     * Ví dụ: #1890ff, rgb(24,144,255)
+     */
+    brandColor?: string;
+    /**
+     * Màu brand nhạt (light).
+     * Dùng cho background, hover nhẹ.
+     */
+    brandLightColor?: string;
+    /**
+     * URL logo hiển thị ở sidebar.
+     * Nên đặt trong thư mục public hoặc dùng URL CDN.
+     */
+    logoUrl?: string;
+    /**
+     * Title mặc định của hệ thống.
+     * Nếu menu không truyền title thì sẽ dùng giá trị này.
+     * @default "Back Office"
+     */
+    defaultTitle?: string;
+    /**
+     * Cấu hình tính năng ghim menu.
+     * - `enabled`: bật/tắt tính năng ghim.
+     * Hệ thống mặc định là false
+     */
+    pin?: {
+        enabled?: boolean;
+    };
+}
+declare const SD_LAYOUT_CONFIGURATION: InjectionToken<ISdLayoutConfiguration>;
+
+declare class SdLayoutService {
+    #private;
+    userInfo: _angular_core.WritableSignal<SdLayoutUserInfo | undefined>;
+    sidebar: _angular_core.WritableSignal<_sdcorejs_angular_modules_layout.SidebarConfigurationV1 | undefined>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdLayoutService>;
+}
+
+declare class SdPageComponent {
+    private el;
+    title: _angular_core.InputSignal<string>;
+    description: _angular_core.InputSignal<string>;
+    noHeader: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdPageComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdPageComponent, "sd-page", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "noHeader": { "alias": "noHeader"; "required": false; "isSignal": true; }; }, {}, never, ["[headerLeft]", "[headerRight]", "*"], true, never>;
+}
+
+declare class SdLayoutComponent {
+    #private;
+    menusInput: _angular_core.InputSignal<SdLayoutMenu[]>;
+    menus: _angular_core.Signal<SdLayoutMenu[]>;
+    userInfo: _angular_core.WritableSignal<_sdcorejs_angular_modules_layout.SdLayoutUserInfo | undefined>;
+    sidebar: _angular_core.WritableSignal<_sdcorejs_angular_modules_layout.SidebarConfigurationV1 | undefined>;
+    isMobileOrTablet: _angular_core.WritableSignal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdLayoutComponent, "sd-layout", never, { "menusInput": { "alias": "menus"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+declare class SidebarMobileV1Component {
+    #private;
+    menus: _angular_core.InputSignal<SdLayoutMenu[]>;
+    userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
+    sidebar: _angular_core.InputSignal<SidebarConfigurationV1>;
+    isShowSidebar: _angular_core.WritableSignal<boolean>;
+    titleMenuGroup: _angular_core.WritableSignal<string | undefined>;
+    constructor();
+    openSidebar: () => void;
+    onToggle: (_data: boolean | null) => void;
+    onPopupOfSideBarOpened: () => void;
+    onPopupOfSideBarClosed: () => void;
+    onExpandSideBar: () => void;
+    onMouseleaveSideBar: () => void;
+    onTitleMenuGroupChanged: (title: string | undefined) => void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarMobileV1Component, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidebarMobileV1Component, "sidebar-mobile-v1", never, { "menus": { "alias": "menus"; "required": false; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+declare class SidebarMobileOverlayComponent {
+    #private;
+    isShowSidebar: _angular_core.InputSignal<boolean>;
+    menus: _angular_core.InputSignal<SdLayoutMenu[]>;
+    userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
+    sidebar: _angular_core.InputSignal<SidebarConfigurationV1>;
+    showSideBar: _angular_core.OutputEmitterRef<boolean | null>;
+    expandSideBar: _angular_core.OutputEmitterRef<void>;
+    popupUserMenuOpened: _angular_core.OutputEmitterRef<void>;
+    popupUserMenuClosed: _angular_core.OutputEmitterRef<void>;
+    titleMenuGroupChanged: _angular_core.OutputEmitterRef<string | undefined>;
+    titleMenuGroup: _angular_core.WritableSignal<string | undefined>;
+    currentPath: _angular_core.WritableSignal<string>;
+    expandedMobileGroups: _angular_core.WritableSignal<Set<string>>;
+    constructor();
+    toggleMobileGroup(groupId: string | undefined): void;
+    isExpanded(groupId: string | undefined): boolean;
+    navigate(args: {
+        path?: string;
+        queryParams?: Params;
+    }): void;
+    onClose(): void;
+    hasChildren(menu: SdLayoutMenu): boolean;
+    getChildren(menu: SdLayoutMenu): SdLayoutMenu[];
+    getPath(menu: SdLayoutMenu): string | undefined;
+    getQueryParams(menu: SdLayoutMenu): Params;
+    onUserMenuOpened: () => void;
+    onUserMenuClosed: () => void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarMobileOverlayComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidebarMobileOverlayComponent, "sd-sidebar-mobile-overlay", never, { "isShowSidebar": { "alias": "isShowSidebar"; "required": false; "isSignal": true; }; "menus": { "alias": "menus"; "required": true; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": true; "isSignal": true; }; }, { "showSideBar": "showSideBar"; "expandSideBar": "expandSideBar"; "popupUserMenuOpened": "popupUserMenuOpened"; "popupUserMenuClosed": "popupUserMenuClosed"; "titleMenuGroupChanged": "titleMenuGroupChanged"; }, never, never, true, never>;
+}
+
+declare class SdLayoutModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<SdLayoutModule, never, [typeof i1.RouterModule], never>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<SdLayoutModule>;
+}
+
+export { ForbiddenModule, HomeModule, NotFoundModule, SD_LAYOUT_CONFIGURATION, SdLayoutComponent, SdLayoutModule, SdLayoutService, SdLayoutStorageService, SdPageComponent, SidebarMobileOverlayComponent, SidebarMobileV1Component };
+export type { ISdLayoutConfiguration, ISdSidebarConfiguration, Menus, SdLayoutChildrenMenu, SdLayoutMenu, SdLayoutRootMenu, SdLayoutUserInfo, SidebarConfigurationV1 };

package/modules/permission/index.d.ts

@@ -1,4 +1,101 @@
-export * from './src/configurations';
-export * from './src/services';
-export * from './src/directives';
-export * from './src/guards';
+import * as i0 from '@angular/core';
+import { InjectionToken } from '@angular/core';
+import { MaybeAsync } from '@sdcorejs/utils/models';
+import { CanActivate, CanActivateChild, ActivatedRouteSnapshot, RouterStateSnapshot } from '@angular/router';
+
+/**
+ * Cấu hình trung tâm cho module permission.
+ *
+ * Luồng hoạt động chính:
+ * 1. `loadPermissions(key?)` ở service được gọi để lấy danh sách mã quyền theo từng `key` cấu hình.
+ * 2. Guard/service đối chiếu mã quyền theo route metadata.
+ * 3. Khi không đủ quyền, callback `onForbiden()` sẽ được gọi (nếu có).
+ *
+ * Lưu ý:
+ * - `SD_PERMISSION_CONFIGURATION` hỗ trợ cả cấu hình đơn và mảng cấu hình (`multi: true`).
+ * - Nếu cần tạm bỏ qua kiểm tra quyền (POC/UAT cục bộ), đặt `disabled = true`.
+ */
+interface ISdPermissionConfiguration {
+    /**
+     * Khóa định danh cấu hình.
+      * Dùng để phân biệt khi hệ thống mở rộng theo nhiều profile permission.
+      *
+      * Lưu ý: `undefined` cũng được xem là một key hợp lệ (cấu hình mặc định).
+     */
+    key?: string;
+    /**
+     * Bật/tắt kiểm tra permission toàn cục.
+     * - `true`: bỏ qua kiểm tra quyền.
+     * - `false | undefined`: kiểm tra quyền theo cấu hình route.
+     */
+    disabled?: boolean;
+    /**
+     * Trả về danh sách mã quyền của user hiện tại.
+     * Có thể đồng bộ hoặc bất đồng bộ.
+     *
+     * Ví dụ giá trị trả về:
+     * - `['PRODUCT_C_EMPLOYEE_VIEW', 'PRODUCT_C_EMPLOYEE_UPDATE']`
+     */
+    loadPermissions: () => MaybeAsync<string[]>;
+    /**
+     * Callback xử lý khi user không có quyền truy cập URL hiện tại.
+     * Thường dùng để điều hướng sang trang forbidden hoặc hiển thị thông báo.
+     *
+     * Giữ nguyên tên `onForbiden` để tương thích API hiện tại.
+     */
+    onForbiden?: () => void;
+    /**
+     * Cung cấp access token hiện tại cho các tác vụ liên quan permission.
+     * Hỗ trợ trả về đồng bộ, Promise hoặc Observable.
+     */
+    getToken?: () => MaybeAsync<string | undefined | null>;
+}
+/**
+ * InjectionToken cho cấu hình permission.
+ *
+ * Ví dụ provider:
+ * {
+ *   provide: SD_PERMISSION_CONFIGURATION,
+ *   useValue: {
+ *     disabled: false,
+ *     loadPermissions: () => ['SAMPLE_C_EMPLOYEE_VIEW'],
+ *     onForbiden: () => router.navigateByUrl('/layout/forbidden')
+ *   }
+ * }
+ */
+declare const SD_PERMISSION_CONFIGURATION: InjectionToken<ISdPermissionConfiguration | ISdPermissionConfiguration[]>;
+
+declare class SdPermissionService {
+    #private;
+    constructor();
+    loadPermissions: (key?: string) => Promise<string[]>;
+    loadAllPermissions: () => Promise<void>;
+    hasPermission: (permission: string | string[], key?: string) => boolean;
+    getToken: (key?: string) => Promise<string | null | undefined>;
+    decodeToken: <T>(key?: string) => Promise<T | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdPermissionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdPermissionService>;
+}
+
+declare class SdPermissionDirective {
+    #private;
+    readonly sdPermission: i0.InputSignal<string | string[] | null | undefined>;
+    readonly sdPermissionKey: i0.InputSignal<string | undefined>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdPermissionDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SdPermissionDirective, "[sdPermission]", never, { "sdPermission": { "alias": "sdPermission"; "required": false; "isSignal": true; }; "sdPermissionKey": { "alias": "sdPermissionKey"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class SdPermissionGuard implements CanActivate, CanActivateChild {
+    #private;
+    private configuration;
+    private permissionService;
+    constructor(configuration: ISdPermissionConfiguration | ISdPermissionConfiguration[], permissionService: SdPermissionService);
+    canActivate: (next: ActivatedRouteSnapshot, state: RouterStateSnapshot) => Promise<boolean>;
+    canActivateChild: (activatedRoute: ActivatedRouteSnapshot, state: RouterStateSnapshot) => Promise<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdPermissionGuard, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdPermissionGuard>;
+}
+
+export { SD_PERMISSION_CONFIGURATION, SdPermissionDirective, SdPermissionGuard, SdPermissionService };
+export type { ISdPermissionConfiguration };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdcorejs/angular",
-  "version": "19.0.0",
+  "version": "20.0.0-rc.2",
   "peerDependencies": {
     "@angular/common": "^19.0.0 || ^20.0.0 || ^21.0.0",
     "@angular/core": "^19.0.0 || ^20.0.0 || ^21.0.0",
@@ -36,50 +36,6 @@
       "types": "./components/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components.mjs"
     },
-    "./configurations": {
-      "types": "./configurations/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-configurations.mjs"
-    },
-    "./directives": {
-      "types": "./directives/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-directives.mjs"
-    },
-    "./forms": {
-      "types": "./forms/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-forms.mjs"
-    },
-    "./handlers": {
-      "types": "./handlers/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-handlers.mjs"
-    },
-    "./i18n": {
-      "types": "./i18n/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-i18n.mjs"
-    },
-    "./interceptors": {
-      "types": "./interceptors/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-interceptors.mjs"
-    },
-    "./models": {
-      "types": "./models/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-models.mjs"
-    },
-    "./modules": {
-      "types": "./modules/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-modules.mjs"
-    },
-    "./pipes": {
-      "types": "./pipes/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-pipes.mjs"
-    },
-    "./services": {
-      "types": "./services/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-services.mjs"
-    },
-    "./utilities": {
-      "types": "./utilities/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-utilities.mjs"
-    },
     "./components/anchor": {
       "types": "./components/anchor/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-anchor.mjs"
@@ -204,6 +160,18 @@
       "types": "./components/view/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-view.mjs"
     },
+    "./configurations": {
+      "types": "./configurations/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-configurations.mjs"
+    },
+    "./directives": {
+      "types": "./directives/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-directives.mjs"
+    },
+    "./forms": {
+      "types": "./forms/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-forms.mjs"
+    },
     "./forms/autocomplete": {
       "types": "./forms/autocomplete/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-forms-autocomplete.mjs"
@@ -272,6 +240,26 @@
       "types": "./forms/textarea/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-forms-textarea.mjs"
     },
+    "./handlers": {
+      "types": "./handlers/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-handlers.mjs"
+    },
+    "./i18n": {
+      "types": "./i18n/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-i18n.mjs"
+    },
+    "./interceptors": {
+      "types": "./interceptors/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-interceptors.mjs"
+    },
+    "./models": {
+      "types": "./models/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-models.mjs"
+    },
+    "./modules": {
+      "types": "./modules/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-modules.mjs"
+    },
     "./modules/auth": {
       "types": "./modules/auth/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-modules-auth.mjs"
@@ -292,6 +280,14 @@
       "types": "./modules/permission/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-modules-permission.mjs"
     },
+    "./pipes": {
+      "types": "./pipes/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-pipes.mjs"
+    },
+    "./services": {
+      "types": "./services/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-services.mjs"
+    },
     "./services/api": {
       "types": "./services/api/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-api.mjs"
@@ -328,6 +324,10 @@
       "types": "./services/storage/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-storage.mjs"
     },
+    "./utilities": {
+      "types": "./utilities/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-utilities.mjs"
+    },
     "./utilities/data-state": {
       "types": "./utilities/data-state/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-utilities-data-state.mjs"