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

package/config/config.development.js

@@ -0,0 +1,44 @@
+module.exports = {
+  /*
+    Board Import Configuration
+
+    Settings for drawing → board conversion pipeline (DXF / IFC / image).
+    Override in your application's config to tune performance limits.
+  */
+  boardImport: {
+    /*
+      Maximum entities parsed from a single drawing. Performance guard.
+      Drawings with more entities are truncated; warning is recorded in
+      MappingResult.warnings.
+    */
+    maxEntities: 100000,
+
+    /*
+      Maximum concurrent ImportSession workers within a single process.
+      Higher = faster batch import, more memory.
+
+      Recommended: number of CPU cores.
+    */
+    maxConcurrentJobs: 4,
+
+    /*
+      Default scope(s) to use when ImportSession options.scopes is empty.
+      Application typically registers ImportRules under a domain scope (e.g. 'fmsim').
+
+      Example:
+        defaultScopes: ['fmsim']
+    */
+    // defaultScopes: undefined,
+
+    /*
+      Default geometry handling for assembled BoardModel.
+      These are applied when the corresponding ImportSession option is undefined.
+    */
+    defaults: {
+      normalizeOrigin: true,   // shift bbox so minX,minY = 0
+      flipY: true,             // CAD Y-up → scene Y-down
+      scale: 1,                // 1mm = 1 scene unit (CAD standard)
+      applyBinding: true       // run Stage 4 (subscription auto-mapping)
+    }
+  }
+}

package/config/config.production.js

@@ -0,0 +1,18 @@
+module.exports = {
+  /*
+    Board Import Configuration — Production
+
+    See config.development.js for the full reference. Production typically tunes
+    `maxConcurrentJobs` based on host capacity.
+  */
+  boardImport: {
+    maxEntities: 100000,
+    maxConcurrentJobs: 4,
+    defaults: {
+      normalizeOrigin: true,
+      flipY: true,
+      scale: 1,
+      applyBinding: true
+    }
+  }
+}

package/dist-server/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @things-factory/board-import — 도면(CAD/이미지/IFC) → Board Model 백엔드 코어.
+ *
+ * Phase 1: DXF 결정적 파이프라인 (AI 미사용).
+ * Phase 2+: GraphQL/REST 엔드포인트, AI 통합.
+ */
+export * from './service/index';

package/dist-server/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * @things-factory/board-import — 도면(CAD/이미지/IFC) → Board Model 백엔드 코어.
+ *
+ * Phase 1: DXF 결정적 파이프라인 (AI 미사용).
+ * Phase 2+: GraphQL/REST 엔드포인트, AI 통합.
+ */
+tslib_1.__exportStar(require("./service/index"), exports);
+//# sourceMappingURL=index.js.map

package/dist-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,0DAA+B","sourcesContent":["/**\n * @things-factory/board-import — 도면(CAD/이미지/IFC) → Board Model 백엔드 코어.\n *\n * Phase 1: DXF 결정적 파이프라인 (AI 미사용).\n * Phase 2+: GraphQL/REST 엔드포인트, AI 통합.\n */\nexport * from './service/index'\n"]}

package/dist-server/service/adapters/dxf-adapter.d.ts

@@ -0,0 +1,8 @@
+import type { AdapterCapabilities, AdapterInput, FormatAdapter, ParseOptions, ParseResult } from '../types/index';
+export declare class DxfAdapter implements FormatAdapter {
+    readonly format = "dxf";
+    readonly supportedExtensions: string[];
+    readonly capabilities: AdapterCapabilities;
+    detect(file: AdapterInput, filename?: string): Promise<boolean>;
+    parse(file: AdapterInput, options?: ParseOptions): Promise<ParseResult>;
+}

package/dist-server/service/adapters/dxf-adapter.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DxfAdapter = void 0;
+const tslib_1 = require("tslib");
+/**
+ * DXF Format Adapter — DXF 텍스트 파일을 UniversalEntity 목록으로 정규화.
+ *
+ * 백엔드 환경(Node.js)에서 동작. 입력은 string / Buffer / ArrayBuffer / Uint8Array 모두 허용.
+ *
+ * 구현 범위 (Phase 1):
+ *   - INSERT (블록 참조) → kind='shape', attribs.name 추출
+ *   - LWPOLYLINE / POLYLINE → kind='path'
+ *   - CIRCLE → kind='shape', attribs.shape='circle'
+ *   - LINE → kind='path' (단일 선분)
+ *   - TEXT / MTEXT → kind='text'
+ *   - 레이어, 좌표, 회전 추출
+ *   - $INSUNITS 단위 추출
+ *
+ * 보류 (Phase 2+):
+ *   - HATCH, SPLINE, ELLIPSE 의 정밀 변환
+ *   - 블록 정의 안의 entities 깊이 펼치기
+ *   - 외부 참조 (XREF)
+ */
+const dxf_parser_1 = tslib_1.__importDefault(require("dxf-parser"));
+const DXF_INSUNITS_TO_UNITS = {
+    0: 'unknown',
+    1: 'inch',
+    4: 'mm',
+    5: 'cm',
+    6: 'm'
+};
+class DxfAdapter {
+    constructor() {
+        this.format = 'dxf';
+        this.supportedExtensions = ['.dxf'];
+        this.capabilities = {
+            has2D: true,
+            has3D: false,
+            hasSemanticLabels: false,
+            hasTextLabels: true,
+            hasAttributes: true
+        };
+    }
+    async detect(file, filename) {
+        if (filename) {
+            const lower = filename.toLowerCase();
+            if (lower.endsWith('.dxf'))
+                return true;
+            // 명백한 non-DXF 확장자는 content peek 자체를 시도하지 않음.
+            // 잘못된 입력 타입(Promise/Stream 등) 이 흘러도 detect 가 throw 하지 않게 가드.
+            if (/\.(jpe?g|png|gif|webp|bmp|svg|pdf|ifc|gltf|glb|json|xml|csv|xlsx?|docx?)$/.test(lower)) {
+                return false;
+            }
+        }
+        try {
+            const head = readHead(file, 256);
+            return /\b0\s*\n\s*SECTION\b/.test(head) || /^\s*999/.test(head);
+        }
+        catch {
+            // 입력 타입을 텍스트로 못 읽으면 DXF 가 아니다 — false 로 흘려보내 다음 어댑터에 양보.
+            return false;
+        }
+    }
+    async parse(file, options = {}) {
+        const text = readText(file);
+        const parser = new dxf_parser_1.default();
+        const dxf = parser.parseSync(text);
+        if (!dxf)
+            throw new Error('DXF 파싱 실패');
+        const entities = [];
+        let uidCounter = 0;
+        const nextUid = () => `dxf-${++uidCounter}`;
+        const excludeLayers = new Set((options.excludeLayers || []).map(l => l.toLowerCase()));
+        const maxEntities = options.maxEntities ?? 100000;
+        for (const e of dxf.entities || []) {
+            if (entities.length >= maxEntities)
+                break;
+            const layer = e.layer || '';
+            if (excludeLayers.has(layer.toLowerCase()))
+                continue;
+            const ue = entityToUniversal(e, layer, nextUid());
+            if (ue)
+                entities.push(ue);
+        }
+        const bbox = computeBoundingBox(entities);
+        const units = DXF_INSUNITS_TO_UNITS[dxf.header?.$INSUNITS ?? 0];
+        return {
+            entities,
+            metadata: {
+                format: 'dxf',
+                formatVersion: dxf.header?.$ACADVER,
+                ...(dxf.header || {})
+            },
+            bbox,
+            units
+        };
+    }
+}
+exports.DxfAdapter = DxfAdapter;
+// ── DXF entity → UniversalEntity ─────────────────────────────────────
+function entityToUniversal(e, layer, uid) {
+    const type = e.type;
+    switch (type) {
+        case 'INSERT': {
+            const x = e.position?.x ?? 0;
+            const y = e.position?.y ?? 0;
+            const width = (e.xScale ?? 1) * 1;
+            const height = (e.yScale ?? 1) * 1;
+            return {
+                uid,
+                kind: 'shape',
+                position: { x, y },
+                size: { width, height },
+                rotation: e.rotation ?? 0,
+                bbox: { min: { x, y }, max: { x: x + width, y: y + height } },
+                attribs: {
+                    name: e.name,
+                    layer,
+                    shape: 'rect'
+                }
+            };
+        }
+        case 'CIRCLE': {
+            const cx = e.center?.x ?? 0;
+            const cy = e.center?.y ?? 0;
+            const r = e.radius ?? 0;
+            return {
+                uid,
+                kind: 'shape',
+                position: { x: cx - r, y: cy - r },
+                size: { width: 2 * r, height: 2 * r },
+                bbox: { min: { x: cx - r, y: cy - r }, max: { x: cx + r, y: cy + r } },
+                attribs: { layer, shape: 'circle' }
+            };
+        }
+        case 'LWPOLYLINE':
+        case 'POLYLINE': {
+            const verts = (e.vertices || []).map((v) => ({ x: v.x, y: v.y }));
+            if (verts.length === 0)
+                return null;
+            const xs = verts.map(v => v.x);
+            const ys = verts.map(v => v.y);
+            const min = { x: Math.min(...xs), y: Math.min(...ys) };
+            const max = { x: Math.max(...xs), y: Math.max(...ys) };
+            return {
+                uid,
+                kind: 'path',
+                position: { x: min.x, y: min.y },
+                size: { width: max.x - min.x, height: max.y - min.y },
+                bbox: { min, max },
+                attribs: { layer, shape: 'polyline', vertices: verts, closed: !!e.shape }
+            };
+        }
+        case 'LINE': {
+            const x1 = e.vertices?.[0]?.x ?? 0;
+            const y1 = e.vertices?.[0]?.y ?? 0;
+            const x2 = e.vertices?.[1]?.x ?? 0;
+            const y2 = e.vertices?.[1]?.y ?? 0;
+            const min = { x: Math.min(x1, x2), y: Math.min(y1, y2) };
+            const max = { x: Math.max(x1, x2), y: Math.max(y1, y2) };
+            return {
+                uid,
+                kind: 'path',
+                position: { x: min.x, y: min.y },
+                size: { width: max.x - min.x, height: max.y - min.y },
+                bbox: { min, max },
+                attribs: { layer, shape: 'polyline', vertices: [{ x: x1, y: y1 }, { x: x2, y: y2 }] }
+            };
+        }
+        case 'TEXT':
+        case 'MTEXT': {
+            const x = e.position?.x ?? e.startPoint?.x ?? 0;
+            const y = e.position?.y ?? e.startPoint?.y ?? 0;
+            const text = e.text ?? e.string ?? '';
+            const h = e.textHeight ?? e.height ?? 1;
+            return {
+                uid,
+                kind: 'text',
+                position: { x, y },
+                bbox: { min: { x, y }, max: { x: x + h * (text.length || 1), y: y + h } },
+                attribs: { layer, text }
+            };
+        }
+        default:
+            return null;
+    }
+}
+// ── 유틸 ─────────────────────────────────────────────────────────────
+function computeBoundingBox(entities) {
+    if (entities.length === 0)
+        return { min: { x: 0, y: 0 }, max: { x: 0, y: 0 } };
+    let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+    for (const e of entities) {
+        if (e.bbox.min.x < minX)
+            minX = e.bbox.min.x;
+        if (e.bbox.min.y < minY)
+            minY = e.bbox.min.y;
+        if (e.bbox.max.x > maxX)
+            maxX = e.bbox.max.x;
+        if (e.bbox.max.y > maxY)
+            maxY = e.bbox.max.y;
+    }
+    return { min: { x: minX, y: minY }, max: { x: maxX, y: maxY } };
+}
+function readText(file) {
+    if (typeof file === 'string')
+        return file;
+    if (Buffer.isBuffer(file))
+        return file.toString('utf-8');
+    if (file instanceof Uint8Array)
+        return Buffer.from(file).toString('utf-8');
+    if (file instanceof ArrayBuffer)
+        return Buffer.from(new Uint8Array(file)).toString('utf-8');
+    throw new Error('Unsupported DXF input type');
+}
+function readHead(file, maxBytes) {
+    const text = readText(file);
+    return text.substring(0, maxBytes);
+}
+//# sourceMappingURL=dxf-adapter.js.map

package/dist-server/service/adapters/dxf-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dxf-adapter.js","sourceRoot":"","sources":["../../../server/service/adapters/dxf-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DXF Format Adapter — DXF 텍스트 파일을 UniversalEntity 목록으로 정규화.\n *\n * 백엔드 환경(Node.js)에서 동작. 입력은 string / Buffer / ArrayBuffer / Uint8Array 모두 허용.\n *\n * 구현 범위 (Phase 1):\n *   - INSERT (블록 참조) → kind='shape', attribs.name 추출\n *   - LWPOLYLINE / POLYLINE → kind='path'\n *   - CIRCLE → kind='shape', attribs.shape='circle'\n *   - LINE → kind='path' (단일 선분)\n *   - TEXT / MTEXT → kind='text'\n *   - 레이어, 좌표, 회전 추출\n *   - $INSUNITS 단위 추출\n *\n * 보류 (Phase 2+):\n *   - HATCH, SPLINE, ELLIPSE 의 정밀 변환\n *   - 블록 정의 안의 entities 깊이 펼치기\n *   - 외부 참조 (XREF)\n */\nimport DxfParser from 'dxf-parser'\n\nimport type {\n  AdapterCapabilities,\n  AdapterInput,\n  BoundingBox,\n  FormatAdapter,\n  ParseOptions,\n  ParseResult,\n  UniversalEntity\n} from '../types/index'\n\nconst DXF_INSUNITS_TO_UNITS: Record<number, ParseResult['units']> = {\n  0: 'unknown',\n  1: 'inch',\n  4: 'mm',\n  5: 'cm',\n  6: 'm'\n}\n\nexport class DxfAdapter implements FormatAdapter {\n  readonly format = 'dxf'\n  readonly supportedExtensions = ['.dxf']\n  readonly capabilities: AdapterCapabilities = {\n    has2D: true,\n    has3D: false,\n    hasSemanticLabels: false,\n    hasTextLabels: true,\n    hasAttributes: true\n  }\n\n  async detect(file: AdapterInput, filename?: string): Promise<boolean> {\n    if (filename) {\n      const lower = filename.toLowerCase()\n      if (lower.endsWith('.dxf')) return true\n      // 명백한 non-DXF 확장자는 content peek 자체를 시도하지 않음.\n      // 잘못된 입력 타입(Promise/Stream 등) 이 흘러도 detect 가 throw 하지 않게 가드.\n      if (/\\.(jpe?g|png|gif|webp|bmp|svg|pdf|ifc|gltf|glb|json|xml|csv|xlsx?|docx?)$/.test(lower)) {\n        return false\n      }\n    }\n    try {\n      const head = readHead(file, 256)\n      return /\\b0\\s*\\n\\s*SECTION\\b/.test(head) || /^\\s*999/.test(head)\n    } catch {\n      // 입력 타입을 텍스트로 못 읽으면 DXF 가 아니다 — false 로 흘려보내 다음 어댑터에 양보.\n      return false\n    }\n  }\n\n  async parse(file: AdapterInput, options: ParseOptions = {}): Promise<ParseResult> {\n    const text = readText(file)\n    const parser = new DxfParser()\n    const dxf = parser.parseSync(text)\n\n    if (!dxf) throw new Error('DXF 파싱 실패')\n\n    const entities: UniversalEntity[] = []\n    let uidCounter = 0\n    const nextUid = () => `dxf-${++uidCounter}`\n\n    const excludeLayers = new Set((options.excludeLayers || []).map(l => l.toLowerCase()))\n    const maxEntities = options.maxEntities ?? 100000\n\n    for (const e of dxf.entities || []) {\n      if (entities.length >= maxEntities) break\n\n      const layer = (e as any).layer || ''\n      if (excludeLayers.has(layer.toLowerCase())) continue\n\n      const ue = entityToUniversal(e, layer, nextUid())\n      if (ue) entities.push(ue)\n    }\n\n    const bbox = computeBoundingBox(entities)\n    const units = DXF_INSUNITS_TO_UNITS[(dxf.header as any)?.$INSUNITS ?? 0]\n\n    return {\n      entities,\n      metadata: {\n        format: 'dxf',\n        formatVersion: (dxf.header as any)?.$ACADVER,\n        ...((dxf.header as any) || {})\n      },\n      bbox,\n      units\n    }\n  }\n}\n\n// ── DXF entity → UniversalEntity ─────────────────────────────────────\n\nfunction entityToUniversal(e: any, layer: string, uid: string): UniversalEntity | null {\n  const type = e.type as string\n\n  switch (type) {\n    case 'INSERT': {\n      const x = e.position?.x ?? 0\n      const y = e.position?.y ?? 0\n      const width = (e.xScale ?? 1) * 1\n      const height = (e.yScale ?? 1) * 1\n      return {\n        uid,\n        kind: 'shape',\n        position: { x, y },\n        size: { width, height },\n        rotation: e.rotation ?? 0,\n        bbox: { min: { x, y }, max: { x: x + width, y: y + height } },\n        attribs: {\n          name: e.name,\n          layer,\n          shape: 'rect'\n        }\n      }\n    }\n\n    case 'CIRCLE': {\n      const cx = e.center?.x ?? 0\n      const cy = e.center?.y ?? 0\n      const r = e.radius ?? 0\n      return {\n        uid,\n        kind: 'shape',\n        position: { x: cx - r, y: cy - r },\n        size: { width: 2 * r, height: 2 * r },\n        bbox: { min: { x: cx - r, y: cy - r }, max: { x: cx + r, y: cy + r } },\n        attribs: { layer, shape: 'circle' }\n      }\n    }\n\n    case 'LWPOLYLINE':\n    case 'POLYLINE': {\n      const verts: { x: number; y: number }[] = (e.vertices || []).map((v: any) => ({ x: v.x, y: v.y }))\n      if (verts.length === 0) return null\n      const xs = verts.map(v => v.x)\n      const ys = verts.map(v => v.y)\n      const min = { x: Math.min(...xs), y: Math.min(...ys) }\n      const max = { x: Math.max(...xs), y: Math.max(...ys) }\n      return {\n        uid,\n        kind: 'path',\n        position: { x: min.x, y: min.y },\n        size: { width: max.x - min.x, height: max.y - min.y },\n        bbox: { min, max },\n        attribs: { layer, shape: 'polyline', vertices: verts, closed: !!e.shape }\n      }\n    }\n\n    case 'LINE': {\n      const x1 = e.vertices?.[0]?.x ?? 0\n      const y1 = e.vertices?.[0]?.y ?? 0\n      const x2 = e.vertices?.[1]?.x ?? 0\n      const y2 = e.vertices?.[1]?.y ?? 0\n      const min = { x: Math.min(x1, x2), y: Math.min(y1, y2) }\n      const max = { x: Math.max(x1, x2), y: Math.max(y1, y2) }\n      return {\n        uid,\n        kind: 'path',\n        position: { x: min.x, y: min.y },\n        size: { width: max.x - min.x, height: max.y - min.y },\n        bbox: { min, max },\n        attribs: { layer, shape: 'polyline', vertices: [{ x: x1, y: y1 }, { x: x2, y: y2 }] }\n      }\n    }\n\n    case 'TEXT':\n    case 'MTEXT': {\n      const x = e.position?.x ?? e.startPoint?.x ?? 0\n      const y = e.position?.y ?? e.startPoint?.y ?? 0\n      const text = e.text ?? e.string ?? ''\n      const h = e.textHeight ?? e.height ?? 1\n      return {\n        uid,\n        kind: 'text',\n        position: { x, y },\n        bbox: { min: { x, y }, max: { x: x + h * (text.length || 1), y: y + h } },\n        attribs: { layer, text }\n      }\n    }\n\n    default:\n      return null\n  }\n}\n\n// ── 유틸 ─────────────────────────────────────────────────────────────\n\nfunction computeBoundingBox(entities: UniversalEntity[]): BoundingBox {\n  if (entities.length === 0) return { min: { x: 0, y: 0 }, max: { x: 0, y: 0 } }\n  let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity\n  for (const e of entities) {\n    if (e.bbox.min.x < minX) minX = e.bbox.min.x\n    if (e.bbox.min.y < minY) minY = e.bbox.min.y\n    if (e.bbox.max.x > maxX) maxX = e.bbox.max.x\n    if (e.bbox.max.y > maxY) maxY = e.bbox.max.y\n  }\n  return { min: { x: minX, y: minY }, max: { x: maxX, y: maxY } }\n}\n\nfunction readText(file: AdapterInput): string {\n  if (typeof file === 'string') return file\n  if (Buffer.isBuffer(file)) return file.toString('utf-8')\n  if (file instanceof Uint8Array) return Buffer.from(file).toString('utf-8')\n  if (file instanceof ArrayBuffer) return Buffer.from(new Uint8Array(file)).toString('utf-8')\n  throw new Error('Unsupported DXF input type')\n}\n\nfunction readHead(file: AdapterInput, maxBytes: number): string {\n  const text = readText(file)\n  return text.substring(0, maxBytes)\n}\n"]}

package/dist-server/service/adapters/image-adapter.d.ts

@@ -0,0 +1,32 @@
+import type { AdapterCapabilities, AdapterInput, FormatAdapter, ParseOptions, ParseResult } from '../types/index';
+export interface ImageParseOptions extends ParseOptions {
+    /** 자연어 컨텍스트 — VLM 에 함께 전달. 예: "factory floor plan with AGV paths and stockers" */
+    context?: string;
+    /** 후보 카테고리 — VLM 이 그 안에서 라벨링하도록 가이드 */
+    categories?: string[];
+    /**
+     * 이미지 dimension — VLM 프롬프트가 픽셀 좌표계를 명시하기 위해 사용. ImageAdapter 가
+     * 헤더에서 읽어 자동 주입한다. 호출자가 직접 부를 때도 명시 가능.
+     */
+    imageWidth?: number;
+    imageHeight?: number;
+    /**
+     * 사용자 자유서술 hint — 도면 설명, 강조 부분, 카테고리 가이드 등.
+     * VLM 의 view type 분류 + entity 추출 양쪽에 추가 컨텍스트로 합류.
+     */
+    userPrompt?: string;
+    /**
+     * View type 명시 (강제). 미지정 시 ImageAdapter 가 1-pass classify 로 자동 결정.
+     * - 'top-down' : orthographic 도면 / 평면도 (픽셀 좌표 그대로)
+     * - 'perspective-3d' : 3D 렌더 / 조감도 / 등각투상 (floor plan 추론)
+     * - 'photo' : 실사진 (floor plan 추론)
+     */
+    viewType?: 'top-down' | 'perspective-3d' | 'photo';
+}
+export declare class ImageAdapter implements FormatAdapter {
+    readonly format = "image";
+    readonly supportedExtensions: string[];
+    readonly capabilities: AdapterCapabilities;
+    detect(file: AdapterInput, filename?: string): Promise<boolean>;
+    parse(file: AdapterInput, options?: ImageParseOptions): Promise<ParseResult>;
+}