@simplysm/angular 14.0.19 → 14.0.22

package/src/core/providers/sd-app-structure.utils.ts

@@ -0,0 +1,350 @@
+import type {
+  TSdAppStructureItem,
+  ISdMenu,
+  ISdFlatMenu,
+  ISdPermission,
+  ISdFlatPermission,
+} from "./sd-app-structure.types";
+
+export abstract class SdAppStructureUtils {
+  //---------- Info
+
+  static getTitleByFullCode<TModule>(items: TSdAppStructureItem<TModule>[], fullCode: string) {
+    const itemChain = this.getItemChainByFullCode(items, fullCode);
+    if (itemChain.length === 0) {
+      throw new Error(`Item not found for fullCode: ${fullCode}`);
+    }
+    const parent = itemChain
+      .slice(0, -1)
+      .map((item) => item.title)
+      .join(" > ");
+    const current = itemChain.last()!.title;
+    return (parent ? `[${parent}] ` : "") + current;
+  }
+
+  static getPermsByFullCode<TModule, K extends string>(
+    items: TSdAppStructureItem<TModule>[],
+    fullCodes: string[],
+    permKeys: K[],
+    permRecord: Record<string, boolean> | undefined,
+  ): K[] {
+    if (permRecord === undefined) return [] as K[];
+
+    const result = [] as K[];
+    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 != null && !("perms" in item);
+        })
+      ) {
+        result.push(permKey);
+      }
+    }
+
+    return result;
+  }
+
+  static getItemChainByFullCode<TModule>(
+    items: TSdAppStructureItem<TModule>[],
+    fullCode: string,
+  ): TSdAppStructureItem<TModule>[] {
+    const codeChain = fullCode.split(".");
+
+    const result: TSdAppStructureItem<TModule>[] = [];
+
+    let cursorChildren = items;
+    for (const currCode of codeChain) {
+      const cursor = cursorChildren.single((item) => item.code === currCode);
+      if (cursor == null) return [];
+      cursorChildren = "children" in cursor ? cursor.children : [];
+      result.push(cursor);
+    }
+
+    return result;
+  }
+
+  //---------- Menus
+
+  static getMenus<TModule>(
+    items: TSdAppStructureItem<TModule>[],
+    codeChain: string[],
+    usableModules: TModule[] | undefined,
+    permRecord: Record<string, boolean> | undefined,
+  ): ISdMenu[] {
+    const resultMenus: ISdMenu[] = [];
+
+    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,
+            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,
+          url: item.url,
+        });
+      }
+    }
+
+    return resultMenus;
+  }
+
+  static getFlatMenus<TModule>(
+    items: TSdAppStructureItem<TModule>[],
+    usableModules: TModule[] | undefined,
+    permRecord: Record<string, boolean> | undefined,
+  ): ISdFlatMenu<TModule>[] {
+    const resultFlatMenus: ISdFlatMenu<TModule>[] = [];
+
+    type QueueItem = {
+      item: TSdAppStructureItem<TModule>;
+      titleChain: string[];
+      codeChain: string[];
+      modulesChain: TModule[][];
+      requiredModulesChain: TModule[][];
+    };
+
+    const queue: QueueItem[] = 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<TModule>(
+    items: TSdAppStructureItem<TModule>[],
+    codeChain: string[],
+    usableModules: TModule[] | undefined,
+  ): ISdPermission<TModule>[] {
+    const results: ISdPermission<TModule>[] = [];
+    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<TModule>(
+    items: TSdAppStructureItem<TModule>[],
+    usableModules: TModule[] | undefined,
+  ) {
+    const results: ISdFlatPermission<TModule>[] = [];
+
+    type QueueItem = {
+      item: TSdAppStructureItem<TModule>;
+      titleChain: string[];
+      codeChain: string[];
+      modulesChain: TModule[][];
+      requiredModulesChain: TModule[][];
+    };
+
+    const queue: QueueItem[] = 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)
+
+  private static _isUsableModulesChain<TModule>(
+    modulesChain: TModule[][],
+    requiredModulesChain: TModule[][],
+    usableModules: TModule[] | undefined,
+  ) {
+    // 각 레벨의 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;
+  }
+
+  private static _isUsableModules<TModule>(
+    modules: TModule[] | undefined,
+    requiredModules: TModule[] | undefined,
+    usableModules: TModule[] | undefined,
+  ): boolean {
+    // 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/src/{ui/overlay/busy → core/providers}/sd-busy.provider.ts

@@ -8,7 +8,7 @@ import {
   signal,
   type ComponentRef,
 } from "@angular/core";
-import { SdBusyContainerControl } from "./sd-busy-container.control";
+import { SdBusyContainerControl } from "../../ui/overlay/busy/sd-busy-container.control";
 
 export type TSdBusyType = "spinner" | "bar" | "cube";
 

package/src/core/providers/sd-print.provider.ts

@@ -8,7 +8,7 @@ import {
   type Type,
 } from "@angular/core";
 import type { TDirectiveInputSignals, TWithOptional } from "../utils/TDirectiveInputSignals";
-import { SdBusyProvider } from "../../ui/overlay/busy/sd-busy.provider";
+import { SdBusyProvider } from "./sd-busy.provider";
 import { wait } from "@simplysm/core-common";
 import { jsPDF } from "jspdf";
 import * as htmlToImage from "html-to-image";

package/src/core/providers/sd-service-client-factory.provider.ts

@@ -2,7 +2,7 @@ import { DestroyRef, inject, Injectable, type WritableSignal } from "@angular/co
 import type { ServiceConnectionOptions, ServiceProgressState } from "@simplysm/service-client";
 import { createServiceClient, ServiceClient } from "@simplysm/service-client";
 import { SdAngularConfigProvider } from "./sd-angular-config.provider";
-import { SdToastProvider } from "../../ui/overlay/toast/sd-toast.provider";
+import { SdToastProvider } from "./sd-toast.provider";
 
 @Injectable({ providedIn: "root" })
 export class SdServiceClientFactoryProvider {

package/src/{ui/overlay/toast → core/providers}/sd-toast.provider.ts

@@ -13,10 +13,10 @@ import {
   type WritableSignal,
 } from "@angular/core";
 import { outputToObservable } from "@angular/core/rxjs-interop";
-import type { TDirectiveInputSignals } from "../../../core/utils/TDirectiveInputSignals";
-import { SdToastControl } from "./sd-toast.control";
-import { SdToastContainerControl } from "./sd-toast-container.control";
-import { SdSystemLogProvider } from "../../../core/providers/sd-system-log.provider";
+import type { TDirectiveInputSignals } from "../utils/TDirectiveInputSignals";
+import { SdToastControl } from "../../ui/overlay/toast/sd-toast.control";
+import { SdToastContainerControl } from "../../ui/overlay/toast/sd-toast-container.control";
+import { SdSystemLogProvider } from "./sd-system-log.provider";
 import "@simplysm/core-browser";
 
 export type TSdToastSeverity = "info" | "success" | "warning" | "danger";

package/src/core/types/select-modal-output-result.ts

@@ -0,0 +1,7 @@
+/**
+ * 모달 선택 결과
+ */
+export interface ISelectModalOutputResult<T> {
+  selectedItemKeys: any[];
+  selectedItems: T[];
+}

package/src/core/utils/setups/setupCanDeactivate.ts

@@ -1,6 +1,6 @@
 import { DestroyRef, ElementRef, inject, reflectComponentType } from "@angular/core";
 import { ActivatedRoute, type CanDeactivateFn } from "@angular/router";
-import { SdActivatedModalProvider } from "../../../ui/overlay/modal/sd-modal.provider";
+import { SdActivatedModalProvider } from "../../providers/sd-activated-modal.provider";
 
 export function setupCanDeactivate(fn: () => boolean): void {
   const activatedModal = inject(SdActivatedModalProvider, { optional: true });

package/src/core/utils/useViewTitleSignal.ts

@@ -1,5 +1,5 @@
 import { computed, inject, type Signal } from "@angular/core";
-import { SdActivatedModalProvider } from "../../ui/overlay/modal/sd-modal.provider";
+import { SdActivatedModalProvider } from "../providers/sd-activated-modal.provider";
 import { SdAppStructureProvider } from "../providers/sd-app-structure.provider";
 import { useFullPageCodeSignal } from "./useFullPageCodeSignal";
 import { useCurrentPageCodeSignal } from "./useCurrentPageCodeSignal";

package/src/core/utils/useViewTypeSignal.ts

@@ -1,6 +1,6 @@
 import { computed, inject, type Signal } from "@angular/core";
 import { ActivatedRoute } from "@angular/router";
-import { SdActivatedModalProvider } from "../../ui/overlay/modal/sd-modal.provider";
+import { SdActivatedModalProvider } from "../providers/sd-activated-modal.provider";
 import { useCurrentPageCodeSignal } from "./useCurrentPageCodeSignal";
 import { useFullPageCodeSignal } from "./useFullPageCodeSignal";
 

package/src/features/base/sd-base-container.control.ts

@@ -14,7 +14,7 @@ import { SdBusyContainerControl } from "../../ui/overlay/busy/sd-busy-container.
 import { SdTopbarContainerControl } from "../../ui/navigation/topbar/sd-topbar-container.control";
 import { SdTopbarControl } from "../../ui/navigation/topbar/sd-topbar.control";
 import { SdAppStructureProvider } from "../../core/providers/sd-app-structure.provider";
-import { SdActivatedModalProvider } from "../../ui/overlay/modal/sd-modal.provider";
+import { SdActivatedModalProvider } from "../../core/providers/sd-activated-modal.provider";
 import { useCurrentPageCodeSignal } from "../../core/utils/useCurrentPageCodeSignal";
 import { useFullPageCodeSignal } from "../../core/utils/useFullPageCodeSignal";
 import {

package/src/features/data-view/sd-data-detail.control.ts

@@ -25,7 +25,7 @@ import { SdButtonControl } from "../../ui/form/button/sd-button.control";
 import { SdAnchorControl } from "../../ui/form/button/sd-anchor.control";
 import { SdFormControl } from "../../ui/form/sd-form.control";
 import { type ISdModal } from "../../ui/overlay/modal/sd-modal.provider";
-import { SdToastProvider } from "../../ui/overlay/toast/sd-toast.provider";
+import { SdToastProvider } from "../../core/providers/sd-toast.provider";
 import { SdBaseContainerControl } from "../base/sd-base-container.control";
 import { NgIcon } from "@ng-icons/core";
 import {