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

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

@@ -0,0 +1,73 @@
+/**
+ * Board Prefab Registry — 고품질 복합 컴포넌트 프리셋 카탈로그.
+ *
+ * 의도:
+ *   - 보드 설계자가 실제로 원하는 단위는 rect/circle 같은 원시 도형이 아닌
+ *     "온도 모니터링 카드", "AGV 배터리 상태판", "공정 KPI 타일" 같은 디자인된
+ *     복합 모듈. 이 layer 가 그 단위를 시스템 차원에서 제공.
+ *   - LLM 은 자유 작곡하지 않고 검증된 prefab 카탈로그에서 고름 → 결과 일관성 ↑,
+ *     비용 ↓, 진입 장벽 낮춤.
+ *
+ * 통합:
+ *   - 호스트 (operato 등) 가 패키지 로드 시 `registerBoardPrefab` 으로 자기 prefab
+ *     등록. board-ai 는 registry 만 관리. 초기 예시 prefab 몇 개를 자체 등록 — 진짜
+ *     디자인된 prefab 은 별도 패키지에서 추가.
+ *   - LLM 도구 통합:
+ *       getAvailablePrefabs (read)  → registry 의 메타데이터 반환
+ *       addPrefab (write)           → name + 좌표/옵션 → 단일 BoardComponent (group)
+ *
+ * 식별자:
+ *   - `name` 은 unique. 같은 name 으로 register 시 override (호스트가 자기 prefab 을
+ *     커스터마이징할 수 있도록 의도적 허용).
+ *   - 카테고리는 free-form string — registry 가 강제하지 않음. 사용자/운영 자율.
+ */
+import type { BoardComponent } from '@things-factory/board-import';
+export interface BoardPrefab {
+    /** Unique 식별자 — 'kebab-case' 권장 */
+    name: string;
+    /** 자유 분류 — 'monitoring' | 'control' | 'decoration' | 'kpi' 등 */
+    category?: string;
+    /** 사용자 / LLM 이 이해할 한 문장 설명 */
+    description: string;
+    /**
+     * 자연어 매칭 힌트 — '온도', '게이지', '카드' 등.
+     * findComponents 같은 검색이 아니라 LLM 의 의도 매칭용 메타데이터.
+     */
+    keywords?: string[];
+    /** 권장 기본 크기 — options 에 width/height 미지정 시 사용 */
+    defaultSize?: {
+        width: number;
+        height: number;
+    };
+    /**
+     * Prefab 의 컴포넌트 트리를 만든다. 단일 `BoardComponent` 반환 — 보통 group 타입이며
+     * `components` 자식을 가진다. 단일 add op 으로 매핑되어 undo 도 한 단위.
+     *
+     * options:
+     *   - left/top: anchor 좌표 (top-left 원점)
+     *   - width/height: 크기 (없으면 defaultSize)
+     *   - 추가 키: prefab 별 자유 (title 텍스트, 색상 등)
+     */
+    build(options: PrefabBuildOptions): BoardComponent;
+}
+export interface PrefabBuildOptions {
+    left: number;
+    top: number;
+    width?: number;
+    height?: number;
+    /** prefab 별 커스터마이징 — 자유 형태 */
+    [k: string]: any;
+}
+/**
+ * Prefab 등록. 같은 name 은 덮어씀 (호스트가 자기 prefab 으로 default 를 교체 가능).
+ */
+export declare function registerBoardPrefab(prefab: BoardPrefab): void;
+/** 이름으로 조회. 없으면 undefined. */
+export declare function findBoardPrefab(name: string): BoardPrefab | undefined;
+/** 등록된 prefab 의 메타데이터 (build 함수 제외) — getAvailablePrefabs 결과용. */
+export declare function listBoardPrefabs(filter?: {
+    category?: string;
+    keywordPattern?: string;
+}): Array<Omit<BoardPrefab, 'build'>>;
+/** 테스트용 — 등록 상태 초기화. */
+export declare function clearBoardPrefabsForTest(): void;

package/dist-server/service/prefab-registry.js

@@ -0,0 +1,258 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerBoardPrefab = registerBoardPrefab;
+exports.findBoardPrefab = findBoardPrefab;
+exports.listBoardPrefabs = listBoardPrefabs;
+exports.clearBoardPrefabsForTest = clearBoardPrefabsForTest;
+const REGISTRY = new Map();
+/**
+ * Prefab 등록. 같은 name 은 덮어씀 (호스트가 자기 prefab 으로 default 를 교체 가능).
+ */
+function registerBoardPrefab(prefab) {
+    if (!prefab || typeof prefab.name !== 'string' || prefab.name.length === 0) {
+        throw new Error('registerBoardPrefab: prefab.name is required');
+    }
+    if (typeof prefab.build !== 'function') {
+        throw new Error(`registerBoardPrefab(${prefab.name}): build() is required`);
+    }
+    REGISTRY.set(prefab.name, prefab);
+}
+/** 이름으로 조회. 없으면 undefined. */
+function findBoardPrefab(name) {
+    return REGISTRY.get(name);
+}
+/** 등록된 prefab 의 메타데이터 (build 함수 제외) — getAvailablePrefabs 결과용. */
+function listBoardPrefabs(filter) {
+    const items = [];
+    for (const p of REGISTRY.values()) {
+        if (filter?.category && p.category !== filter.category)
+            continue;
+        if (filter?.keywordPattern) {
+            const needle = filter.keywordPattern.toLowerCase();
+            const haystack = [
+                p.name,
+                p.description,
+                ...(p.keywords ?? [])
+            ]
+                .join(' ')
+                .toLowerCase();
+            if (!haystack.includes(needle))
+                continue;
+        }
+        items.push({
+            name: p.name,
+            category: p.category,
+            description: p.description,
+            keywords: p.keywords,
+            defaultSize: p.defaultSize
+        });
+    }
+    return items;
+}
+/** 테스트용 — 등록 상태 초기화. */
+function clearBoardPrefabsForTest() {
+    REGISTRY.clear();
+}
+// ── 초기 예시 prefab ─────────────────────────────────────────────
+//
+// 패키지 차원 default — 진짜 polished 디자인은 operato / 도메인 패키지에서 register.
+// 여기서는 architecture 데모 + LLM 이 선택할 후보가 0 이 되지 않도록 최소 set.
+/**
+ * monitor-card — 라벨 + 큰 숫자값 + 부제 의 모니터링 타일.
+ * 가장 흔한 대시보드 단위. AGV 배터리 / 온도 / 가동률 등 한 줄 KPI 표시.
+ */
+const MONITOR_CARD = {
+    name: 'monitor-card',
+    category: 'monitoring',
+    description: 'KPI 모니터링 카드 — 상단에 라벨, 중앙에 큰 값, 하단에 부제. 단일 수치 한 줄 표시 (온도/가동률/배터리 등).',
+    keywords: ['모니터링', 'kpi', '카드', '값', 'value', 'card'],
+    defaultSize: { width: 200, height: 120 },
+    build(opts) {
+        const w = opts.width ?? 200;
+        const h = opts.height ?? 120;
+        const title = typeof opts.title === 'string' ? opts.title : 'Label';
+        const value = typeof opts.value === 'string' ? opts.value : '0';
+        const subtitle = typeof opts.subtitle === 'string' ? opts.subtitle : '';
+        const fill = typeof opts.fillStyle === 'string' ? opts.fillStyle : '#1a2332';
+        const accent = typeof opts.accent === 'string' ? opts.accent : '#4fc3f7';
+        return {
+            type: 'group',
+            left: opts.left,
+            top: opts.top,
+            width: w,
+            height: h,
+            name: 'monitor-card',
+            components: [
+                {
+                    type: 'rect',
+                    left: 0,
+                    top: 0,
+                    width: w,
+                    height: h,
+                    fillStyle: fill,
+                    strokeStyle: '#2a3a52',
+                    strokeWidth: 1
+                },
+                {
+                    type: 'text',
+                    left: 12,
+                    top: 10,
+                    width: w - 24,
+                    height: 16,
+                    text: title,
+                    fillStyle: '#94a3b8',
+                    fontSize: 12
+                },
+                {
+                    type: 'text',
+                    left: 12,
+                    top: 32,
+                    width: w - 24,
+                    height: h - 60,
+                    text: value,
+                    fillStyle: accent,
+                    fontSize: 32,
+                    fontWeight: 'bold'
+                },
+                {
+                    type: 'text',
+                    left: 12,
+                    top: h - 22,
+                    width: w - 24,
+                    height: 14,
+                    text: subtitle,
+                    fillStyle: '#64748b',
+                    fontSize: 11
+                }
+            ]
+        };
+    }
+};
+/**
+ * gauge-panel — 라벨 붙은 원형 게이지 패널.
+ * gauge-circle 컴포넌트가 things-scene에 있음을 전제. 진짜 게이지가 없으면 폴백으로 circle.
+ */
+const GAUGE_PANEL = {
+    name: 'gauge-panel',
+    category: 'monitoring',
+    description: '원형 게이지 + 라벨. 0~100 (또는 min/max) 범위의 단일 값 시각화 (CPU, 압력, 충전 등).',
+    keywords: ['게이지', 'gauge', '원형', '미터', 'meter', '센서'],
+    defaultSize: { width: 180, height: 200 },
+    build(opts) {
+        const w = opts.width ?? 180;
+        const h = opts.height ?? 200;
+        const title = typeof opts.title === 'string' ? opts.title : 'Gauge';
+        const value = typeof opts.value === 'number' ? opts.value : 50;
+        const min = typeof opts.min === 'number' ? opts.min : 0;
+        const max = typeof opts.max === 'number' ? opts.max : 100;
+        const fill = typeof opts.fillStyle === 'string' ? opts.fillStyle : '#1a2332';
+        return {
+            type: 'group',
+            left: opts.left,
+            top: opts.top,
+            width: w,
+            height: h,
+            name: 'gauge-panel',
+            components: [
+                {
+                    type: 'rect',
+                    left: 0,
+                    top: 0,
+                    width: w,
+                    height: h,
+                    fillStyle: fill,
+                    strokeStyle: '#2a3a52',
+                    strokeWidth: 1
+                },
+                {
+                    // gauge-circle 이 등록되어 있을 때 사용. 미등록 환경에서는 정상 추가는 되나
+                    // render 가 fallback. operato 패키지에서 normalizeComponent 가 default 채움.
+                    type: 'gauge-circle',
+                    left: 20,
+                    top: 20,
+                    width: w - 40,
+                    height: w - 40, // 정사각형 게이지
+                    value,
+                    min,
+                    max
+                },
+                {
+                    type: 'text',
+                    left: 12,
+                    top: h - 28,
+                    width: w - 24,
+                    height: 18,
+                    text: title,
+                    fillStyle: '#94a3b8',
+                    fontSize: 13
+                }
+            ]
+        };
+    }
+};
+/**
+ * stat-tile — 컬러 타일 + 큰 숫자. monitor-card 보다 강조된 단일 수치 표시.
+ * 사용자 시선이 가장 먼저 가는 위치에 배치.
+ */
+const STAT_TILE = {
+    name: 'stat-tile',
+    category: 'kpi',
+    description: '강조 컬러 타일 + 큰 숫자값 + 작은 라벨. monitor-card 보다 시각적 무게가 강함 — 핵심 KPI 1~3 개에만 사용.',
+    keywords: ['타일', 'tile', 'kpi', '강조', 'highlight'],
+    defaultSize: { width: 220, height: 140 },
+    build(opts) {
+        const w = opts.width ?? 220;
+        const h = opts.height ?? 140;
+        const title = typeof opts.title === 'string' ? opts.title : 'Total';
+        const value = typeof opts.value === 'string' ? opts.value : '0';
+        const fill = typeof opts.fillStyle === 'string' ? opts.fillStyle : '#0ea5e9';
+        const textColor = typeof opts.textColor === 'string' ? opts.textColor : '#ffffff';
+        return {
+            type: 'group',
+            left: opts.left,
+            top: opts.top,
+            width: w,
+            height: h,
+            name: 'stat-tile',
+            components: [
+                {
+                    type: 'rect',
+                    left: 0,
+                    top: 0,
+                    width: w,
+                    height: h,
+                    fillStyle: fill,
+                    strokeStyle: 'transparent',
+                    strokeWidth: 0
+                },
+                {
+                    type: 'text',
+                    left: 16,
+                    top: 16,
+                    width: w - 32,
+                    height: 18,
+                    text: title,
+                    fillStyle: textColor,
+                    fontSize: 13,
+                    opacity: 0.85
+                },
+                {
+                    type: 'text',
+                    left: 16,
+                    top: 40,
+                    width: w - 32,
+                    height: h - 56,
+                    text: value,
+                    fillStyle: textColor,
+                    fontSize: 40,
+                    fontWeight: 'bold'
+                }
+            ]
+        };
+    }
+};
+// 모듈 로드 시 자동 등록 (idempotent — 다시 register 해도 덮어쓰기)
+registerBoardPrefab(MONITOR_CARD);
+registerBoardPrefab(GAUGE_PANEL);
+registerBoardPrefab(STAT_TILE);
+//# sourceMappingURL=prefab-registry.js.map

package/dist-server/service/prefab-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefab-registry.js","sourceRoot":"","sources":["../../server/service/prefab-registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Board Prefab Registry — 고품질 복합 컴포넌트 프리셋 카탈로그.\n *\n * 의도:\n *   - 보드 설계자가 실제로 원하는 단위는 rect/circle 같은 원시 도형이 아닌\n *     \"온도 모니터링 카드\", \"AGV 배터리 상태판\", \"공정 KPI 타일\" 같은 디자인된\n *     복합 모듈. 이 layer 가 그 단위를 시스템 차원에서 제공.\n *   - LLM 은 자유 작곡하지 않고 검증된 prefab 카탈로그에서 고름 → 결과 일관성 ↑,\n *     비용 ↓, 진입 장벽 낮춤.\n *\n * 통합:\n *   - 호스트 (operato 등) 가 패키지 로드 시 `registerBoardPrefab` 으로 자기 prefab\n *     등록. board-ai 는 registry 만 관리. 초기 예시 prefab 몇 개를 자체 등록 — 진짜\n *     디자인된 prefab 은 별도 패키지에서 추가.\n *   - LLM 도구 통합:\n *       getAvailablePrefabs (read)  → registry 의 메타데이터 반환\n *       addPrefab (write)           → name + 좌표/옵션 → 단일 BoardComponent (group)\n *\n * 식별자:\n *   - `name` 은 unique. 같은 name 으로 register 시 override (호스트가 자기 prefab 을\n *     커스터마이징할 수 있도록 의도적 허용).\n *   - 카테고리는 free-form string — registry 가 강제하지 않음. 사용자/운영 자율.\n */\nimport type { BoardComponent } from '@things-factory/board-import'\n\nexport interface BoardPrefab {\n  /** Unique 식별자 — 'kebab-case' 권장 */\n  name: string\n\n  /** 자유 분류 — 'monitoring' | 'control' | 'decoration' | 'kpi' 등 */\n  category?: string\n\n  /** 사용자 / LLM 이 이해할 한 문장 설명 */\n  description: string\n\n  /**\n   * 자연어 매칭 힌트 — '온도', '게이지', '카드' 등.\n   * findComponents 같은 검색이 아니라 LLM 의 의도 매칭용 메타데이터.\n   */\n  keywords?: string[]\n\n  /** 권장 기본 크기 — options 에 width/height 미지정 시 사용 */\n  defaultSize?: { width: number; height: number }\n\n  /**\n   * Prefab 의 컴포넌트 트리를 만든다. 단일 `BoardComponent` 반환 — 보통 group 타입이며\n   * `components` 자식을 가진다. 단일 add op 으로 매핑되어 undo 도 한 단위.\n   *\n   * options:\n   *   - left/top: anchor 좌표 (top-left 원점)\n   *   - width/height: 크기 (없으면 defaultSize)\n   *   - 추가 키: prefab 별 자유 (title 텍스트, 색상 등)\n   */\n  build(options: PrefabBuildOptions): BoardComponent\n}\n\nexport interface PrefabBuildOptions {\n  left: number\n  top: number\n  width?: number\n  height?: number\n  /** prefab 별 커스터마이징 — 자유 형태 */\n  [k: string]: any\n}\n\nconst REGISTRY = new Map<string, BoardPrefab>()\n\n/**\n * Prefab 등록. 같은 name 은 덮어씀 (호스트가 자기 prefab 으로 default 를 교체 가능).\n */\nexport function registerBoardPrefab(prefab: BoardPrefab): void {\n  if (!prefab || typeof prefab.name !== 'string' || prefab.name.length === 0) {\n    throw new Error('registerBoardPrefab: prefab.name is required')\n  }\n  if (typeof prefab.build !== 'function') {\n    throw new Error(`registerBoardPrefab(${prefab.name}): build() is required`)\n  }\n  REGISTRY.set(prefab.name, prefab)\n}\n\n/** 이름으로 조회. 없으면 undefined. */\nexport function findBoardPrefab(name: string): BoardPrefab | undefined {\n  return REGISTRY.get(name)\n}\n\n/** 등록된 prefab 의 메타데이터 (build 함수 제외) — getAvailablePrefabs 결과용. */\nexport function listBoardPrefabs(filter?: {\n  category?: string\n  keywordPattern?: string\n}): Array<Omit<BoardPrefab, 'build'>> {\n  const items: Array<Omit<BoardPrefab, 'build'>> = []\n  for (const p of REGISTRY.values()) {\n    if (filter?.category && p.category !== filter.category) continue\n    if (filter?.keywordPattern) {\n      const needle = filter.keywordPattern.toLowerCase()\n      const haystack = [\n        p.name,\n        p.description,\n        ...(p.keywords ?? [])\n      ]\n        .join(' ')\n        .toLowerCase()\n      if (!haystack.includes(needle)) continue\n    }\n    items.push({\n      name: p.name,\n      category: p.category,\n      description: p.description,\n      keywords: p.keywords,\n      defaultSize: p.defaultSize\n    })\n  }\n  return items\n}\n\n/** 테스트용 — 등록 상태 초기화. */\nexport function clearBoardPrefabsForTest(): void {\n  REGISTRY.clear()\n}\n\n// ── 초기 예시 prefab ─────────────────────────────────────────────\n//\n// 패키지 차원 default — 진짜 polished 디자인은 operato / 도메인 패키지에서 register.\n// 여기서는 architecture 데모 + LLM 이 선택할 후보가 0 이 되지 않도록 최소 set.\n\n/**\n * monitor-card — 라벨 + 큰 숫자값 + 부제 의 모니터링 타일.\n * 가장 흔한 대시보드 단위. AGV 배터리 / 온도 / 가동률 등 한 줄 KPI 표시.\n */\nconst MONITOR_CARD: BoardPrefab = {\n  name: 'monitor-card',\n  category: 'monitoring',\n  description:\n    'KPI 모니터링 카드 — 상단에 라벨, 중앙에 큰 값, 하단에 부제. 단일 수치 한 줄 표시 (온도/가동률/배터리 등).',\n  keywords: ['모니터링', 'kpi', '카드', '값', 'value', 'card'],\n  defaultSize: { width: 200, height: 120 },\n  build(opts) {\n    const w = opts.width ?? 200\n    const h = opts.height ?? 120\n    const title = typeof opts.title === 'string' ? opts.title : 'Label'\n    const value = typeof opts.value === 'string' ? opts.value : '0'\n    const subtitle = typeof opts.subtitle === 'string' ? opts.subtitle : ''\n    const fill = typeof opts.fillStyle === 'string' ? opts.fillStyle : '#1a2332'\n    const accent = typeof opts.accent === 'string' ? opts.accent : '#4fc3f7'\n\n    return {\n      type: 'group',\n      left: opts.left,\n      top: opts.top,\n      width: w,\n      height: h,\n      name: 'monitor-card',\n      components: [\n        {\n          type: 'rect',\n          left: 0,\n          top: 0,\n          width: w,\n          height: h,\n          fillStyle: fill,\n          strokeStyle: '#2a3a52',\n          strokeWidth: 1\n        },\n        {\n          type: 'text',\n          left: 12,\n          top: 10,\n          width: w - 24,\n          height: 16,\n          text: title,\n          fillStyle: '#94a3b8',\n          fontSize: 12\n        },\n        {\n          type: 'text',\n          left: 12,\n          top: 32,\n          width: w - 24,\n          height: h - 60,\n          text: value,\n          fillStyle: accent,\n          fontSize: 32,\n          fontWeight: 'bold'\n        },\n        {\n          type: 'text',\n          left: 12,\n          top: h - 22,\n          width: w - 24,\n          height: 14,\n          text: subtitle,\n          fillStyle: '#64748b',\n          fontSize: 11\n        }\n      ]\n    } as any as BoardComponent\n  }\n}\n\n/**\n * gauge-panel — 라벨 붙은 원형 게이지 패널.\n * gauge-circle 컴포넌트가 things-scene에 있음을 전제. 진짜 게이지가 없으면 폴백으로 circle.\n */\nconst GAUGE_PANEL: BoardPrefab = {\n  name: 'gauge-panel',\n  category: 'monitoring',\n  description:\n    '원형 게이지 + 라벨. 0~100 (또는 min/max) 범위의 단일 값 시각화 (CPU, 압력, 충전 등).',\n  keywords: ['게이지', 'gauge', '원형', '미터', 'meter', '센서'],\n  defaultSize: { width: 180, height: 200 },\n  build(opts) {\n    const w = opts.width ?? 180\n    const h = opts.height ?? 200\n    const title = typeof opts.title === 'string' ? opts.title : 'Gauge'\n    const value = typeof opts.value === 'number' ? opts.value : 50\n    const min = typeof opts.min === 'number' ? opts.min : 0\n    const max = typeof opts.max === 'number' ? opts.max : 100\n    const fill = typeof opts.fillStyle === 'string' ? opts.fillStyle : '#1a2332'\n\n    return {\n      type: 'group',\n      left: opts.left,\n      top: opts.top,\n      width: w,\n      height: h,\n      name: 'gauge-panel',\n      components: [\n        {\n          type: 'rect',\n          left: 0,\n          top: 0,\n          width: w,\n          height: h,\n          fillStyle: fill,\n          strokeStyle: '#2a3a52',\n          strokeWidth: 1\n        },\n        {\n          // gauge-circle 이 등록되어 있을 때 사용. 미등록 환경에서는 정상 추가는 되나\n          // render 가 fallback. operato 패키지에서 normalizeComponent 가 default 채움.\n          type: 'gauge-circle',\n          left: 20,\n          top: 20,\n          width: w - 40,\n          height: w - 40, // 정사각형 게이지\n          value,\n          min,\n          max\n        },\n        {\n          type: 'text',\n          left: 12,\n          top: h - 28,\n          width: w - 24,\n          height: 18,\n          text: title,\n          fillStyle: '#94a3b8',\n          fontSize: 13\n        }\n      ]\n    } as any as BoardComponent\n  }\n}\n\n/**\n * stat-tile — 컬러 타일 + 큰 숫자. monitor-card 보다 강조된 단일 수치 표시.\n * 사용자 시선이 가장 먼저 가는 위치에 배치.\n */\nconst STAT_TILE: BoardPrefab = {\n  name: 'stat-tile',\n  category: 'kpi',\n  description:\n    '강조 컬러 타일 + 큰 숫자값 + 작은 라벨. monitor-card 보다 시각적 무게가 강함 — 핵심 KPI 1~3 개에만 사용.',\n  keywords: ['타일', 'tile', 'kpi', '강조', 'highlight'],\n  defaultSize: { width: 220, height: 140 },\n  build(opts) {\n    const w = opts.width ?? 220\n    const h = opts.height ?? 140\n    const title = typeof opts.title === 'string' ? opts.title : 'Total'\n    const value = typeof opts.value === 'string' ? opts.value : '0'\n    const fill = typeof opts.fillStyle === 'string' ? opts.fillStyle : '#0ea5e9'\n    const textColor = typeof opts.textColor === 'string' ? opts.textColor : '#ffffff'\n\n    return {\n      type: 'group',\n      left: opts.left,\n      top: opts.top,\n      width: w,\n      height: h,\n      name: 'stat-tile',\n      components: [\n        {\n          type: 'rect',\n          left: 0,\n          top: 0,\n          width: w,\n          height: h,\n          fillStyle: fill,\n          strokeStyle: 'transparent',\n          strokeWidth: 0\n        },\n        {\n          type: 'text',\n          left: 16,\n          top: 16,\n          width: w - 32,\n          height: 18,\n          text: title,\n          fillStyle: textColor,\n          fontSize: 13,\n          opacity: 0.85\n        },\n        {\n          type: 'text',\n          left: 16,\n          top: 40,\n          width: w - 32,\n          height: h - 56,\n          text: value,\n          fillStyle: textColor,\n          fontSize: 40,\n          fontWeight: 'bold'\n        }\n      ]\n    } as any as BoardComponent\n  }\n}\n\n// 모듈 로드 시 자동 등록 (idempotent — 다시 register 해도 덮어쓰기)\nregisterBoardPrefab(MONITOR_CARD)\nregisterBoardPrefab(GAUGE_PANEL)\nregisterBoardPrefab(STAT_TILE)\n"]}

package/dist-server/service/styling/clear-tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * clearStyle — 특정 styling aspect 들을 초기화 (제거).
+ *
+ * preset 적용 전 / 데이터 바인딩 적용 전 깨끗한 상태로 돌리기 위한 helper.
+ */
+import type { BoardEditOp } from '../types';
+export interface ClearStyleInput {
+    refids: number[];
+    aspects: Array<'fill' | 'stroke' | 'shadow' | 'material' | 'font' | 'opacity'>;
+}
+export interface OpsResult {
+    ops: BoardEditOp[];
+    errors: string[];
+}
+export declare function buildClearStyleOps(input: ClearStyleInput): OpsResult;

package/dist-server/service/styling/clear-tools.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildClearStyleOps = buildClearStyleOps;
+const ASPECT_TO_PATCH = {
+    fill: { fillStyle: { type: 'none' } },
+    // stroke: strokeStyle 는 색상 문자열 (top-level), 굵기는 lineWidth (top-level).
+    // 굵기 0 으로 윤곽선 시각 제거 (색은 유지). 완전 제거는 strokeStyle: null 동시 set.
+    stroke: { lineWidth: 0 },
+    shadow: { shadow: { blur: 0, color: 'transparent' } },
+    material: { material3d: { preset: 'default' } },
+    // font: null = delete 시맨틱 (apply-patch.ts:233-243). 핵심 폰트 키 모두 제거 →
+    // component 가 기본 폰트 동작으로 복귀. 보존이 의도라면 font aspect 미선택.
+    font: {
+        fontSize: null,
+        fontFamily: null,
+        fontColor: null,
+        fontWeight: null,
+        fontStyle: null
+    },
+    opacity: { alpha: 1 }
+};
+function buildClearStyleOps(input) {
+    if (!Array.isArray(input.refids) || input.refids.length === 0) {
+        return { ops: [], errors: ['refids must be a non-empty array'] };
+    }
+    const refids = input.refids.filter(n => typeof n === 'number' && Number.isFinite(n));
+    if (refids.length === 0)
+        return { ops: [], errors: ['No valid numeric refids'] };
+    if (!Array.isArray(input.aspects) || input.aspects.length === 0) {
+        return { ops: [], errors: ['aspects must be a non-empty array'] };
+    }
+    const valid = ['fill', 'stroke', 'shadow', 'material', 'font', 'opacity'];
+    const unknown = input.aspects.filter(a => !valid.includes(a));
+    if (unknown.length > 0) {
+        return {
+            ops: [],
+            errors: [`Unknown aspect(s): ${unknown.join(', ')}. Valid: ${valid.join('/')}`]
+        };
+    }
+    // 모든 aspect 의 patch 를 하나로 병합 (한 refid 당 하나의 modify op)
+    const merged = {};
+    for (const a of input.aspects) {
+        Object.assign(merged, ASPECT_TO_PATCH[a]);
+    }
+    if (Object.keys(merged).length === 0) {
+        return { ops: [], errors: ['No effective patch — try other aspects'] };
+    }
+    return {
+        ops: refids.map(refid => ({ op: 'modify', refid, patch: merged })),
+        errors: []
+    };
+}
+//# sourceMappingURL=clear-tools.js.map

package/dist-server/service/styling/clear-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-tools.js","sourceRoot":"","sources":["../../../server/service/styling/clear-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * clearStyle — 특정 styling aspect 들을 초기화 (제거).\n *\n * preset 적용 전 / 데이터 바인딩 적용 전 깨끗한 상태로 돌리기 위한 helper.\n */\nimport type { BoardEditOp } from '../types'\n\nexport interface ClearStyleInput {\n  refids: number[]\n  aspects: Array<'fill' | 'stroke' | 'shadow' | 'material' | 'font' | 'opacity'>\n}\n\nexport interface OpsResult {\n  ops: BoardEditOp[]\n  errors: string[]\n}\n\nconst ASPECT_TO_PATCH: Record<string, any> = {\n  fill: { fillStyle: { type: 'none' } },\n  // stroke: strokeStyle 는 색상 문자열 (top-level), 굵기는 lineWidth (top-level).\n  // 굵기 0 으로 윤곽선 시각 제거 (색은 유지). 완전 제거는 strokeStyle: null 동시 set.\n  stroke: { lineWidth: 0 },\n  shadow: { shadow: { blur: 0, color: 'transparent' } },\n  material: { material3d: { preset: 'default' } },\n  // font: null = delete 시맨틱 (apply-patch.ts:233-243). 핵심 폰트 키 모두 제거 →\n  // component 가 기본 폰트 동작으로 복귀. 보존이 의도라면 font aspect 미선택.\n  font: {\n    fontSize: null,\n    fontFamily: null,\n    fontColor: null,\n    fontWeight: null,\n    fontStyle: null\n  },\n  opacity: { alpha: 1 }\n}\n\nexport function buildClearStyleOps(input: ClearStyleInput): OpsResult {\n  if (!Array.isArray(input.refids) || input.refids.length === 0) {\n    return { ops: [], errors: ['refids must be a non-empty array'] }\n  }\n  const refids = input.refids.filter(n => typeof n === 'number' && Number.isFinite(n))\n  if (refids.length === 0) return { ops: [], errors: ['No valid numeric refids'] }\n\n  if (!Array.isArray(input.aspects) || input.aspects.length === 0) {\n    return { ops: [], errors: ['aspects must be a non-empty array'] }\n  }\n  const valid = ['fill', 'stroke', 'shadow', 'material', 'font', 'opacity']\n  const unknown = input.aspects.filter(a => !valid.includes(a))\n  if (unknown.length > 0) {\n    return {\n      ops: [],\n      errors: [`Unknown aspect(s): ${unknown.join(', ')}. Valid: ${valid.join('/')}`]\n    }\n  }\n\n  // 모든 aspect 의 patch 를 하나로 병합 (한 refid 당 하나의 modify op)\n  const merged: any = {}\n  for (const a of input.aspects) {\n    Object.assign(merged, ASPECT_TO_PATCH[a])\n  }\n  if (Object.keys(merged).length === 0) {\n    return { ops: [], errors: ['No effective patch — try other aspects'] }\n  }\n\n  return {\n    ops: refids.map(refid => ({ op: 'modify', refid, patch: merged })),\n    errors: []\n  }\n}\n"]}

package/dist-server/service/styling/color-utils.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Color 파싱 / 정규화 유틸 — styling tool 들이 공통으로 사용.
+ *
+ * AI 가 자연어로 색상 표현하는 다양한 형태를 받아 표준 hex 또는 rgba 로 변환.
+ *
+ * 지원 입력:
+ *   - hex 6자리:  '#ff0000', '#FF0000'
+ *   - hex 3자리:  '#f00'  (→ '#ff0000')
+ *   - hex 8자리:  '#ff0000ff' (alpha 포함)
+ *   - rgb / rgba: 'rgb(255,0,0)', 'rgba(255,0,0,0.5)'
+ *   - CSS named: 'red', 'transparent', ...
+ *   - 시맨틱 alias: 'warm-red', 'forest-green', ...
+ *
+ * 출력 형태:
+ *   - normalizeColor(): 표준 hex (#rrggbb), opacity 는 별개로 분리 반환
+ *   - validateColor():  유효성만 체크 (boolean + 에러 메시지)
+ */
+/** Parse 결과 — color 와 alpha 분리. alpha 는 0..1. */
+export interface ParsedColor {
+    /** 표준 hex (#rrggbb, 소문자) 또는 'transparent' */
+    hex: string;
+    /** Alpha 채널 0..1. transparent 면 0, 명시 alpha 없으면 1. */
+    alpha: number;
+}
+/**
+ * 색상 입력을 정규 hex + alpha 로 변환.
+ * 잘못된 입력은 null — 호출자가 에러 처리.
+ */
+export declare function parseColor(input: string | null | undefined): ParsedColor | null;
+/**
+ * 단순 검증 — 정규화 가능 여부만.
+ * 에러 메시지에 정정 제안 포함 가능.
+ */
+export declare function validateColor(input: string | null | undefined): {
+    valid: boolean;
+    error?: string;
+    suggestion?: string;
+};
+/**
+ * 색상을 hex 문자열로 정규화 (저장용).
+ * 실패 시 null.
+ */
+export declare function normalizeColor(input: string | null | undefined): string | null;