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

package/dist-client/utils/board-edit-patch.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Client-side BoardEditPatch types + applier.
+ *
+ * NOTE: 동일 정의가 server/service/types.ts + apply-patch.ts 에 있음.
+ * client 번들이 server 코드를 import 하지 않도록 분리. 변경 시 양쪽 동기화 필요.
+ */
+/**
+ * 컴포넌트 타깃팅은 항상 `refid` (things-scene universal numeric handle).
+ * `id` 는 데이터 바인딩 이름이며 unique 가 아니므로 targeting 에 사용하지 않는다.
+ *
+ * 보드는 최상위 부모 — 자체 속성 (fillStyle / width / height / name 등) 을 갖고,
+ * `modifyBoard` 로 변경. 자식 컴포넌트 변경 (`modify`) 와 분리.
+ */
+export type BoardEditOp = {
+    op: 'add';
+    component: any;
+} | {
+    op: 'remove';
+    refid: number;
+} | {
+    op: 'modify';
+    refid: number;
+    patch: any;
+} | {
+    op: 'modifyBoard';
+    patch: any;
+} | {
+    op: 'replace';
+    board: any;
+};
+export interface BoardEditPatch {
+    ops: BoardEditOp[];
+    summary: string;
+    confidence: number;
+}
+export interface PatchApplyReport {
+    /** 패치 적용 후 보드. 모든 op 가 noop 이어도 입력 그대로 반환. */
+    board: any;
+    /** 실제로 보드를 바꾼 op 들. */
+    applied: BoardEditOp[];
+    /** id 매칭 실패 등으로 noop 이 된 op 들 — 호출자가 사용자에게 알릴 단서. */
+    missed: BoardEditOp[];
+}
+/**
+ * Patch 를 BoardModel 에 적용 (pure, board 를 mutate 하지 않음).
+ */
+export declare function applyBoardEditPatch(board: any | undefined, patch: BoardEditPatch): any;
+/**
+ * Verbose 변형 — 각 op 의 적용 여부를 보고.
+ *
+ * `modify` 와 `remove` 는 id 가 보드에 없으면 silent no-op 이 된다. LLM 이 잘못된
+ * id 를 만들어 보내면 사용자에게 "수정했습니다" 라고 답하지만 실제로는 아무 변화도
+ * 없는 상황이 발생 — 호스트가 missed 를 보고 사용자에게 경고할 수 있도록 별도
+ * entry point 제공.
+ */
+export declare function applyBoardEditPatchVerbose(board: any | undefined, patch: BoardEditPatch): PatchApplyReport;
+/**
+ * 주어진 board 상태에서 op 의 inverse 를 계산.
+ *
+ * Revert 기능 — patch 적용 직전 board + op 로 역연산을 만든다. 호스트가
+ * 누적해두면 나중에 역순 실행만으로 복원.
+ *
+ * add 의 inverse 는 새로 발급될 refid 를 알아야 → 모델 단계에서 계산 불가.
+ * 호스트가 scene.add 직후 refid 를 캡처해 직접 만들 것.
+ */
+export declare function computeInverseOp(board: any, op: BoardEditOp): BoardEditOp | null;
+/**
+ * 컴포넌트에 부분 patch 를 적용 (deep merge).
+ * threeD 등 nested object 는 deep merge — 색만 바꾸려고 했을 때 geometry 까지 사라지지 않도록.
+ *
+ * host (board-modeller-page) 에서 things-scene 의 component.set(merged) 호출 전에 사용.
+ */
+export declare function mergeComponent(base: any, patch: any): any;

package/dist-client/utils/board-edit-patch.js

@@ -0,0 +1,159 @@
+/**
+ * Client-side BoardEditPatch types + applier.
+ *
+ * NOTE: 동일 정의가 server/service/types.ts + apply-patch.ts 에 있음.
+ * client 번들이 server 코드를 import 하지 않도록 분리. 변경 시 양쪽 동기화 필요.
+ */
+const EMPTY_BOARD = { width: 1000, height: 600, components: [] };
+/**
+ * Patch 를 BoardModel 에 적용 (pure, board 를 mutate 하지 않음).
+ */
+export function applyBoardEditPatch(board, patch) {
+    return applyBoardEditPatchVerbose(board, patch).board;
+}
+/**
+ * Verbose 변형 — 각 op 의 적용 여부를 보고.
+ *
+ * `modify` 와 `remove` 는 id 가 보드에 없으면 silent no-op 이 된다. LLM 이 잘못된
+ * id 를 만들어 보내면 사용자에게 "수정했습니다" 라고 답하지만 실제로는 아무 변화도
+ * 없는 상황이 발생 — 호스트가 missed 를 보고 사용자에게 경고할 수 있도록 별도
+ * entry point 제공.
+ */
+export function applyBoardEditPatchVerbose(board, patch) {
+    let result = board ?? EMPTY_BOARD;
+    const applied = [];
+    const missed = [];
+    for (const op of patch.ops) {
+        const next = applyOp(result, op);
+        if (next === result || componentsUnchanged(result, next)) {
+            missed.push(op);
+        }
+        else {
+            applied.push(op);
+            result = next;
+        }
+    }
+    return { board: result, applied, missed };
+}
+function componentsUnchanged(prev, next) {
+    // applyOp 는 항상 새 객체를 만든다. 따라서 reference 비교가 안 되고 내용 비교 필요.
+    // components 는 map/filter 결과 reference 도 다를 수 있으므로 length + 요소 ref 비교.
+    const a = prev.components ?? [];
+    const b = next.components ?? [];
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return prev.width === next.width && prev.height === next.height && prev.fillStyle === next.fillStyle;
+}
+function applyOp(board, op) {
+    switch (op.op) {
+        case 'replace':
+            return op.board;
+        case 'add':
+            return { ...board, components: [...(board.components || []), op.component] };
+        case 'remove':
+            return {
+                ...board,
+                components: (board.components || []).filter((c) => c?.refid !== op.refid)
+            };
+        case 'modify':
+            return {
+                ...board,
+                components: (board.components || []).map((c) => c?.refid === op.refid ? mergeComponent(c, op.patch) : c)
+            };
+        case 'modifyBoard': {
+            const patch = { ...(op.patch || {}) };
+            delete patch.components; // 자식 변경은 별도 op
+            return mergeComponent(board, patch); // 최상위 board 자체에 deep-merge
+        }
+        default:
+            return board;
+    }
+}
+/**
+ * 주어진 board 상태에서 op 의 inverse 를 계산.
+ *
+ * Revert 기능 — patch 적용 직전 board + op 로 역연산을 만든다. 호스트가
+ * 누적해두면 나중에 역순 실행만으로 복원.
+ *
+ * add 의 inverse 는 새로 발급될 refid 를 알아야 → 모델 단계에서 계산 불가.
+ * 호스트가 scene.add 직후 refid 를 캡처해 직접 만들 것.
+ */
+export function computeInverseOp(board, op) {
+    if (!board)
+        return null;
+    const components = board.components ?? [];
+    switch (op.op) {
+        case 'add':
+            return null;
+        case 'remove': {
+            const target = components.find((c) => c?.refid === op.refid);
+            if (!target)
+                return null;
+            return { op: 'add', component: JSON.parse(JSON.stringify(target)) };
+        }
+        case 'modify': {
+            const target = components.find((c) => c?.refid === op.refid);
+            if (!target)
+                return null;
+            const oldValues = {};
+            for (const k of Object.keys(op.patch || {})) {
+                const v = target[k];
+                oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v));
+            }
+            return { op: 'modify', refid: op.refid, patch: oldValues };
+        }
+        case 'modifyBoard': {
+            const oldValues = {};
+            const patch = op.patch || {};
+            for (const k of Object.keys(patch)) {
+                if (k === 'components')
+                    continue;
+                const v = board[k];
+                oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v));
+            }
+            return { op: 'modifyBoard', patch: oldValues };
+        }
+        case 'replace':
+            return { op: 'replace', board: JSON.parse(JSON.stringify(board)) };
+        default:
+            return null;
+    }
+}
+/**
+ * 컴포넌트에 부분 patch 를 적용 (deep merge).
+ * threeD 등 nested object 는 deep merge — 색만 바꾸려고 했을 때 geometry 까지 사라지지 않도록.
+ *
+ * host (board-modeller-page) 에서 things-scene 의 component.set(merged) 호출 전에 사용.
+ */
+export function mergeComponent(base, patch) {
+    const out = { ...base };
+    for (const key of Object.keys(patch)) {
+        if (isPlainObject(base[key]) && isPlainObject(patch[key])) {
+            out[key] = deepMerge(base[key], patch[key]);
+        }
+        else {
+            out[key] = patch[key];
+        }
+    }
+    return out;
+}
+function deepMerge(a, b) {
+    const out = { ...a };
+    for (const key of Object.keys(b)) {
+        if (isPlainObject(a[key]) && isPlainObject(b[key])) {
+            out[key] = deepMerge(a[key], b[key]);
+        }
+        else {
+            out[key] = b[key];
+        }
+    }
+    return out;
+}
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+//# sourceMappingURL=board-edit-patch.js.map

package/dist-client/utils/board-edit-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-edit-patch.js","sourceRoot":"","sources":["../../client/utils/board-edit-patch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Client-side BoardEditPatch types + applier.\n *\n * NOTE: 동일 정의가 server/service/types.ts + apply-patch.ts 에 있음.\n * client 번들이 server 코드를 import 하지 않도록 분리. 변경 시 양쪽 동기화 필요.\n */\n\n/**\n * 컴포넌트 타깃팅은 항상 `refid` (things-scene universal numeric handle).\n * `id` 는 데이터 바인딩 이름이며 unique 가 아니므로 targeting 에 사용하지 않는다.\n *\n * 보드는 최상위 부모 — 자체 속성 (fillStyle / width / height / name 등) 을 갖고,\n * `modifyBoard` 로 변경. 자식 컴포넌트 변경 (`modify`) 와 분리.\n */\nexport type BoardEditOp =\n  | { op: 'add'; component: any }\n  | { op: 'remove'; refid: number }\n  | { op: 'modify'; refid: number; patch: any }\n  | { op: 'modifyBoard'; patch: any }\n  | { op: 'replace'; board: any }\n\nexport interface BoardEditPatch {\n  ops: BoardEditOp[]\n  summary: string\n  confidence: number\n}\n\nexport interface PatchApplyReport {\n  /** 패치 적용 후 보드. 모든 op 가 noop 이어도 입력 그대로 반환. */\n  board: any\n  /** 실제로 보드를 바꾼 op 들. */\n  applied: BoardEditOp[]\n  /** id 매칭 실패 등으로 noop 이 된 op 들 — 호출자가 사용자에게 알릴 단서. */\n  missed: BoardEditOp[]\n}\n\nconst EMPTY_BOARD = { width: 1000, height: 600, components: [] as any[] }\n\n/**\n * Patch 를 BoardModel 에 적용 (pure, board 를 mutate 하지 않음).\n */\nexport function applyBoardEditPatch(board: any | undefined, patch: BoardEditPatch): any {\n  return applyBoardEditPatchVerbose(board, patch).board\n}\n\n/**\n * Verbose 변형 — 각 op 의 적용 여부를 보고.\n *\n * `modify` 와 `remove` 는 id 가 보드에 없으면 silent no-op 이 된다. LLM 이 잘못된\n * id 를 만들어 보내면 사용자에게 \"수정했습니다\" 라고 답하지만 실제로는 아무 변화도\n * 없는 상황이 발생 — 호스트가 missed 를 보고 사용자에게 경고할 수 있도록 별도\n * entry point 제공.\n */\nexport function applyBoardEditPatchVerbose(\n  board: any | undefined,\n  patch: BoardEditPatch\n): PatchApplyReport {\n  let result: any = board ?? EMPTY_BOARD\n  const applied: BoardEditOp[] = []\n  const missed: BoardEditOp[] = []\n\n  for (const op of patch.ops) {\n    const next = applyOp(result, op)\n    if (next === result || componentsUnchanged(result, next)) {\n      missed.push(op)\n    } else {\n      applied.push(op)\n      result = next\n    }\n  }\n\n  return { board: result, applied, missed }\n}\n\nfunction componentsUnchanged(prev: any, next: any): boolean {\n  // applyOp 는 항상 새 객체를 만든다. 따라서 reference 비교가 안 되고 내용 비교 필요.\n  // components 는 map/filter 결과 reference 도 다를 수 있으므로 length + 요소 ref 비교.\n  const a = prev.components ?? []\n  const b = next.components ?? []\n  if (a.length !== b.length) return false\n  for (let i = 0; i < a.length; i++) {\n    if (a[i] !== b[i]) return false\n  }\n  return prev.width === next.width && prev.height === next.height && prev.fillStyle === next.fillStyle\n}\n\nfunction applyOp(board: any, op: BoardEditOp): any {\n  switch (op.op) {\n    case 'replace':\n      return op.board\n    case 'add':\n      return { ...board, components: [...(board.components || []), op.component] }\n    case 'remove':\n      return {\n        ...board,\n        components: (board.components || []).filter((c: any) => c?.refid !== op.refid)\n      }\n    case 'modify':\n      return {\n        ...board,\n        components: (board.components || []).map((c: any) =>\n          c?.refid === op.refid ? mergeComponent(c, op.patch) : c\n        )\n      }\n    case 'modifyBoard': {\n      const patch = { ...(op.patch || {}) }\n      delete patch.components // 자식 변경은 별도 op\n      return mergeComponent(board, patch) // 최상위 board 자체에 deep-merge\n    }\n    default:\n      return board\n  }\n}\n\n/**\n * 주어진 board 상태에서 op 의 inverse 를 계산.\n *\n * Revert 기능 — patch 적용 직전 board + op 로 역연산을 만든다. 호스트가\n * 누적해두면 나중에 역순 실행만으로 복원.\n *\n * add 의 inverse 는 새로 발급될 refid 를 알아야 → 모델 단계에서 계산 불가.\n * 호스트가 scene.add 직후 refid 를 캡처해 직접 만들 것.\n */\nexport function computeInverseOp(board: any, op: BoardEditOp): BoardEditOp | null {\n  if (!board) return null\n  const components = board.components ?? []\n\n  switch (op.op) {\n    case 'add':\n      return null\n\n    case 'remove': {\n      const target = components.find((c: any) => c?.refid === op.refid)\n      if (!target) return null\n      return { op: 'add', component: JSON.parse(JSON.stringify(target)) }\n    }\n\n    case 'modify': {\n      const target = components.find((c: any) => c?.refid === op.refid)\n      if (!target) return null\n      const oldValues: any = {}\n      for (const k of Object.keys(op.patch || {})) {\n        const v = (target as any)[k]\n        oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v))\n      }\n      return { op: 'modify', refid: op.refid, patch: oldValues }\n    }\n\n    case 'modifyBoard': {\n      const oldValues: any = {}\n      const patch = op.patch || {}\n      for (const k of Object.keys(patch)) {\n        if (k === 'components') continue\n        const v = (board as any)[k]\n        oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v))\n      }\n      return { op: 'modifyBoard', patch: oldValues }\n    }\n\n    case 'replace':\n      return { op: 'replace', board: JSON.parse(JSON.stringify(board)) }\n\n    default:\n      return null\n  }\n}\n\n/**\n * 컴포넌트에 부분 patch 를 적용 (deep merge).\n * threeD 등 nested object 는 deep merge — 색만 바꾸려고 했을 때 geometry 까지 사라지지 않도록.\n *\n * host (board-modeller-page) 에서 things-scene 의 component.set(merged) 호출 전에 사용.\n */\nexport function mergeComponent(base: any, patch: any): any {\n  const out: any = { ...base }\n  for (const key of Object.keys(patch)) {\n    if (isPlainObject(base[key]) && isPlainObject(patch[key])) {\n      out[key] = deepMerge(base[key], patch[key])\n    } else {\n      out[key] = patch[key]\n    }\n  }\n  return out\n}\n\nfunction deepMerge(a: any, b: any): any {\n  const out: any = { ...a }\n  for (const key of Object.keys(b)) {\n    if (isPlainObject(a[key]) && isPlainObject(b[key])) {\n      out[key] = deepMerge(a[key], b[key])\n    } else {\n      out[key] = b[key]\n    }\n  }\n  return out\n}\n\nfunction isPlainObject(v: any): boolean {\n  return v !== null && typeof v === 'object' && !Array.isArray(v)\n}\n"]}

package/dist-server/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @things-factory/board-ai — AI 주도 보드 모델링.
+ *
+ * 단일 진입점 `chat()` 으로 보드 생성·편집·스타일링을 자연어로 통합 처리.
+ * board-import 의 BoardModel 위에서 동작하며, ai-client-base 가 LLM provider 추상화 담당.
+ *
+ * 사용:
+ * ```ts
+ * import { createAIClient } from '@things-factory/ai-client-base'
+ * import { DefaultBoardAIAssistant, applyBoardEditPatch } from '@things-factory/board-ai'
+ *
+ * const base = createAIClient({ provider: 'anthropic', apiKey: '...' })
+ * const ai = new DefaultBoardAIAssistant(base, { scopes: ['fmsim'] })
+ *
+ * let board
+ * const r = await ai.chat([{ role: 'user', content: 'AGV 3대를 우측에 추가' }], board)
+ * if (r.patch) board = applyBoardEditPatch(board, r.patch)
+ * console.log(r.reply)
+ * ```
+ */
+export * from './service/index.js';

package/dist-server/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * @things-factory/board-ai — AI 주도 보드 모델링.
+ *
+ * 단일 진입점 `chat()` 으로 보드 생성·편집·스타일링을 자연어로 통합 처리.
+ * board-import 의 BoardModel 위에서 동작하며, ai-client-base 가 LLM provider 추상화 담당.
+ *
+ * 사용:
+ * ```ts
+ * import { createAIClient } from '@things-factory/ai-client-base'
+ * import { DefaultBoardAIAssistant, applyBoardEditPatch } from '@things-factory/board-ai'
+ *
+ * const base = createAIClient({ provider: 'anthropic', apiKey: '...' })
+ * const ai = new DefaultBoardAIAssistant(base, { scopes: ['fmsim'] })
+ *
+ * let board
+ * const r = await ai.chat([{ role: 'user', content: 'AGV 3대를 우측에 추가' }], board)
+ * if (r.patch) board = applyBoardEditPatch(board, r.patch)
+ * console.log(r.reply)
+ * ```
+ */
+tslib_1.__exportStar(require("./service/index.js"), 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;;;;;;;;;;;;;;;;;;;GAmBG;AACH,6DAAkC","sourcesContent":["/**\n * @things-factory/board-ai — AI 주도 보드 모델링.\n *\n * 단일 진입점 `chat()` 으로 보드 생성·편집·스타일링을 자연어로 통합 처리.\n * board-import 의 BoardModel 위에서 동작하며, ai-client-base 가 LLM provider 추상화 담당.\n *\n * 사용:\n * ```ts\n * import { createAIClient } from '@things-factory/ai-client-base'\n * import { DefaultBoardAIAssistant, applyBoardEditPatch } from '@things-factory/board-ai'\n *\n * const base = createAIClient({ provider: 'anthropic', apiKey: '...' })\n * const ai = new DefaultBoardAIAssistant(base, { scopes: ['fmsim'] })\n *\n * let board\n * const r = await ai.chat([{ role: 'user', content: 'AGV 3대를 우측에 추가' }], board)\n * if (r.patch) board = applyBoardEditPatch(board, r.patch)\n * console.log(r.reply)\n * ```\n */\nexport * from './service/index.js'\n"]}

package/dist-server/service/apply-patch.d.ts

@@ -0,0 +1,46 @@
+/**
+ * BoardEditPatch 를 BoardModel 에 적용하는 표준 helper.
+ *
+ * 호출자가 patch 응답을 받아 보드에 반영할 때 사용.
+ * Pure function — 입력을 mutate 하지 않음.
+ */
+import type { BoardComponent, BoardModel } from '@things-factory/board-import';
+import type { BoardEditOp, BoardEditPatch } from './types.js';
+export interface PatchApplyReport {
+    /** 패치 적용 후 보드. 모든 op 가 noop 이어도 입력 그대로 반환. */
+    board: BoardModel;
+    /** 실제로 보드를 바꾼 op 들. */
+    applied: BoardEditOp[];
+    /** id 매칭 실패 등으로 noop 이 된 op 들 — 호출자가 사용자에게 알릴 단서. */
+    missed: BoardEditOp[];
+}
+export declare function applyBoardEditPatch(board: BoardModel | undefined, patch: BoardEditPatch): BoardModel;
+/**
+ * Verbose 변형 — 각 op 의 적용 여부를 보고.
+ *
+ * `modify` 와 `remove` 는 id 가 보드에 없으면 silent no-op 이 된다 (patch 함수의
+ * 의도적 단순화). LLM 이 잘못된 id 를 만들어 보내면 사용자에게 "수정했습니다"
+ * 라고 답하지만 실제로는 아무 변화도 없는 상황이 발생 — 호스트가 missed 를
+ * 보고 사용자에게 경고할 수 있도록 별도 entry point 제공.
+ */
+export declare function applyBoardEditPatchVerbose(board: BoardModel | undefined, patch: BoardEditPatch): PatchApplyReport;
+/**
+ * 주어진 board 상태에서 op 의 inverse 를 계산.
+ *
+ * Revert 기능의 코어 — patch 적용 직전 board 와 op 만 알면 그 op 의 역연산을
+ * 만들 수 있으므로, 호스트가 in-place 적용하면서 함께 누적해 두면 나중에
+ * 역순 실행만으로 복원 가능.
+ *
+ * 반환:
+ *   - inverse op 또는 null (unsupported / 데이터 부족)
+ *   - add 의 inverse 는 add 후 발급되는 refid 가 필요해서 모델 단계에서 계산 불가 →
+ *     호스트가 scene.add 직후 refid 를 캡처해 직접 만들 것 (이 함수는 pre-applied
+ *     board 만 보고 만들 수 있는 종류만 처리: remove / modify / modifyBoard / replace)
+ */
+export declare function computeInverseOp(board: BoardModel | undefined, op: BoardEditOp): BoardEditOp | null;
+export declare function applyOp(board: BoardModel, op: BoardEditOp): BoardModel;
+/**
+ * 컴포넌트에 부분 patch 를 적용.
+ * threeD 등 nested object 는 deep merge — 호출자가 색만 바꾸려고 했을 때 geometry 까지 사라지지 않도록.
+ */
+export declare function mergeComponent(base: BoardComponent, patch: Partial<BoardComponent>): BoardComponent;

package/dist-server/service/apply-patch.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyBoardEditPatch = applyBoardEditPatch;
+exports.applyBoardEditPatchVerbose = applyBoardEditPatchVerbose;
+exports.computeInverseOp = computeInverseOp;
+exports.applyOp = applyOp;
+exports.mergeComponent = mergeComponent;
+const EMPTY_BOARD = {
+    width: 1000,
+    height: 600,
+    components: []
+};
+function applyBoardEditPatch(board, patch) {
+    return applyBoardEditPatchVerbose(board, patch).board;
+}
+/**
+ * Verbose 변형 — 각 op 의 적용 여부를 보고.
+ *
+ * `modify` 와 `remove` 는 id 가 보드에 없으면 silent no-op 이 된다 (patch 함수의
+ * 의도적 단순화). LLM 이 잘못된 id 를 만들어 보내면 사용자에게 "수정했습니다"
+ * 라고 답하지만 실제로는 아무 변화도 없는 상황이 발생 — 호스트가 missed 를
+ * 보고 사용자에게 경고할 수 있도록 별도 entry point 제공.
+ */
+function applyBoardEditPatchVerbose(board, patch) {
+    let result = board ?? EMPTY_BOARD;
+    const applied = [];
+    const missed = [];
+    for (const op of patch.ops) {
+        const next = applyOp(result, op);
+        if (next === result || componentsUnchanged(result, next)) {
+            missed.push(op);
+        }
+        else {
+            applied.push(op);
+            result = next;
+        }
+    }
+    return { board: result, applied, missed };
+}
+function componentsUnchanged(prev, next) {
+    // applyOp 는 항상 새 객체를 만든다 (`{ ...board, components: ... }`). 따라서 reference
+    // 비교가 안 되고 내용 비교가 필요. components 는 map/filter 결과 reference 도 다를 수
+    // 있으므로 length + JSON 깊이 비교.
+    const a = prev.components ?? [];
+    const b = next.components ?? [];
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    // root meta (width/height/...) 비교
+    return prev.width === next.width && prev.height === next.height && prev.fillStyle === next.fillStyle;
+}
+/**
+ * 주어진 board 상태에서 op 의 inverse 를 계산.
+ *
+ * Revert 기능의 코어 — patch 적용 직전 board 와 op 만 알면 그 op 의 역연산을
+ * 만들 수 있으므로, 호스트가 in-place 적용하면서 함께 누적해 두면 나중에
+ * 역순 실행만으로 복원 가능.
+ *
+ * 반환:
+ *   - inverse op 또는 null (unsupported / 데이터 부족)
+ *   - add 의 inverse 는 add 후 발급되는 refid 가 필요해서 모델 단계에서 계산 불가 →
+ *     호스트가 scene.add 직후 refid 를 캡처해 직접 만들 것 (이 함수는 pre-applied
+ *     board 만 보고 만들 수 있는 종류만 처리: remove / modify / modifyBoard / replace)
+ */
+function computeInverseOp(board, op) {
+    if (!board)
+        return null;
+    const components = board.components ?? [];
+    switch (op.op) {
+        case 'add':
+            // add 의 inverse 는 새로 발급될 refid 를 알아야 → 호스트 측에서 처리
+            return null;
+        case 'remove': {
+            const target = components.find(c => c?.refid === op.refid);
+            if (!target)
+                return null; // 매칭 실패 — silent no-op 이라 inverse 도 없음
+            return { op: 'add', component: JSON.parse(JSON.stringify(target)) };
+        }
+        case 'modify': {
+            const target = components.find(c => c?.refid === op.refid);
+            if (!target)
+                return null;
+            // patch 가 건드린 키만 보관. nested 는 통째로.
+            const oldValues = {};
+            for (const k of Object.keys(op.patch || {})) {
+                const v = target[k];
+                oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v));
+            }
+            return { op: 'modify', refid: op.refid, patch: oldValues };
+        }
+        case 'modifyBoard': {
+            const oldValues = {};
+            const patch = op.patch || {};
+            for (const k of Object.keys(patch)) {
+                if (k === 'components')
+                    continue;
+                const v = board[k];
+                oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v));
+            }
+            return { op: 'modifyBoard', patch: oldValues };
+        }
+        case 'replace':
+            // 이전 보드 통째로 보관 — replace 의 자연스러운 inverse 는 또 다른 replace
+            return { op: 'replace', board: JSON.parse(JSON.stringify(board)) };
+        default:
+            return null;
+    }
+}
+function applyOp(board, op) {
+    const components = board.components ?? [];
+    switch (op.op) {
+        case 'replace':
+            return op.board;
+        case 'add':
+            return { ...board, components: [...components, op.component] };
+        case 'remove':
+            return { ...board, components: components.filter(c => c?.refid !== op.refid) };
+        case 'modify':
+            return {
+                ...board,
+                components: components.map(c => c?.refid === op.refid ? mergeComponent(c, op.patch) : c)
+            };
+        case 'modifyBoard': {
+            // 루트 속성 (fillStyle / width / height / name 등) 만 deep merge.
+            // components 키는 무시 — 자식 변경은 add/remove/modify 별도 op 로.
+            const patch = { ...op.patch };
+            delete patch.components;
+            return mergeBoardRoot(board, patch);
+        }
+        default:
+            return board;
+    }
+}
+function mergeBoardRoot(board, patch) {
+    const out = { ...board };
+    for (const key of Object.keys(patch)) {
+        const bv = board[key];
+        const pv = patch[key];
+        if (bv !== null &&
+            pv !== null &&
+            typeof bv === 'object' &&
+            typeof pv === 'object' &&
+            !Array.isArray(bv) &&
+            !Array.isArray(pv)) {
+            out[key] = deepMergeRoot(bv, pv);
+        }
+        else {
+            out[key] = pv;
+        }
+    }
+    return out;
+}
+function deepMergeRoot(a, b) {
+    const out = { ...a };
+    for (const key of Object.keys(b)) {
+        const av = a[key];
+        const bv = b[key];
+        if (av !== null &&
+            bv !== null &&
+            typeof av === 'object' &&
+            typeof bv === 'object' &&
+            !Array.isArray(av) &&
+            !Array.isArray(bv)) {
+            out[key] = deepMergeRoot(av, bv);
+        }
+        else {
+            out[key] = bv;
+        }
+    }
+    return out;
+}
+/**
+ * 컴포넌트에 부분 patch 를 적용.
+ * threeD 등 nested object 는 deep merge — 호출자가 색만 바꾸려고 했을 때 geometry 까지 사라지지 않도록.
+ */
+function mergeComponent(base, patch) {
+    const out = { ...base };
+    for (const key of Object.keys(patch)) {
+        const baseVal = base[key];
+        const patchVal = patch[key];
+        if (isPlainObject(baseVal) &&
+            isPlainObject(patchVal)) {
+            out[key] = deepMerge(baseVal, patchVal);
+        }
+        else {
+            out[key] = patchVal;
+        }
+    }
+    return out;
+}
+function deepMerge(a, b) {
+    const out = { ...a };
+    for (const key of Object.keys(b)) {
+        const av = a[key];
+        const bv = b[key];
+        if (isPlainObject(av) && isPlainObject(bv)) {
+            out[key] = deepMerge(av, bv);
+        }
+        else {
+            out[key] = bv;
+        }
+    }
+    return out;
+}
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+//# sourceMappingURL=apply-patch.js.map

package/dist-server/service/apply-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-patch.js","sourceRoot":"","sources":["../../server/service/apply-patch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * BoardEditPatch 를 BoardModel 에 적용하는 표준 helper.\n *\n * 호출자가 patch 응답을 받아 보드에 반영할 때 사용.\n * Pure function — 입력을 mutate 하지 않음.\n */\nimport type { BoardComponent, BoardModel } from '@things-factory/board-import'\nimport type { BoardEditOp, BoardEditPatch } from './types.js'\n\nconst EMPTY_BOARD: BoardModel = {\n  width: 1000,\n  height: 600,\n  components: []\n}\n\nexport interface PatchApplyReport {\n  /** 패치 적용 후 보드. 모든 op 가 noop 이어도 입력 그대로 반환. */\n  board: BoardModel\n  /** 실제로 보드를 바꾼 op 들. */\n  applied: BoardEditOp[]\n  /** id 매칭 실패 등으로 noop 이 된 op 들 — 호출자가 사용자에게 알릴 단서. */\n  missed: BoardEditOp[]\n}\n\nexport function applyBoardEditPatch(\n  board: BoardModel | undefined,\n  patch: BoardEditPatch\n): BoardModel {\n  return applyBoardEditPatchVerbose(board, patch).board\n}\n\n/**\n * Verbose 변형 — 각 op 의 적용 여부를 보고.\n *\n * `modify` 와 `remove` 는 id 가 보드에 없으면 silent no-op 이 된다 (patch 함수의\n * 의도적 단순화). LLM 이 잘못된 id 를 만들어 보내면 사용자에게 \"수정했습니다\"\n * 라고 답하지만 실제로는 아무 변화도 없는 상황이 발생 — 호스트가 missed 를\n * 보고 사용자에게 경고할 수 있도록 별도 entry point 제공.\n */\nexport function applyBoardEditPatchVerbose(\n  board: BoardModel | undefined,\n  patch: BoardEditPatch\n): PatchApplyReport {\n  let result: BoardModel = board ?? EMPTY_BOARD\n  const applied: BoardEditOp[] = []\n  const missed: BoardEditOp[] = []\n\n  for (const op of patch.ops) {\n    const next = applyOp(result, op)\n    if (next === result || componentsUnchanged(result, next)) {\n      missed.push(op)\n    } else {\n      applied.push(op)\n      result = next\n    }\n  }\n\n  return { board: result, applied, missed }\n}\n\nfunction componentsUnchanged(prev: BoardModel, next: BoardModel): boolean {\n  // applyOp 는 항상 새 객체를 만든다 (`{ ...board, components: ... }`). 따라서 reference\n  // 비교가 안 되고 내용 비교가 필요. components 는 map/filter 결과 reference 도 다를 수\n  // 있으므로 length + JSON 깊이 비교.\n  const a = prev.components ?? []\n  const b = next.components ?? []\n  if (a.length !== b.length) return false\n  for (let i = 0; i < a.length; i++) {\n    if (a[i] !== b[i]) return false\n  }\n  // root meta (width/height/...) 비교\n  return prev.width === next.width && prev.height === next.height && prev.fillStyle === next.fillStyle\n}\n\n/**\n * 주어진 board 상태에서 op 의 inverse 를 계산.\n *\n * Revert 기능의 코어 — patch 적용 직전 board 와 op 만 알면 그 op 의 역연산을\n * 만들 수 있으므로, 호스트가 in-place 적용하면서 함께 누적해 두면 나중에\n * 역순 실행만으로 복원 가능.\n *\n * 반환:\n *   - inverse op 또는 null (unsupported / 데이터 부족)\n *   - add 의 inverse 는 add 후 발급되는 refid 가 필요해서 모델 단계에서 계산 불가 →\n *     호스트가 scene.add 직후 refid 를 캡처해 직접 만들 것 (이 함수는 pre-applied\n *     board 만 보고 만들 수 있는 종류만 처리: remove / modify / modifyBoard / replace)\n */\nexport function computeInverseOp(\n  board: BoardModel | undefined,\n  op: BoardEditOp\n): BoardEditOp | null {\n  if (!board) return null\n  const components = board.components ?? []\n\n  switch (op.op) {\n    case 'add':\n      // add 의 inverse 는 새로 발급될 refid 를 알아야 → 호스트 측에서 처리\n      return null\n\n    case 'remove': {\n      const target = components.find(c => (c as any)?.refid === op.refid)\n      if (!target) return null // 매칭 실패 — silent no-op 이라 inverse 도 없음\n      return { op: 'add', component: JSON.parse(JSON.stringify(target)) }\n    }\n\n    case 'modify': {\n      const target = components.find(c => (c as any)?.refid === op.refid)\n      if (!target) return null\n      // patch 가 건드린 키만 보관. nested 는 통째로.\n      const oldValues: any = {}\n      for (const k of Object.keys(op.patch || {})) {\n        const v = (target as any)[k]\n        oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v))\n      }\n      return { op: 'modify', refid: op.refid, patch: oldValues }\n    }\n\n    case 'modifyBoard': {\n      const oldValues: any = {}\n      const patch = op.patch || {}\n      for (const k of Object.keys(patch)) {\n        if (k === 'components') continue\n        const v = (board as any)[k]\n        oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v))\n      }\n      return { op: 'modifyBoard', patch: oldValues }\n    }\n\n    case 'replace':\n      // 이전 보드 통째로 보관 — replace 의 자연스러운 inverse 는 또 다른 replace\n      return { op: 'replace', board: JSON.parse(JSON.stringify(board)) }\n\n    default:\n      return null\n  }\n}\n\nexport function applyOp(board: BoardModel, op: BoardEditOp): BoardModel {\n  const components = board.components ?? []\n  switch (op.op) {\n    case 'replace':\n      return op.board\n\n    case 'add':\n      return { ...board, components: [...components, op.component] }\n\n    case 'remove':\n      return { ...board, components: components.filter(c => (c as any)?.refid !== op.refid) }\n\n    case 'modify':\n      return {\n        ...board,\n        components: components.map(c =>\n          (c as any)?.refid === op.refid ? mergeComponent(c, op.patch) : c\n        )\n      }\n\n    case 'modifyBoard': {\n      // 루트 속성 (fillStyle / width / height / name 등) 만 deep merge.\n      // components 키는 무시 — 자식 변경은 add/remove/modify 별도 op 로.\n      const patch = { ...op.patch } as any\n      delete patch.components\n      return mergeBoardRoot(board, patch)\n    }\n\n    default:\n      return board\n  }\n}\n\nfunction mergeBoardRoot(board: BoardModel, patch: any): BoardModel {\n  const out: any = { ...board }\n  for (const key of Object.keys(patch)) {\n    const bv = (board as any)[key]\n    const pv = patch[key]\n    if (\n      bv !== null &&\n      pv !== null &&\n      typeof bv === 'object' &&\n      typeof pv === 'object' &&\n      !Array.isArray(bv) &&\n      !Array.isArray(pv)\n    ) {\n      out[key] = deepMergeRoot(bv, pv)\n    } else {\n      out[key] = pv\n    }\n  }\n  return out\n}\n\nfunction deepMergeRoot(a: any, b: any): any {\n  const out: any = { ...a }\n  for (const key of Object.keys(b)) {\n    const av = a[key]\n    const bv = b[key]\n    if (\n      av !== null &&\n      bv !== null &&\n      typeof av === 'object' &&\n      typeof bv === 'object' &&\n      !Array.isArray(av) &&\n      !Array.isArray(bv)\n    ) {\n      out[key] = deepMergeRoot(av, bv)\n    } else {\n      out[key] = bv\n    }\n  }\n  return out\n}\n\n/**\n * 컴포넌트에 부분 patch 를 적용.\n * threeD 등 nested object 는 deep merge — 호출자가 색만 바꾸려고 했을 때 geometry 까지 사라지지 않도록.\n */\nexport function mergeComponent(base: BoardComponent, patch: Partial<BoardComponent>): BoardComponent {\n  const out: any = { ...base }\n  for (const key of Object.keys(patch)) {\n    const baseVal = (base as any)[key]\n    const patchVal = (patch as any)[key]\n    if (\n      isPlainObject(baseVal) &&\n      isPlainObject(patchVal)\n    ) {\n      out[key] = deepMerge(baseVal, patchVal)\n    } else {\n      out[key] = patchVal\n    }\n  }\n  return out as BoardComponent\n}\n\nfunction deepMerge(a: any, b: any): any {\n  const out: any = { ...a }\n  for (const key of Object.keys(b)) {\n    const av = a[key]\n    const bv = b[key]\n    if (isPlainObject(av) && isPlainObject(bv)) {\n      out[key] = deepMerge(av, bv)\n    } else {\n      out[key] = bv\n    }\n  }\n  return out\n}\n\nfunction isPlainObject(v: any): boolean {\n  return v !== null && typeof v === 'object' && !Array.isArray(v)\n}\n"]}