@things-factory/board-ui 10.1.20 → 10.1.25

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":"AAAA,OAAO,GAAG,MAAM,aAAa,CAAA;AAE7B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAS,MAAM,wBAAwB,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEhE,MAAM,UAAU,mBAAmB;IACjC,MAAM,SAAS,GAAG,IAAI,YAAY,CAChC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAgB,EAAE;QAC/C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YAEjD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;gBAClC,KAAK,EAAE,GAAG,CAAA;;;;;;;WAOT;gBACD,SAAS,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE;gBAC9D,OAAO,EAAE,UAAU,EAAE;aACtB,CAAC,CAAA;YAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;YAElC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAA;gBACvD,OAAM;YACR,CAAC;YAED,IAAI,KAAU,CAAA;YACd,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnC,QAAQ;gBACR,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;YACtB,CAAC;iBAAM,CAAC;gBACN,OAAO;gBACP,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;gBAC/B,MAAM,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;YACtE,CAAC;YAED,IAAI,KAAY,CAAA;YAEhB,IAAI,CAAC;gBACH,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACrC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,KAAK,GAAG,MAAM,CAAC;oBACb,KAAK;oBACL,IAAI,EAAE,CAAC;oBACP,WAAW,EAAE,QAAe;oBAC5B,WAAW,EAAE,IAAI,gBAAgB,CAAC,OAAO,CAAC;oBAC1C,OAAO,EAAE,EAAE,SAAS,EAAE;oBACtB,wBAAwB,EAAE;wBACxB,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;4BAClC,OAAO,MAAM,SAAS,CACpB;gCACE,KAAK,EAAE,GAAG,CAAA;;6CAEe,GAAG;;;;;;6BAMnB;6BACV,EACD;gCACE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;oCACvB,IAAI,IAAI,EAAE,CAAC;wCACT,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAExB;wCAAC,SAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;wCACtE,SAAS,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;oCAC/B,CAAC;gCACH,CAAC;6BACF,CACF,CAAA;wBACH,CAAC;wBAED,OAAO,KAAI,CAAC;qBACb;iBACK,CAAC,CAAA;gBAET,6BAA6B;YAC/B,CAAC;YAED,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,KAAK,CAAC,CAAC,CAAC,CAAA;YACR,MAAM,CAAC,CAAC,CAAC,CAAA;QACX,CAAC;IACH,CAAC,EACD,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE;QAChB,GAAG,CAAC,OAAO,EAAE,CAAA;IACf,CAAC,CACF,CAAA;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAA","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;

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

@@ -1,299 +0,0 @@
-import { mergeComponent } from '@things-factory/board-ai';
-import { findSceneComponent } from './board-action-dispatch';
-const NOOP_RESULT = { applied: false, inverseOps: [] };
-/**
- * 단일 BoardEditOp 를 things-scene 에 in-place 적용.
- *
- * `replace` 는 받지 않음 (호스트의 wholesale 경로). 미지원 op / 누락 컴포넌트 시
- * `applied: false` 반환. 호스트가 missed 로 분류해 사용자 경고.
- */
-export function dispatchBoardEditOp(scene, op, ctx = {}) {
-    if (!scene || !op)
-        return NOOP_RESULT;
-    const normalize = ctx.normalize ?? ((c) => c);
-    switch (op.op) {
-        case 'add': {
-            const normalized = normalize(op.component);
-            // add 의 inverse 는 새로 발급될 refid 가 필요 → scene.add 직전/직후 차집합으로 캡처.
-            const prevRefids = new Set(collectAllRefids(scene));
-            scene.add(normalized, {});
-            const newRefids = collectAllRefids(scene).filter(r => !prevRefids.has(r));
-            const inverseOps = newRefids.map(refid => ({ op: 'remove', refid }));
-            return { applied: true, inverseOps };
-        }
-        case 'remove': {
-            const target = findSceneComponent(scene, { refid: op.refid });
-            if (!target || !target.parent)
-                return NOOP_RESULT;
-            const savedModel = JSON.parse(JSON.stringify(target.model));
-            const prevSelected = scene.selected ?? [];
-            scene.selected = [target];
-            scene.remove();
-            scene.selected = prevSelected.filter((c) => c !== target);
-            return { applied: true, inverseOps: [{ op: 'add', component: savedModel }] };
-        }
-        case 'modify': {
-            const target = findSceneComponent(scene, { refid: op.refid });
-            if (!target)
-                return NOOP_RESULT;
-            const oldValues = captureOldKeys(target.model, op.patch);
-            const merged = mergeComponent(target.model, op.patch);
-            target.set(merged);
-            // change 는 자동 snapshot 안 함 → commander.execute 로 명시 push
-            scene.commander?.execute(null, false);
-            return {
-                applied: true,
-                inverseOps: [{ op: 'modify', refid: op.refid, patch: oldValues }]
-            };
-        }
-        case 'modifyBoard': {
-            const root = scene.root;
-            if (!root || typeof root.set !== 'function')
-                return NOOP_RESULT;
-            const cleanPatch = { ...(op.patch || {}) };
-            delete cleanPatch.components; // 자식 변경은 별도 op
-            const oldValues = captureOldKeys(root.model, cleanPatch);
-            const merged = mergeComponent(root.model, cleanPatch);
-            root.set(merged);
-            scene.commander?.execute(null, false);
-            return { applied: true, inverseOps: [{ op: 'modifyBoard', patch: oldValues }] };
-        }
-        case 'align': {
-            const targets = op.refids
-                .map(r => findSceneComponent(scene, { refid: r }))
-                .filter((c) => c);
-            if (targets.length < 2)
-                return NOOP_RESULT;
-            const beforeBounds = targets.map((c) => ({
-                refid: c.get('refid'),
-                left: c.get('left'),
-                top: c.get('top'),
-                width: c.get('width'),
-                height: c.get('height')
-            }));
-            const prevSelected = scene.selected ?? [];
-            scene.selected = targets;
-            scene.align(op.direction);
-            scene.selected = prevSelected;
-            // 정렬 직전 좌표를 modify inverse 시퀀스로 — 정확한 좌표 복원
-            const inverseOps = beforeBounds.map(b => ({
-                op: 'modify',
-                refid: b.refid,
-                patch: { left: b.left, top: b.top, width: b.width, height: b.height }
-            }));
-            return { applied: true, inverseOps };
-        }
-        case 'distribute': {
-            const targets = op.refids
-                .map(r => findSceneComponent(scene, { refid: r }))
-                .filter((c) => c);
-            if (targets.length < 2)
-                return NOOP_RESULT;
-            const beforeBounds = targets.map((c) => ({
-                refid: c.get('refid'),
-                left: c.get('left'),
-                top: c.get('top')
-            }));
-            const prevSelected = scene.selected ?? [];
-            scene.selected = targets;
-            // things-scene API 는 'VERTICAL' / 'HORIZONTAL' 대문자
-            scene.distribute(op.axis === 'horizontal' ? 'HORIZONTAL' : 'VERTICAL');
-            scene.selected = prevSelected;
-            const inverseOps = beforeBounds.map(b => ({
-                op: 'modify',
-                refid: b.refid,
-                patch: { left: b.left, top: b.top }
-            }));
-            return { applied: true, inverseOps };
-        }
-        case 'group': {
-            const targets = op.refids
-                .map(r => findSceneComponent(scene, { refid: r }))
-                .filter((c) => c);
-            if (targets.length < 2)
-                return NOOP_RESULT;
-            const prevRefids = new Set(collectAllRefids(scene));
-            const prevSelected = scene.selected ?? [];
-            scene.selected = targets;
-            scene.group();
-            scene.selected = prevSelected;
-            const newRefids = collectAllRefids(scene).filter(r => !prevRefids.has(r));
-            const inverseOps = newRefids.map(refid => ({ op: 'ungroup', refid }));
-            return { applied: true, inverseOps };
-        }
-        case 'ungroup': {
-            const target = findSceneComponent(scene, { refid: op.refid });
-            if (!target)
-                return NOOP_RESULT;
-            const childRefids = [];
-            const children = target.components ?? [];
-            for (const child of children) {
-                const r = child.get?.('refid');
-                if (typeof r === 'number')
-                    childRefids.push(r);
-            }
-            const prevSelected = scene.selected ?? [];
-            scene.selected = [target];
-            scene.ungroup();
-            scene.selected = prevSelected.filter((c) => c !== target);
-            const inverseOps = childRefids.length >= 2 ? [{ op: 'group', refids: childRefids }] : [];
-            return { applied: true, inverseOps };
-        }
-        case 'zorder': {
-            const target = findSceneComponent(scene, { refid: op.refid });
-            if (!target)
-                return NOOP_RESULT;
-            const prevSelected = scene.selected ?? [];
-            scene.selected = [target];
-            scene.zorder(op.direction);
-            scene.selected = prevSelected;
-            // Best-effort: forward↔backward, front↔back. 정확하지 않을 수 있지만
-            // 단일 step 단순 반전이라 대부분 OK.
-            const opp = {
-                forward: 'backward',
-                backward: 'forward',
-                front: 'back',
-                back: 'front'
-            };
-            const dir = opp[op.direction];
-            const inverseOps = dir
-                ? [{ op: 'zorder', refid: op.refid, direction: dir }]
-                : [];
-            return { applied: true, inverseOps };
-        }
-        case 'arrange': {
-            // Sugar layout — host 측에서 grid/row/column 위치 계산.
-            // align/distribute 와 달리 things-scene 의 native API 가 없으므로 직접 좌표 계산
-            // 해서 target.set() 으로 적용. left/top 만 변경, width/height 유지.
-            const targets = op.refids
-                .map(r => findSceneComponent(scene, { refid: r }))
-                .filter((c) => c);
-            if (targets.length < 2)
-                return NOOP_RESULT;
-            const beforePositions = targets.map((c) => ({
-                refid: c.get('refid'),
-                left: c.get('left'),
-                top: c.get('top')
-            }));
-            const sizes = targets.map((c) => ({
-                width: typeof c.get('width') === 'number' ? c.get('width') : 0,
-                height: typeof c.get('height') === 'number' ? c.get('height') : 0
-            }));
-            const positions = computeArrangePositions(op.layout, beforePositions, sizes);
-            for (let i = 0; i < targets.length; i++) {
-                const t = targets[i];
-                const pos = positions[i];
-                const merged = mergeComponent(t.model, { left: pos.left, top: pos.top });
-                t.set(merged);
-            }
-            // 단일 snapshot — N 개 modify 가 한 undo step
-            scene.commander?.execute(null, false);
-            const inverseOps = beforePositions.map(b => ({
-                op: 'modify',
-                refid: b.refid,
-                patch: { left: b.left, top: b.top }
-            }));
-            return { applied: true, inverseOps };
-        }
-        case 'replace':
-            // 'replace' 는 호스트의 wholesale 경로 — dispatcher 는 받지 않음.
-            return NOOP_RESULT;
-        default:
-            return NOOP_RESULT;
-    }
-}
-/**
- * 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 function computeArrangePositions(layout, current, sizes) {
-    if (current.length === 0)
-        return [];
-    const anchor = layout.anchor ?? { left: current[0].left, top: current[0].top };
-    const gap = typeof layout.gap === 'number' ? layout.gap : 10;
-    if (layout.type === 'grid') {
-        const cols = Math.max(1, Math.floor(layout.cols));
-        const cellW = sizes.reduce((m, s) => Math.max(m, s.width), 0);
-        const cellH = sizes.reduce((m, s) => Math.max(m, s.height), 0);
-        return current.map((_, i) => {
-            const row = Math.floor(i / cols);
-            const col = i % cols;
-            return {
-                left: anchor.left + col * (cellW + gap),
-                top: anchor.top + row * (cellH + gap)
-            };
-        });
-    }
-    if (layout.type === 'row') {
-        const align = layout.align ?? 'start';
-        const maxH = sizes.reduce((m, s) => Math.max(m, s.height), 0);
-        const out = [];
-        let cursor = anchor.left;
-        for (let i = 0; i < sizes.length; i++) {
-            const s = sizes[i];
-            let top = anchor.top;
-            if (align === 'center')
-                top = anchor.top + (maxH - s.height) / 2;
-            else if (align === 'end')
-                top = anchor.top + (maxH - s.height);
-            out.push({ left: cursor, top });
-            cursor += s.width + gap;
-        }
-        return out;
-    }
-    // column
-    const align = layout.align ?? 'start';
-    const maxW = sizes.reduce((m, s) => Math.max(m, s.width), 0);
-    const out = [];
-    let cursor = anchor.top;
-    for (let i = 0; i < sizes.length; i++) {
-        const s = sizes[i];
-        let left = anchor.left;
-        if (align === 'center')
-            left = anchor.left + (maxW - s.width) / 2;
-        else if (align === 'end')
-            left = anchor.left + (maxW - s.width);
-        out.push({ left, top: cursor });
-        cursor += s.height + gap;
-    }
-    return out;
-}
-/**
- * scene 의 모든 컴포넌트 refid 수집 — add/group 의 inverse 계산용.
- *
- * scene.add / scene.group 직전·직후 호출해 차집합으로 새 발급 refid 식별.
- */
-export function collectAllRefids(scene) {
-    const refids = [];
-    const map = scene?.rootContainer?.refidIndexMap;
-    if (map && typeof map.forEach === 'function') {
-        map.forEach((_, refid) => refids.push(refid));
-    }
-    return refids;
-}
-/**
- * patch 가 변경하려는 키들에 대해 model 의 현재 값을 deep-clone 으로 캡처.
- * inverse modify / modifyBoard op 의 patch 로 사용. 원본에 없던 키는 null 로 보관
- * (revert 시 명시적 null reset).
- */
-export function captureOldKeys(model, patch) {
-    const out = {};
-    for (const k of Object.keys(patch || {})) {
-        const v = model?.[k];
-        out[k] = v === undefined ? null : JSON.parse(JSON.stringify(v));
-    }
-    return out;
-}
-//# sourceMappingURL=board-edit-dispatch.js.map