@simplysm/angular 14.0.1 → 14.0.5

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

@@ -0,0 +1,446 @@
+import { computed, inject, Injectable } from "@angular/core";
+import type { Signal } from "@angular/core";
+
+export function usePermsSignal<K extends string>(viewCodes: string[], keys: K[]): Signal<K[]> {
+  const sdAppStructure = inject(SdAppStructureProvider);
+  return computed(() => sdAppStructure.getPermsByFullCode(viewCodes, keys));
+}
+
+// 권한은 모듈만 체크하고
+// 메뉴는 모듈/권한 모두 체크함
+@Injectable({ providedIn: "root" })
+export abstract class SdAppStructureProvider<TModule = unknown> {
+  abstract items: TSdAppStructureItem<TModule>[];
+  abstract usableModules: Signal<TModule[] | undefined>;
+  abstract permRecord: Signal<Record<string, boolean> | undefined>;
+
+  usableMenus = computed(() =>
+    SdAppStructureUtils.getMenus(this.items, [], this.usableModules(), this.permRecord()),
+  );
+  usableFlatMenus = computed<ISdFlatMenu<TModule>[]>(() =>
+    SdAppStructureUtils.getFlatMenus(this.items, this.usableModules(), this.permRecord()),
+  );
+
+  getPermissionsByStructure(items: TSdAppStructureItem<TModule>[], codeChain: string[] = []) {
+    return SdAppStructureUtils.getPermissions(items, codeChain, this.usableModules());
+  }
+
+  getTitleByFullCode(fullCode: string) {
+    return SdAppStructureUtils.getTitleByFullCode(this.items, fullCode);
+  }
+
+  getItemChainByFullCode(fullCode: string) {
+    return SdAppStructureUtils.getItemChainByFullCode(this.items, fullCode);
+  }
+
+  getPermsByFullCode<K extends string>(fullCodes: string[], permKeys: K[]): K[] {
+    return SdAppStructureUtils.getPermsByFullCode(
+      this.items,
+      fullCodes,
+      permKeys,
+      this.permRecord(),
+    );
+  }
+}
+
+export abstract class SdAppStructureUtils {
+  //---------- Info
+
+  static getTitleByFullCode<TModule>(items: TSdAppStructureItem<TModule>[], fullCode: string) {
+    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<TModule, K extends string>(
+    items: TSdAppStructureItem<TModule>[],
+    fullCodes: string[],
+    permKeys: K[],
+    permRecord: Record<string, boolean> | undefined,
+  ): 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 || !("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 cursor: TSdAppStructureItem<TModule> | undefined;
+    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<TModule>(
+    items: TSdAppStructureItem<TModule>[],
+    codeChain: string[],
+    usableModules: TModule[] | undefined,
+    permRecord: Record<string, boolean> | undefined,
+  ): ISdMenu<TModule>[] {
+    const resultMenus: ISdMenu<TModule>[] = [];
+
+    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<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))
+    );
+  }
+}
+
+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[][];
+}

package/src/core/providers/sd-file-dialog.provider.ts

@@ -0,0 +1,49 @@
+import { wait } from "@simplysm/core-common";
+import { Injectable } from "@angular/core";
+
+@Injectable({ providedIn: "root" })
+export class SdFileDialogProvider {
+  async showAsync(multiple?: false, accept?: string): Promise<File | undefined>;
+  async showAsync(multiple: true, accept?: string): Promise<File[] | undefined>;
+  async showAsync(multiple?: boolean, accept?: string): Promise<File[] | File | undefined> {
+    return new Promise<File[] | File | undefined>((resolve) => {
+      let inputEl: HTMLInputElement | undefined = document.createElement("input");
+
+      inputEl.type = "file";
+      inputEl.multiple = multiple ?? false;
+      if (accept !== undefined) {
+        inputEl.accept = accept;
+      }
+      inputEl.onchange = (event: Event): void => {
+        if (inputEl) {
+          document.body.removeChild(inputEl);
+          inputEl = undefined;
+        }
+
+        const files = (event.target as HTMLInputElement).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 (): Promise<void> => {
+          await wait.time(1000);
+          if (inputEl) {
+            document.body.removeChild(inputEl);
+            inputEl = undefined;
+          }
+
+          resolve(undefined);
+        };
+      });
+    });
+  }
+}

package/src/core/providers/sd-local-storage.provider.ts

@@ -0,0 +1,21 @@
+import { inject, Injectable } from "@angular/core";
+import { SdAngularConfigProvider } from "./sd-angular-config.provider";
+
+@Injectable({ providedIn: "root" })
+export class SdLocalStorageProvider<T> {
+  private readonly _sdNgConf = inject(SdAngularConfigProvider);
+
+  set<K extends keyof T & string>(key: K, value: T[K]) {
+    localStorage.setItem(`${this._sdNgConf.clientName}.${key}`, JSON.stringify(value));
+  }
+
+  get<K extends keyof T & string>(key: K): T[K] | undefined {
+    const json = localStorage.getItem(`${this._sdNgConf.clientName}.${key}`);
+    if (json == null) return undefined;
+    return JSON.parse(json);
+  }
+
+  remove(key: keyof T & string) {
+    localStorage.removeItem(`${this._sdNgConf.clientName}.${key}`);
+  }
+}

package/src/core/providers/sd-navigate-window.provider.ts

@@ -0,0 +1,44 @@
+import { Injectable } from "@angular/core";
+
+@Injectable({ providedIn: "root" })
+export class SdNavigateWindowProvider {
+  private _beforeUnloadController: AbortController | undefined;
+
+  get isWindow(): boolean {
+    const urlSearchParams = new URLSearchParams(
+      location.hash.slice(location.hash.indexOf(";") + 1),
+    );
+    return urlSearchParams.get("window") === "true";
+  }
+
+  open(navigate: string, params?: Record<string, string>, features?: string): void {
+    if (this.isWindow || (features != null && features !== "")) {
+      const newWindow = window.open(
+        `${location.pathname}#${navigate};${new URLSearchParams({ ...params, window: "true" }).toString()}`,
+        "",
+        features,
+      );
+
+      // 기존 beforeunload 리스너 제거
+      if (this._beforeUnloadController != null) {
+        this._beforeUnloadController.abort();
+      }
+      this._beforeUnloadController = new AbortController();
+
+      window.addEventListener(
+        "beforeunload",
+        () => {
+          if (newWindow) {
+            newWindow.close();
+          }
+        },
+        { signal: this._beforeUnloadController.signal },
+      );
+    } else {
+      window.open(
+        `${location.pathname}#${navigate};${new URLSearchParams(params).toString()}`,
+        "_blank",
+      );
+    }
+  }
+}