@things-factory/board-import 10.0.0-beta.71 → 10.0.0-beta.73

package/dist-server/service/converters/generic-to.d.ts

@@ -1,16 +1,25 @@
-import type { BoardComponent } from '../pipeline/stage3-board.js';
+import type { BoardComponent } from '../pipeline/stage3-board';
 export interface ConvertOptions {
     scopes?: string[];
-    /** 새 컴포넌트의 ID. 미지정 시 ImportRule 의 idStrategy 적용 또는 자동 생성 */
+    /** 새 컴포넌트의 ID. 미지정 시 ImportRule 의 idStrategy 적용 또는 자동 생성. */
     id?: string;
+    /**
+     * 코어 placeholder type ('placeholder') 외에 인정할 도메인 추상 type list.
+     * 예: ['GenericTransport', 'GenericFacility'].
+     * 호출자가 자기 도메인 패키지의 추상까지 변환 대상으로 포함하도록 명시.
+     */
+    extraPlaceholderTypes?: ReadonlyArray<string>;
 }
+/** things-scene 코어가 등록한 도메인 비종속 placeholder type. */
+export declare const CORE_PLACEHOLDER_TYPES: readonly ["placeholder"];
+export declare function isPlaceholderType(type: string | undefined, extraTypes?: ReadonlyArray<string>): boolean;
 /**
- * GenericObject 를 지정된 도메인 type 으로 변환한다.
- * 기존 좌표/크기/회전/source 보존.
+ * 추상 placeholder 를 지정된 도메인 type 으로 변환. 호환되는 모든 generic-* 수용 (코어 + 도메인).
+ *
+ * 기존 좌표/크기/회전/source 보존. placeholder 시각 메타 (placeholderLabel/Hint, fillStyle 등) 는 제거.
  */
-export declare function convertGenericTo(generic: BoardComponent, toType: string, options?: ConvertOptions): BoardComponent;
+export declare function convertPlaceholderTo(placeholder: BoardComponent, toType: string, options?: ConvertOptions): BoardComponent;
 /**
- * 변환된 컴포넌트를 다시 GenericObject 로 되돌린다.
- * convertedFrom 정보가 있어야 가능.
+ * @deprecated Use `convertPlaceholderTo`. Placeholder 한정 — 새 코드는 일반화된 helper.
  */
-export declare function revertToGeneric(component: BoardComponent, options?: ConvertOptions): BoardComponent;
+export declare function convertGenericTo(generic: BoardComponent, toType: string, options?: ConvertOptions): BoardComponent;

package/dist-server/service/converters/generic-to.js

@@ -1,78 +1,78 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CORE_PLACEHOLDER_TYPES = void 0;
+exports.isPlaceholderType = isPlaceholderType;
+exports.convertPlaceholderTo = convertPlaceholderTo;
 exports.convertGenericTo = convertGenericTo;
-exports.revertToGeneric = revertToGeneric;
 /**
- * GenericObject ↔ 도메인 컴포넌트 변환.
+ * Generic placeholder → 도메인 컴포넌트 변환.
  *
- * Import 시 매칭되지 않은 entity 는 GenericObject 로 보드에 배치된다.
- * 사용자가 사후에 모델러 UI 에서 "Convert to Stocker" 등 액션으로 호출.
+ * Import 시 매칭되지 않은 entity 는 `placeholder` 타입으로 보드에 배치된다.
+ * 사용자가 사후에 모델러 UI 에서 "Convert to ..." 액션으로 도메인 컴포넌트로 변환.
+ *
+ * 아키텍처 원칙:
+ *   - `placeholder` — 도메인 비종속 임시 추상. 다른 type 으로 변환하는 기능만.
+ *     GLB 지원 없음 (GltfComponent mixin 제거됨).
+ *   - 도메인 generic 추상 (GenericTransport, GenericFacility 등) — 영구 도메인 추상.
+ *     GLB 바디를 직접 채우는 방식으로 사용. 변환 대상 아님.
  *
  * 변환 시:
  *   - 좌표/크기/회전 보존
  *   - source (원본 entity attribs) 보존
  *   - 등록된 ImportRule.build 의 defaultState / idStrategy 적용
  */
-const index_js_1 = require("../registry/index.js");
-const stage2_mapping_js_1 = require("../pipeline/stage2-mapping.js");
+const index_1 = require("../registry/index");
+const stage2_mapping_1 = require("../pipeline/stage2-mapping");
+/** things-scene 코어가 등록한 도메인 비종속 placeholder type. */
+exports.CORE_PLACEHOLDER_TYPES = [stage2_mapping_1.GENERIC_OBJECT_TYPE];
+function isPlaceholderType(type, extraTypes = []) {
+    if (!type)
+        return false;
+    if (exports.CORE_PLACEHOLDER_TYPES.includes(type))
+        return true;
+    return extraTypes.includes(type);
+}
+// ── 일반화된 변환 helper ─────────────────────────────────────────────
 /**
- * GenericObject 를 지정된 도메인 type 으로 변환한다.
- * 기존 좌표/크기/회전/source 보존.
+ * 추상 placeholder 를 지정된 도메인 type 으로 변환. 호환되는 모든 generic-* 수용 (코어 + 도메인).
+ *
+ * 기존 좌표/크기/회전/source 보존. placeholder 시각 메타 (placeholderLabel/Hint, fillStyle 등) 는 제거.
  */
-function convertGenericTo(generic, toType, options = {}) {
-    if (generic.type !== stage2_mapping_js_1.GENERIC_OBJECT_TYPE) {
-        throw new Error(`Source component is not GenericObject (type=${generic.type})`);
+function convertPlaceholderTo(placeholder, toType, options = {}) {
+    const extra = options.extraPlaceholderTypes ?? [];
+    if (!isPlaceholderType(placeholder.type, extra)) {
+        throw new Error(`Source component is not a generic placeholder (type=${placeholder.type}). ` +
+            `Expected one of: ${[...exports.CORE_PLACEHOLDER_TYPES, ...extra].join(', ')}`);
     }
-    const rules = (0, index_js_1.getImportRules)(options.scopes);
+    const rules = (0, index_1.getImportRules)(options.scopes);
     const rule = rules.find(r => r.componentType === toType);
     const category = rule?.category ?? 'unknown';
-    const newId = options.id ?? generic.id;
-    const preset = (0, index_js_1.find3DPreset)(toType, category, options.scopes);
+    const newId = options.id ?? placeholder.id;
+    const preset = (0, index_1.find3DPreset)(toType, category, options.scopes);
     const threeD = {
         geometry: preset.geometry,
         ...(preset.material && { material: preset.material }),
         origin: preset.origin ?? 'bottom'
     };
-    const { strokeStyle, strokeDashArray, fillStyle, label, ...preservedState } = generic;
+    // placeholder 시각/스타일 메타는 새 type 으로 옮길 때 의미 없음 — 제거.
+    const { strokeStyle: _strokeStyle, strokeDashArray: _strokeDashArray, fillStyle: _fillStyle, label: _label, placeholderLabel: _placeholderLabel, placeholderHint: _placeholderHint, ...preservedState } = placeholder;
     return {
         ...preservedState,
         category,
         type: toType,
         id: newId,
         threeD,
-        ...(rule?.build.defaultState || {}),
-        /**
-         * 변환 추적 — 되돌리기 가능하게 source 보존.
-         * `convertedFrom` 키는 board-modeller UI 에서 "되돌리기" 액션 활성화 단서.
-         */
-        convertedFrom: {
-            type: stage2_mapping_js_1.GENERIC_OBJECT_TYPE,
-            previousState: { strokeStyle, strokeDashArray, fillStyle, label }
-        }
+        ...(rule?.build.defaultState || {})
     };
 }
+// ── Backward-compat alias — 기존 호출처 호환 ──────────────────────
 /**
- * 변환된 컴포넌트를 다시 GenericObject 로 되돌린다.
- * convertedFrom 정보가 있어야 가능.
+ * @deprecated Use `convertPlaceholderTo`. Placeholder 한정 — 새 코드는 일반화된 helper.
  */
-function revertToGeneric(component, options = {}) {
-    const previous = component.convertedFrom?.previousState;
-    if (!previous) {
-        throw new Error('이 컴포넌트는 GenericObject 에서 변환된 것이 아닙니다 (convertedFrom 없음).');
+function convertGenericTo(generic, toType, options = {}) {
+    if (generic.type !== stage2_mapping_1.GENERIC_OBJECT_TYPE) {
+        throw new Error(`Source component is not Placeholder (type=${generic.type})`);
     }
-    const preset = (0, index_js_1.find3DPreset)(stage2_mapping_js_1.GENERIC_OBJECT_TYPE, 'unknown', options.scopes);
-    const threeD = {
-        geometry: preset.geometry,
-        ...(preset.material && { material: preset.material }),
-        origin: preset.origin ?? 'bottom'
-    };
-    const { convertedFrom, ...rest } = component;
-    return {
-        ...rest,
-        category: 'unknown',
-        type: stage2_mapping_js_1.GENERIC_OBJECT_TYPE,
-        threeD,
-        ...previous
-    };
+    return convertPlaceholderTo(generic, toType, options);
 }
 //# sourceMappingURL=generic-to.js.map

package/dist-server/service/converters/generic-to.js.map

@@ -1 +1 @@
-{"version":3,"file":"generic-to.js","sourceRoot":"","sources":["../../../server/service/converters/generic-to.ts"],"names":[],"mappings":";;AA0BA,4CAwCC;AAMD,0CAyBC;AAjGD;;;;;;;;;;GAUG;AACH,mDAAmE;AAGnE,qEAAmE;AAQnE;;;GAGG;AACH,SAAgB,gBAAgB,CAC9B,OAAuB,EACvB,MAAc,EACd,UAA0B,EAAE;IAE5B,IAAI,OAAO,CAAC,IAAI,KAAK,uCAAmB,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,+CAA+C,OAAO,CAAC,IAAI,GAAG,CAAC,CAAA;IACjF,CAAC;IAED,MAAM,KAAK,GAAG,IAAA,yBAAc,EAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,MAAM,CAAC,CAAA;IAExD,MAAM,QAAQ,GAAsB,IAAI,EAAE,QAAQ,IAAI,SAAS,CAAA;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE,CAAA;IAEtC,MAAM,MAAM,GAAG,IAAA,uBAAY,EAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7D,MAAM,MAAM,GAAG;QACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ;KAClC,CAAA;IAED,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAA;IAErF,OAAO;QACL,GAAG,cAAc;QACjB,QAAQ;QACR,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,KAAK;QACT,MAAM;QACN,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;QACnC;;;WAGG;QACH,aAAa,EAAE;YACb,IAAI,EAAE,uCAAmB;YACzB,aAAa,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE;SAClE;KACF,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAC7B,SAAyB,EACzB,UAA0B,EAAE;IAE5B,MAAM,QAAQ,GAAI,SAAiB,CAAC,aAAa,EAAE,aAAa,CAAA;IAChE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,uBAAY,EAAC,uCAAmB,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3E,MAAM,MAAM,GAAG;QACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ;KAClC,CAAA;IAED,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,SAAgB,CAAA;IAEnD,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,uCAAmB;QACzB,MAAM;QACN,GAAG,QAAQ;KACZ,CAAA;AACH,CAAC","sourcesContent":["/**\n * GenericObject ↔ 도메인 컴포넌트 변환.\n *\n * Import 시 매칭되지 않은 entity 는 GenericObject 로 보드에 배치된다.\n * 사용자가 사후에 모델러 UI 에서 \"Convert to Stocker\" 등 액션으로 호출.\n *\n * 변환 시:\n *   - 좌표/크기/회전 보존\n *   - source (원본 entity attribs) 보존\n *   - 등록된 ImportRule.build 의 defaultState / idStrategy 적용\n */\nimport { find3DPreset, getImportRules } from '../registry/index.js'\nimport type { BoardComponent } from '../pipeline/stage3-board.js'\nimport type { ComponentCategory } from '../types/registry.js'\nimport { GENERIC_OBJECT_TYPE } from '../pipeline/stage2-mapping.js'\n\nexport interface ConvertOptions {\n  scopes?: string[]\n  /** 새 컴포넌트의 ID. 미지정 시 ImportRule 의 idStrategy 적용 또는 자동 생성 */\n  id?: string\n}\n\n/**\n * GenericObject 를 지정된 도메인 type 으로 변환한다.\n * 기존 좌표/크기/회전/source 보존.\n */\nexport function convertGenericTo(\n  generic: BoardComponent,\n  toType: string,\n  options: ConvertOptions = {}\n): BoardComponent {\n  if (generic.type !== GENERIC_OBJECT_TYPE) {\n    throw new Error(`Source component is not GenericObject (type=${generic.type})`)\n  }\n\n  const rules = getImportRules(options.scopes)\n  const rule = rules.find(r => r.componentType === toType)\n\n  const category: ComponentCategory = rule?.category ?? 'unknown'\n  const newId = options.id ?? generic.id\n\n  const preset = find3DPreset(toType, category, options.scopes)\n  const threeD = {\n    geometry: preset.geometry,\n    ...(preset.material && { material: preset.material }),\n    origin: preset.origin ?? 'bottom'\n  }\n\n  const { strokeStyle, strokeDashArray, fillStyle, label, ...preservedState } = generic\n\n  return {\n    ...preservedState,\n    category,\n    type: toType,\n    id: newId,\n    threeD,\n    ...(rule?.build.defaultState || {}),\n    /**\n     * 변환 추적 — 되돌리기 가능하게 source 보존.\n     * `convertedFrom` 키는 board-modeller UI 에서 \"되돌리기\" 액션 활성화 단서.\n     */\n    convertedFrom: {\n      type: GENERIC_OBJECT_TYPE,\n      previousState: { strokeStyle, strokeDashArray, fillStyle, label }\n    }\n  }\n}\n\n/**\n * 변환된 컴포넌트를 다시 GenericObject 로 되돌린다.\n * convertedFrom 정보가 있어야 가능.\n */\nexport function revertToGeneric(\n  component: BoardComponent,\n  options: ConvertOptions = {}\n): BoardComponent {\n  const previous = (component as any).convertedFrom?.previousState\n  if (!previous) {\n    throw new Error('이 컴포넌트는 GenericObject 에서 변환된 것이 아닙니다 (convertedFrom 없음).')\n  }\n\n  const preset = find3DPreset(GENERIC_OBJECT_TYPE, 'unknown', options.scopes)\n  const threeD = {\n    geometry: preset.geometry,\n    ...(preset.material && { material: preset.material }),\n    origin: preset.origin ?? 'bottom'\n  }\n\n  const { convertedFrom, ...rest } = component as any\n\n  return {\n    ...rest,\n    category: 'unknown',\n    type: GENERIC_OBJECT_TYPE,\n    threeD,\n    ...previous\n  }\n}\n"]}
+{"version":3,"file":"generic-to.js","sourceRoot":"","sources":["../../../server/service/converters/generic-to.ts"],"names":[],"mappings":";;;AAqCA,8CAOC;AASD,oDA6CC;AAOD,4CASC;AAlHD;;;;;;;;;;;;;;;;GAgBG;AACH,6CAAgE;AAGhE,+DAAgE;AAchE,qDAAqD;AACxC,QAAA,sBAAsB,GAAG,CAAC,oCAAmB,CAAU,CAAA;AAEpE,SAAgB,iBAAiB,CAC/B,IAAwB,EACxB,aAAoC,EAAE;IAEtC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IACvB,IAAK,8BAA4C,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC7E,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AAClC,CAAC;AAED,kEAAkE;AAElE;;;;GAIG;AACH,SAAgB,oBAAoB,CAClC,WAA2B,EAC3B,MAAc,EACd,UAA0B,EAAE;IAE5B,MAAM,KAAK,GAAG,OAAO,CAAC,qBAAqB,IAAI,EAAE,CAAA;IACjD,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,uDAAuD,WAAW,CAAC,IAAI,KAAK;YAC1E,oBAAoB,CAAC,GAAG,8BAAsB,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzE,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,IAAA,sBAAc,EAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,MAAM,CAAC,CAAA;IAExD,MAAM,QAAQ,GAAsB,IAAI,EAAE,QAAQ,IAAI,SAAS,CAAA;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,IAAI,WAAW,CAAC,EAAE,CAAA;IAE1C,MAAM,MAAM,GAAG,IAAA,oBAAY,EAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7D,MAAM,MAAM,GAAG;QACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ;KAClC,CAAA;IAED,oDAAoD;IACpD,MAAM,EACJ,WAAW,EAAE,YAAY,EACzB,eAAe,EAAE,gBAAgB,EACjC,SAAS,EAAE,UAAU,EACrB,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,iBAAiB,EACnC,eAAe,EAAE,gBAAgB,EACjC,GAAG,cAAc,EAClB,GAAG,WAAkB,CAAA;IAEtB,OAAO;QACL,GAAG,cAAc;QACjB,QAAQ;QACR,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,KAAK;QACT,MAAM;QACN,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;KACpC,CAAA;AACH,CAAC;AAED,8DAA8D;AAE9D;;GAEG;AACH,SAAgB,gBAAgB,CAC9B,OAAuB,EACvB,MAAc,EACd,UAA0B,EAAE;IAE5B,IAAI,OAAO,CAAC,IAAI,KAAK,oCAAmB,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,CAAC,IAAI,GAAG,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;AACvD,CAAC","sourcesContent":["/**\n * Generic placeholder → 도메인 컴포넌트 변환.\n *\n * Import 시 매칭되지 않은 entity 는 `placeholder` 타입으로 보드에 배치된다.\n * 사용자가 사후에 모델러 UI 에서 \"Convert to ...\" 액션으로 도메인 컴포넌트로 변환.\n *\n * 아키텍처 원칙:\n *   - `placeholder` — 도메인 비종속 임시 추상. 다른 type 으로 변환하는 기능만.\n *     GLB 지원 없음 (GltfComponent mixin 제거됨).\n *   - 도메인 generic 추상 (GenericTransport, GenericFacility 등) — 영구 도메인 추상.\n *     GLB 바디를 직접 채우는 방식으로 사용. 변환 대상 아님.\n *\n * 변환 시:\n *   - 좌표/크기/회전 보존\n *   - source (원본 entity attribs) 보존\n *   - 등록된 ImportRule.build 의 defaultState / idStrategy 적용\n */\nimport { find3DPreset, getImportRules } from '../registry/index'\nimport type { BoardComponent } from '../pipeline/stage3-board'\nimport type { ComponentCategory } from '../types/registry'\nimport { GENERIC_OBJECT_TYPE } from '../pipeline/stage2-mapping'\n\nexport interface ConvertOptions {\n  scopes?: string[]\n  /** 새 컴포넌트의 ID. 미지정 시 ImportRule 의 idStrategy 적용 또는 자동 생성. */\n  id?: string\n  /**\n   * 코어 placeholder type ('placeholder') 외에 인정할 도메인 추상 type list.\n   * 예: ['GenericTransport', 'GenericFacility'].\n   * 호출자가 자기 도메인 패키지의 추상까지 변환 대상으로 포함하도록 명시.\n   */\n  extraPlaceholderTypes?: ReadonlyArray<string>\n}\n\n/** things-scene 코어가 등록한 도메인 비종속 placeholder type. */\nexport const CORE_PLACEHOLDER_TYPES = [GENERIC_OBJECT_TYPE] as const\n\nexport function isPlaceholderType(\n  type: string | undefined,\n  extraTypes: ReadonlyArray<string> = []\n): boolean {\n  if (!type) return false\n  if ((CORE_PLACEHOLDER_TYPES as readonly string[]).includes(type)) return true\n  return extraTypes.includes(type)\n}\n\n// ── 일반화된 변환 helper ─────────────────────────────────────────────\n\n/**\n * 추상 placeholder 를 지정된 도메인 type 으로 변환. 호환되는 모든 generic-* 수용 (코어 + 도메인).\n *\n * 기존 좌표/크기/회전/source 보존. placeholder 시각 메타 (placeholderLabel/Hint, fillStyle 등) 는 제거.\n */\nexport function convertPlaceholderTo(\n  placeholder: BoardComponent,\n  toType: string,\n  options: ConvertOptions = {}\n): BoardComponent {\n  const extra = options.extraPlaceholderTypes ?? []\n  if (!isPlaceholderType(placeholder.type, extra)) {\n    throw new Error(\n      `Source component is not a generic placeholder (type=${placeholder.type}). ` +\n        `Expected one of: ${[...CORE_PLACEHOLDER_TYPES, ...extra].join(', ')}`\n    )\n  }\n\n  const rules = getImportRules(options.scopes)\n  const rule = rules.find(r => r.componentType === toType)\n\n  const category: ComponentCategory = rule?.category ?? 'unknown'\n  const newId = options.id ?? placeholder.id\n\n  const preset = find3DPreset(toType, category, options.scopes)\n  const threeD = {\n    geometry: preset.geometry,\n    ...(preset.material && { material: preset.material }),\n    origin: preset.origin ?? 'bottom'\n  }\n\n  // placeholder 시각/스타일 메타는 새 type 으로 옮길 때 의미 없음 — 제거.\n  const {\n    strokeStyle: _strokeStyle,\n    strokeDashArray: _strokeDashArray,\n    fillStyle: _fillStyle,\n    label: _label,\n    placeholderLabel: _placeholderLabel,\n    placeholderHint: _placeholderHint,\n    ...preservedState\n  } = placeholder as any\n\n  return {\n    ...preservedState,\n    category,\n    type: toType,\n    id: newId,\n    threeD,\n    ...(rule?.build.defaultState || {})\n  }\n}\n\n// ── Backward-compat alias — 기존 호출처 호환 ──────────────────────\n\n/**\n * @deprecated Use `convertPlaceholderTo`. Placeholder 한정 — 새 코드는 일반화된 helper.\n */\nexport function convertGenericTo(\n  generic: BoardComponent,\n  toType: string,\n  options: ConvertOptions = {}\n): BoardComponent {\n  if (generic.type !== GENERIC_OBJECT_TYPE) {\n    throw new Error(`Source component is not Placeholder (type=${generic.type})`)\n  }\n  return convertPlaceholderTo(generic, toType, options)\n}\n"]}

package/dist-server/service/import-session/import-actions.d.ts

@@ -0,0 +1,79 @@
+/**
+ * board-import 의 ResolverContext 무관 service-level 함수.
+ *
+ * import-session-resolver 의 mutation/query 핵심 로직을 typeorm getRepository /
+ * ResolverContext 외부 의존성을 인자로 분리해 단위 테스트 + LLM tool builder 에서
+ * 재사용 가능하도록 추출. materializeFromSession 의 패턴 동일.
+ *
+ * 호출자 책임:
+ *   - resolver: getRepository / context.state 에서 도메인/유저 추출 후 deps 채워 호출
+ *   - import-tools.ts: ToolDispatchHelpers 가 builder 호출 시 ctx 에서 추출
+ */
+import type { ImportSession } from './import-session';
+export interface SessionRepoLike {
+    findOneBy(criteria: any): Promise<ImportSession | null>;
+    save(entity: any): Promise<ImportSession>;
+    find(options: any): Promise<ImportSession[]>;
+}
+export interface ImportActionsContext {
+    domain: {
+        id: string;
+        [k: string]: any;
+    };
+    user: any;
+}
+export interface StartImportJobInput {
+    attachmentId: string;
+    chatSessionId?: string;
+    scopes?: string[];
+    normalizeOrigin?: boolean;
+    flipY?: boolean;
+    scale?: number;
+    applyBinding?: boolean;
+    parseOptions?: any;
+    /**
+     * 사용자 자유서술 — 도면 설명 / 강조 부분 / 분류 힌트 등.
+     * VLM 이 view type 분류 + entity 추출 양쪽 패스에 모두 추가 컨텍스트로 사용.
+     */
+    userPrompt?: string;
+}
+/**
+ * 비동기 import job 시작. ImportSession 즉시 반환, 백그라운드에서 worker 실행.
+ *
+ * resolver 와 LLM tool builder 양쪽이 공유하는 진입점. side-effect 인 worker 가동도
+ * 본 함수에 묶음 — 사용자 입장에선 "단일 호출 = import 시작" 의미.
+ *
+ * `startWorker` 는 의존성 주입 — default 는 setImmediate(runImportJob). 단위 테스트는
+ * noop 주입해 worker chain 이 jest 환경에서 평가되지 않도록 한다 (typeorm DataSource init
+ * 안 된 환경에서 entity decorator 평가 시 fail 회피).
+ */
+export declare function startImportJobAsync(input: StartImportJobInput, context: ImportActionsContext, sessionRepo: SessionRepoLike, startWorker?: (sessionId: string) => void): Promise<ImportSession>;
+/**
+ * 단일 ImportSession 조회 (도메인 격리). 미존재면 null.
+ */
+export declare function fetchImportSession(sessionId: string, context: ImportActionsContext, sessionRepo: SessionRepoLike): Promise<ImportSession | null>;
+/**
+ * 한 ChatSession 안에서 발동된 ImportSession 목록 (최신순 50개). board-ai 의 chat 흐름이
+ * "이 chat 의 import 들 보여줘" 같은 호출에서 사용.
+ */
+export declare function listImportSessionsByChatSession(chatSessionId: string, context: ImportActionsContext, sessionRepo: SessionRepoLike): Promise<ImportSession[]>;
+/**
+ * 등록된 FormatAdapter 들의 능력 정보. context 무관 (인스턴스만 inspect).
+ * 외부 RPC 의존성도 없어 LLM 이 안전하게 호출 가능한 read tool.
+ */
+export interface AdapterInfo {
+    format: string;
+    supportedExtensions: string[];
+    capabilities: {
+        has2D: boolean;
+        has3D: boolean;
+        hasSemanticLabels: boolean;
+        hasTextLabels: boolean;
+        hasAttributes: boolean;
+    };
+}
+export declare function describeAdapter(adapter: {
+    format: string;
+    supportedExtensions: string[];
+    capabilities: any;
+}): AdapterInfo;

package/dist-server/service/import-session/import-actions.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * board-import 의 ResolverContext 무관 service-level 함수.
+ *
+ * import-session-resolver 의 mutation/query 핵심 로직을 typeorm getRepository /
+ * ResolverContext 외부 의존성을 인자로 분리해 단위 테스트 + LLM tool builder 에서
+ * 재사용 가능하도록 추출. materializeFromSession 의 패턴 동일.
+ *
+ * 호출자 책임:
+ *   - resolver: getRepository / context.state 에서 도메인/유저 추출 후 deps 채워 호출
+ *   - import-tools.ts: ToolDispatchHelpers 가 builder 호출 시 ctx 에서 추출
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startImportJobAsync = startImportJobAsync;
+exports.fetchImportSession = fetchImportSession;
+exports.listImportSessionsByChatSession = listImportSessionsByChatSession;
+exports.describeAdapter = describeAdapter;
+// ── service 함수들 ────────────────────────────────────────────────────
+/**
+ * 비동기 import job 시작. ImportSession 즉시 반환, 백그라운드에서 worker 실행.
+ *
+ * resolver 와 LLM tool builder 양쪽이 공유하는 진입점. side-effect 인 worker 가동도
+ * 본 함수에 묶음 — 사용자 입장에선 "단일 호출 = import 시작" 의미.
+ *
+ * `startWorker` 는 의존성 주입 — default 는 setImmediate(runImportJob). 단위 테스트는
+ * noop 주입해 worker chain 이 jest 환경에서 평가되지 않도록 한다 (typeorm DataSource init
+ * 안 된 환경에서 entity decorator 평가 시 fail 회피).
+ */
+async function startImportJobAsync(input, context, sessionRepo, startWorker = defaultStartWorker) {
+    const session = await sessionRepo.save({
+        domain: context.domain,
+        attachmentId: input.attachmentId,
+        chatSessionId: input.chatSessionId,
+        status: 'queued',
+        progress: 0,
+        message: 'Queued',
+        optionsJson: JSON.stringify({
+            scopes: input.scopes,
+            normalizeOrigin: input.normalizeOrigin,
+            flipY: input.flipY,
+            scale: input.scale,
+            applyBinding: input.applyBinding,
+            parseOptions: input.parseOptions,
+            userPrompt: input.userPrompt
+        }),
+        creator: context.user
+    });
+    // 백그라운드 worker 시작 — 의존성 주입으로 분리 (테스트 격리 + lazy require).
+    startWorker(session.id);
+    return session;
+}
+/**
+ * Default startWorker — setImmediate(runImportJob). worker module 은 lazy require 로
+ * module-level 평가 chain (attachment-base STORAGE, pipeline 의 adapters 등) 을 회피.
+ */
+function defaultStartWorker(sessionId) {
+    setImmediate(() => {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { runImportJob } = require('./import-worker');
+        runImportJob(sessionId).catch((err) => {
+            console.error('[board-import] runImportJob unhandled:', err);
+        });
+    });
+}
+/**
+ * 단일 ImportSession 조회 (도메인 격리). 미존재면 null.
+ */
+async function fetchImportSession(sessionId, context, sessionRepo) {
+    return await sessionRepo.findOneBy({
+        id: sessionId,
+        domain: { id: context.domain.id }
+    });
+}
+/**
+ * 한 ChatSession 안에서 발동된 ImportSession 목록 (최신순 50개). board-ai 의 chat 흐름이
+ * "이 chat 의 import 들 보여줘" 같은 호출에서 사용.
+ */
+async function listImportSessionsByChatSession(chatSessionId, context, sessionRepo) {
+    return await sessionRepo.find({
+        where: { chatSessionId, domain: { id: context.domain.id } },
+        order: { createdAt: 'DESC' },
+        take: 50
+    });
+}
+function describeAdapter(adapter) {
+    return {
+        format: adapter.format,
+        supportedExtensions: [...adapter.supportedExtensions],
+        capabilities: {
+            has2D: !!adapter.capabilities.has2D,
+            has3D: !!adapter.capabilities.has3D,
+            hasSemanticLabels: !!adapter.capabilities.hasSemanticLabels,
+            hasTextLabels: !!adapter.capabilities.hasTextLabels,
+            hasAttributes: !!adapter.capabilities.hasAttributes
+        }
+    };
+}
+//# sourceMappingURL=import-actions.js.map

package/dist-server/service/import-session/import-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-actions.js","sourceRoot":"","sources":["../../../server/service/import-session/import-actions.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AA+CH,kDA4BC;AAmBD,gDASC;AAMD,0EAUC;AAkBD,0CAgBC;AAtHD,sEAAsE;AAEtE;;;;;;;;;GASG;AACI,KAAK,UAAU,mBAAmB,CACvC,KAA0B,EAC1B,OAA6B,EAC7B,WAA4B,EAC5B,cAA2C,kBAAkB;IAE7D,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC;QACrC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC;QACF,OAAO,EAAE,OAAO,CAAC,IAAI;KACf,CAAC,CAAA;IAET,yDAAyD;IACzD,WAAW,CAAC,OAAO,CAAC,EAAG,CAAC,CAAA;IACxB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,YAAY,CAAC,GAAG,EAAE;QAChB,8DAA8D;QAC9D,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;QACnD,YAAY,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;YAC3C,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,GAAG,CAAC,CAAA;QAC9D,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,OAA6B,EAC7B,WAA4B;IAE5B,OAAO,MAAM,WAAW,CAAC,SAAS,CAAC;QACjC,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE;KAClC,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,+BAA+B,CACnD,aAAqB,EACrB,OAA6B,EAC7B,WAA4B;IAE5B,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC;QAC5B,KAAK,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE;QAC3D,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;QAC5B,IAAI,EAAE,EAAE;KACT,CAAC,CAAA;AACJ,CAAC;AAkBD,SAAgB,eAAe,CAAC,OAI/B;IACC,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,mBAAmB,EAAE,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;QACrD,YAAY,EAAE;YACZ,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK;YACnC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK;YACnC,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,iBAAiB;YAC3D,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,aAAa;YACnD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,aAAa;SACpD;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * board-import 의 ResolverContext 무관 service-level 함수.\n *\n * import-session-resolver 의 mutation/query 핵심 로직을 typeorm getRepository /\n * ResolverContext 외부 의존성을 인자로 분리해 단위 테스트 + LLM tool builder 에서\n * 재사용 가능하도록 추출. materializeFromSession 의 패턴 동일.\n *\n * 호출자 책임:\n *   - resolver: getRepository / context.state 에서 도메인/유저 추출 후 deps 채워 호출\n *   - import-tools.ts: ToolDispatchHelpers 가 builder 호출 시 ctx 에서 추출\n */\n\n// type-only import — module level 에서 typeorm decorator chain 을 평가하지 않는다.\n// 단위 테스트 환경이 typeorm DataSource init 전에도 service 함수 검증할 수 있게 함.\nimport type { ImportSession } from './import-session'\n\n// ── 입력/의존성 타입 ──────────────────────────────────────────────────\n\nexport interface SessionRepoLike {\n  findOneBy(criteria: any): Promise<ImportSession | null>\n  save(entity: any): Promise<ImportSession>\n  find(options: any): Promise<ImportSession[]>\n}\n\nexport interface ImportActionsContext {\n  domain: { id: string; [k: string]: any }\n  user: any\n}\n\nexport interface StartImportJobInput {\n  attachmentId: string\n  chatSessionId?: string\n  scopes?: string[]\n  normalizeOrigin?: boolean\n  flipY?: boolean\n  scale?: number\n  applyBinding?: boolean\n  parseOptions?: any\n  /**\n   * 사용자 자유서술 — 도면 설명 / 강조 부분 / 분류 힌트 등.\n   * VLM 이 view type 분류 + entity 추출 양쪽 패스에 모두 추가 컨텍스트로 사용.\n   */\n  userPrompt?: string\n}\n\n// ── service 함수들 ────────────────────────────────────────────────────\n\n/**\n * 비동기 import job 시작. ImportSession 즉시 반환, 백그라운드에서 worker 실행.\n *\n * resolver 와 LLM tool builder 양쪽이 공유하는 진입점. side-effect 인 worker 가동도\n * 본 함수에 묶음 — 사용자 입장에선 \"단일 호출 = import 시작\" 의미.\n *\n * `startWorker` 는 의존성 주입 — default 는 setImmediate(runImportJob). 단위 테스트는\n * noop 주입해 worker chain 이 jest 환경에서 평가되지 않도록 한다 (typeorm DataSource init\n * 안 된 환경에서 entity decorator 평가 시 fail 회피).\n */\nexport async function startImportJobAsync(\n  input: StartImportJobInput,\n  context: ImportActionsContext,\n  sessionRepo: SessionRepoLike,\n  startWorker: (sessionId: string) => void = defaultStartWorker\n): Promise<ImportSession> {\n  const session = await sessionRepo.save({\n    domain: context.domain,\n    attachmentId: input.attachmentId,\n    chatSessionId: input.chatSessionId,\n    status: 'queued',\n    progress: 0,\n    message: 'Queued',\n    optionsJson: JSON.stringify({\n      scopes: input.scopes,\n      normalizeOrigin: input.normalizeOrigin,\n      flipY: input.flipY,\n      scale: input.scale,\n      applyBinding: input.applyBinding,\n      parseOptions: input.parseOptions,\n      userPrompt: input.userPrompt\n    }),\n    creator: context.user\n  } as any)\n\n  // 백그라운드 worker 시작 — 의존성 주입으로 분리 (테스트 격리 + lazy require).\n  startWorker(session.id!)\n  return session\n}\n\n/**\n * Default startWorker — setImmediate(runImportJob). worker module 은 lazy require 로\n * module-level 평가 chain (attachment-base STORAGE, pipeline 의 adapters 등) 을 회피.\n */\nfunction defaultStartWorker(sessionId: string): void {\n  setImmediate(() => {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const { runImportJob } = require('./import-worker')\n    runImportJob(sessionId).catch((err: Error) => {\n      console.error('[board-import] runImportJob unhandled:', err)\n    })\n  })\n}\n\n/**\n * 단일 ImportSession 조회 (도메인 격리). 미존재면 null.\n */\nexport async function fetchImportSession(\n  sessionId: string,\n  context: ImportActionsContext,\n  sessionRepo: SessionRepoLike\n): Promise<ImportSession | null> {\n  return await sessionRepo.findOneBy({\n    id: sessionId,\n    domain: { id: context.domain.id }\n  })\n}\n\n/**\n * 한 ChatSession 안에서 발동된 ImportSession 목록 (최신순 50개). board-ai 의 chat 흐름이\n * \"이 chat 의 import 들 보여줘\" 같은 호출에서 사용.\n */\nexport async function listImportSessionsByChatSession(\n  chatSessionId: string,\n  context: ImportActionsContext,\n  sessionRepo: SessionRepoLike\n): Promise<ImportSession[]> {\n  return await sessionRepo.find({\n    where: { chatSessionId, domain: { id: context.domain.id } },\n    order: { createdAt: 'DESC' },\n    take: 50\n  })\n}\n\n/**\n * 등록된 FormatAdapter 들의 능력 정보. context 무관 (인스턴스만 inspect).\n * 외부 RPC 의존성도 없어 LLM 이 안전하게 호출 가능한 read tool.\n */\nexport interface AdapterInfo {\n  format: string\n  supportedExtensions: string[]\n  capabilities: {\n    has2D: boolean\n    has3D: boolean\n    hasSemanticLabels: boolean\n    hasTextLabels: boolean\n    hasAttributes: boolean\n  }\n}\n\nexport function describeAdapter(adapter: {\n  format: string\n  supportedExtensions: string[]\n  capabilities: any\n}): AdapterInfo {\n  return {\n    format: adapter.format,\n    supportedExtensions: [...adapter.supportedExtensions],\n    capabilities: {\n      has2D: !!adapter.capabilities.has2D,\n      has3D: !!adapter.capabilities.has3D,\n      hasSemanticLabels: !!adapter.capabilities.hasSemanticLabels,\n      hasTextLabels: !!adapter.capabilities.hasTextLabels,\n      hasAttributes: !!adapter.capabilities.hasAttributes\n    }\n  }\n}\n"]}

package/dist-server/service/import-session/import-session-resolver.d.ts

@@ -1,5 +1,20 @@
 import '@things-factory/auth-base';
-import { ImportSession } from './import-session.js';
+import { Board } from '@things-factory/board-service';
+import { ImportSession } from './import-session';
+import { type SuggestBoardMetaResult } from './suggest-board-name';
+declare class MaterializeImportSessionInput {
+    sessionId: string;
+    name: string;
+    description?: string;
+    groupId?: string;
+    type?: 'main' | 'sub' | 'popup';
+    thumbnail?: string;
+    variantId?: string;
+}
+declare class SuggestBoardNameInput {
+    sessionId?: string;
+    hint?: string;
+}
 declare class ImportBoardAsyncInput {
     attachmentId: string;
     chatSessionId?: string;
@@ -9,10 +24,16 @@ declare class ImportBoardAsyncInput {
     scale?: number;
     applyBinding?: boolean;
     parseOptions?: any;
+    userPrompt?: string;
 }
 export declare class ImportSessionResolver {
     importSession(id: string, context: ResolverContext): Promise<ImportSession | null>;
     importSessionsByChatSession(chatSessionId: string, context: ResolverContext): Promise<ImportSession[]>;
     importBoardAsync(input: ImportBoardAsyncInput, context: ResolverContext): Promise<ImportSession>;
+    suggestBoardName(input: SuggestBoardNameInput, context: ResolverContext): Promise<string>;
+    suggestBoardMeta(input: SuggestBoardNameInput, context: ResolverContext): Promise<SuggestBoardMetaResult>;
+    /** 두 query 가 공유하는 deps wiring — typeorm find idiomatic 패턴 (distinctAlias 회귀 회피). */
+    private _buildSuggestDeps;
+    materializeImportSession(input: MaterializeImportSessionInput, context: ResolverContext): Promise<Board>;
 }
 export {};