@things-factory/board-ui 10.1.24 → 10.1.26

package/dist-client/utils/board-model-diff.d.ts

@@ -1,8 +1,8 @@
-import type { BoardEditOp } from '@things-factory/board-ai';
+import type { SceneEditOp } from '@operato/scene-ops';
 interface AnyModel {
     components?: any[];
     [k: string]: any;
 }
-/** prev → next 모델 차이를 BoardEditOp[] 로. 변화 없으면 빈 배열. */
-export declare function diffBoardModel(prev: AnyModel | null | undefined, next: AnyModel | null | undefined): BoardEditOp[];
+/** prev → next 모델 차이를 SceneEditOp[] 로. 변화 없으면 빈 배열. */
+export declare function diffBoardModel(prev: AnyModel | null | undefined, next: AnyModel | null | undefined): SceneEditOp[];
 export {};

package/dist-client/utils/board-model-diff.js.map

@@ -1 +1 @@
-{"version":3,"file":"board-model-diff.js","sourceRoot":"","sources":["../../client/utils/board-model-diff.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * diffBoardModel (Phase Board-AI C3a) — 사용자 직접편집을 BoardEditOp[] 로 캡처하기 위한\n * *순수* 모델 diff. 모델러의 @model-changed 직전/직후 모델을 비교해 add/remove/modify/modifyBoard\n * 를 산출 → recordDirectPatch 로 보내 다른 참여자/AI 에 방송(C3b).\n *\n * 범위(프로토타입): top-level 컴포넌트의 add/remove/modify + 보드 root 속성(modifyBoard).\n * 중첩(group 내부) 편집은 coarse — 추후 정밀화. 순수·결정적 → 단위테스트.\n */\nimport type { BoardEditOp } from '@things-factory/board-ai'\n\ninterface AnyModel {\n  components?: any[]\n  [k: string]: any\n}\n\n/** prev → next 모델 차이를 BoardEditOp[] 로. 변화 없으면 빈 배열. */\nexport function diffBoardModel(prev: AnyModel | null | undefined, next: AnyModel | null | undefined): BoardEditOp[] {\n  const ops: BoardEditOp[] = []\n  const prevComps = indexByRefid(prev?.components)\n  const nextComps = indexByRefid(next?.components)\n\n  // remove — prev 에 있고 next 에 없음\n  for (const refid of prevComps.keys()) {\n    if (!nextComps.has(refid)) ops.push({ op: 'remove', refid } as BoardEditOp)\n  }\n  // add — next 에 있고 prev 에 없음 (전체 컴포넌트)\n  for (const [refid, comp] of nextComps) {\n    if (!prevComps.has(refid)) ops.push({ op: 'add', component: comp } as BoardEditOp)\n  }\n  // modify — 양쪽에 있고 속성 변경\n  for (const [refid, nc] of nextComps) {\n    const pc = prevComps.get(refid)\n    if (!pc) continue\n    const patch = propDiff(pc, nc, COMPONENT_SKIP)\n    if (patch) ops.push({ op: 'modify', refid, patch } as BoardEditOp)\n  }\n  // modifyBoard — 보드 root 속성(components 제외) 변경\n  const boardPatch = propDiff(prev || {}, next || {}, BOARD_SKIP)\n  if (boardPatch) ops.unshift({ op: 'modifyBoard', patch: boardPatch } as BoardEditOp)\n\n  return ops\n}\n\nconst COMPONENT_SKIP = new Set(['components'])\nconst BOARD_SKIP = new Set(['components'])\n\n/** top-level 컴포넌트를 refid 로 색인 (refid 없는 건 제외 — diff 불가). */\nfunction indexByRefid(components: any[] | undefined): Map<number, any> {\n  const map = new Map<number, any>()\n  if (!Array.isArray(components)) return map\n  for (const c of components) {\n    if (c && c.refid != null) map.set(c.refid, c)\n  }\n  return map\n}\n\n/**\n * a → b 의 속성 차이. b 에서 *변경되거나 추가된* 키만 (deep 비교는 JSON.stringify).\n * skip 키 제외. 차이 없으면 undefined.\n */\nfunction propDiff(a: any, b: any, skip: Set<string>): Record<string, any> | undefined {\n  const patch: Record<string, any> = {}\n  for (const key of Object.keys(b || {})) {\n    if (skip.has(key)) continue\n    if (stableStr(a?.[key]) !== stableStr(b[key])) patch[key] = b[key]\n  }\n  return Object.keys(patch).length ? patch : undefined\n}\n\nfunction stableStr(v: any): string {\n  if (v === undefined) return '\u0000undef'\n  try {\n    return JSON.stringify(v)\n  } catch {\n    return String(v)\n  }\n}\n"]}
+{"version":3,"file":"board-model-diff.js","sourceRoot":"","sources":["../../client/utils/board-model-diff.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * diffBoardModel (Phase Board-AI C3a) — 사용자 직접편집을 SceneEditOp[] 로 캡처하기 위한\n * *순수* 모델 diff. 모델러의 @model-changed 직전/직후 모델을 비교해 add/remove/modify/modifyScene\n * 를 산출 → recordDirectPatch 로 보내 다른 참여자/AI 에 방송(C3b).\n *\n * 범위(프로토타입): top-level 컴포넌트의 add/remove/modify + 보드 root 속성(modifyScene).\n * 중첩(group 내부) 편집은 coarse — 추후 정밀화. 순수·결정적 → 단위테스트.\n */\nimport type { SceneEditOp } from '@operato/scene-ops'\n\ninterface AnyModel {\n  components?: any[]\n  [k: string]: any\n}\n\n/** prev → next 모델 차이를 SceneEditOp[] 로. 변화 없으면 빈 배열. */\nexport function diffBoardModel(prev: AnyModel | null | undefined, next: AnyModel | null | undefined): SceneEditOp[] {\n  const ops: SceneEditOp[] = []\n  const prevComps = indexByRefid(prev?.components)\n  const nextComps = indexByRefid(next?.components)\n\n  // remove — prev 에 있고 next 에 없음\n  for (const refid of prevComps.keys()) {\n    if (!nextComps.has(refid)) ops.push({ op: 'remove', refid } as SceneEditOp)\n  }\n  // add — next 에 있고 prev 에 없음 (전체 컴포넌트)\n  for (const [refid, comp] of nextComps) {\n    if (!prevComps.has(refid)) ops.push({ op: 'add', component: comp } as SceneEditOp)\n  }\n  // modify — 양쪽에 있고 속성 변경\n  for (const [refid, nc] of nextComps) {\n    const pc = prevComps.get(refid)\n    if (!pc) continue\n    const patch = propDiff(pc, nc, COMPONENT_SKIP)\n    if (patch) ops.push({ op: 'modify', refid, patch } as SceneEditOp)\n  }\n  // modifyScene — 보드 root 속성(components 제외) 변경\n  const boardPatch = propDiff(prev || {}, next || {}, BOARD_SKIP)\n  if (boardPatch) ops.unshift({ op: 'modifyScene', patch: boardPatch } as SceneEditOp)\n\n  return ops\n}\n\nconst COMPONENT_SKIP = new Set(['components'])\nconst BOARD_SKIP = new Set(['components'])\n\n/** top-level 컴포넌트를 refid 로 색인 (refid 없는 건 제외 — diff 불가). */\nfunction indexByRefid(components: any[] | undefined): Map<number, any> {\n  const map = new Map<number, any>()\n  if (!Array.isArray(components)) return map\n  for (const c of components) {\n    if (c && c.refid != null) map.set(c.refid, c)\n  }\n  return map\n}\n\n/**\n * a → b 의 속성 차이. b 에서 *변경되거나 추가된* 키만 (deep 비교는 JSON.stringify).\n * skip 키 제외. 차이 없으면 undefined.\n */\nfunction propDiff(a: any, b: any, skip: Set<string>): Record<string, any> | undefined {\n  const patch: Record<string, any> = {}\n  for (const key of Object.keys(b || {})) {\n    if (skip.has(key)) continue\n    if (stableStr(a?.[key]) !== stableStr(b[key])) patch[key] = b[key]\n  }\n  return Object.keys(patch).length ? patch : undefined\n}\n\nfunction stableStr(v: any): string {\n  if (v === undefined) return '\u0000undef'\n  try {\n    return JSON.stringify(v)\n  } catch {\n    return String(v)\n  }\n}\n"]}

package/dist-client/utils/patch-apply-gate.js

@@ -1,7 +1,7 @@
 /*
  * PatchApplyGate (Phase Board-AI C2) — 같은 patch 를 모델러에서 *정확히 1회만* 적용 보장.
  * 실시간 공동편집에서 같은 patch 가 두 경로로 도달할 수 있다:
- *   ① 로컬 낙관적 적용(onBoardEditPatch) ② 서버 브로드캐스트 구독(boardPatchActivity)
+ *   ① 로컬 낙관적 적용(onSceneEditPatch) ② 서버 브로드캐스트 구독(boardPatchActivity)
  * 자기발신 echo + 두 경로 도착 순서 무관 — 먼저 claim 한 쪽이 적용, 나머지는 skip.
  *
  * patchId 없으면(영속 안 된 로컬 전용 patch) 게이팅 불가 → 항상 적용(true).

package/dist-client/utils/patch-apply-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"patch-apply-gate.js","sourceRoot":"","sources":["../../client/utils/patch-apply-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAc;IAIzB,YAA6B,MAAM,GAAG;QAAT,QAAG,GAAH,GAAG,CAAM;QAHrB,YAAO,GAAG,IAAI,GAAG,EAAU,CAAA;QAC3B,UAAK,GAAa,EAAE,CAAA;IAEI,CAAC;IAE1C,uEAAuE;IACvE,QAAQ,CAAC,OAAkC;QACzC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAA;QAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;YAClC,IAAI,OAAO,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACzD,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,wBAAwB;IACxB,GAAG,CAAC,OAAe;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,iCAAiC;IACjC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;IAC1B,CAAC;CACF","sourcesContent":["/*\n * PatchApplyGate (Phase Board-AI C2) — 같은 patch 를 모델러에서 *정확히 1회만* 적용 보장.\n * 실시간 공동편집에서 같은 patch 가 두 경로로 도달할 수 있다:\n *   ① 로컬 낙관적 적용(onBoardEditPatch) ② 서버 브로드캐스트 구독(boardPatchActivity)\n * 자기발신 echo + 두 경로 도착 순서 무관 — 먼저 claim 한 쪽이 적용, 나머지는 skip.\n *\n * patchId 없으면(영속 안 된 로컬 전용 patch) 게이팅 불가 → 항상 적용(true).\n * 메모리 bound — 오래된 id 부터 제거(FIFO).\n */\nexport class PatchApplyGate {\n  private readonly claimed = new Set<string>()\n  private readonly order: string[] = []\n\n  constructor(private readonly cap = 500) {}\n\n  /** 아직 적용 전이면 claim 하고 true. 이미 claim 됐으면 false (skip). id 없으면 true. */\n  tryClaim(patchId: string | undefined | null): boolean {\n    if (!patchId) return true\n    if (this.claimed.has(patchId)) return false\n    this.claimed.add(patchId)\n    this.order.push(patchId)\n    if (this.order.length > this.cap) {\n      const evicted = this.order.shift()\n      if (evicted !== undefined) this.claimed.delete(evicted)\n    }\n    return true\n  }\n\n  /** 이미 claim(적용) 됐는지. */\n  has(patchId: string): boolean {\n    return this.claimed.has(patchId)\n  }\n\n  /** 현재 추적 중인 patch 수 (테스트/진단). */\n  get size(): number {\n    return this.claimed.size\n  }\n}\n"]}
+{"version":3,"file":"patch-apply-gate.js","sourceRoot":"","sources":["../../client/utils/patch-apply-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAc;IAIzB,YAA6B,MAAM,GAAG;QAAT,QAAG,GAAH,GAAG,CAAM;QAHrB,YAAO,GAAG,IAAI,GAAG,EAAU,CAAA;QAC3B,UAAK,GAAa,EAAE,CAAA;IAEI,CAAC;IAE1C,uEAAuE;IACvE,QAAQ,CAAC,OAAkC;QACzC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAA;QAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;YAClC,IAAI,OAAO,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACzD,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,wBAAwB;IACxB,GAAG,CAAC,OAAe;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,iCAAiC;IACjC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;IAC1B,CAAC;CACF","sourcesContent":["/*\n * PatchApplyGate (Phase Board-AI C2) — 같은 patch 를 모델러에서 *정확히 1회만* 적용 보장.\n * 실시간 공동편집에서 같은 patch 가 두 경로로 도달할 수 있다:\n *   ① 로컬 낙관적 적용(onSceneEditPatch) ② 서버 브로드캐스트 구독(boardPatchActivity)\n * 자기발신 echo + 두 경로 도착 순서 무관 — 먼저 claim 한 쪽이 적용, 나머지는 skip.\n *\n * patchId 없으면(영속 안 된 로컬 전용 patch) 게이팅 불가 → 항상 적용(true).\n * 메모리 bound — 오래된 id 부터 제거(FIFO).\n */\nexport class PatchApplyGate {\n  private readonly claimed = new Set<string>()\n  private readonly order: string[] = []\n\n  constructor(private readonly cap = 500) {}\n\n  /** 아직 적용 전이면 claim 하고 true. 이미 claim 됐으면 false (skip). id 없으면 true. */\n  tryClaim(patchId: string | undefined | null): boolean {\n    if (!patchId) return true\n    if (this.claimed.has(patchId)) return false\n    this.claimed.add(patchId)\n    this.order.push(patchId)\n    if (this.order.length > this.cap) {\n      const evicted = this.order.shift()\n      if (evicted !== undefined) this.claimed.delete(evicted)\n    }\n    return true\n  }\n\n  /** 이미 claim(적용) 됐는지. */\n  has(patchId: string): boolean {\n    return this.claimed.has(patchId)\n  }\n\n  /** 현재 추적 중인 patch 수 (테스트/진단). */\n  get size(): number {\n    return this.claimed.size\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/board-ui",
-  "version": "10.1.24",
+  "version": "10.1.26",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -19,8 +19,8 @@
   "scripts": {
     "build": "npm run build:server && npm run build:client",
     "copy:files": "copyfiles -e \"./client/**/*.{ts,js,json}\" -u 1 \"./client/**/*\" dist-client",
-    "build:client": "npm run copy:files && npx tsc --p ./client/tsconfig.json",
-    "build:server": "npx tsc --p ./server/tsconfig.json",
+    "build:client": "npm run clean:client && npm run copy:files && npx tsc --p ./client/tsconfig.json",
+    "build:server": "npm run clean:server && npx tsc --p ./server/tsconfig.json",
     "clean:client": "npx rimraf dist-client",
     "clean:server": "npx rimraf dist-server",
     "clean": "npm run clean:server && npm run clean:client"
@@ -30,7 +30,7 @@
     "@material/web": "^2.0.0",
     "@operato/app": "^10.0.0",
     "@operato/attachment": "^10.0.0",
-    "@operato/board": "^10.0.0",
+    "@operato/board": "^10.14.0",
     "@operato/data-grist": "^10.0.0",
     "@operato/graphql": "^10.0.0",
     "@operato/help": "^10.0.0",
@@ -39,13 +39,14 @@
     "@operato/oops": "^10.0.0",
     "@operato/popup": "^10.0.0",
     "@operato/pull-to-refresh": "^10.0.0",
+    "@operato/scene-ops": "^10.14.1",
     "@operato/shell": "^10.0.0",
     "@operato/styles": "^10.0.0",
     "@operato/utils": "^10.0.0",
-    "@things-factory/barcode-base": "^10.1.24",
-    "@things-factory/board-ai": "^10.1.24",
-    "@things-factory/fav-base": "^10.1.24",
+    "@things-factory/barcode-base": "^10.1.26",
+    "@things-factory/board-ai": "^10.1.26",
+    "@things-factory/fav-base": "^10.1.26",
     "@things-factory/utils": "^10.1.20"
   },
-  "gitHead": "0d88a504e0ffa63cd91279b88c6998d4bf1b3d86"
+  "gitHead": "151bda14d899442c6846532ddded1e2bfe23a2f5"
 }

package/dist-client/board-placement-palette.d.ts

@@ -1,39 +0,0 @@
-export interface BoardPlacementItem {
-    id: string;
-    label: string;
-    sub?: string;
-    /**
-     * 계층에서의 부모 — 있으면 트레이가 **트리로** 보여 줄 수 있다. 없으면 최상위.
-     *
-     * 호스트가 안 주면 예전처럼 평평한 목록이다(선택 사항). 부모를 못 찾은 항목은 **버리지 않고**
-     * 최상위로 올린다 — 목록에서 조용히 사라지면 저작하는 사람은 "그런 게 없네" 로 끝난다.
-     */
-    parentId?: string;
-    /** 종류 묶음 — 있으면 트레이가 **종류별로** 보여 줄 수 있다(같은 종류 여럿에 한 번에 배치). */
-    group?: string;
-}
-/** 한 항목의 가능한 표현(N:M). key = 호스트가 정하는 표현 식별자(같은 항목 안에서 유일해야 한다). */
-export interface BoardPlacementView {
-    key: string;
-    label: string;
-    sub?: string;
-}
-export interface BoardPlacementProvider {
-    label?: string;
-    /** 이 board 의 배치 후보(전체). 비어있으면 트레이 숨김. boardId 로 컨텍스트 해소. */
-    items(boardId: string): BoardPlacementItem[] | Promise<BoardPlacementItem[]>;
-    /** 항목의 가능한 표현들(능력×목적, N:M). 없으면(미지정) 단일 componentFor 로 동작. */
-    viewsFor?(itemId: string): BoardPlacementView[];
-    /** 선택한 view(또는 기본)로 추가할 things-scene 컴포넌트 model(반드시 `tag` 포함). null=표현 없음. */
-    componentFor(item: BoardPlacementItem, viewKey?: string): any;
-    /**
-     * 배치된 컴포넌트 → 그것이 어느 표현인지(`viewsFor` 가 준 key). 트레이가 "이미 놓았는지" 를 판단한다.
-     *
-     * 구현하지 않으면 트레이는 컴포넌트 `type` 을 key 로 보고 비교한다 — `viewsFor` 의 key 가 type 과 다른
-     * 호스트는 **반드시 구현해야 한다.** 구현하지 않으면 이미 놓은 표현도 계속 "안 놓음" 으로 보이고,
-     * "모두 자동 배치" 가 같은 것을 또 놓는다.
-     */
-    viewKeyOfComponent?(component: any): string | null;
-}
-export declare function registerBoardPlacementProvider(p: BoardPlacementProvider): void;
-export declare function boardPlacementProvider(): BoardPlacementProvider | null;

package/dist-client/board-placement-palette.js

@@ -1,8 +0,0 @@
-let _provider = null;
-export function registerBoardPlacementProvider(p) {
-    _provider = p;
-}
-export function boardPlacementProvider() {
-    return _provider;
-}
-//# sourceMappingURL=board-placement-palette.js.map

package/dist-client/board-placement-palette.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"board-placement-palette.js","sourceRoot":"","sources":["../client/board-placement-palette.ts"],"names":[],"mappings":"AAiDA,IAAI,SAAS,GAAkC,IAAI,CAAA;AACnD,MAAM,UAAU,8BAA8B,CAAC,CAAyB;IACtE,SAAS,GAAG,CAAC,CAAA;AACf,CAAC;AACD,MAAM,UAAU,sBAAsB;IACpC,OAAO,SAAS,CAAA;AAClB,CAAC","sourcesContent":["/*\n * board 배치 팔레트 — 일반(표현-무관) 확장점. 호스트가 \"보드에 배치할 항목\"을 공급하고,\n * board-modeller 가 트레이로 노출 + place 시 컴포넌트를 생성한다. board 제품(@operato/board)은 무변경,\n * 이 통합층(board-ui)이 훅만 제공. 트윈은 이 훅의 호스트 구현자일 뿐(트윈 전용 로직 없음).\n *\n * 대칭: operato-twin map-modeller 의 \"미배치 노드 트레이\"(A2)를 board 표현으로 확장하는 일반 메커니즘.\n * place 는 board-edit 'add' op(기존 채널)로 컴포넌트를 추가하고, 컴포넌트 model 의 `tag` 로 라이브 결합\n * (board-provider 가 data(tag:) 구독). 이미 배치됨 = scene 에 같은 tag 컴포넌트 존재.\n */\nexport interface BoardPlacementItem {\n  id: string // 곧 컴포넌트 tag (라이브 결합 키)\n  label: string\n  sub?: string\n  /**\n   * 계층에서의 부모 — 있으면 트레이가 **트리로** 보여 줄 수 있다. 없으면 최상위.\n   *\n   * 호스트가 안 주면 예전처럼 평평한 목록이다(선택 사항). 부모를 못 찾은 항목은 **버리지 않고**\n   * 최상위로 올린다 — 목록에서 조용히 사라지면 저작하는 사람은 \"그런 게 없네\" 로 끝난다.\n   */\n  parentId?: string\n  /** 종류 묶음 — 있으면 트레이가 **종류별로** 보여 줄 수 있다(같은 종류 여럿에 한 번에 배치). */\n  group?: string\n}\n\n/** 한 항목의 가능한 표현(N:M). key = 호스트가 정하는 표현 식별자(같은 항목 안에서 유일해야 한다). */\nexport interface BoardPlacementView {\n  key: string\n  label: string\n  sub?: string\n}\n\nexport interface BoardPlacementProvider {\n  label?: string // 트레이 제목(기본 \"미배치\")\n  /** 이 board 의 배치 후보(전체). 비어있으면 트레이 숨김. boardId 로 컨텍스트 해소. */\n  items(boardId: string): BoardPlacementItem[] | Promise<BoardPlacementItem[]>\n  /** 항목의 가능한 표현들(능력×목적, N:M). 없으면(미지정) 단일 componentFor 로 동작. */\n  viewsFor?(itemId: string): BoardPlacementView[]\n  /** 선택한 view(또는 기본)로 추가할 things-scene 컴포넌트 model(반드시 `tag` 포함). null=표현 없음. */\n  componentFor(item: BoardPlacementItem, viewKey?: string): any\n  /**\n   * 배치된 컴포넌트 → 그것이 어느 표현인지(`viewsFor` 가 준 key). 트레이가 \"이미 놓았는지\" 를 판단한다.\n   *\n   * 구현하지 않으면 트레이는 컴포넌트 `type` 을 key 로 보고 비교한다 — `viewsFor` 의 key 가 type 과 다른\n   * 호스트는 **반드시 구현해야 한다.** 구현하지 않으면 이미 놓은 표현도 계속 \"안 놓음\" 으로 보이고,\n   * \"모두 자동 배치\" 가 같은 것을 또 놓는다.\n   */\n  viewKeyOfComponent?(component: any): string | null\n}\n\nlet _provider: BoardPlacementProvider | null = null\nexport function registerBoardPlacementProvider(p: BoardPlacementProvider): void {\n  _provider = p\n}\nexport function boardPlacementProvider(): BoardPlacementProvider | null {\n  return _provider\n}\n"]}

package/dist-client/board-provider.d.ts

@@ -1,3 +0,0 @@
-import { ReferenceMap } from '@hatiolab/things-scene';
-export declare function createBoardProvider(): ReferenceMap;
-export declare const provider: ReferenceMap;

package/dist-client/board-provider.js

@@ -1,87 +0,0 @@
-import gql from 'graphql-tag';
-import { create, error, ReferenceMap } from '@hatiolab/things-scene';
-import { BoardDataStorage, BoardModelCache } from '@operato/board';
-import { client, gqlContext, subscribe } from '@operato/graphql';
-export function createBoardProvider() {
-    const _provider = new ReferenceMap(async (boardId, resolve, reject) => {
-        const startTime = performance.now();
-        try {
-            const cached = await BoardModelCache.get(boardId);
-            const response = await client.query({
-                query: gql `
-            query FetchBoardById($id: String!, $cachedUpdatedAt: String) {
-              board(id: $id, cachedUpdatedAt: $cachedUpdatedAt) {
-                model
-                updatedAt
-              }
-            }
-          `,
-                variables: { id: boardId, cachedUpdatedAt: cached?.updatedAt },
-                context: gqlContext()
-            });
-            const board = response.data?.board;
-            if (!board) {
-                reject(new Error('Failed to get the requested board.'));
-                return;
-            }
-            let model;
-            if (board.model === null && cached) {
-                // 캐시 유효
-                model = cached.model;
-            }
-            else {
-                // 새 모델
-                model = JSON.parse(board.model);
-                await BoardModelCache.put(boardId, '', board.model, board.updatedAt);
-            }
-            let scene;
-            try {
-                scene = await provider.get(boardId);
-            }
-            catch (e) {
-                scene = create({
-                    model,
-                    mode: 0,
-                    refProvider: provider,
-                    dataStorage: new BoardDataStorage(boardId),
-                    loading: { startTime },
-                    dataSubscriptionProvider: {
-                        subscribe: async (tag, component) => {
-                            return await subscribe({
-                                query: gql `
-                              subscription {
-                                data(tag: "${tag}") {
-                                  tag
-                                  data
-                                  ts
-                                }
-                              }
-                            `
-                            }, {
-                                next: async ({ data }) => {
-                                    if (data) {
-                                        const payload = data.data;
-                                        component.app?.lagTracker?.record?.(payload.tag, payload.ts);
-                                        component.data = payload.data;
-                                    }
-                                }
-                            });
-                        },
-                        dispose() { }
-                    }
-                });
-                // s.app.baseUrl = undefined;
-            }
-            resolve(scene);
-        }
-        catch (e) {
-            error(e);
-            reject(e);
-        }
-    }, async (id, ref) => {
-        ref.dispose();
-    });
-    return _provider;
-}
-export const provider = createBoardProvider();
-//# sourceMappingURL=board-provider.js.map

package/dist-client/board-provider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"board-provider.js","sourceRoot":"","sources":["../client/board-provider.ts"],"names":[],"mappings":"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","sourcesContent":["import gql from 'graphql-tag'\n\nimport { create, error, ReferenceMap, Scene } from '@hatiolab/things-scene'\nimport { BoardDataStorage, BoardModelCache } from '@operato/board'\nimport { client, gqlContext, subscribe } from '@operato/graphql'\n\nexport function createBoardProvider() {\n  const _provider = new ReferenceMap(\n    async (boardId, resolve, reject): Promise<any> => {\n      const startTime = performance.now()\n      try {\n        const cached = await BoardModelCache.get(boardId)\n\n        const response = await client.query({\n          query: gql`\n            query FetchBoardById($id: String!, $cachedUpdatedAt: String) {\n              board(id: $id, cachedUpdatedAt: $cachedUpdatedAt) {\n                model\n                updatedAt\n              }\n            }\n          `,\n          variables: { id: boardId, cachedUpdatedAt: cached?.updatedAt },\n          context: gqlContext()\n        })\n\n        const board = response.data?.board\n\n        if (!board) {\n          reject(new Error('Failed to get the requested board.'))\n          return\n        }\n\n        let model: any\n        if (board.model === null && cached) {\n          // 캐시 유효\n          model = cached.model\n        } else {\n          // 새 모델\n          model = JSON.parse(board.model)\n          await BoardModelCache.put(boardId, '', board.model, board.updatedAt)\n        }\n\n        let scene: Scene\n\n        try {\n          scene = await provider.get(boardId)\n        } catch (e) {\n          scene = create({\n            model,\n            mode: 0,\n            refProvider: provider as any,\n            dataStorage: new BoardDataStorage(boardId),\n            loading: { startTime },\n            dataSubscriptionProvider: {\n              subscribe: async (tag, component) => {\n                return await subscribe(\n                  {\n                    query: gql`\n                              subscription {\n                                data(tag: \"${tag}\") {\n                                  tag\n                                  data\n                                  ts\n                                }\n                              }\n                            `\n                  },\n                  {\n                    next: async ({ data }) => {\n                      if (data) {\n                        const payload = data.data\n                        // 전달 지연 기록 (scene/app 레벨 트래커) — ts 는 component.data 에 넣지 않음.\n                        ;(component as any).app?.lagTracker?.record?.(payload.tag, payload.ts)\n                        component.data = payload.data\n                      }\n                    }\n                  }\n                )\n              },\n\n              dispose() {}\n            }\n          } as any)\n\n          // s.app.baseUrl = undefined;\n        }\n\n        resolve(scene)\n      } catch (e) {\n        error(e)\n        reject(e)\n      }\n    },\n    async (id, ref) => {\n      ref.dispose()\n    }\n  )\n\n  return _provider\n}\n\nexport const provider = createBoardProvider()\n"]}

package/dist-client/pages/board-action-dispatch.d.ts

@@ -1,31 +0,0 @@
-/**
- * Host 측 BoardActionOp dispatcher — AI 가 지시한 ephemeral scene action 을
- * things-scene API 로 실행.
- *
- * 별개 채널 — board-edit-patch 와 달리 model 변경 X, undo 영향 X, dirty flag 무관.
- * pure function 형태 (스크롤되는 customElement 와 분리) — Lit 외부에서 단위 테스트 가능.
- */
-import type { BoardActionOp } from '@things-factory/board-ai';
-/**
- * AI 의 BoardEditOp / BoardActionOp 가 지정한 대상 (id 또는 refid) 으로
- * things-scene component 검색.
- *
- * id (사용자/AI 가 명시적으로 설정한 string identifier) 와
- * refid (things-scene 이 모든 컴포넌트에 자동 발급하는 numeric identifier) 는
- * 서로 별개 개념. 이 함수는 호스트 측에서 둘 중 어느 쪽으로든 lookup 가능하게 통합.
- * refid 가 universal 이므로 우선.
- */
-export declare function findSceneComponent(scene: any, target: {
-    id?: string;
-    refid?: number;
-}): any;
-/**
- * 단일 BoardActionOp 를 things-scene 에 적용.
- *
- * 호스트는 actions 배열을 순회하며 매 op 마다 호출. 실패 (잘못된 action /
- * 누락된 컴포넌트 / API 예외) 시 `false` 반환 — 호스트가 warn 처리.
- *
- * setSceneMode 의 경우 호스트 측 reactive `mode` property 동기는 별도 (return
- * 후 호스트가 scene.mode 재읽기). things-scene 의 mode: edit=1, view=0.
- */
-export declare function dispatchBoardAction(scene: any, action: BoardActionOp): boolean;

package/dist-client/pages/board-action-dispatch.js

@@ -1,80 +0,0 @@
-/**
- * AI 의 BoardEditOp / BoardActionOp 가 지정한 대상 (id 또는 refid) 으로
- * things-scene component 검색.
- *
- * id (사용자/AI 가 명시적으로 설정한 string identifier) 와
- * refid (things-scene 이 모든 컴포넌트에 자동 발급하는 numeric identifier) 는
- * 서로 별개 개념. 이 함수는 호스트 측에서 둘 중 어느 쪽으로든 lookup 가능하게 통합.
- * refid 가 universal 이므로 우선.
- */
-export function findSceneComponent(scene, target) {
-    if (!scene)
-        return null;
-    if (typeof target.refid === 'number') {
-        const byRefid = scene.rootContainer?.refidIndexMap?.get(target.refid);
-        if (byRefid)
-            return byRefid;
-    }
-    if (typeof target.id === 'string' && target.id.length > 0) {
-        return scene.findById?.(target.id) ?? null;
-    }
-    return null;
-}
-/**
- * 단일 BoardActionOp 를 things-scene 에 적용.
- *
- * 호스트는 actions 배열을 순회하며 매 op 마다 호출. 실패 (잘못된 action /
- * 누락된 컴포넌트 / API 예외) 시 `false` 반환 — 호스트가 warn 처리.
- *
- * setSceneMode 의 경우 호스트 측 reactive `mode` property 동기는 별도 (return
- * 후 호스트가 scene.mode 재읽기). things-scene 의 mode: edit=1, view=0.
- */
-export function dispatchBoardAction(scene, action) {
-    if (!scene || !action)
-        return false;
-    switch (action.action) {
-        case 'selectComponents': {
-            const refids = Array.isArray(action.refids) ? action.refids : [];
-            const targets = refids
-                .map(r => findSceneComponent(scene, { refid: r }))
-                .filter((c) => c);
-            scene.selected = targets;
-            return true;
-        }
-        case 'centerToComponent': {
-            const target = findSceneComponent(scene, { refid: action.refid });
-            if (!target)
-                return false;
-            const animated = action.animated !== false;
-            scene.centerTo(target, animated);
-            return true;
-        }
-        case 'fitToView': {
-            const mode = action.mode ?? 'fit';
-            scene.fit(mode);
-            return true;
-        }
-        case 'setSceneMode': {
-            scene.mode = action.mode === 'edit' ? 1 : 0;
-            return true;
-        }
-        case 'highlightComponents': {
-            // things-scene 의 highlightSearchResults API 위임 — 2D outline + 3D outline
-            // 모두 자동 처리 (operato-board 의 3D first-class UX).
-            const refids = Array.isArray(action.refids) ? action.refids : [];
-            const targets = refids
-                .map(r => findSceneComponent(scene, { refid: r }))
-                .filter((c) => c);
-            if (typeof scene.highlightSearchResults === 'function') {
-                scene.highlightSearchResults(targets);
-            }
-            // 변경된 시각 반영
-            if (typeof scene.invalidate === 'function')
-                scene.invalidate();
-            return true;
-        }
-        default:
-            return false;
-    }
-}
-//# sourceMappingURL=board-action-dispatch.js.map

package/dist-client/pages/board-action-dispatch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"board-action-dispatch.js","sourceRoot":"","sources":["../../client/pages/board-action-dispatch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Host 측 BoardActionOp dispatcher — AI 가 지시한 ephemeral scene action 을\n * things-scene API 로 실행.\n *\n * 별개 채널 — board-edit-patch 와 달리 model 변경 X, undo 영향 X, dirty flag 무관.\n * pure function 형태 (스크롤되는 customElement 와 분리) — Lit 외부에서 단위 테스트 가능.\n */\nimport type { BoardActionOp } from '@things-factory/board-ai'\n\n/**\n * AI 의 BoardEditOp / BoardActionOp 가 지정한 대상 (id 또는 refid) 으로\n * things-scene component 검색.\n *\n * id (사용자/AI 가 명시적으로 설정한 string identifier) 와\n * refid (things-scene 이 모든 컴포넌트에 자동 발급하는 numeric identifier) 는\n * 서로 별개 개념. 이 함수는 호스트 측에서 둘 중 어느 쪽으로든 lookup 가능하게 통합.\n * refid 가 universal 이므로 우선.\n */\nexport function findSceneComponent(\n  scene: any,\n  target: { id?: string; refid?: number }\n): any {\n  if (!scene) return null\n  if (typeof target.refid === 'number') {\n    const byRefid = scene.rootContainer?.refidIndexMap?.get(target.refid)\n    if (byRefid) return byRefid\n  }\n  if (typeof target.id === 'string' && target.id.length > 0) {\n    return scene.findById?.(target.id) ?? null\n  }\n  return null\n}\n\n/**\n * 단일 BoardActionOp 를 things-scene 에 적용.\n *\n * 호스트는 actions 배열을 순회하며 매 op 마다 호출. 실패 (잘못된 action /\n * 누락된 컴포넌트 / API 예외) 시 `false` 반환 — 호스트가 warn 처리.\n *\n * setSceneMode 의 경우 호스트 측 reactive `mode` property 동기는 별도 (return\n * 후 호스트가 scene.mode 재읽기). things-scene 의 mode: edit=1, view=0.\n */\nexport function dispatchBoardAction(scene: any, action: BoardActionOp): boolean {\n  if (!scene || !action) return false\n  switch (action.action) {\n    case 'selectComponents': {\n      const refids = Array.isArray(action.refids) ? action.refids : []\n      const targets = refids\n        .map(r => findSceneComponent(scene, { refid: r }))\n        .filter((c: any) => c)\n      scene.selected = targets\n      return true\n    }\n    case 'centerToComponent': {\n      const target = findSceneComponent(scene, { refid: action.refid })\n      if (!target) return false\n      const animated = action.animated !== false\n      scene.centerTo(target, animated)\n      return true\n    }\n    case 'fitToView': {\n      const mode = action.mode ?? 'fit'\n      scene.fit(mode)\n      return true\n    }\n    case 'setSceneMode': {\n      scene.mode = action.mode === 'edit' ? 1 : 0\n      return true\n    }\n    case 'highlightComponents': {\n      // things-scene 의 highlightSearchResults API 위임 — 2D outline + 3D outline\n      // 모두 자동 처리 (operato-board 의 3D first-class UX).\n      const refids = Array.isArray(action.refids) ? action.refids : []\n      const targets = refids\n        .map(r => findSceneComponent(scene, { refid: r }))\n        .filter((c: any) => c)\n      if (typeof scene.highlightSearchResults === 'function') {\n        scene.highlightSearchResults(targets)\n      }\n      // 변경된 시각 반영\n      if (typeof scene.invalidate === 'function') scene.invalidate()\n      return true\n    }\n    default:\n      return false\n  }\n}\n"]}

package/dist-client/pages/board-edit-dispatch.d.ts

@@ -1,74 +0,0 @@
-/**
- * Host 측 BoardEditOp dispatcher — AI 의 model 변경 op 를 things-scene 에 in-place
- * 적용 + revert 용 inverse op 캡처.
- *
- * 핵심:
- *   - scene 의 in-place mutation API (scene.add / target.set / scene.remove 등)
- *     로 적용 → commander 가 자동 snapshot push → CMD+Z / dirty / selection 보존.
- *   - 'replace' 는 부득이 wholesale 경로 (호스트가 별도 처리). dispatcher 는 받지 않음.
- *   - 각 op 의 inverse 를 적용 직전/직후 scene 상태로 계산해 함께 반환 — 호스트가
- *     누적해 두면 나중에 같은 dispatcher 로 역순 적용해 revert 구현.
- *
- * Pure function — Lit element 외부에서 mock scene 으로 단위 테스트 가능.
- */
-import type { BoardEditOp, ArrangeLayout } from '@things-factory/board-ai';
-export interface DispatchContext {
-    /**
-     * `add` op 의 component 를 things-scene 의 default 와 deep-merge.
-     * 호스트가 BoardModeller 의 template registry 를 보고 채운다 — dispatcher 는 호출만.
-     * 미지정 시 component 를 그대로 scene.add 에 전달.
-     */
-    normalize?: (c: any) => any;
-}
-export interface DispatchResult {
-    /** op 가 실제로 scene 에 반영됐는지. silent no-op (없는 refid 등) → false */
-    applied: boolean;
-    /** 적용 직전/직후 상태로 계산한 revert 용 inverse — 단일 op 가 다중 inverse 를
-     *  생성할 수 있음 (예: align 1개 → modify N개, group 1개 → ungroup 1개). */
-    inverseOps: BoardEditOp[];
-}
-/**
- * 단일 BoardEditOp 를 things-scene 에 in-place 적용.
- *
- * `replace` 는 받지 않음 (호스트의 wholesale 경로). 미지원 op / 누락 컴포넌트 시
- * `applied: false` 반환. 호스트가 missed 로 분류해 사용자 경고.
- */
-export declare function dispatchBoardEditOp(scene: any, op: BoardEditOp, ctx?: DispatchContext): DispatchResult;
-/**
- * Sugar layout 위치 계산 — grid / row / column.
- *
- * 정책:
- *   - left/top 만 변경. width/height 는 보존 (사용자 의도).
- *   - grid: cell size = max(width)/max(height) — 컴포넌트 사이즈 다를 때 겹침 방지.
- *     Row-major 채움.
- *   - row/column: 각 컴포넌트의 실 size + gap 으로 누적. align (start/center/end) 으로
- *     cross-axis 정렬.
- *   - anchor 미지정 시 첫 컴포넌트의 현재 (left, top) — 예측 가능.
- *
- * 입력: layout 정의 + 각 target 의 현재 (left, top) (anchor default 용) + sizes.
- * 출력: 각 target 의 새 (left, top). targets 와 동일 순서.
- *
- * Pure function — host dispatcher 외부에서도 단위 테스트 가능.
- */
-export declare function computeArrangePositions(layout: ArrangeLayout, current: Array<{
-    left: number;
-    top: number;
-}>, sizes: Array<{
-    width: number;
-    height: number;
-}>): Array<{
-    left: number;
-    top: number;
-}>;
-/**
- * scene 의 모든 컴포넌트 refid 수집 — add/group 의 inverse 계산용.
- *
- * scene.add / scene.group 직전·직후 호출해 차집합으로 새 발급 refid 식별.
- */
-export declare function collectAllRefids(scene: any): number[];
-/**
- * patch 가 변경하려는 키들에 대해 model 의 현재 값을 deep-clone 으로 캡처.
- * inverse modify / modifyBoard op 의 patch 로 사용. 원본에 없던 키는 null 로 보관
- * (revert 시 명시적 null reset).
- */
-export declare function captureOldKeys(model: any, patch: any): any;