@simplysm/angular 14.0.1 → 14.0.4

package/dist/core/provideSdAngular.js

@@ -0,0 +1,127 @@
+import { DestroyRef, effect, EnvironmentInjector, ErrorHandler, inject, makeEnvironmentProviders, provideAppInitializer, provideEnvironmentInitializer, provideZonelessChangeDetection, } from "@angular/core";
+import { IMAGE_CONFIG } from "@angular/common";
+import { EVENT_MANAGER_PLUGINS } from "@angular/platform-browser";
+import { toSignal } from "@angular/core/rxjs-interop";
+import { NavigationCancel, NavigationEnd, NavigationError, NavigationStart, Router, } from "@angular/router";
+import { SwUpdate } from "@angular/service-worker";
+import { provideNgIconsConfig } from "@ng-icons/core";
+import { SdBusyProvider } from "../ui/overlay/busy/sd-busy.provider";
+import { SdAngularConfigProvider } from "./providers/sd-angular-config.provider";
+import { SdThemeProvider } from "./providers/sd-theme-provider";
+import { SdLocalStorageProvider } from "./providers/sd-local-storage.provider";
+import { SdGlobalErrorHandlerPlugin } from "./plugins/sd-global-error-handler.plugin";
+import { SdSaveCommandEventPlugin } from "./plugins/commands/sd-save-command-event.plugin";
+import { SdRefreshCommandEventPlugin } from "./plugins/commands/sd-refresh-command-event.plugin";
+import { SdInsertCommandEventPlugin } from "./plugins/commands/sd-insert-command-event.plugin";
+import { SdResizeEventPlugin } from "./plugins/events/sd-resize-event.plugin";
+import { SdIntersectionEventPlugin } from "./plugins/events/sd-intersection-event.plugin";
+import { SdOptionEventPlugin } from "./plugins/events/sd-option-event.plugin";
+export function provideSdAngular(opt) {
+    return makeEnvironmentProviders([
+        {
+            provide: IMAGE_CONFIG,
+            useValue: {
+                disableImageSizeWarning: true,
+                disableImageLazyLoadWarning: true,
+            },
+        },
+        provideNgIconsConfig({
+            strokeWidth: 1.5,
+            size: "1.33em",
+        }),
+        provideEnvironmentInitializer(() => {
+            const sdTheme = inject(SdThemeProvider);
+            const sdLocalStorage = inject(SdLocalStorageProvider);
+            const savedDark = sdLocalStorage.get("sd-theme-dark");
+            if (savedDark != null) {
+                sdTheme.dark.set(savedDark);
+            }
+            effect(() => {
+                sdLocalStorage.set("sd-theme-dark", sdTheme.dark());
+            });
+        }),
+        provideEnvironmentInitializer(() => {
+            const envInjector = inject(EnvironmentInjector);
+            const rejectionListener = (event) => {
+                event.preventDefault();
+                const errorHandler = envInjector.get(ErrorHandler);
+                errorHandler.handleError(event);
+            };
+            const errorListener = (event) => {
+                event.preventDefault();
+                const errorHandler = envInjector.get(ErrorHandler);
+                errorHandler.handleError(event);
+            };
+            window.addEventListener("unhandledrejection", rejectionListener);
+            window.addEventListener("error", errorListener);
+            inject(DestroyRef).onDestroy(() => {
+                window.removeEventListener("error", errorListener);
+                window.removeEventListener("unhandledrejection", rejectionListener);
+            });
+        }),
+        {
+            provide: SdAngularConfigProvider,
+            useFactory: () => {
+                const provider = new SdAngularConfigProvider();
+                provider.clientName = opt.clientName;
+                return provider;
+            },
+        },
+        { provide: EVENT_MANAGER_PLUGINS, useClass: SdSaveCommandEventPlugin, multi: true },
+        { provide: EVENT_MANAGER_PLUGINS, useClass: SdRefreshCommandEventPlugin, multi: true },
+        { provide: EVENT_MANAGER_PLUGINS, useClass: SdInsertCommandEventPlugin, multi: true },
+        { provide: EVENT_MANAGER_PLUGINS, useClass: SdResizeEventPlugin, multi: true },
+        { provide: EVENT_MANAGER_PLUGINS, useClass: SdIntersectionEventPlugin, multi: true },
+        { provide: EVENT_MANAGER_PLUGINS, useClass: SdOptionEventPlugin, multi: true },
+        { provide: ErrorHandler, useClass: SdGlobalErrorHandlerPlugin },
+        provideZonelessChangeDetection(),
+        provideAppInitializer(() => {
+            const swUpdate = inject(SwUpdate, { optional: true });
+            const destroyRef = inject(DestroyRef);
+            let timerId;
+            const updateFn = async () => {
+                try {
+                    if (swUpdate?.isEnabled) {
+                        if (await swUpdate.checkForUpdate()) {
+                            if (window.confirm("클라이언트가 업데이트되었습니다. 새로고침하시겠습니까?\n\n" +
+                                "  - 새로고침하지 않으면 몇몇 기능이 정상적으로 동작하지 않을 수 있습니다.")) {
+                                await swUpdate.activateUpdate();
+                                window.location.reload();
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // checkForUpdate 실패 시 무시하고 다음 폴링 주기에 재시도
+                }
+                finally {
+                    timerId = setTimeout(updateFn, 5 * 60 * 1000);
+                }
+            };
+            void updateFn();
+            destroyRef.onDestroy(() => {
+                if (timerId != null) {
+                    clearTimeout(timerId);
+                }
+            });
+        }),
+        provideAppInitializer(() => {
+            const router = inject(Router, { optional: true });
+            if (router == null)
+                return;
+            const sdBusy = inject(SdBusyProvider);
+            const navEvent = toSignal(router.events);
+            effect(() => {
+                const event = navEvent();
+                if (event instanceof NavigationStart) {
+                    sdBusy.globalBusyCount.update((v) => v + 1);
+                }
+                else if (event instanceof NavigationEnd ||
+                    event instanceof NavigationCancel ||
+                    event instanceof NavigationError) {
+                    sdBusy.globalBusyCount.update((v) => v - 1);
+                }
+            });
+        }),
+    ]);
+}

package/dist/core/providers/sd-angular-config.provider.d.ts

@@ -0,0 +1,7 @@
+import * as i0 from "@angular/core";
+export declare class SdAngularConfigProvider {
+    clientName: string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdAngularConfigProvider, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdAngularConfigProvider>;
+}
+//# sourceMappingURL=sd-angular-config.provider.d.ts.map

package/dist/core/providers/sd-angular-config.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-angular-config.provider.d.ts","sourceRoot":"","sources":["..\\..\\..\\src\\core\\providers\\sd-angular-config.provider.ts"],"names":[],"mappings":";AAEA,qBACa,uBAAuB;IAClC,UAAU,EAAG,MAAM,CAAC;yCADT,uBAAuB;6CAAvB,uBAAuB;CAEnC"}

package/dist/core/providers/sd-angular-config.provider.js

@@ -0,0 +1,11 @@
+import { Injectable } from "@angular/core";
+import * as i0 from "@angular/core";
+export class SdAngularConfigProvider {
+    clientName;
+    static ɵfac = function SdAngularConfigProvider_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || SdAngularConfigProvider)(); };
+    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: SdAngularConfigProvider, factory: SdAngularConfigProvider.ɵfac, providedIn: "root" });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(SdAngularConfigProvider, [{
+        type: Injectable,
+        args: [{ providedIn: "root" }]
+    }], null, null); })();

package/dist/core/providers/sd-app-structure.provider.d.ts

@@ -0,0 +1,79 @@
+import type { Signal } from "@angular/core";
+import * as i0 from "@angular/core";
+export declare function usePermsSignal<K extends string>(viewCodes: string[], keys: K[]): Signal<K[]>;
+export declare abstract class SdAppStructureProvider<TModule = unknown> {
+    abstract items: TSdAppStructureItem<TModule>[];
+    abstract usableModules: Signal<TModule[] | undefined>;
+    abstract permRecord: Signal<Record<string, boolean> | undefined>;
+    usableMenus: Signal<ISdMenu<TModule>[]>;
+    usableFlatMenus: Signal<ISdFlatMenu<TModule>[]>;
+    getPermissionsByStructure(items: TSdAppStructureItem<TModule>[], codeChain?: string[]): ISdPermission<TModule>[];
+    getTitleByFullCode(fullCode: string): string;
+    getItemChainByFullCode(fullCode: string): TSdAppStructureItem<TModule>[];
+    getPermsByFullCode<K extends string>(fullCodes: string[], permKeys: K[]): K[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdAppStructureProvider<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdAppStructureProvider<any>>;
+}
+export declare abstract class SdAppStructureUtils {
+    static getTitleByFullCode<TModule>(items: TSdAppStructureItem<TModule>[], fullCode: string): string;
+    static getPermsByFullCode<TModule, K extends string>(items: TSdAppStructureItem<TModule>[], fullCodes: string[], permKeys: K[], permRecord: Record<string, boolean> | undefined): K[];
+    static getItemChainByFullCode<TModule>(items: TSdAppStructureItem<TModule>[], fullCode: string): TSdAppStructureItem<TModule>[];
+    static getMenus<TModule>(items: TSdAppStructureItem<TModule>[], codeChain: string[], usableModules: TModule[] | undefined, permRecord: Record<string, boolean> | undefined): ISdMenu<TModule>[];
+    static getFlatMenus<TModule>(items: TSdAppStructureItem<TModule>[], usableModules: TModule[] | undefined, permRecord: Record<string, boolean> | undefined): ISdFlatMenu<TModule>[];
+    static getPermissions<TModule>(items: TSdAppStructureItem<TModule>[], codeChain: string[], usableModules: TModule[] | undefined): ISdPermission<TModule>[];
+    static getFlatPermissions<TModule>(items: TSdAppStructureItem<TModule>[], usableModules: TModule[] | undefined): ISdFlatPermission<TModule>[];
+    private static _isUsableModulesChain;
+    private static _isUsableModules;
+}
+export type TSdAppStructureItem<TModule = unknown> = ISdAppStructureGroupItem<TModule> | ISdAppStructureLeafItem<TModule>;
+interface ISdAppStructureGroupItem<TModule> {
+    code: string;
+    title: string;
+    modules?: TModule[];
+    requiredModules?: TModule[];
+    icon?: string;
+    children: TSdAppStructureItem<TModule>[];
+}
+interface ISdAppStructureLeafItem<TModule> {
+    code: string;
+    title: string;
+    modules?: TModule[];
+    requiredModules?: TModule[];
+    perms?: ("use" | "edit")[];
+    subPerms?: ISdAppStructureSubPermission<TModule>[];
+    icon?: string;
+    isNotMenu?: boolean;
+}
+interface ISdAppStructureSubPermission<TModule> {
+    code: string;
+    title: string;
+    modules?: TModule[];
+    requiredModules?: TModule[];
+    perms: ("use" | "edit")[];
+}
+export interface ISdMenu<TModule = unknown> {
+    title: string;
+    codeChain: string[];
+    icon: string | undefined;
+    modules: TModule[] | undefined;
+    children: ISdMenu<TModule>[] | undefined;
+}
+export interface ISdFlatMenu<TModule = unknown> {
+    titleChain: string[];
+    codeChain: string[];
+    modulesChain: TModule[][];
+}
+export interface ISdPermission<TModule = unknown> {
+    title: string;
+    codeChain: string[];
+    modules: TModule[] | undefined;
+    perms: ("use" | "edit")[] | undefined;
+    children: ISdPermission<TModule>[] | undefined;
+}
+export interface ISdFlatPermission<TModule = unknown> {
+    titleChain: string[];
+    codeChain: string[];
+    modulesChain: TModule[][];
+}
+export {};
+//# sourceMappingURL=sd-app-structure.provider.d.ts.map

package/dist/core/providers/sd-app-structure.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-app-structure.provider.d.ts","sourceRoot":"","sources":["..\\..\\..\\src\\core\\providers\\sd-app-structure.provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;;AAE5C,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAG5F;AAID,8BACsB,sBAAsB,CAAC,OAAO,GAAG,OAAO;IAC5D,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAAC;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;IAEjE,WAAW,6BAET;IACF,eAAe,iCAEb;IAEF,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,GAAE,MAAM,EAAO;IAIzF,kBAAkB,CAAC,QAAQ,EAAE,MAAM;IAInC,sBAAsB,CAAC,QAAQ,EAAE,MAAM;IAIvC,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;yCAxBzD,sBAAsB;6CAAtB,sBAAsB;CAgC3C;AAED,8BAAsB,mBAAmB;IAGvC,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM;IAU1F,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC,SAAS,MAAM,EACjD,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,EACrC,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,EAAE,CAAC,EAAE,EACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,CAAC,EAAE;IAqBN,MAAM,CAAC,sBAAsB,CAAC,OAAO,EACnC,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,EACrC,QAAQ,EAAE,MAAM,GACf,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAoBjC,MAAM,CAAC,QAAQ,CAAC,OAAO,EACrB,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,EACrC,SAAS,EAAE,MAAM,EAAE,EACnB,aAAa,EAAE,OAAO,EAAE,GAAG,SAAS,EACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,OAAO,CAAC,OAAO,CAAC,EAAE;IA6CrB,MAAM,CAAC,YAAY,CAAC,OAAO,EACzB,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,EACrC,aAAa,EAAE,OAAO,EAAE,GAAG,SAAS,EACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,WAAW,CAAC,OAAO,CAAC,EAAE;IA0DzB,MAAM,CAAC,cAAc,CAAC,OAAO,EAC3B,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,EACrC,SAAS,EAAE,MAAM,EAAE,EACnB,aAAa,EAAE,OAAO,EAAE,GAAG,SAAS,GACnC,aAAa,CAAC,OAAO,CAAC,EAAE;IAyC3B,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAC/B,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,EACrC,aAAa,EAAE,OAAO,EAAE,GAAG,SAAS;IAgFtC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAsBpC,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAiBhC;AAED,MAAM,MAAM,mBAAmB,CAAC,OAAO,GAAG,OAAO,IAC7C,wBAAwB,CAAC,OAAO,CAAC,GACjC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAErC,UAAU,wBAAwB,CAAC,OAAO;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;CAC1C;AAED,UAAU,uBAAuB,CAAC,OAAO;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,4BAA4B,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,4BAA4B,CAAC,OAAO;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,KAAK,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,OAAO,CAAC,OAAO,GAAG,OAAO;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,WAAW,CAAC,OAAO,GAAG,OAAO;IAC5C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,OAAO;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IAC/B,KAAK,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC;IACtC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,OAAO;IAClD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC;CAC3B"}

package/dist/core/providers/sd-app-structure.provider.js

@@ -0,0 +1,278 @@
+import { computed, inject, Injectable } from "@angular/core";
+import * as i0 from "@angular/core";
+export function usePermsSignal(viewCodes, keys) {
+    const sdAppStructure = inject(SdAppStructureProvider);
+    return computed(() => sdAppStructure.getPermsByFullCode(viewCodes, keys));
+}
+// 권한은 모듈만 체크하고
+// 메뉴는 모듈/권한 모두 체크함
+export class SdAppStructureProvider {
+    usableMenus = computed(() => SdAppStructureUtils.getMenus(this.items, [], this.usableModules(), this.permRecord()), ...(ngDevMode ? [{ debugName: "usableMenus" }] : /* istanbul ignore next */ []));
+    usableFlatMenus = computed(() => SdAppStructureUtils.getFlatMenus(this.items, this.usableModules(), this.permRecord()), ...(ngDevMode ? [{ debugName: "usableFlatMenus" }] : /* istanbul ignore next */ []));
+    getPermissionsByStructure(items, codeChain = []) {
+        return SdAppStructureUtils.getPermissions(items, codeChain, this.usableModules());
+    }
+    getTitleByFullCode(fullCode) {
+        return SdAppStructureUtils.getTitleByFullCode(this.items, fullCode);
+    }
+    getItemChainByFullCode(fullCode) {
+        return SdAppStructureUtils.getItemChainByFullCode(this.items, fullCode);
+    }
+    getPermsByFullCode(fullCodes, permKeys) {
+        return SdAppStructureUtils.getPermsByFullCode(this.items, fullCodes, permKeys, this.permRecord());
+    }
+    static ɵfac = function SdAppStructureProvider_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || SdAppStructureProvider)(); };
+    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: SdAppStructureProvider, factory: SdAppStructureProvider.ɵfac, providedIn: "root" });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(SdAppStructureProvider, [{
+        type: Injectable,
+        args: [{ providedIn: "root" }]
+    }], null, null); })();
+export class SdAppStructureUtils {
+    //---------- Info
+    static getTitleByFullCode(items, fullCode) {
+        const itemChain = this.getItemChainByFullCode(items, fullCode);
+        const parent = itemChain
+            .slice(0, -1)
+            .map((item) => item.title)
+            .join(" > ");
+        const current = itemChain.last().title;
+        return (parent ? `[${parent}] ` : "") + current;
+    }
+    static getPermsByFullCode(items, fullCodes, permKeys, permRecord) {
+        const result = [];
+        for (const permKey of permKeys) {
+            // 해당 권한이 설정되어있거나
+            if (fullCodes.some((fullCode) => permRecord?.[fullCode + "." + permKey])) {
+                result.push(permKey);
+            }
+            // 권한이라는것이 아얘 존재하지 않거나
+            else if (fullCodes.every((fullCode) => {
+                const item = this.getItemChainByFullCode(items, fullCode).last();
+                return !item || !("perms" in item);
+            })) {
+                result.push(permKey);
+            }
+        }
+        return result;
+    }
+    static getItemChainByFullCode(items, fullCode) {
+        const codeChain = fullCode.split(".");
+        const result = [];
+        let cursor;
+        let cursorChildren = items;
+        for (const currCode of codeChain) {
+            cursor = cursorChildren.single((item) => item.code === currCode);
+            cursorChildren = cursor != null && "children" in cursor ? cursor.children : [];
+            if (cursor) {
+                result.push(cursor);
+            }
+        }
+        return result;
+    }
+    //---------- Menus
+    static getMenus(items, codeChain, usableModules, permRecord) {
+        const resultMenus = [];
+        for (const item of items) {
+            if ("isNotMenu" in item && item.isNotMenu)
+                continue;
+            const currCodeChain = [...codeChain, item.code];
+            // 모듈 활성화 여부 확인
+            if (!this._isUsableModules(item.modules, item.requiredModules, usableModules))
+                continue;
+            // 그룹 메뉴
+            if ("children" in item) {
+                const children = this.getMenus(item.children, currCodeChain, usableModules, permRecord);
+                // 자식 중 표시 가능한 게 있으면 그룹 메뉴 포함
+                if (children.length > 0) {
+                    resultMenus.push({
+                        title: item.title,
+                        icon: item.icon,
+                        codeChain: currCodeChain,
+                        modules: item.modules,
+                        children,
+                    });
+                }
+            }
+            // Leaf 메뉴
+            else {
+                const code = currCodeChain.join(".");
+                if (item.perms != null && !permRecord?.[code + ".use"])
+                    continue;
+                resultMenus.push({
+                    title: item.title,
+                    icon: item.icon,
+                    codeChain: currCodeChain,
+                    modules: item.modules,
+                    children: undefined,
+                });
+            }
+        }
+        return resultMenus;
+    }
+    static getFlatMenus(items, usableModules, permRecord) {
+        const resultFlatMenus = [];
+        const queue = items.map((item) => ({
+            item,
+            titleChain: [],
+            codeChain: [],
+            modulesChain: [],
+            requiredModulesChain: [],
+        }));
+        while (queue.length > 0) {
+            const { item, titleChain, codeChain, modulesChain, requiredModulesChain } = queue.shift();
+            if ("isNotMenu" in item && item.isNotMenu)
+                continue;
+            const currTitleChain = [...titleChain, item.title];
+            const currCodeChain = [...codeChain, item.code];
+            const currModulesChain = item.modules ? [...modulesChain, item.modules] : modulesChain;
+            const currRequiredModulesChain = item.requiredModules
+                ? [...requiredModulesChain, item.requiredModules]
+                : requiredModulesChain;
+            if (!this._isUsableModulesChain(currModulesChain, currRequiredModulesChain, usableModules))
+                continue;
+            if ("children" in item) {
+                for (const child of item.children) {
+                    queue.push({
+                        item: child,
+                        titleChain: currTitleChain,
+                        codeChain: currCodeChain,
+                        modulesChain: currModulesChain,
+                        requiredModulesChain: currRequiredModulesChain,
+                    });
+                }
+            }
+            else if (item.perms == null || Boolean(permRecord?.[currCodeChain.join(".") + ".use"])) {
+                resultFlatMenus.push({
+                    titleChain: currTitleChain,
+                    codeChain: currCodeChain,
+                    modulesChain: currModulesChain,
+                });
+            }
+        }
+        return resultFlatMenus;
+    }
+    //---------- Perms
+    static getPermissions(items, codeChain, usableModules) {
+        const results = [];
+        for (const item of items) {
+            const currCodeChain = [...codeChain, item.code];
+            // 모듈 활성화 여부 확인
+            if (!this._isUsableModules(item.modules, item.requiredModules, usableModules))
+                continue;
+            // 그룹
+            if ("children" in item) {
+                const children = this.getPermissions(item.children, currCodeChain, usableModules);
+                results.push({
+                    title: item.title,
+                    codeChain: currCodeChain,
+                    modules: item.modules,
+                    perms: undefined,
+                    children: children,
+                });
+            }
+            // Leaf
+            else {
+                results.push({
+                    title: item.title,
+                    codeChain: currCodeChain,
+                    perms: item.perms,
+                    modules: item.modules,
+                    children: item.subPerms?.map((subPerm) => ({
+                        title: subPerm.title,
+                        codeChain: [...currCodeChain, subPerm.code],
+                        perms: subPerm.perms,
+                        modules: subPerm.modules,
+                        children: undefined,
+                    })),
+                });
+            }
+        }
+        return results;
+    }
+    static getFlatPermissions(items, usableModules) {
+        const results = [];
+        const queue = items.map((item) => ({
+            item,
+            titleChain: [],
+            codeChain: [],
+            modulesChain: [],
+            requiredModulesChain: [],
+        }));
+        while (queue.length > 0) {
+            const { item, titleChain, codeChain, modulesChain, requiredModulesChain } = queue.shift();
+            const currTitleChain = [...titleChain, item.title];
+            const currCodeChain = [...codeChain, item.code];
+            const currModulesChain = item.modules ? [...modulesChain, item.modules] : modulesChain;
+            const currRequiredModulesChain = item.requiredModules
+                ? [...requiredModulesChain, item.requiredModules]
+                : requiredModulesChain;
+            if (!this._isUsableModulesChain(currModulesChain, currRequiredModulesChain, usableModules))
+                continue;
+            // 1. 자식 enqueue
+            if ("children" in item) {
+                for (const child of item.children) {
+                    queue.push({
+                        item: child,
+                        titleChain: currTitleChain,
+                        codeChain: currCodeChain,
+                        modulesChain: currModulesChain,
+                        requiredModulesChain: currRequiredModulesChain,
+                    });
+                }
+            }
+            // 1. 직접 perms 처리
+            if ("perms" in item) {
+                for (const perm of item.perms ?? []) {
+                    results.push({
+                        titleChain: currTitleChain,
+                        codeChain: [...currCodeChain, perm],
+                        modulesChain: currModulesChain,
+                    });
+                }
+            }
+            // 2. subPerms 처리
+            if ("subPerms" in item) {
+                for (const subPerm of item.subPerms ?? []) {
+                    // subPerm도 모듈 체크
+                    if (!this._isUsableModules(subPerm.modules, subPerm.requiredModules, usableModules))
+                        continue;
+                    for (const perm of subPerm.perms) {
+                        results.push({
+                            titleChain: currTitleChain,
+                            codeChain: [...currCodeChain, subPerm.code, perm],
+                            modulesChain: [...currModulesChain, subPerm.modules ?? []],
+                        });
+                    }
+                }
+            }
+        }
+        return results;
+    }
+    //-- Modules (private)
+    static _isUsableModulesChain(modulesChain, requiredModulesChain, usableModules) {
+        // 각 레벨의 modules (OR) 체크
+        for (const modules of modulesChain) {
+            if (!this._isUsableModules(modules, undefined, usableModules)) {
+                return false;
+            }
+        }
+        // 각 레벨의 requiredModules (AND) 체크
+        for (const requiredModules of requiredModulesChain) {
+            if (!this._isUsableModules(undefined, requiredModules, usableModules)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    static _isUsableModules(modules, requiredModules, usableModules) {
+        // 1. requiredModules: 모두 있어야 함 (AND)
+        if (requiredModules && requiredModules.length > 0) {
+            if (!requiredModules.every((m) => usableModules?.includes(m))) {
+                return false;
+            }
+        }
+        // 2. modules: 하나라도 있으면 됨 (OR)
+        return (modules == null || modules.length === 0 || modules.some((m) => usableModules?.includes(m)));
+    }
+}

package/dist/core/providers/sd-file-dialog.provider.d.ts

@@ -0,0 +1,8 @@
+import * as i0 from "@angular/core";
+export declare class SdFileDialogProvider {
+    showAsync(multiple?: false, accept?: string): Promise<File | undefined>;
+    showAsync(multiple: true, accept?: string): Promise<File[] | undefined>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdFileDialogProvider, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdFileDialogProvider>;
+}
+//# sourceMappingURL=sd-file-dialog.provider.d.ts.map

package/dist/core/providers/sd-file-dialog.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-file-dialog.provider.d.ts","sourceRoot":"","sources":["..\\..\\..\\src\\core\\providers\\sd-file-dialog.provider.ts"],"names":[],"mappings":";AAGA,qBACa,oBAAoB;IACzB,SAAS,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IACvE,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC;yCAFlE,oBAAoB;6CAApB,oBAAoB;CA4ChC"}

package/dist/core/providers/sd-file-dialog.provider.js

@@ -0,0 +1,49 @@
+import { wait } from "@simplysm/core-common";
+import { Injectable } from "@angular/core";
+import * as i0 from "@angular/core";
+export class SdFileDialogProvider {
+    async showAsync(multiple, accept) {
+        return new Promise((resolve) => {
+            let inputEl = document.createElement("input");
+            inputEl.type = "file";
+            inputEl.multiple = multiple ?? false;
+            if (accept !== undefined) {
+                inputEl.accept = accept;
+            }
+            inputEl.onchange = (event) => {
+                if (inputEl) {
+                    document.body.removeChild(inputEl);
+                    inputEl = undefined;
+                }
+                const files = event.target.files;
+                resolve(multiple ? Array.from(files) : files[0]);
+            };
+            inputEl.style.opacity = "0";
+            inputEl.style.position = "fixed";
+            inputEl.style.top = "0";
+            inputEl.style.left = "0";
+            inputEl.style.pointerEvents = "none";
+            document.body.appendChild(inputEl);
+            inputEl.focus();
+            inputEl.click();
+            setTimeout(() => {
+                if (inputEl == null)
+                    return;
+                inputEl.onfocus = async () => {
+                    await wait.time(1000);
+                    if (inputEl) {
+                        document.body.removeChild(inputEl);
+                        inputEl = undefined;
+                    }
+                    resolve(undefined);
+                };
+            });
+        });
+    }
+    static ɵfac = function SdFileDialogProvider_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || SdFileDialogProvider)(); };
+    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: SdFileDialogProvider, factory: SdFileDialogProvider.ɵfac, providedIn: "root" });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(SdFileDialogProvider, [{
+        type: Injectable,
+        args: [{ providedIn: "root" }]
+    }], null, null); })();

package/dist/core/providers/sd-local-storage.provider.d.ts

@@ -0,0 +1,10 @@
+import * as i0 from "@angular/core";
+export declare class SdLocalStorageProvider<T> {
+    private readonly _sdNgConf;
+    set<K extends keyof T & string>(key: K, value: T[K]): void;
+    get<K extends keyof T & string>(key: K): T[K] | undefined;
+    remove(key: keyof T & string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdLocalStorageProvider<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdLocalStorageProvider<any>>;
+}
+//# sourceMappingURL=sd-local-storage.provider.d.ts.map

package/dist/core/providers/sd-local-storage.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-local-storage.provider.d.ts","sourceRoot":"","sources":["..\\..\\..\\src\\core\\providers\\sd-local-storage.provider.ts"],"names":[],"mappings":";AAGA,qBACa,sBAAsB,CAAC,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAE7D,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAInD,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;IAMzD,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM;yCAbjB,sBAAsB;6CAAtB,sBAAsB;CAgBlC"}

package/dist/core/providers/sd-local-storage.provider.js

@@ -0,0 +1,24 @@
+import { inject, Injectable } from "@angular/core";
+import { SdAngularConfigProvider } from "./sd-angular-config.provider";
+import * as i0 from "@angular/core";
+export class SdLocalStorageProvider {
+    _sdNgConf = inject(SdAngularConfigProvider);
+    set(key, value) {
+        localStorage.setItem(`${this._sdNgConf.clientName}.${key}`, JSON.stringify(value));
+    }
+    get(key) {
+        const json = localStorage.getItem(`${this._sdNgConf.clientName}.${key}`);
+        if (json == null)
+            return undefined;
+        return JSON.parse(json);
+    }
+    remove(key) {
+        localStorage.removeItem(`${this._sdNgConf.clientName}.${key}`);
+    }
+    static ɵfac = function SdLocalStorageProvider_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || SdLocalStorageProvider)(); };
+    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: SdLocalStorageProvider, factory: SdLocalStorageProvider.ɵfac, providedIn: "root" });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(SdLocalStorageProvider, [{
+        type: Injectable,
+        args: [{ providedIn: "root" }]
+    }], null, null); })();

package/dist/core/providers/sd-navigate-window.provider.d.ts

@@ -0,0 +1,9 @@
+import * as i0 from "@angular/core";
+export declare class SdNavigateWindowProvider {
+    private _beforeUnloadController;
+    get isWindow(): boolean;
+    open(navigate: string, params?: Record<string, string>, features?: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdNavigateWindowProvider, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdNavigateWindowProvider>;
+}
+//# sourceMappingURL=sd-navigate-window.provider.d.ts.map

package/dist/core/providers/sd-navigate-window.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-navigate-window.provider.d.ts","sourceRoot":"","sources":["..\\..\\..\\src\\core\\providers\\sd-navigate-window.provider.ts"],"names":[],"mappings":";AAEA,qBACa,wBAAwB;IACnC,OAAO,CAAC,uBAAuB,CAA8B;IAE7D,IAAI,QAAQ,IAAI,OAAO,CAKtB;IAED,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;yCAVrE,wBAAwB;6CAAxB,wBAAwB;CAwCpC"}