@things-factory/board-import 10.0.0-beta.108

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/pipeline/index.ts"],"names":[],"mappings":";;;AA8EA,kCAYC;AAQD,kDAoEC;AAtKD;;;;;;;;;;GAUG;AACH,yDAAoD;AACpD,6DAAwD;AAGxD,qDAA+C;AAC/C,iDAAqF;AACrF,qDAAmD;AAsDnD,iEAAiE;AACjE,2DAA2D;AAC3D,8CAA8C;AAC9C,EAAE;AACF,4EAA4E;AAC/D,QAAA,gBAAgB,GAAoB,CAAC,IAAI,wBAAU,EAAE,EAAE,IAAI,4BAAY,EAAE,CAAC,CAAA;AAEhF,KAAK,UAAU,WAAW,CAAC,IAAmB;IACnD,0DAA0D;IAC1D,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAA;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACjD,CAAC;IACD,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,mBAAmB,CAAC,IAAmB;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC7E,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;IAElE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IAChE,MAAM,UAAU,GAAG;QACjB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAA;IACD,MAAM,eAAe,GAAoB;QACvC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,IAAI;QAC7C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;QACtB,UAAU;KACX,CAAA;IAED,8CAA8C;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,QAAQ,GAAoB,EAAE,CAAA;QACpC,MAAM,QAAQ,GAAoB,EAAE,CAAA;QACpC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAChC,qCAAqC;YACrC,MAAM,aAAa,GAAgB;gBACjC,GAAG,MAAM;gBACT,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;aAC5B,CAAA;YACD,MAAM,OAAO,GAAG,IAAA,6BAAY,EAAC,aAAa,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;YACpE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACtB,IAAI,UAAU,GAAG,IAAA,4BAAa,EAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;YACvF,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;gBAChC,UAAU,GAAG,IAAA,iCAAgB,EAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;YACpE,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;gBACxC,cAAc,EAAE,CAAC,CAAC,cAAc;gBAChC,UAAU;gBACV,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IAC9C,CAAC;IAED,iDAAiD;IACjD,MAAM,OAAO,GAAG,IAAA,6BAAY,EAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IAC7D,IAAI,UAAU,GAAG,IAAA,4BAAa,EAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;IAChF,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;QAChC,UAAU,GAAG,IAAA,iCAAgB,EAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,EAAE,EAAE,SAAS;gBACb,KAAK,EAAE,SAAS;gBAChB,UAAU;gBACV,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,KAAK,EAAE,MAAM;KACd,CAAA;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,IAAkB,EAClB,QAAiB;IAEjB,KAAK,MAAM,CAAC,IAAI,wBAAgB,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;YAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,mDAA+C;AAAtC,8GAAA,YAAY,OAAA;AACrB,+CAA8C;AAArC,6GAAA,aAAa,OAAA;AACtB,mDAAmD;AAA1C,kHAAA,gBAAgB,OAAA","sourcesContent":["/**\n * High-level Pipeline — 도면 한 장 → 운영 가능한 Board Model.\n *\n * 백엔드에서 호출:\n * ```ts\n * import { importBoard } from '@things-factory/board-import'\n *\n * const buf = await fs.promises.readFile(path)\n * const result = await importBoard({ file: buf, filename: 'plant.dxf', scopes: ['fmsim'] })\n * ```\n */\nimport { DxfAdapter } from '../adapters/dxf-adapter'\nimport { ImageAdapter } from '../adapters/image-adapter'\nimport type { AdapterInput, BoundingBox, FormatAdapter, ParseOptions, ParseResult } from '../types/index'\nimport type { MappingResult } from '../types/registry'\nimport { applyMapping } from './stage2-mapping'\nimport { assembleBoard, type AssembleOptions, type BoardModel } from './stage3-board'\nimport { applyDataBinding } from './stage4-binding'\n\nexport interface ImportOptions {\n  file: AdapterInput\n  filename?: string\n  /** 등록된 매핑 규칙의 어느 scope 를 사용할지 */\n  scopes?: string[]\n  /** 어댑터 옵션 (excludeLayers 등) */\n  parseOptions?: ParseOptions\n  /** 좌표 normalize (좌상단 0,0) */\n  normalizeOrigin?: boolean\n  /** Y 축 뒤집기 (CAD Y-up → scene Y-down) */\n  flipY?: boolean\n  /** scene unit 변환 배율 */\n  scale?: number\n  /** 데이터 바인딩 stage 적용 여부 */\n  applyBinding?: boolean\n  /** 사용자 정의 어댑터 (있으면 디폴트 검색 대신 사용) */\n  adapter?: FormatAdapter\n}\n\nexport interface ImportResult {\n  boardModel: BoardModel\n  mapping: MappingResult\n  parse: ParseResult\n}\n\n/**\n * 변환 시안 (variant) — AI 가 같은 도면을 다른 관점으로 해석한 결과. 사용자가 review 단계에서\n * 시각 비교 후 선택. parse 가 multi-variant 응답하면 (현재 ImageAdapter), 각 variant 마다\n * 독립 mapping + assemble. DXF 같은 single-variant adapter 는 1 boardModel 만.\n */\nexport interface VariantResult {\n  id: string\n  label: string\n  description?: string\n  /** 보드 정체성 — name 자동 추천 기반. */\n  subjectName?: string\n  /** 보드 정체성 — description 자동 추천 기반. */\n  subjectDescription?: string\n  /** AI 의 의도 narrative — review 카드 표시 (transient). */\n  importStrategy?: string\n  boardModel: BoardModel\n  /** mapping 통계 (시안별 — entities 가 다르므로 stats 도 다름). */\n  stats: MappingResult['stats']\n}\n\nexport interface ImportVariantsResult {\n  variants: VariantResult[]\n  /** 각 시안의 mapping 결과 묶음. variants[i] 와 같은 인덱스. */\n  mappings: MappingResult[]\n  parse: ParseResult\n}\n\n// Adapter detection 순서가 중요: 정밀 형식 (DXF) 먼저, 폴백 / 비정형 (Image) 나중.\n// detect() 가 filename 확장자 우선이라 충돌은 거의 없지만, 시그니처 모호한 경우 (예:\n// 확장자 없는 binary stream) 도 정밀 형식이 먼저 잡히는 게 안전.\n//\n// import-tools.ts 의 listImportAdapters builder 가 본 배열을 inspect — 외부 export.\nexport const DEFAULT_ADAPTERS: FormatAdapter[] = [new DxfAdapter(), new ImageAdapter()]\n\nexport async function importBoard(opts: ImportOptions): Promise<ImportResult> {\n  // 단일 변형 — multi-variant adapter 라도 첫 시안만 반환. back-compat.\n  const result = await importBoardVariants(opts)\n  const first = result.variants[0]\n  if (!first) {\n    throw new Error('Import produced no variants.')\n  }\n  return {\n    boardModel: first.boardModel,\n    mapping: result.mappings[0],\n    parse: result.parse\n  }\n}\n\n/**\n * 다중 시안 import — parse 1번 (비싼 VLM/DXF), 시안별 mapping + assemble.\n *\n * AI multi-variant adapter (ImageAdapter) 는 parse.variants 에 N 시안 반환 → 각각 mapping +\n * assemble. Single-variant adapter (DxfAdapter) 는 parse.variants 미존재 → 단일 시안 1 boardModel.\n */\nexport async function importBoardVariants(opts: ImportOptions): Promise<ImportVariantsResult> {\n  const adapter = opts.adapter ?? (await pickAdapter(opts.file, opts.filename))\n  if (!adapter) throw new Error('지원되지 않는 도면 형식이거나 어댑터를 식별할 수 없습니다.')\n\n  const parsed = await adapter.parse(opts.file, opts.parseOptions)\n  const importMeta = {\n    format: adapter.format,\n    sourceBbox: parsed.bbox,\n    units: parsed.units,\n    importedAt: new Date().toISOString()\n  }\n  const assembleOptions: AssembleOptions = {\n    scopes: opts.scopes,\n    normalizeOrigin: opts.normalizeOrigin ?? true,\n    flipY: opts.flipY ?? true,\n    scale: opts.scale ?? 1,\n    importMeta\n  }\n\n  // multi-variant adapter — parse.variants 가 존재\n  if (Array.isArray(parsed.variants) && parsed.variants.length > 0) {\n    const variants: VariantResult[] = []\n    const mappings: MappingResult[] = []\n    for (const v of parsed.variants) {\n      // 각 시안의 entities 로 mapping (시안별로 다름)\n      const variantParsed: ParseResult = {\n        ...parsed,\n        entities: v.entities,\n        bbox: v.bbox ?? parsed.bbox\n      }\n      const mapping = applyMapping(variantParsed, { scopes: opts.scopes })\n      mappings.push(mapping)\n      let boardModel = assembleBoard(mapping.components, variantParsed.bbox, assembleOptions)\n      if (opts.applyBinding !== false) {\n        boardModel = applyDataBinding(boardModel, { scopes: opts.scopes })\n      }\n      variants.push({\n        id: v.id,\n        label: v.label,\n        description: v.description,\n        subjectName: v.subjectName,\n        subjectDescription: v.subjectDescription,\n        importStrategy: v.importStrategy,\n        boardModel,\n        stats: mapping.stats\n      })\n    }\n    return { variants, mappings, parse: parsed }\n  }\n\n  // single-variant adapter (DXF 등) — 단일 boardModel\n  const mapping = applyMapping(parsed, { scopes: opts.scopes })\n  let boardModel = assembleBoard(mapping.components, parsed.bbox, assembleOptions)\n  if (opts.applyBinding !== false) {\n    boardModel = applyDataBinding(boardModel, { scopes: opts.scopes })\n  }\n  return {\n    variants: [\n      {\n        id: 'default',\n        label: 'default',\n        boardModel,\n        stats: mapping.stats\n      }\n    ],\n    mappings: [mapping],\n    parse: parsed\n  }\n}\n\nasync function pickAdapter(\n  file: AdapterInput,\n  filename?: string\n): Promise<FormatAdapter | undefined> {\n  for (const a of DEFAULT_ADAPTERS) {\n    if (await a.detect(file, filename)) return a\n  }\n  return undefined\n}\n\nexport { applyMapping } from './stage2-mapping'\nexport { assembleBoard } from './stage3-board'\nexport { applyDataBinding } from './stage4-binding'\nexport type { BoardModel, BoardComponent, AssembleOptions } from './stage3-board'\nexport type { MappingOptions } from './stage2-mapping'\nexport type { BindingOptions } from './stage4-binding'\n"]}

package/dist-server/service/pipeline/stage2-mapping.d.ts

@@ -0,0 +1,29 @@
+import type { ParseResult } from '../types/index';
+import type { ComponentCategory, MappingResult } from '../types/registry';
+/**
+ * 매핑되지 않은 entity 가 변환되는 placeholder 도메인 type.
+ *
+ * 반드시 things-scene 의 `Component.register('placeholder', Placeholder)` 에서 쓰는
+ * **kebab-case** 와 일치해야 한다.
+ */
+export declare const GENERIC_OBJECT_TYPE = "placeholder";
+/**
+ * 카테고리 힌트 → fallback placeholder type 의 코어 기본 매핑.
+ */
+export declare const DEFAULT_CATEGORY_FALLBACK: Record<ComponentCategory, string>;
+export interface MappingOptions {
+    /** 어떤 scope 의 규칙을 사용할지 (생략 시 전부) */
+    scopes?: string[];
+    /**
+     * 매칭 안 된 entity 를 placeholder 로 변환할지 여부 (default: true).
+     * false 면 buffer 에서 제외되고 stats.skipped 로 카운트.
+     */
+    emitGeneric?: boolean;
+    /**
+     * 카테고리 힌트(`entity.attribs.categoryHint`) → fallback placeholder type override.
+     * `DEFAULT_CATEGORY_FALLBACK` 와 머지되어 사용. 도메인 패키지가 자기 추상 type 을
+     * 사용하고 싶을 때 명시 (예: `{ vehicle: 'GenericTransport' }`).
+     */
+    categoryFallback?: Partial<Record<ComponentCategory, string>>;
+}
+export declare function applyMapping(parsed: ParseResult, options?: MappingOptions): MappingResult;

package/dist-server/service/pipeline/stage2-mapping.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CATEGORY_FALLBACK = exports.GENERIC_OBJECT_TYPE = void 0;
+exports.applyMapping = applyMapping;
+/**
+ * Stage 2 — Universal Entities → Component Drafts.
+ * 등록된 ImportRule 들을 entity 마다 평가하여 컴포넌트 type 결정.
+ */
+const index_1 = require("../registry/index");
+/**
+ * 매핑되지 않은 entity 가 변환되는 placeholder 도메인 type.
+ *
+ * 반드시 things-scene 의 `Component.register('placeholder', Placeholder)` 에서 쓰는
+ * **kebab-case** 와 일치해야 한다.
+ */
+exports.GENERIC_OBJECT_TYPE = 'placeholder';
+/**
+ * 카테고리 힌트 → fallback placeholder type 의 코어 기본 매핑.
+ */
+exports.DEFAULT_CATEGORY_FALLBACK = {
+    vehicle: 'placeholder',
+    equipment: 'placeholder',
+    container: 'placeholder',
+    io: 'placeholder',
+    structure: 'placeholder',
+    path: 'placeholder',
+    region: 'placeholder',
+    marker: 'placeholder',
+    unknown: exports.GENERIC_OBJECT_TYPE
+};
+function applyMapping(parsed, options = {}) {
+    const rules = (0, index_1.getImportRules)(options.scopes)
+        .slice()
+        .sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+    const components = [];
+    const warnings = [];
+    const stats = { total: parsed.entities.length, matched: 0, generic: 0, skipped: 0 };
+    const usedIds = new Map();
+    const emitGeneric = options.emitGeneric !== false;
+    const fallbackTable = { ...exports.DEFAULT_CATEGORY_FALLBACK, ...(options.categoryFallback || {}) };
+    for (const entity of parsed.entities) {
+        const rule = rules.find(r => matchRule(r.match, entity));
+        if (!rule) {
+            if (!emitGeneric) {
+                stats.skipped++;
+                continue;
+            }
+            const hint = entity.attribs.categoryHint || 'unknown';
+            const fallbackType = fallbackTable[hint] || fallbackTable.unknown;
+            const draft = makeGenericDraft(entity, usedIds, fallbackType, hint);
+            components.push(draft);
+            stats.generic++;
+            continue;
+        }
+        const id = resolveId(rule.build.idStrategy ?? 'auto', entity, rule.componentType, usedIds);
+        let draft = {
+            category: rule.category ?? 'unknown',
+            type: rule.componentType,
+            id,
+            state: { ...(rule.build.defaultState || {}) },
+            matchedBy: rule,
+            source: entity
+        };
+        if (rule.build.transform) {
+            try {
+                draft = rule.build.transform(entity, draft);
+            }
+            catch (e) {
+                warnings.push({
+                    level: 'warn',
+                    entity,
+                    message: `transform 실패 (${rule.componentType}): ${e.message}`
+                });
+            }
+        }
+        components.push(draft);
+        stats.matched++;
+    }
+    return { components, stats, warnings };
+}
+/**
+ * 매칭되지 않은 entity 를 placeholder draft 로 변환.
+ * 좌표·크기·원본 attribs 모두 보존하여 사후 변환 가능하게 한다.
+ *
+ * - `type`: 카테고리 힌트 fallback 매핑으로 결정 (기본 GenericObject).
+ * - `category`: 힌트 그대로 (없으면 'unknown') — 3D Preset 폴백에 사용됨.
+ * - state: placeholderLabel / placeholderHint 만 — 시각 표현은 컴포넌트 자체 render 가 담당.
+ *   things-scene 의 GenericObject 의 renderPlaceholder 가 theme.fill / theme.stroke
+ *   를 자체 적용하므로 state.fillStyle / strokeStyle / strokeDashArray 를 두면 Shape.postrender
+ *   가 그것을 추가로 적용해 시각 leak (보드 전체에 stale path 가 칠해지는 회귀) 가 발생.
+ */
+function makeGenericDraft(entity, usedIds, type = exports.GENERIC_OBJECT_TYPE, category = 'unknown') {
+    const id = resolveId('auto', entity, type, usedIds);
+    const placeholderLabel = entity.attribs.name || entity.attribs.layer || entity.attribs.text || '';
+    const placeholderHint = entity.attribs.layer || entity.attribs.name;
+    const baseState = {
+        placeholderLabel,
+        ...(placeholderHint ? { placeholderHint } : {})
+    };
+    return {
+        category,
+        type,
+        id,
+        state: baseState,
+        source: entity
+    };
+}
+// ── 매칭 로직 ──────────────────────────────────────────────────────
+function matchRule(matcher, entity) {
+    if (matcher.cad) {
+        const m = matcher.cad;
+        let ok = true;
+        if (m.blockNamePattern && !m.blockNamePattern.test(entity.attribs.name || ''))
+            ok = false;
+        if (m.layer && !matchString(m.layer, entity.attribs.layer || ''))
+            ok = false;
+        if (m.entityKinds && !m.entityKinds.includes(entity.kind))
+            ok = false;
+        if (m.textAdjacent) {
+            const adjacentText = (entity.neighbors || [])
+                .filter(r => r.relation === 'labeled-by')
+                .map(r => r.uid);
+            if (!adjacentText.some(t => m.textAdjacent.test(t)))
+                ok = false;
+        }
+        if (ok)
+            return true;
+    }
+    if (matcher.ifc) {
+        const m = matcher.ifc;
+        let ok = true;
+        if (m.ifcClass && !matchString(m.ifcClass, entity.attribs.semanticType || ''))
+            ok = false;
+        if (ok)
+            return true;
+    }
+    if (matcher.geometry) {
+        const g = matcher.geometry;
+        let ok = true;
+        if (g.shape && entity.attribs.shape !== g.shape)
+            ok = false;
+        if (g.sizeRange && entity.size) {
+            const area = entity.size.width * entity.size.height;
+            if (g.sizeRange.minArea !== undefined && area < g.sizeRange.minArea)
+                ok = false;
+            if (g.sizeRange.maxArea !== undefined && area > g.sizeRange.maxArea)
+                ok = false;
+        }
+        if (g.aspectRatio && entity.size) {
+            const ratio = entity.size.height === 0 ? 1 : entity.size.width / entity.size.height;
+            if (g.aspectRatio.min !== undefined && ratio < g.aspectRatio.min)
+                ok = false;
+            if (g.aspectRatio.max !== undefined && ratio > g.aspectRatio.max)
+                ok = false;
+        }
+        if (ok)
+            return true;
+    }
+    if (matcher.image && matcher.image.labels.length > 0) {
+        const label = entity.attribs.vlmLabel;
+        if (label && matcher.image.labels.includes(label))
+            return true;
+    }
+    return false;
+}
+function matchString(pattern, value) {
+    if (typeof pattern === 'string')
+        return pattern === value;
+    return pattern.test(value);
+}
+// ── ID 부여 전략 ──────────────────────────────────────────────────
+/**
+ * 컴포넌트 ID 부여.
+ *
+ * **정책: 의미 있는 ID 만 부여한다.** 의미 없는 시퀀스 (`generic-object-1`, `STK_002`) 는
+ * 사용자/시스템 혼동만 야기하고 운영 가치가 없다 — 차라리 미부여 (undefined) 가 낫다.
+ *
+ *   - **fromAttribute / fromAdjacentText / fromIfcGlobalId**: 명시 strategy — 해당 출처
+ *     사용. 없으면 undefined.
+ *   - **auto / default**: VLM 이 도면 텍스트 라벨을 추출해 attribs.name 에 채웠으면 그것 사용.
+ *     없으면 undefined.
+ *   - **custom**: 호출자 정의. 빈 결과면 undefined.
+ *
+ * 중복 ID 는 두 번째부터 undefined (이미 운영 ID 로 정확히 일치하는 게 있으니 새로 부여하면
+ * 잘못된 동일성 매칭 야기).
+ */
+function resolveId(strategy, entity, _type, usedIds) {
+    let id;
+    if (typeof strategy === 'object' && 'custom' in strategy) {
+        id = strategy.custom(entity);
+    }
+    else {
+        switch (strategy) {
+            case 'fromAttribute':
+                id = entity.attribs.name;
+                break;
+            case 'fromAdjacentText':
+                id = (entity.neighbors || []).find(r => r.relation === 'labeled-by')?.uid;
+                break;
+            case 'fromIfcGlobalId':
+                id = entity.attribs.ifcGlobalId;
+                break;
+            case 'auto':
+            default:
+                // VLM 이 도면 텍스트 라벨 추출했으면 그것. 없으면 ID 미부여.
+                id = entity.attribs.name;
+        }
+    }
+    if (id)
+        id = sanitizeId(id);
+    // 중복 회피 — 이미 사용된 ID 면 undefined (의미 없는 자동 변형 부여 X)
+    if (id && usedIds.has(id)) {
+        return undefined;
+    }
+    if (id)
+        usedIds.set(id, 1);
+    return id;
+}
+/**
+ * ID 정규화 — 알파넘 + 하이픈/언더스코어 만 허용. 공백 → 하이픈, 다른 특수문자 제거.
+ * 빈 결과면 undefined.
+ */
+function sanitizeId(raw) {
+    const cleaned = raw
+        .trim()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-zA-Z0-9_\-]/g, '')
+        .slice(0, 64);
+    return cleaned || undefined;
+}
+//# sourceMappingURL=stage2-mapping.js.map

package/dist-server/service/pipeline/stage2-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage2-mapping.js","sourceRoot":"","sources":["../../../server/service/pipeline/stage2-mapping.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Stage 2 — Universal Entities → Component Drafts.\n * 등록된 ImportRule 들을 entity 마다 평가하여 컴포넌트 type 결정.\n */\nimport { getImportRules } from '../registry/index'\nimport type { ParseResult, UniversalEntity } from '../types/index'\nimport type {\n  ComponentCategory,\n  ComponentDraft,\n  IdStrategy,\n  ImportMatcher,\n  MappingResult,\n  MappingWarning\n} from '../types/registry'\n\n/**\n * 매핑되지 않은 entity 가 변환되는 placeholder 도메인 type.\n *\n * 반드시 things-scene 의 `Component.register('placeholder', Placeholder)` 에서 쓰는\n * **kebab-case** 와 일치해야 한다.\n */\nexport const GENERIC_OBJECT_TYPE = 'placeholder'\n\n/**\n * 카테고리 힌트 → fallback placeholder type 의 코어 기본 매핑.\n */\nexport const DEFAULT_CATEGORY_FALLBACK: Record<ComponentCategory, string> = {\n  vehicle: 'placeholder',\n  equipment: 'placeholder',\n  container: 'placeholder',\n  io: 'placeholder',\n  structure: 'placeholder',\n  path: 'placeholder',\n  region: 'placeholder',\n  marker: 'placeholder',\n  unknown: GENERIC_OBJECT_TYPE\n}\n\nexport interface MappingOptions {\n  /** 어떤 scope 의 규칙을 사용할지 (생략 시 전부) */\n  scopes?: string[]\n  /**\n   * 매칭 안 된 entity 를 placeholder 로 변환할지 여부 (default: true).\n   * false 면 buffer 에서 제외되고 stats.skipped 로 카운트.\n   */\n  emitGeneric?: boolean\n  /**\n   * 카테고리 힌트(`entity.attribs.categoryHint`) → fallback placeholder type override.\n   * `DEFAULT_CATEGORY_FALLBACK` 와 머지되어 사용. 도메인 패키지가 자기 추상 type 을\n   * 사용하고 싶을 때 명시 (예: `{ vehicle: 'GenericTransport' }`).\n   */\n  categoryFallback?: Partial<Record<ComponentCategory, string>>\n}\n\nexport function applyMapping(parsed: ParseResult, options: MappingOptions = {}): MappingResult {\n  const rules = getImportRules(options.scopes)\n    .slice()\n    .sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0))\n\n  const components: ComponentDraft[] = []\n  const warnings: MappingWarning[] = []\n  const stats = { total: parsed.entities.length, matched: 0, generic: 0, skipped: 0 }\n\n  const usedIds = new Map<string, number>()\n  const emitGeneric = options.emitGeneric !== false\n  const fallbackTable = { ...DEFAULT_CATEGORY_FALLBACK, ...(options.categoryFallback || {}) }\n\n  for (const entity of parsed.entities) {\n    const rule = rules.find(r => matchRule(r.match, entity))\n\n    if (!rule) {\n      if (!emitGeneric) {\n        stats.skipped++\n        continue\n      }\n      const hint = (entity.attribs.categoryHint as ComponentCategory | undefined) || 'unknown'\n      const fallbackType = fallbackTable[hint] || fallbackTable.unknown\n      const draft = makeGenericDraft(entity, usedIds, fallbackType, hint)\n      components.push(draft)\n      stats.generic++\n      continue\n    }\n\n    const id = resolveId(rule.build.idStrategy ?? 'auto', entity, rule.componentType, usedIds)\n    let draft: ComponentDraft = {\n      category: rule.category ?? 'unknown',\n      type: rule.componentType,\n      id,\n      state: { ...(rule.build.defaultState || {}) },\n      matchedBy: rule,\n      source: entity\n    }\n\n    if (rule.build.transform) {\n      try {\n        draft = rule.build.transform(entity, draft)\n      } catch (e) {\n        warnings.push({\n          level: 'warn',\n          entity,\n          message: `transform 실패 (${rule.componentType}): ${(e as Error).message}`\n        })\n      }\n    }\n\n    components.push(draft)\n    stats.matched++\n  }\n\n  return { components, stats, warnings }\n}\n\n/**\n * 매칭되지 않은 entity 를 placeholder draft 로 변환.\n * 좌표·크기·원본 attribs 모두 보존하여 사후 변환 가능하게 한다.\n *\n * - `type`: 카테고리 힌트 fallback 매핑으로 결정 (기본 GenericObject).\n * - `category`: 힌트 그대로 (없으면 'unknown') — 3D Preset 폴백에 사용됨.\n * - state: placeholderLabel / placeholderHint 만 — 시각 표현은 컴포넌트 자체 render 가 담당.\n *   things-scene 의 GenericObject 의 renderPlaceholder 가 theme.fill / theme.stroke\n *   를 자체 적용하므로 state.fillStyle / strokeStyle / strokeDashArray 를 두면 Shape.postrender\n *   가 그것을 추가로 적용해 시각 leak (보드 전체에 stale path 가 칠해지는 회귀) 가 발생.\n */\nfunction makeGenericDraft(\n  entity: UniversalEntity,\n  usedIds: Map<string, number>,\n  type: string = GENERIC_OBJECT_TYPE,\n  category: ComponentCategory = 'unknown'\n): ComponentDraft {\n  const id = resolveId('auto', entity, type, usedIds)\n  const placeholderLabel =\n    entity.attribs.name || entity.attribs.layer || entity.attribs.text || ''\n  const placeholderHint = entity.attribs.layer || entity.attribs.name\n\n  const baseState: Record<string, any> = {\n    placeholderLabel,\n    ...(placeholderHint ? { placeholderHint } : {})\n  }\n\n  return {\n    category,\n    type,\n    id,\n    state: baseState,\n    source: entity\n  }\n}\n\n// ── 매칭 로직 ──────────────────────────────────────────────────────\n\nfunction matchRule(matcher: ImportMatcher, entity: UniversalEntity): boolean {\n  if (matcher.cad) {\n    const m = matcher.cad\n    let ok = true\n    if (m.blockNamePattern && !m.blockNamePattern.test(entity.attribs.name || '')) ok = false\n    if (m.layer && !matchString(m.layer, entity.attribs.layer || '')) ok = false\n    if (m.entityKinds && !m.entityKinds.includes(entity.kind)) ok = false\n    if (m.textAdjacent) {\n      const adjacentText = (entity.neighbors || [])\n        .filter(r => r.relation === 'labeled-by')\n        .map(r => r.uid)\n      if (!adjacentText.some(t => m.textAdjacent!.test(t))) ok = false\n    }\n    if (ok) return true\n  }\n\n  if (matcher.ifc) {\n    const m = matcher.ifc\n    let ok = true\n    if (m.ifcClass && !matchString(m.ifcClass, entity.attribs.semanticType || '')) ok = false\n    if (ok) return true\n  }\n\n  if (matcher.geometry) {\n    const g = matcher.geometry\n    let ok = true\n    if (g.shape && entity.attribs.shape !== g.shape) ok = false\n    if (g.sizeRange && entity.size) {\n      const area = entity.size.width * entity.size.height\n      if (g.sizeRange.minArea !== undefined && area < g.sizeRange.minArea) ok = false\n      if (g.sizeRange.maxArea !== undefined && area > g.sizeRange.maxArea) ok = false\n    }\n    if (g.aspectRatio && entity.size) {\n      const ratio = entity.size.height === 0 ? 1 : entity.size.width / entity.size.height\n      if (g.aspectRatio.min !== undefined && ratio < g.aspectRatio.min) ok = false\n      if (g.aspectRatio.max !== undefined && ratio > g.aspectRatio.max) ok = false\n    }\n    if (ok) return true\n  }\n\n  if (matcher.image && matcher.image.labels.length > 0) {\n    const label = entity.attribs.vlmLabel\n    if (label && matcher.image.labels.includes(label)) return true\n  }\n\n  return false\n}\n\nfunction matchString(pattern: string | RegExp, value: string): boolean {\n  if (typeof pattern === 'string') return pattern === value\n  return pattern.test(value)\n}\n\n// ── ID 부여 전략 ──────────────────────────────────────────────────\n\n/**\n * 컴포넌트 ID 부여.\n *\n * **정책: 의미 있는 ID 만 부여한다.** 의미 없는 시퀀스 (`generic-object-1`, `STK_002`) 는\n * 사용자/시스템 혼동만 야기하고 운영 가치가 없다 — 차라리 미부여 (undefined) 가 낫다.\n *\n *   - **fromAttribute / fromAdjacentText / fromIfcGlobalId**: 명시 strategy — 해당 출처\n *     사용. 없으면 undefined.\n *   - **auto / default**: VLM 이 도면 텍스트 라벨을 추출해 attribs.name 에 채웠으면 그것 사용.\n *     없으면 undefined.\n *   - **custom**: 호출자 정의. 빈 결과면 undefined.\n *\n * 중복 ID 는 두 번째부터 undefined (이미 운영 ID 로 정확히 일치하는 게 있으니 새로 부여하면\n * 잘못된 동일성 매칭 야기).\n */\nfunction resolveId(\n  strategy: IdStrategy,\n  entity: UniversalEntity,\n  _type: string,\n  usedIds: Map<string, number>\n): string | undefined {\n  let id: string | undefined\n\n  if (typeof strategy === 'object' && 'custom' in strategy) {\n    id = strategy.custom(entity)\n  } else {\n    switch (strategy) {\n      case 'fromAttribute':\n        id = entity.attribs.name\n        break\n      case 'fromAdjacentText':\n        id = (entity.neighbors || []).find(r => r.relation === 'labeled-by')?.uid\n        break\n      case 'fromIfcGlobalId':\n        id = entity.attribs.ifcGlobalId\n        break\n      case 'auto':\n      default:\n        // VLM 이 도면 텍스트 라벨 추출했으면 그것. 없으면 ID 미부여.\n        id = entity.attribs.name\n    }\n  }\n\n  if (id) id = sanitizeId(id)\n\n  // 중복 회피 — 이미 사용된 ID 면 undefined (의미 없는 자동 변형 부여 X)\n  if (id && usedIds.has(id)) {\n    return undefined\n  }\n  if (id) usedIds.set(id, 1)\n  return id\n}\n\n/**\n * ID 정규화 — 알파넘 + 하이픈/언더스코어 만 허용. 공백 → 하이픈, 다른 특수문자 제거.\n * 빈 결과면 undefined.\n */\nfunction sanitizeId(raw: string): string | undefined {\n  const cleaned = raw\n    .trim()\n    .replace(/\\s+/g, '-')\n    .replace(/[^a-zA-Z0-9_\\-]/g, '')\n    .slice(0, 64)\n  return cleaned || undefined\n}\n"]}

package/dist-server/service/pipeline/stage3-board.d.ts

@@ -0,0 +1,52 @@
+import type { BoundingBox } from '../types/index';
+import type { ComponentCategory, ComponentDraft } from '../types/registry';
+export interface BoardModel {
+    width?: number;
+    height?: number;
+    fillStyle?: string;
+    /**
+     * 컴포넌트 목록. things-scene 보드 모델 호환을 위해 optional.
+     * 빈 보드 / legacy 형식 / root container 가 직접 model 인 경우 누락 가능.
+     * 사용처는 항상 `(model.components ?? [])` 패턴으로 접근.
+     */
+    components?: BoardComponent[];
+    /** 메타: import 출처 */
+    importMeta?: {
+        format: string;
+        sourceBbox: BoundingBox;
+        units?: string;
+        importedAt: string;
+    };
+    /** things-scene / 사용자 도메인이 임의 추가하는 필드 */
+    [k: string]: any;
+}
+export interface BoardComponent {
+    /** Universal category — 모든 컴포넌트가 보유. 변환·렌더 정책의 기반. */
+    category: ComponentCategory;
+    /** 도메인 type. 'GenericObject' 면 변환 가능한 placeholder. */
+    type: string;
+    id?: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    rotation?: number;
+    /** 3D Preset 해석 결과 (있으면) */
+    threeD?: Record<string, any>;
+    [k: string]: any;
+}
+export interface AssembleOptions {
+    /** scope 들 — 3D preset 조회 시 사용 */
+    scopes?: string[];
+    /** 좌표계 정규화: true 면 entities 의 minX,minY 가 0,0 이 되도록 이동 */
+    normalizeOrigin?: boolean;
+    /** Y 축 뒤집기: CAD (Y-up) → scene (Y-down) */
+    flipY?: boolean;
+    /** 단위 → scene unit 변환 비율. 1 이면 그대로. */
+    scale?: number;
+    /** 보드 배경색 */
+    backgroundColor?: string;
+    /** importMeta 를 모델에 첨부 */
+    importMeta?: BoardModel['importMeta'];
+}
+export declare function assembleBoard(drafts: ComponentDraft[], bbox: BoundingBox, options?: AssembleOptions): BoardModel;

package/dist-server/service/pipeline/stage3-board.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assembleBoard = assembleBoard;
+/**
+ * Stage 3 — ComponentDraft → Board Model JSON.
+ * 좌표/단위 변환 + 3D Preset 적용.
+ */
+const index_1 = require("../registry/index");
+/**
+ * 보드 외곽 padding (양쪽). 컴포넌트가 root 가장자리에 정확히 맞닿지 않도록 살짝 여백.
+ * 너무 크면 빈 공간 낭비, 너무 작으면 시각적으로 갑갑함 → 40 unit.
+ */
+const BOARD_PADDING = 40;
+/**
+ * 빈 보드 / 너무 작은 컨텐츠일 때 fallback 크기.
+ * 최소 1000x1000 — things-scene 의 RootContainer 기본 크기에 맞춤.
+ */
+const MIN_BOARD_SIZE = 1000;
+function assembleBoard(drafts, bbox, options = {}) {
+    const scale = options.scale ?? 1;
+    const offsetX = options.normalizeOrigin ? -bbox.min.x : 0;
+    const offsetY = options.normalizeOrigin ? -bbox.min.y : 0;
+    // 1단계: bbox 기반 가설 board 크기. 그러나 entity bbox 와 position+size 가 어긋나는 경우
+    // 컴포넌트가 root 외곽으로 spill 할 수 있어 2단계에서 컴포넌트 실제 edge 로 보정한다.
+    let boardWidth = (bbox.max.x - bbox.min.x) * scale;
+    let boardHeight = (bbox.max.y - bbox.min.y) * scale;
+    const layouts = drafts.map(d => {
+        const src = d.source;
+        const left = src ? (src.position.x + offsetX) * scale : 0;
+        const rawTop = src ? (src.position.y + offsetY) * scale : 0;
+        const width = (src?.size?.width ?? 1) * scale;
+        const height = (src?.size?.height ?? 1) * scale;
+        return { d, src, left, rawTop, width, height };
+    });
+    // 2단계: 컴포넌트 실제 edge 로 board 크기 보정. bbox 보다 컴포넌트 right/bottom 이
+    // 크면 그것 기준. 모든 컴포넌트 left/top 도 음수 안 되도록 0 이상 보장 (있으면 offset 보정).
+    let computedRight = 0;
+    let computedBottom = 0;
+    let computedMinLeft = 0;
+    let computedMinTop = 0;
+    for (const l of layouts) {
+        if (l.left < computedMinLeft)
+            computedMinLeft = l.left;
+        if (l.rawTop < computedMinTop)
+            computedMinTop = l.rawTop;
+        if (l.left + l.width > computedRight)
+            computedRight = l.left + l.width;
+        if (l.rawTop + l.height > computedBottom)
+            computedBottom = l.rawTop + l.height;
+    }
+    // 음수 left/top 이 있으면 추가 offset 으로 0 으로 끌어올림.
+    const extraOffsetX = computedMinLeft < 0 ? -computedMinLeft : 0;
+    const extraOffsetY = computedMinTop < 0 ? -computedMinTop : 0;
+    if (extraOffsetX || extraOffsetY) {
+        for (const l of layouts) {
+            l.left += extraOffsetX;
+            l.rawTop += extraOffsetY;
+        }
+        computedRight += extraOffsetX;
+        computedBottom += extraOffsetY;
+    }
+    // 최종 board 크기 — bbox 와 컴포넌트 실제 max edge 중 큰 값 + padding.
+    // 컴포넌트 없으면 padding 의미 없고, fallback 으로 MIN_BOARD_SIZE.
+    boardWidth = Math.max(boardWidth, computedRight);
+    boardHeight = Math.max(boardHeight, computedBottom);
+    if (layouts.length > 0) {
+        boardWidth += BOARD_PADDING * 2;
+        boardHeight += BOARD_PADDING * 2;
+    }
+    boardWidth = Math.max(boardWidth, MIN_BOARD_SIZE);
+    boardHeight = Math.max(boardHeight, MIN_BOARD_SIZE);
+    // 3단계: padding 만큼 모든 컴포넌트 안쪽으로 평행이동 + flipY 적용.
+    const components = layouts.map(({ d, src, left, rawTop, width, height }) => {
+        const finalLeft = left + BOARD_PADDING;
+        const finalRawTop = rawTop + BOARD_PADDING;
+        const finalTop = options.flipY ? boardHeight - finalRawTop - height : finalRawTop;
+        const rotation = src?.rotation;
+        const preset = (0, index_1.find3DPreset)(d.type, d.category, options.scopes);
+        const threeD = presetToState(preset);
+        return {
+            category: d.category,
+            type: d.type,
+            id: d.id,
+            left: finalLeft,
+            top: finalTop,
+            width,
+            height,
+            ...(rotation !== undefined && { rotation: options.flipY ? -rotation : rotation }),
+            threeD,
+            ...d.state
+        };
+    });
+    return {
+        width: boardWidth,
+        height: boardHeight,
+        fillStyle: options.backgroundColor ?? '#ffffff',
+        components,
+        importMeta: options.importMeta
+    };
+}
+function presetToState(preset) {
+    return {
+        geometry: preset.geometry,
+        ...(preset.material && { material: preset.material }),
+        origin: preset.origin ?? 'bottom'
+    };
+}
+//# sourceMappingURL=stage3-board.js.map

package/dist-server/service/pipeline/stage3-board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage3-board.js","sourceRoot":"","sources":["../../../server/service/pipeline/stage3-board.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Stage 3 — ComponentDraft → Board Model JSON.\n * 좌표/단위 변환 + 3D Preset 적용.\n */\nimport { find3DPreset } from '../registry/index'\nimport type { BoundingBox } from '../types/index'\nimport type { ComponentCategory, ComponentDraft } from '../types/registry'\n\nexport interface BoardModel {\n  width?: number\n  height?: number\n  fillStyle?: string\n  /**\n   * 컴포넌트 목록. things-scene 보드 모델 호환을 위해 optional.\n   * 빈 보드 / legacy 형식 / root container 가 직접 model 인 경우 누락 가능.\n   * 사용처는 항상 `(model.components ?? [])` 패턴으로 접근.\n   */\n  components?: BoardComponent[]\n  /** 메타: import 출처 */\n  importMeta?: {\n    format: string\n    sourceBbox: BoundingBox\n    units?: string\n    importedAt: string\n  }\n  /** things-scene / 사용자 도메인이 임의 추가하는 필드 */\n  [k: string]: any\n}\n\nexport interface BoardComponent {\n  /** Universal category — 모든 컴포넌트가 보유. 변환·렌더 정책의 기반. */\n  category: ComponentCategory\n  /** 도메인 type. 'GenericObject' 면 변환 가능한 placeholder. */\n  type: string\n  id?: string\n  left: number\n  top: number\n  width: number\n  height: number\n  rotation?: number\n  /** 3D Preset 해석 결과 (있으면) */\n  threeD?: Record<string, any>\n  [k: string]: any\n}\n\nexport interface AssembleOptions {\n  /** scope 들 — 3D preset 조회 시 사용 */\n  scopes?: string[]\n  /** 좌표계 정규화: true 면 entities 의 minX,minY 가 0,0 이 되도록 이동 */\n  normalizeOrigin?: boolean\n  /** Y 축 뒤집기: CAD (Y-up) → scene (Y-down) */\n  flipY?: boolean\n  /** 단위 → scene unit 변환 비율. 1 이면 그대로. */\n  scale?: number\n  /** 보드 배경색 */\n  backgroundColor?: string\n  /** importMeta 를 모델에 첨부 */\n  importMeta?: BoardModel['importMeta']\n}\n\n/**\n * 보드 외곽 padding (양쪽). 컴포넌트가 root 가장자리에 정확히 맞닿지 않도록 살짝 여백.\n * 너무 크면 빈 공간 낭비, 너무 작으면 시각적으로 갑갑함 → 40 unit.\n */\nconst BOARD_PADDING = 40\n\n/**\n * 빈 보드 / 너무 작은 컨텐츠일 때 fallback 크기.\n * 최소 1000x1000 — things-scene 의 RootContainer 기본 크기에 맞춤.\n */\nconst MIN_BOARD_SIZE = 1000\n\nexport function assembleBoard(\n  drafts: ComponentDraft[],\n  bbox: BoundingBox,\n  options: AssembleOptions = {}\n): BoardModel {\n  const scale = options.scale ?? 1\n  const offsetX = options.normalizeOrigin ? -bbox.min.x : 0\n  const offsetY = options.normalizeOrigin ? -bbox.min.y : 0\n\n  // 1단계: bbox 기반 가설 board 크기. 그러나 entity bbox 와 position+size 가 어긋나는 경우\n  // 컴포넌트가 root 외곽으로 spill 할 수 있어 2단계에서 컴포넌트 실제 edge 로 보정한다.\n  let boardWidth = (bbox.max.x - bbox.min.x) * scale\n  let boardHeight = (bbox.max.y - bbox.min.y) * scale\n\n  // 1.5단계: 컴포넌트 layout 1차 (flipY 미적용 — boardHeight 확정 전이라 미루기).\n  type Layout = {\n    d: ComponentDraft\n    src: ComponentDraft['source']\n    left: number\n    rawTop: number\n    width: number\n    height: number\n  }\n  const layouts: Layout[] = drafts.map(d => {\n    const src = d.source\n    const left = src ? (src.position.x + offsetX) * scale : 0\n    const rawTop = src ? (src.position.y + offsetY) * scale : 0\n    const width = (src?.size?.width ?? 1) * scale\n    const height = (src?.size?.height ?? 1) * scale\n    return { d, src, left, rawTop, width, height }\n  })\n\n  // 2단계: 컴포넌트 실제 edge 로 board 크기 보정. bbox 보다 컴포넌트 right/bottom 이\n  // 크면 그것 기준. 모든 컴포넌트 left/top 도 음수 안 되도록 0 이상 보장 (있으면 offset 보정).\n  let computedRight = 0\n  let computedBottom = 0\n  let computedMinLeft = 0\n  let computedMinTop = 0\n  for (const l of layouts) {\n    if (l.left < computedMinLeft) computedMinLeft = l.left\n    if (l.rawTop < computedMinTop) computedMinTop = l.rawTop\n    if (l.left + l.width > computedRight) computedRight = l.left + l.width\n    if (l.rawTop + l.height > computedBottom) computedBottom = l.rawTop + l.height\n  }\n  // 음수 left/top 이 있으면 추가 offset 으로 0 으로 끌어올림.\n  const extraOffsetX = computedMinLeft < 0 ? -computedMinLeft : 0\n  const extraOffsetY = computedMinTop < 0 ? -computedMinTop : 0\n  if (extraOffsetX || extraOffsetY) {\n    for (const l of layouts) {\n      l.left += extraOffsetX\n      l.rawTop += extraOffsetY\n    }\n    computedRight += extraOffsetX\n    computedBottom += extraOffsetY\n  }\n\n  // 최종 board 크기 — bbox 와 컴포넌트 실제 max edge 중 큰 값 + padding.\n  // 컴포넌트 없으면 padding 의미 없고, fallback 으로 MIN_BOARD_SIZE.\n  boardWidth = Math.max(boardWidth, computedRight)\n  boardHeight = Math.max(boardHeight, computedBottom)\n  if (layouts.length > 0) {\n    boardWidth += BOARD_PADDING * 2\n    boardHeight += BOARD_PADDING * 2\n  }\n  boardWidth = Math.max(boardWidth, MIN_BOARD_SIZE)\n  boardHeight = Math.max(boardHeight, MIN_BOARD_SIZE)\n\n  // 3단계: padding 만큼 모든 컴포넌트 안쪽으로 평행이동 + flipY 적용.\n  const components: BoardComponent[] = layouts.map(({ d, src, left, rawTop, width, height }) => {\n    const finalLeft = left + BOARD_PADDING\n    const finalRawTop = rawTop + BOARD_PADDING\n    const finalTop = options.flipY ? boardHeight - finalRawTop - height : finalRawTop\n    const rotation = src?.rotation\n\n    const preset = find3DPreset(d.type, d.category, options.scopes)\n    const threeD = presetToState(preset)\n\n    return {\n      category: d.category,\n      type: d.type,\n      id: d.id,\n      left: finalLeft,\n      top: finalTop,\n      width,\n      height,\n      ...(rotation !== undefined && { rotation: options.flipY ? -rotation : rotation }),\n      threeD,\n      ...d.state\n    }\n  })\n\n  return {\n    width: boardWidth,\n    height: boardHeight,\n    fillStyle: options.backgroundColor ?? '#ffffff',\n    components,\n    importMeta: options.importMeta\n  }\n}\n\nfunction presetToState(preset: import('../types/registry.js').ThreeDPreset): Record<string, any> {\n  return {\n    geometry: preset.geometry,\n    ...(preset.material && { material: preset.material }),\n    origin: preset.origin ?? 'bottom'\n  }\n}\n"]}

package/dist-server/service/pipeline/stage4-binding.d.ts

@@ -0,0 +1,9 @@
+import type { BoardModel } from './stage3-board';
+export interface BindingOptions {
+    scopes?: string[];
+}
+/**
+ * 보드 모델의 모든 컴포넌트에 subscription 정보를 주입.
+ * things-factory 의 dataSubscriptionProvider 가 인식하는 형태로.
+ */
+export declare function applyDataBinding(model: BoardModel, options?: BindingOptions): BoardModel;

package/dist-server/service/pipeline/stage4-binding.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyDataBinding = applyDataBinding;
+/**
+ * Stage 4 — 보드 모델에 데이터 바인딩 자동 설정.
+ * 컴포넌트 type 에 등록된 SubscriptionRule 을 찾아 subscriptionTag 등 부여.
+ */
+const index_1 = require("../registry/index");
+/**
+ * 보드 모델의 모든 컴포넌트에 subscription 정보를 주입.
+ * things-factory 의 dataSubscriptionProvider 가 인식하는 형태로.
+ */
+function applyDataBinding(model, options = {}) {
+    const components = model.components.map(c => bindComponent(c, options));
+    return { ...model, components };
+}
+function bindComponent(c, options) {
+    const rule = (0, index_1.findSubscriptionRule)(c.type, options.scopes);
+    if (!rule)
+        return c;
+    return {
+        ...c,
+        subscriptionTag: rule.tag,
+        subscriptionIdField: rule.idField ?? 'NAME',
+        ...(rule.fieldMappings && { subscriptionFieldMappings: rule.fieldMappings })
+    };
+}
+//# sourceMappingURL=stage4-binding.js.map

package/dist-server/service/pipeline/stage4-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage4-binding.js","sourceRoot":"","sources":["../../../server/service/pipeline/stage4-binding.ts"],"names":[],"mappings":";;AAeA,4CAGC;AAlBD;;;GAGG;AACH,6CAAwD;AAOxD;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,KAAiB,EAAE,UAA0B,EAAE;IAC9E,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;IACvE,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,CAAA;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,CAAiB,EAAE,OAAuB;IAC/D,MAAM,IAAI,GAAG,IAAA,4BAAoB,EAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAA;IAEnB,OAAO;QACL,GAAG,CAAC;QACJ,eAAe,EAAE,IAAI,CAAC,GAAG;QACzB,mBAAmB,EAAE,IAAI,CAAC,OAAO,IAAI,MAAM;QAC3C,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,yBAAyB,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;KAC7E,CAAA;AACH,CAAC","sourcesContent":["/**\n * Stage 4 — 보드 모델에 데이터 바인딩 자동 설정.\n * 컴포넌트 type 에 등록된 SubscriptionRule 을 찾아 subscriptionTag 등 부여.\n */\nimport { findSubscriptionRule } from '../registry/index'\nimport type { BoardComponent, BoardModel } from './stage3-board'\n\nexport interface BindingOptions {\n  scopes?: string[]\n}\n\n/**\n * 보드 모델의 모든 컴포넌트에 subscription 정보를 주입.\n * things-factory 의 dataSubscriptionProvider 가 인식하는 형태로.\n */\nexport function applyDataBinding(model: BoardModel, options: BindingOptions = {}): BoardModel {\n  const components = model.components.map(c => bindComponent(c, options))\n  return { ...model, components }\n}\n\nfunction bindComponent(c: BoardComponent, options: BindingOptions): BoardComponent {\n  const rule = findSubscriptionRule(c.type, options.scopes)\n  if (!rule) return c\n\n  return {\n    ...c,\n    subscriptionTag: rule.tag,\n    subscriptionIdField: rule.idField ?? 'NAME',\n    ...(rule.fieldMappings && { subscriptionFieldMappings: rule.fieldMappings })\n  }\n}\n"]}

package/dist-server/service/registry/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 앱이 자기 도메인 매핑을 등록하는 Registry.
+ * scope 별로 분리 보관 (예: 'fmsim', 'mms', 'wms').
+ *
+ * 백엔드 단일 프로세스 안에서 in-memory 로 유지된다. 모듈 부트스트랩 시 등록.
+ */
+import type { ComponentCategory, ImportRule, SubscriptionRule, ThreeDPreset } from '../types/registry';
+export declare function registerImportRules(scope: string, rules: ImportRule[]): void;
+export declare function getImportRules(scopes?: string[]): ImportRule[];
+export declare function clearImportRules(scope: string): void;
+export declare function register3DPresets(scope: string, presets: ThreeDPreset[]): void;
+export declare function get3DPresets(scopes?: string[]): ThreeDPreset[];
+/**
+ * 컴포넌트 type + category 로 3D preset 을 찾는다.
+ * 우선순위:
+ *   1) 앱 등록 preset 중 componentType 정확 일치
+ *   2) 앱 등록 preset 중 category 일치
+ *   3) 코어 디폴트 카테고리 preset
+ *   4) 코어 디폴트 'unknown' preset
+ */
+export declare function find3DPreset(componentType: string, category?: ComponentCategory, scopes?: string[]): ThreeDPreset;
+export declare function clear3DPresets(scope: string): void;
+export declare function registerSubscriptionRules(scope: string, rules: SubscriptionRule[]): void;
+export declare function getSubscriptionRules(scopes?: string[]): SubscriptionRule[];
+export declare function findSubscriptionRule(componentType: string, scopes?: string[]): SubscriptionRule | undefined;
+export declare function clearSubscriptionRules(scope: string): void;
+export declare function clearAllRegistries(): void;