@things-factory/board-import 10.0.0-beta.72 → 10.0.0-beta.74

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

@@ -10,7 +10,13 @@ export interface ConvertOptions {
      */
     extraPlaceholderTypes?: ReadonlyArray<string>;
 }
-/** things-scene 코어가 등록한 도메인 비종속 placeholder type. */
+/**
+ * things-scene 코어가 등록한 도메인 비종속 placeholder type.
+ *
+ * @sync things-scene/src/components/generic-placeholders.ts CORE_PLACEHOLDER_TYPES
+ * client/server 경계로 직접 import 불가 — 값을 바꾸면 양쪽 동시 수정 필수.
+ * 계약은 generic-to.test.ts 의 'CORE_PLACEHOLDER_TYPES contract' 어설션으로 보증.
+ */
 export declare const CORE_PLACEHOLDER_TYPES: readonly ["placeholder"];
 export declare function isPlaceholderType(type: string | undefined, extraTypes?: ReadonlyArray<string>): boolean;
 /**
@@ -19,26 +25,6 @@ export declare function isPlaceholderType(type: string | undefined, extraTypes?:
  * 기존 좌표/크기/회전/source 보존. placeholder 시각 메타 (placeholderLabel/Hint, fillStyle 등) 는 제거.
  */
 export declare function convertPlaceholderTo(placeholder: BoardComponent, toType: string, options?: ConvertOptions): BoardComponent;
-/**
- * Generic placeholder 에 GLB 를 attach 해 GLB 기반 컴포넌트로 morph.
- *
- * morph 정책:
- *   - `placeholder` — type 유지 (GltfComponent mixin 이 있어 GLB 직접 수용).
- *   - 도메인 추상 (`GenericTransport`, `GenericFacility` 등) — type 유지 + src set.
- *     호출자가 toType 명시 가능 (예: 'GenericTransport'). 미지정이면 placeholder type 유지.
- */
-export interface AttachGlbOptions extends ConvertOptions {
-    /** GLB 파일 URL 또는 Attachment src. */
-    src: string;
-    /** 자동으로 모델 크기에 맞춰 width/height/depth 보정 (gltf-object autoFit). */
-    autoFit?: boolean;
-    /**
-     * 명시 변환 type — 도메인 추상 (`GenericTransport` 등) 으로 morph 시 지정.
-     * 미지정 시: placeholder type 유지 (placeholder 는 GltfComponent mixin 으로 GLB 직접 수용).
-     */
-    toType?: string;
-}
-export declare function attachGlbToPlaceholder(placeholder: BoardComponent, options: AttachGlbOptions): BoardComponent;
 /**
  * @deprecated Use `convertPlaceholderTo`. Placeholder 한정 — 새 코드는 일반화된 helper.
  */

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

@@ -3,19 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CORE_PLACEHOLDER_TYPES = void 0;
 exports.isPlaceholderType = isPlaceholderType;
 exports.convertPlaceholderTo = convertPlaceholderTo;
-exports.attachGlbToPlaceholder = attachGlbToPlaceholder;
 exports.convertGenericTo = convertGenericTo;
 /**
  * Generic placeholder → 도메인 컴포넌트 변환.
  *
- * Import 시 매칭되지 않은 entity 는 추상 placeholder 로 보드에 배치된다. 사용자가 사후에
- * 모델러 UI 에서 "Convert to ..." 액션으로 호출하거나, GLB 를 attach 해 GLB 기반 컴포넌트로
- * morph 한다. `placeholder` 는 GltfComponent mixin 을 갖고 있어 GLB attach 시 type 유지.
+ * Import 시 매칭되지 않은 entity 는 `placeholder` 타입으로 보드에 배치된다.
+ * 사용자가 사후에 모델러 UI 에서 "Convert to ..." 액션으로 도메인 컴포넌트로 변환.
  *
- * 인정되는 placeholder type:
- *   - `placeholder` — 도메인 비종속 fallback (things-scene 등록). GLB attach 지원.
- *   - 도메인 패키지의 generic-* 추상 — 호출자가 추가 list 로 명시 (예: 'GenericTransport',
- *     'GenericFacility' 등). 코어 list 외의 추상도 같은 helper 로 변환 가능.
+ * 아키텍처 원칙:
+ *   - `placeholder` — 도메인 비종속 임시 추상. 다른 type 으로 변환하는 기능만.
+ *     GLB 지원 없음 (GltfComponent mixin 제거됨).
+ *   - 도메인 generic 추상 (GenericTransport, GenericFacility 등) — 영구 도메인 추상.
+ *     GLB 바디를 직접 채우는 방식으로 사용. 변환 대상 아님.
  *
  * 변환 시:
  *   - 좌표/크기/회전 보존
@@ -24,7 +23,13 @@ exports.convertGenericTo = convertGenericTo;
  */
 const index_1 = require("../registry/index");
 const stage2_mapping_1 = require("../pipeline/stage2-mapping");
-/** things-scene 코어가 등록한 도메인 비종속 placeholder type. */
+/**
+ * things-scene 코어가 등록한 도메인 비종속 placeholder type.
+ *
+ * @sync things-scene/src/components/generic-placeholders.ts CORE_PLACEHOLDER_TYPES
+ * client/server 경계로 직접 import 불가 — 값을 바꾸면 양쪽 동시 수정 필수.
+ * 계약은 generic-to.test.ts 의 'CORE_PLACEHOLDER_TYPES contract' 어설션으로 보증.
+ */
 exports.CORE_PLACEHOLDER_TYPES = [stage2_mapping_1.GENERIC_OBJECT_TYPE];
 function isPlaceholderType(type, extraTypes = []) {
     if (!type)
@@ -66,21 +71,6 @@ function convertPlaceholderTo(placeholder, toType, options = {}) {
         ...(rule?.build.defaultState || {})
     };
 }
-function attachGlbToPlaceholder(placeholder, options) {
-    const extra = options.extraPlaceholderTypes ?? [];
-    if (!isPlaceholderType(placeholder.type, extra)) {
-        throw new Error(`Source component is not a generic placeholder (type=${placeholder.type}). Cannot attach GLB.`);
-    }
-    const { strokeStyle: _strokeStyle, strokeDashArray: _strokeDashArray, fillStyle: _fillStyle, label: _label, placeholderLabel: _placeholderLabel, placeholderHint: _placeholderHint, ...preservedState } = placeholder;
-    // morph 후 type 결정 — placeholder 는 GltfComponent mixin 보유, 도메인 추상도 type 유지
-    const nextType = options.toType ?? placeholder.type;
-    return {
-        ...preservedState,
-        type: nextType,
-        src: options.src,
-        ...(options.autoFit ? { autoFit: true } : {})
-    };
-}
 // ── Backward-compat alias — 기존 호출처 호환 ──────────────────────
 /**
  * @deprecated Use `convertPlaceholderTo`. Placeholder 한정 — 새 코드는 일반화된 helper.

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":"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","sourcesContent":["/**\n * Generic placeholder → 도메인 컴포넌트 변환.\n *\n * Import 시 매칭되지 않은 entity 는 추상 placeholder 로 보드에 배치된다. 사용자가 사후에\n * 모델러 UI 에서 \"Convert to ...\" 액션으로 호출하거나, GLB 를 attach 해 GLB 기반 컴포넌트로\n * morph 한다. `placeholder` 는 GltfComponent mixin 을 갖고 있어 GLB attach 시 type 유지.\n *\n * 인정되는 placeholder type:\n *   - `placeholder` — 도메인 비종속 fallback (things-scene 등록). GLB attach 지원.\n *   - 도메인 패키지의 generic-* 추상 — 호출자가 추가 list 로 명시 (예: 'GenericTransport',\n *     'GenericFacility' 등). 코어 list 외의 추상도 같은 helper 로 변환 가능.\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/**\n * Generic placeholder 에 GLB 를 attach 해 GLB 기반 컴포넌트로 morph.\n *\n * morph 정책:\n *   - `placeholder` — type 유지 (GltfComponent mixin 이 있어 GLB 직접 수용).\n *   - 도메인 추상 (`GenericTransport`, `GenericFacility` 등) — type 유지 + src set.\n *     호출자가 toType 명시 가능 (예: 'GenericTransport'). 미지정이면 placeholder type 유지.\n */\nexport interface AttachGlbOptions extends ConvertOptions {\n  /** GLB 파일 URL 또는 Attachment src. */\n  src: string\n  /** 자동으로 모델 크기에 맞춰 width/height/depth 보정 (gltf-object autoFit). */\n  autoFit?: boolean\n  /**\n   * 명시 변환 type — 도메인 추상 (`GenericTransport` 등) 으로 morph 시 지정.\n   * 미지정 시: placeholder type 유지 (placeholder 는 GltfComponent mixin 으로 GLB 직접 수용).\n   */\n  toType?: string\n}\n\nexport function attachGlbToPlaceholder(\n  placeholder: BoardComponent,\n  options: AttachGlbOptions\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}). Cannot attach GLB.`\n    )\n  }\n\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  // morph 후 type 결정 — placeholder 는 GltfComponent mixin 보유, 도메인 추상도 type 유지\n  const nextType = options.toType ?? placeholder.type\n\n  return {\n    ...preservedState,\n    type: nextType,\n    src: options.src,\n    ...(options.autoFit ? { autoFit: true } : {})\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"]}
+{"version":3,"file":"generic-to.js","sourceRoot":"","sources":["../../../server/service/converters/generic-to.ts"],"names":[],"mappings":";;;AA2CA,8CAOC;AASD,oDA6CC;AAOD,4CASC;AAxHD;;;;;;;;;;;;;;;;GAgBG;AACH,6CAAgE;AAGhE,+DAAgE;AAchE;;;;;;GAMG;AACU,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/**\n * things-scene 코어가 등록한 도메인 비종속 placeholder type.\n *\n * @sync things-scene/src/components/generic-placeholders.ts CORE_PLACEHOLDER_TYPES\n * client/server 경계로 직접 import 불가 — 값을 바꾸면 양쪽 동시 수정 필수.\n * 계약은 generic-to.test.ts 의 'CORE_PLACEHOLDER_TYPES contract' 어설션으로 보증.\n */\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/index.d.ts

@@ -12,8 +12,8 @@ export type { BoardModel, BoardComponent, AssembleOptions } from './pipeline/sta
 export type { MappingOptions } from './pipeline/stage2-mapping';
 export type { BindingOptions } from './pipeline/stage4-binding';
 export { convertGenericTo, // deprecated alias — keep for backward-compat
-convertPlaceholderTo, attachGlbToPlaceholder, isPlaceholderType, CORE_PLACEHOLDER_TYPES } from './converters/generic-to';
-export type { ConvertOptions, AttachGlbOptions } from './converters/generic-to';
+convertPlaceholderTo, isPlaceholderType, CORE_PLACEHOLDER_TYPES } from './converters/generic-to';
+export type { ConvertOptions } from './converters/generic-to';
 export { DxfAdapter } from './adapters/dxf-adapter';
 export { ImageAdapter } from './adapters/image-adapter';
 export { registerImportRules, registerSubscriptionRules, register3DPresets, getImportRules, getSubscriptionRules, get3DPresets, find3DPreset, findSubscriptionRule, clearImportRules, clearSubscriptionRules, clear3DPresets, clearAllRegistries } from './registry/index';

package/dist-server/service/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BOARD_IMPORT_TOOL_CATEGORY = exports.registerBoardImportTools = exports.DefaultBoardImportAI = exports.getAIClient = exports.setAIClient = exports.clearAllRegistries = exports.clear3DPresets = exports.clearSubscriptionRules = exports.clearImportRules = exports.findSubscriptionRule = exports.find3DPreset = exports.get3DPresets = exports.getSubscriptionRules = exports.getImportRules = exports.register3DPresets = exports.registerSubscriptionRules = exports.registerImportRules = exports.ImageAdapter = exports.DxfAdapter = exports.CORE_PLACEHOLDER_TYPES = exports.isPlaceholderType = exports.attachGlbToPlaceholder = exports.convertPlaceholderTo = exports.convertGenericTo = exports.applyDataBinding = exports.assembleBoard = exports.DEFAULT_CATEGORY_FALLBACK = exports.GENERIC_OBJECT_TYPE = exports.applyMapping = exports.importBoard = exports.schema = exports.entities = void 0;
+exports.BOARD_IMPORT_TOOL_CATEGORY = exports.registerBoardImportTools = exports.DefaultBoardImportAI = exports.getAIClient = exports.setAIClient = exports.clearAllRegistries = exports.clear3DPresets = exports.clearSubscriptionRules = exports.clearImportRules = exports.findSubscriptionRule = exports.find3DPreset = exports.get3DPresets = exports.getSubscriptionRules = exports.getImportRules = exports.register3DPresets = exports.registerSubscriptionRules = exports.registerImportRules = exports.ImageAdapter = exports.DxfAdapter = exports.CORE_PLACEHOLDER_TYPES = exports.isPlaceholderType = exports.convertPlaceholderTo = exports.convertGenericTo = exports.applyDataBinding = exports.assembleBoard = exports.DEFAULT_CATEGORY_FALLBACK = exports.GENERIC_OBJECT_TYPE = exports.applyMapping = exports.importBoard = exports.schema = exports.entities = void 0;
 const tslib_1 = require("tslib");
 // ImportSession (비동기 import) — things-factory 모듈 통합용
 const index_1 = require("./import-session/index");
@@ -23,7 +23,6 @@ Object.defineProperty(exports, "applyDataBinding", { enumerable: true, get: func
 var generic_to_1 = require("./converters/generic-to");
 Object.defineProperty(exports, "convertGenericTo", { enumerable: true, get: function () { return generic_to_1.convertGenericTo; } });
 Object.defineProperty(exports, "convertPlaceholderTo", { enumerable: true, get: function () { return generic_to_1.convertPlaceholderTo; } });
-Object.defineProperty(exports, "attachGlbToPlaceholder", { enumerable: true, get: function () { return generic_to_1.attachGlbToPlaceholder; } });
 Object.defineProperty(exports, "isPlaceholderType", { enumerable: true, get: function () { return generic_to_1.isPlaceholderType; } });
 Object.defineProperty(exports, "CORE_PLACEHOLDER_TYPES", { enumerable: true, get: function () { return generic_to_1.CORE_PLACEHOLDER_TYPES; } });
 // Adapters

package/dist-server/service/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;AAAA,qDAAqD;AACrD,kDAG+B;AAC/B,iEAAsC;AAEzB,QAAA,QAAQ,GAAG,CAAC,GAAG,gBAAqB,CAAC,CAAA;AACrC,QAAA,MAAM,GAAG,EAAE,eAAe,EAAE,CAAC,GAAG,uBAA4B,CAAC,EAAE,CAAA;AAE5E,wBAAwB;AACxB,0CAA8C;AAArC,oGAAA,WAAW,OAAA;AAGpB,sBAAsB;AACtB,4DAIkC;AAHhC,8GAAA,YAAY,OAAA;AACZ,qHAAA,mBAAmB,OAAA;AACnB,2HAAA,yBAAyB,OAAA;AAE3B,wDAAuD;AAA9C,6GAAA,aAAa,OAAA;AACtB,4DAA4D;AAAnD,kHAAA,gBAAgB,OAAA;AAKzB,aAAa;AACb,sDAMgC;AAL9B,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,oHAAA,sBAAsB,OAAA;AACtB,+GAAA,iBAAiB,OAAA;AACjB,oHAAA,sBAAsB,OAAA;AAIxB,WAAW;AACX,sDAAmD;AAA1C,yGAAA,UAAU,OAAA;AACnB,0DAAuD;AAA9C,6GAAA,YAAY,OAAA;AAErB,WAAW;AACX,0CAayB;AAZvB,4GAAA,mBAAmB,OAAA;AACnB,kHAAA,yBAAyB,OAAA;AACzB,0GAAA,iBAAiB,OAAA;AACjB,uGAAA,cAAc,OAAA;AACd,6GAAA,oBAAoB,OAAA;AACpB,qGAAA,YAAY,OAAA;AACZ,qGAAA,YAAY,OAAA;AACZ,6GAAA,oBAAoB,OAAA;AACpB,yGAAA,gBAAgB,OAAA;AAChB,+GAAA,sBAAsB,OAAA;AACtB,uGAAA,cAAc,OAAA;AACd,2GAAA,kBAAkB,OAAA;AAsCpB,gFAAgF;AAChF,oCAImB;AAHjB,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,6GAAA,oBAAoB,OAAA;AAGtB,0DAA0D;AAC1D,oEAAoE;AACpE,+CAGuB;AAFrB,wHAAA,wBAAwB,OAAA;AACxB,0HAAA,0BAA0B,OAAA","sourcesContent":["// ImportSession (비동기 import) — things-factory 모듈 통합용\nimport {\n  entities as ImportSessionEntities,\n  resolverClasses as ImportSessionResolverClasses\n} from './import-session/index'\nexport * from './import-session/index'\n\nexport const entities = [...ImportSessionEntities]\nexport const schema = { resolverClasses: [...ImportSessionResolverClasses] }\n\n// Pipeline (high-level)\nexport { importBoard } from './pipeline/index'\nexport type { ImportOptions, ImportResult } from './pipeline/index'\n\n// Stage 별 (low-level)\nexport {\n  applyMapping,\n  GENERIC_OBJECT_TYPE,\n  DEFAULT_CATEGORY_FALLBACK\n} from './pipeline/stage2-mapping'\nexport { assembleBoard } from './pipeline/stage3-board'\nexport { applyDataBinding } from './pipeline/stage4-binding'\nexport type { BoardModel, BoardComponent, AssembleOptions } from './pipeline/stage3-board'\nexport type { MappingOptions } from './pipeline/stage2-mapping'\nexport type { BindingOptions } from './pipeline/stage4-binding'\n\n// Converters\nexport {\n  convertGenericTo,         // deprecated alias — keep for backward-compat\n  convertPlaceholderTo,\n  attachGlbToPlaceholder,\n  isPlaceholderType,\n  CORE_PLACEHOLDER_TYPES\n} from './converters/generic-to'\nexport type { ConvertOptions, AttachGlbOptions } from './converters/generic-to'\n\n// Adapters\nexport { DxfAdapter } from './adapters/dxf-adapter'\nexport { ImageAdapter } from './adapters/image-adapter'\n\n// Registry\nexport {\n  registerImportRules,\n  registerSubscriptionRules,\n  register3DPresets,\n  getImportRules,\n  getSubscriptionRules,\n  get3DPresets,\n  find3DPreset,\n  findSubscriptionRule,\n  clearImportRules,\n  clearSubscriptionRules,\n  clear3DPresets,\n  clearAllRegistries\n} from './registry/index'\n\n// Types — Universal Entity\nexport type {\n  EntityKind,\n  EntityAttribs,\n  EntityRelation,\n  Vec2,\n  Vec3,\n  Size2,\n  Size3,\n  BoundingBox,\n  UniversalEntity,\n  ParseResult,\n  AdapterMetadata,\n  ParseOptions,\n  AdapterInput,\n  FormatAdapter,\n  AdapterCapabilities\n} from './types/index'\n\n// Types — Registry\nexport type {\n  ComponentCategory,\n  ImportRule,\n  ImportMatcher,\n  ImportBuildSpec,\n  IdStrategy,\n  ComponentDraft,\n  ThreeDPreset,\n  ThreeDGeometry,\n  ThreeDMaterial,\n  SubscriptionRule,\n  MappingResult,\n  MappingWarning\n} from './types/registry'\n\n// AI domain interface (Phase 3+) — provider 추상화는 @things-factory/ai-client-base\nexport {\n  setAIClient,\n  getAIClient,\n  DefaultBoardImportAI\n} from './ai/types'\n\n// LLM tool 노출 — board-ai 의 chat 흐름이 자동 dispatch 가능하도록 등록.\n// import 시 module side-effect 로 registerToolCategory 발동. 명시 호출도 가능.\nexport {\n  registerBoardImportTools,\n  BOARD_IMPORT_TOOL_CATEGORY\n} from './import-tools'\nexport type {\n  BoardImportAI,\n  AIClient, // deprecated alias for BoardImportAI\n  ConventionInferenceOptions,\n  RuleSuggestion,\n  ClassificationOptions,\n  LabeledEntity,\n  EntityClassification,\n  ImageParseOptions\n} from './ai/types'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;AAAA,qDAAqD;AACrD,kDAG+B;AAC/B,iEAAsC;AAEzB,QAAA,QAAQ,GAAG,CAAC,GAAG,gBAAqB,CAAC,CAAA;AACrC,QAAA,MAAM,GAAG,EAAE,eAAe,EAAE,CAAC,GAAG,uBAA4B,CAAC,EAAE,CAAA;AAE5E,wBAAwB;AACxB,0CAA8C;AAArC,oGAAA,WAAW,OAAA;AAGpB,sBAAsB;AACtB,4DAIkC;AAHhC,8GAAA,YAAY,OAAA;AACZ,qHAAA,mBAAmB,OAAA;AACnB,2HAAA,yBAAyB,OAAA;AAE3B,wDAAuD;AAA9C,6GAAA,aAAa,OAAA;AACtB,4DAA4D;AAAnD,kHAAA,gBAAgB,OAAA;AAKzB,aAAa;AACb,sDAKgC;AAJ9B,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,+GAAA,iBAAiB,OAAA;AACjB,oHAAA,sBAAsB,OAAA;AAIxB,WAAW;AACX,sDAAmD;AAA1C,yGAAA,UAAU,OAAA;AACnB,0DAAuD;AAA9C,6GAAA,YAAY,OAAA;AAErB,WAAW;AACX,0CAayB;AAZvB,4GAAA,mBAAmB,OAAA;AACnB,kHAAA,yBAAyB,OAAA;AACzB,0GAAA,iBAAiB,OAAA;AACjB,uGAAA,cAAc,OAAA;AACd,6GAAA,oBAAoB,OAAA;AACpB,qGAAA,YAAY,OAAA;AACZ,qGAAA,YAAY,OAAA;AACZ,6GAAA,oBAAoB,OAAA;AACpB,yGAAA,gBAAgB,OAAA;AAChB,+GAAA,sBAAsB,OAAA;AACtB,uGAAA,cAAc,OAAA;AACd,2GAAA,kBAAkB,OAAA;AAsCpB,gFAAgF;AAChF,oCAImB;AAHjB,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,6GAAA,oBAAoB,OAAA;AAGtB,0DAA0D;AAC1D,oEAAoE;AACpE,+CAGuB;AAFrB,wHAAA,wBAAwB,OAAA;AACxB,0HAAA,0BAA0B,OAAA","sourcesContent":["// ImportSession (비동기 import) — things-factory 모듈 통합용\nimport {\n  entities as ImportSessionEntities,\n  resolverClasses as ImportSessionResolverClasses\n} from './import-session/index'\nexport * from './import-session/index'\n\nexport const entities = [...ImportSessionEntities]\nexport const schema = { resolverClasses: [...ImportSessionResolverClasses] }\n\n// Pipeline (high-level)\nexport { importBoard } from './pipeline/index'\nexport type { ImportOptions, ImportResult } from './pipeline/index'\n\n// Stage 별 (low-level)\nexport {\n  applyMapping,\n  GENERIC_OBJECT_TYPE,\n  DEFAULT_CATEGORY_FALLBACK\n} from './pipeline/stage2-mapping'\nexport { assembleBoard } from './pipeline/stage3-board'\nexport { applyDataBinding } from './pipeline/stage4-binding'\nexport type { BoardModel, BoardComponent, AssembleOptions } from './pipeline/stage3-board'\nexport type { MappingOptions } from './pipeline/stage2-mapping'\nexport type { BindingOptions } from './pipeline/stage4-binding'\n\n// Converters\nexport {\n  convertGenericTo,         // deprecated alias — keep for backward-compat\n  convertPlaceholderTo,\n  isPlaceholderType,\n  CORE_PLACEHOLDER_TYPES\n} from './converters/generic-to'\nexport type { ConvertOptions } from './converters/generic-to'\n\n// Adapters\nexport { DxfAdapter } from './adapters/dxf-adapter'\nexport { ImageAdapter } from './adapters/image-adapter'\n\n// Registry\nexport {\n  registerImportRules,\n  registerSubscriptionRules,\n  register3DPresets,\n  getImportRules,\n  getSubscriptionRules,\n  get3DPresets,\n  find3DPreset,\n  findSubscriptionRule,\n  clearImportRules,\n  clearSubscriptionRules,\n  clear3DPresets,\n  clearAllRegistries\n} from './registry/index'\n\n// Types — Universal Entity\nexport type {\n  EntityKind,\n  EntityAttribs,\n  EntityRelation,\n  Vec2,\n  Vec3,\n  Size2,\n  Size3,\n  BoundingBox,\n  UniversalEntity,\n  ParseResult,\n  AdapterMetadata,\n  ParseOptions,\n  AdapterInput,\n  FormatAdapter,\n  AdapterCapabilities\n} from './types/index'\n\n// Types — Registry\nexport type {\n  ComponentCategory,\n  ImportRule,\n  ImportMatcher,\n  ImportBuildSpec,\n  IdStrategy,\n  ComponentDraft,\n  ThreeDPreset,\n  ThreeDGeometry,\n  ThreeDMaterial,\n  SubscriptionRule,\n  MappingResult,\n  MappingWarning\n} from './types/registry'\n\n// AI domain interface (Phase 3+) — provider 추상화는 @things-factory/ai-client-base\nexport {\n  setAIClient,\n  getAIClient,\n  DefaultBoardImportAI\n} from './ai/types'\n\n// LLM tool 노출 — board-ai 의 chat 흐름이 자동 dispatch 가능하도록 등록.\n// import 시 module side-effect 로 registerToolCategory 발동. 명시 호출도 가능.\nexport {\n  registerBoardImportTools,\n  BOARD_IMPORT_TOOL_CATEGORY\n} from './import-tools'\nexport type {\n  BoardImportAI,\n  AIClient, // deprecated alias for BoardImportAI\n  ConventionInferenceOptions,\n  RuleSuggestion,\n  ClassificationOptions,\n  LabeledEntity,\n  EntityClassification,\n  ImageParseOptions\n} from './ai/types'\n"]}