sonamu 0.6.0 → 0.7.0

package/src/template/implementations/view_id_async_select.template.ts

@@ -1,5 +1,5 @@
-import { TemplateOptions } from "../../types/types";
-import { EntityManager, EntityNamesRecord } from "../../entity/entity-manager";
+import { EntityManager, type EntityNamesRecord } from "../../entity/entity-manager";
+import type { TemplateOptions } from "../../types/types";
 import { Template } from "../template";
 
 export class Template__view_id_async_select extends Template {
@@ -19,15 +19,11 @@ export class Template__view_id_async_select extends Template {
 
     const entity = EntityManager.get(entityId);
     if (!textField) {
-      const pickedProp = entity.props.find((prop) =>
-        ["name", "title"].includes(prop.name)
-      );
+      const pickedProp = entity.props.find((prop) => ["name", "title"].includes(prop.name));
       if (pickedProp) {
         textField = pickedProp.name;
       } else {
-        const candidateProp = entity.props.find(
-          (prop) => prop.type === "string"
-        );
+        const candidateProp = entity.props.find((prop) => prop.type === "string");
         if (candidateProp) {
           textField = candidateProp.name;
         } else {
@@ -44,16 +40,10 @@ import { DropdownProps, DropdownItemProps, DropdownOnSearchChangeData, Dropdown
 import { ${names.capital}SubsetKey, ${
         names.capital
       }SubsetMapping } from "src/services/sonamu.generated";
-import { ${names.capital}Service } from "src/services/${names.fs}/${
-        names.fs
-      }.service";
-import { ${names.capital}ListParams } from "src/services/${names.fs}/${
-        names.fs
-      }.types";
+import { ${names.capital}Service } from "src/services/${names.fs}/${names.fs}.service";
+import { ${names.capital}ListParams } from "src/services/${names.fs}/${names.fs}.types";
 
-export function ${names.capital}IdAsyncSelect<T extends ${
-        names.capital
-      }SubsetKey>(
+export function ${names.capital}IdAsyncSelect<T extends ${names.capital}SubsetKey>(
   { subset, baseListParams, textField, valueField, ...props }: DropdownProps & {
     subset: T;
     baseListParams?: ${names.capital}ListParams;
@@ -66,9 +56,7 @@ export function ${names.capital}IdAsyncSelect<T extends ${
     baseListParams ?? {},
   );
 
-  const { data, error } = ${names.capital}Service.use${
-    names.capitalPlural
-  }(subset, listParams);
+  const { data, error } = ${names.capital}Service.use${names.capitalPlural}(subset, listParams);
   const { rows: ${names.camelPlural}, total } = data ?? {};
 
   useEffect(() => {
@@ -77,9 +65,7 @@ export function ${names.capital}IdAsyncSelect<T extends ${
         return {
           key: ${names.camel}.id,
           value: ${names.camel}[valueField ?? 'id'] as string | number,
-          text: String(${names.camel}[textField${
-            textField ? ` ?? '${textField}'` : ""
-          }]),
+          text: String(${names.camel}[textField${textField ? ` ?? '${textField}'` : ""}]),
         };
       }),
     );

package/src/template/implementations/view_list.template.ts

@@ -1,13 +1,14 @@
+import assert from "assert";
 import inflection from "inflection";
-import * as _ from "lodash-es";
+import { flat, unique } from "radashi";
 import { z } from "zod";
-import { RenderingNode, TemplateKey, TemplateOptions } from "../../types/types";
-import { EntityManager, EntityNamesRecord } from "../../entity/entity-manager";
-import { getRelationPropFromColName, getEnumInfoFromColName } from "../helpers";
-import { RenderedTemplate } from "../template";
-import { Template } from "../template";
-import { zodTypeToRenderingNode, getZodTypeById } from "../zod-converter";
+import { EntityManager, type EntityNamesRecord } from "../../entity/entity-manager";
+import type { RenderingNode, TemplateKey, TemplateOptions } from "../../types/types";
 import { getColumnsNode } from "../entity-converter";
+import { getEnumInfoFromColName, getRelationPropFromColName } from "../helpers";
+import type { RenderedTemplate } from "../template";
+import { Template } from "../template";
+import { getZodTypeById, zodTypeToRenderingNode } from "../zod-converter";
 
 export class Template__view_list extends Template {
   constructor() {
@@ -21,12 +22,7 @@ export class Template__view_list extends Template {
     };
   }
 
-  wrapTc(
-    body: string,
-    key: string,
-    collapsing: boolean = true,
-    className: string = ""
-  ) {
+  wrapTc(body: string, key: string, collapsing: boolean = true, className: string = "") {
     return `<Table.Cell key="${key}"${collapsing ? " collapsing" : ""}${
       className ? ` className={\`${className}\`}` : ""
     }>${body}</Table.Cell>`;
@@ -37,7 +33,7 @@ export class Template__view_list extends Template {
     col: RenderingNode,
     names: EntityNamesRecord,
     parentObj: string = "row",
-    withoutName: boolean = false
+    withoutName: boolean = false,
   ): string {
     const colName = withoutName ? `${parentObj}` : `${parentObj}.${col.name}`;
 
@@ -46,16 +42,12 @@ export class Template__view_list extends Template {
       case "string-date":
       case "number-id":
         return `<>{${colName}}</>`;
-      case "number-fk_id":
-        const relPropFk = getRelationPropFromColName(
-          entityId,
-          col.name.replace("_id", "")
-        );
+      case "number-fk_id": {
+        const relPropFk = getRelationPropFromColName(entityId, col.name.replace("_id", ""));
         return `<>${relPropFk.with}#{${colName}}</>`;
+      }
       case "string-image":
-        return `<>{${
-          col.nullable ? `${colName} && ` : ""
-        }<img src={${colName}} />}</>`;
+        return `<>{${col.nullable ? `${colName} && ` : ""}<img src={${colName}} />}</>`;
       case "datetime":
         if (col.nullable) {
           return `<span className="text-tiny">{${colName} === null ? '-' : formatDateTime(${colName})}</span>`;
@@ -70,23 +62,18 @@ export class Template__view_list extends Template {
         }
       case "boolean":
         return `<>{${colName} ? <Label color='green' circular>O</Label> : <Label color='grey' circular>X</Label> }</>`;
-      case "enums":
+      case "enums": {
         const { id: enumId } = getEnumInfoFromColName(entityId, col.name);
-        return `<>{${
-          col.nullable ? `${colName} && ` : ""
-        }${enumId}Label[${colName}]}</>`;
+        return `<>{${col.nullable ? `${colName} && ` : ""}${enumId}Label[${colName}]}</>`;
+      }
       case "array-images":
-        return `<>{ ${colName}.map(r => ${
-          col.nullable ? `r && ` : ""
-        }<img src={r} />) }</>`;
+        return `<>{ ${colName}.map(r => ${col.nullable ? `r && ` : ""}<img src={r} />) }</>`;
       case "number-plain":
         return `<>{${col.nullable ? `${colName} && ` : ""}numF(${colName})}</>`;
       case "object":
         return `<>{/* object ${colName} */}</>`;
-      case "object-pick":
-        const pickedChild = col.children!.find(
-          (child) => child.name === col.config?.picked
-        );
+      case "object-pick": {
+        const pickedChild = col.children?.find((child) => child.name === col.config?.picked);
         if (!pickedChild) {
           throw new Error(`object-pick 선택 실패 (오브젝트: ${col.name})`);
         }
@@ -94,8 +81,9 @@ export class Template__view_list extends Template {
           entityId,
           pickedChild,
           names,
-          `${colName}${col.nullable ? "?" : ""}`
+          `${colName}${col.nullable ? "?" : ""}`,
         );
+      }
       case "array":
         return `<>{ /* array ${colName} */ }</>`;
       default:
@@ -106,49 +94,44 @@ export class Template__view_list extends Template {
   renderColumnImport(
     entityId: string,
     col: RenderingNode,
-    names: EntityNamesRecord
+    names: EntityNamesRecord,
   ): (string | null)[] {
     if (col.renderType === "enums") {
       const { id: enumId } = getEnumInfoFromColName(names.capital, col.name);
-      return [
-        `import { ${enumId}Label } from 'src/services/sonamu.generated';`,
-      ];
+      return [`import { ${enumId}Label } from 'src/services/sonamu.generated';`];
     } else if (col.renderType === "object") {
       try {
         const relProp = getRelationPropFromColName(entityId, col.name);
-        const result = col.children!.map((child) => {
+        const result = col.children?.map((child) => {
           entityId = relProp.with;
           names = EntityManager.getNamesFromId(relProp.with);
           return this.renderColumnImport(entityId, child, names);
         });
-        return _.flattenDeep(result);
+        return flat(result ?? []);
       } catch {
         return [null];
       }
     } else if (col.renderType === "array") {
-      return this.renderColumnImport(entityId, col.element!, names);
+      assert(col.element);
+      return this.renderColumnImport(entityId, col.element, names);
     }
 
     return [null];
   }
 
-  renderFilterImport(
-    entityId: string,
-    col: RenderingNode,
-    names: EntityNamesRecord
-  ) {
+  renderFilterImport(entityId: string, col: RenderingNode, names: EntityNamesRecord) {
     if (col.name === "search") {
       return `import { ${names.capital}SearchInput } from "src/components/${names.fs}/${names.capital}SearchInput";`;
     } else if (col.renderType === "enums") {
       if (col.name === "orderBy") {
-        const componentId = `${names.capital}${inflection.camelize(
-          col.name
-        )}Select`;
+        const componentId = `${names.capital}${inflection.camelize(col.name)}Select`;
         return `import { ${componentId} } from "src/components/${names.fs}/${componentId}";`;
       } else {
         try {
-          const { id, targetEntityNames: targetMDNames } =
-            getEnumInfoFromColName(entityId, col.name);
+          const { id, targetEntityNames: targetMDNames } = getEnumInfoFromColName(
+            entityId,
+            col.name,
+          );
           const componentId = `${id}Select`;
           return `import { ${componentId} } from "src/components/${targetMDNames.fs}/${componentId}";`;
         } catch {
@@ -157,10 +140,7 @@ export class Template__view_list extends Template {
       }
     } else if (col.renderType === "number-fk_id") {
       try {
-        const relProp = getRelationPropFromColName(
-          entityId,
-          col.name.replace("_id", "")
-        );
+        const relProp = getRelationPropFromColName(entityId, col.name.replace("_id", ""));
         const targetNames = EntityManager.getNamesFromId(relProp.with);
         const componentId = `${relProp.with}IdAsyncSelect`;
         return `import { ${componentId} } from "src/components/${targetNames.fs}/${componentId}";`;
@@ -168,9 +148,7 @@ export class Template__view_list extends Template {
         return "";
       }
     } else {
-      throw new Error(
-        `렌더 불가능한 필터 임포트 ${col.name} ${col.renderType}`
-      );
+      throw new Error(`렌더 불가능한 필터 임포트 ${col.name} ${col.renderType}`);
     }
   }
 
@@ -192,15 +170,10 @@ export class Template__view_list extends Template {
           return "";
         }
       }
-      return `<${componentId} {...register('${col.name}')} ${
-        isClearable ? "clearable" : ""
-      } />`;
+      return `<${componentId} {...register('${col.name}')} ${isClearable ? "clearable" : ""} />`;
     } else if (col.renderType === "number-fk_id") {
       try {
-        const relProp = getRelationPropFromColName(
-          entityId,
-          col.name.replace("_id", "")
-        );
+        const relProp = getRelationPropFromColName(entityId, col.name.replace("_id", ""));
         componentId = `${relProp.with}IdAsyncSelect`;
         return `<${componentId} {...register('${col.name}')} ${
           isClearable ? "clearable" : ""
@@ -209,9 +182,7 @@ export class Template__view_list extends Template {
         return "";
       }
     } else {
-      throw new Error(
-        `렌더 불가능한 필터 임포트 ${col.name} ${col.renderType}`
-      );
+      throw new Error(`렌더 불가능한 필터 임포트 ${col.name} ${col.renderType}`);
     }
   }
 
@@ -223,9 +194,7 @@ export class Template__view_list extends Template {
       orderBy: "id-desc",
       search: "title",
     };
-    const orderByZodType = columns.find(
-      (col) => col.name === "orderBy"
-    )?.zodType;
+    const orderByZodType = columns.find((col) => col.name === "orderBy")?.zodType;
     if (orderByZodType && orderByZodType instanceof z.ZodEnum) {
       def.orderBy = orderByZodType.options[0].toString();
     }
@@ -262,17 +231,16 @@ export class Template__view_list extends Template {
         (col) =>
           col.name !== "id" &&
           col.name !== "queryMode" &&
-          (["enums", "number-id"].includes(col.renderType) ||
-            col.name.endsWith("_id"))
+          (["enums", "number-id"].includes(col.renderType) || col.name.endsWith("_id")),
       )
       // orderBy가 가장 뒤로 오게 순서 조정
       .sort((a) => {
-        return a.name == "orderBy" ? 1 : -1;
+        return a.name === "orderBy" ? 1 : -1;
       });
 
     // 필터 컬럼을 프리 템플릿으로 설정
     const preTemplates: RenderedTemplate["preTemplates"] = [];
-    for (let col of filterColumns) {
+    for (const col of filterColumns) {
       let key: TemplateKey;
       let targetEntityId = entityId;
       let enumId: string | undefined;
@@ -285,10 +253,7 @@ export class Template__view_list extends Template {
         } else {
           key = "view_enums_select";
           try {
-            const { targetEntityNames, id } = getEnumInfoFromColName(
-              entityId,
-              col.name
-            );
+            const { targetEntityNames, id } = getEnumInfoFromColName(entityId, col.name);
             targetEntityId = targetEntityNames.capital;
             enumId = id;
           } catch {
@@ -298,10 +263,7 @@ export class Template__view_list extends Template {
       } else {
         key = "view_id_async_select";
         try {
-          const relProp = getRelationPropFromColName(
-            entityId,
-            col.name.replace("_id", "")
-          );
+          const relProp = getRelationPropFromColName(entityId, col.name.replace("_id", ""));
           targetEntityId = relProp.with;
         } catch {
           continue;
@@ -318,17 +280,18 @@ export class Template__view_list extends Template {
     }
 
     // 리스트 컬럼
-    const columnImports = _.uniq(
-      columnsNode
-        .children!.map((col) => {
+    assert(columnsNode.children);
+    const columnImports = unique(
+      columnsNode.children
+        .flatMap((col) => {
           return this.renderColumnImport(entityId, col, names);
         })
-        .flat()
-        .filter((col) => col !== null)
+        .filter((col) => col !== null),
     ).join("\n");
 
     // SearchInput
-    preTemplates!.push({
+    assert(preTemplates);
+    preTemplates.push({
       key: "view_search_input",
       options: {
         entityId,
@@ -360,12 +323,8 @@ import { DateTime } from "luxon";
 import { DelButton, EditButton, AppBreadcrumbs, AddButton, useSelection, useListParams, SonamuCol, numF, formatDate, formatDateTime } from '@sonamu-kit/react-sui';
 
 import { ${names.capital}SubsetA } from "src/services/sonamu.generated";
-import { ${names.capital}Service } from 'src/services/${names.fs}/${
-        names.fs
-      }.service';
-import { ${names.capital}ListParams } from 'src/services/${names.fs}/${
-        names.fs
-      }.types';
+import { ${names.capital}Service } from 'src/services/${names.fs}/${names.fs}.service';
+import { ${names.capital}ListParams } from 'src/services/${names.fs}/${names.fs}.types';
 ${columnImports}
 ${filterColumns
   .map((col) => {

package/src/template/implementations/view_list_columns.template.ts

@@ -1,5 +1,5 @@
-import { TemplateOptions } from "../../types/types";
-import { EntityManager, EntityNamesRecord } from "../../entity/entity-manager";
+import { EntityManager, type EntityNamesRecord } from "../../entity/entity-manager";
+import type { TemplateOptions } from "../../types/types";
 import { Template } from "../template";
 
 export class Template__view_list_columns extends Template {
@@ -15,11 +15,7 @@ export class Template__view_list_columns extends Template {
   }
 
   // 컬럼
-  render({
-    entityId,
-    columns,
-    columnImports,
-  }: TemplateOptions["view_list_columns"]) {
+  render({ entityId, columns, columnImports }: TemplateOptions["view_list_columns"]) {
     const names = EntityManager.getNamesFromId(entityId);
 
     return {
@@ -35,9 +31,7 @@ import {
 } from 'semantic-ui-react';
 import { DateTime } from "luxon";
 import { TFColumn } from "src/typeframe/iso-types";
-import { ${names.capital}SubsetA } from "src/services/${names.fs}/${
-        names.fs
-      }.generated";
+import { ${names.capital}SubsetA } from "src/services/${names.fs}/${names.fs}.generated";
 ${columnImports}
 
 const columns: { [key in Exclude<keyof ${

package/src/template/implementations/view_search_input.template.ts

@@ -1,5 +1,5 @@
-import { TemplateOptions } from "../../types/types";
-import { EntityManager, EntityNamesRecord } from "../../entity/entity-manager";
+import { EntityManager, type EntityNamesRecord } from "../../entity/entity-manager";
+import type { TemplateOptions } from "../../types/types";
 import { Template } from "../template";
 
 export class Template__view_search_input extends Template {

package/src/template/index.ts

@@ -1,4 +1,6 @@
-export * from "./template";
-export * from "./helpers";
 export * from "./entity-converter";
+export * from "./helpers";
+export * from "./template";
+export * from "./template-manager";
+export * from "./template-types";
 export * from "./zod-converter";

package/src/template/template-manager.ts

@@ -0,0 +1,166 @@
+import path from "path";
+import type { TemplateKey } from "../types/types";
+import { globAsync } from "../utils/async-utils";
+import { importMembers } from "../utils/esm-utils";
+import { Template } from "./template";
+
+class TemplateManagerClass {
+  private templates: Map<TemplateKey | string, Template> = new Map();
+  isAutoloaded: boolean = false;
+
+  // ================================
+  // 기본 메서드
+  // ================================
+
+  /**
+   * 빌트인 템플릿 로드 (implementations/*.template.js)
+   */
+  async autoload(): Promise<void> {
+    if (this.isAutoloaded) {
+      return;
+    }
+    const templateFiles = await globAsync(
+      path.join(import.meta.dirname, "implementations/*.template.js"),
+    );
+
+    for (const templateFile of templateFiles) {
+      const templates = await importMembers<unknown>(templateFile);
+      if (
+        templates.length === 1 &&
+        typeof templates[0].value === "function" &&
+        templates[0].value.prototype instanceof Template
+      ) {
+        const instance = new (templates[0].value as new () => Template)();
+        this.templates.set(instance.key, instance);
+      } else {
+        throw new Error(
+          `Template ${templateFile} should export only one class that extends Template`,
+        );
+      }
+    }
+
+    for (const [key, template] of this.templates) {
+      Template._getTemplatesMap().set(key as TemplateKey, template);
+    }
+
+    this.isAutoloaded = true;
+  }
+
+  /**
+   * 템플릿 다시 로드
+   */
+  async reload(): Promise<void> {
+    this.templates.clear();
+    Template._clearTemplates();
+    this.isAutoloaded = false;
+    await this.autoload();
+  }
+
+  /**
+   * 프로젝트 디렉토리에서 커스텀 템플릿 로드
+   */
+  async loadFromDirectory(dir: string): Promise<number> {
+    const templateFiles = await globAsync(path.join(dir, "*.template.{ts,js}"));
+    let count = 0;
+
+    for (const file of templateFiles) {
+      const templates = await importMembers<unknown>(file);
+      for (const { value } of templates) {
+        if (this.isTemplateClass(value)) {
+          const instance = new (value as new () => Template)();
+          this.register(instance);
+          count++;
+        }
+      }
+    }
+
+    return count;
+  }
+
+  private isTemplateClass(value: unknown): boolean {
+    return typeof value === "function" && value.prototype instanceof Template;
+  }
+
+  // ================================
+  // 템플릿 등록
+  // ================================
+
+  /**
+   * 템플릿 등록
+   */
+  register(template: Template): void {
+    this.templates.set(template.key, template);
+    // 하위 호환
+    Template._getTemplatesMap().set(template.key as TemplateKey, template);
+  }
+
+  /**
+   * 여러 템플릿 등록
+   */
+  registerAll(templates: Template[]): void {
+    for (const template of templates) {
+      this.register(template);
+    }
+  }
+
+  // ================================
+  // 템플릿 조회
+  // ================================
+
+  /**
+   * 템플릿 조회
+   * 빌트인 : 자동완성 지원
+   * 커스텀 : 임의 문자열 지원
+   */
+  get(key: TemplateKey | (string & {})): Template {
+    const template = this.templates.get(key);
+    if (!template) {
+      throw new Error(`Template '${key}' not found. Available: [${this.getAllKeys().join(", ")}]`);
+    }
+    return template;
+  }
+
+  /**
+   * 템플릿 존재 여부
+   */
+  exists(key: string): boolean {
+    return this.templates.has(key);
+  }
+
+  /**
+   * 모든 템플릿 키 목록
+   */
+  getAllKeys(): string[] {
+    return Array.from(this.templates.keys()).sort();
+  }
+
+  /**
+   * 등록된 템플릿 개수
+   */
+  get size(): number {
+    return this.templates.size;
+  }
+
+  // ================================
+  // 테스트 유틸리티
+  // ================================
+
+  /**
+   * 모든 상태 초기화 (테스트용)
+   */
+  reset(): void {
+    this.templates.clear();
+    this.isAutoloaded = false;
+    Template._clearTemplates();
+  }
+
+  /**
+   * 격리된 인스턴스 생성 (테스트용)
+   */
+  static createInstance(): TemplateManagerClass {
+    return new TemplateManagerClass();
+  }
+}
+
+export const TemplateManager = new TemplateManagerClass();
+export { TemplateManagerClass };

package/src/template/template-types.ts

@@ -0,0 +1,16 @@
+/**
+ * 템플릿 그룹 (관련 템플릿 묶음 실행)
+ */
+export type TemplateGroup = {
+  name: string;
+  description?: string;
+  templates: Array<{
+    key: string;
+    getOptions: (baseOptions: Record<string, unknown>) => Record<string, unknown>;
+  }>;
+};
+
+/**
+ * 템플릿 프리셋 (템플릿별 기본 옵션)
+ */
+export type TemplatePreset = Record<string, Record<string, unknown>>;