@things-factory/board-ui 10.0.0-beta.7 → 10.0.0-beta.70

package/dist-client/pages/board-modeller-page.d.ts

@@ -1,8 +1,11 @@
 import './things-scene-components.import';
 import '@operato/board/ox-board-modeller.js';
 import '@operato/oops';
+import '@things-factory/board-ai';
 import { BoardModeller } from '@operato/board/ox-board-modeller.js';
 import { PageView } from '@operato/shell';
+import { findSceneComponent } from './board-action-dispatch.js';
+export { findSceneComponent };
 export declare class BoardModellerPage extends PageView {
     constructor();
     static styles: import("lit").CSSResult[];
@@ -17,7 +20,40 @@ export declare class BoardModellerPage extends PageView {
     componentGroupList?: any[];
     propertyEditor: any;
     preparing?: boolean;
+    /** AI 협력 세션 id — 현재 활성 세션. boardId 변경 시 자동 ensure. 다중 세션 시 활성 1개. */
+    chatSessionId?: string;
+    /** 보드의 모든 ChatSession (탭으로 표시). */
+    chatSessions: Array<{
+        id: string;
+        name?: string;
+        createdAt?: string;
+    }>;
+    /** AI 채팅 패널 열림 상태 (기본 닫힘) */
+    aiPanelOpen: boolean;
+    /**
+     * 적용된 patch 별 inverse op 시퀀스 — Revert 기능용.
+     *
+     * Map<patchId, inverseOps[]>: 각 patch 적용 시점에 계산해 저장. revert 클릭
+     * 시 역순 in-place 적용. 페이지 reload 시 손실 — reload 후 revert 시도는
+     * notify 로 안내 (메모리 외 영속은 별개 작업).
+     */
+    private patchInverses;
+    /** 모델러에 등록된 컴포넌트 type 목록 — chat 호출 시 LLM 에 전달 (lazy cache) */
+    private _knownTypesCache?;
+    /** 등록된 type 의 group 분류 — categories 로 LLM 에 전달 */
+    private _knownCategoriesCache?;
+    private get knownTypes();
+    private get knownCategories();
+    /**
+     * type 별 유효 속성 스킴 — LLM 이 정확한 컴포넌트를 만들도록 (lazy cache).
+     *
+     * 핵심: 좌표 표현은 type 마다 다르다 (left/top vs cx/cy vs points 등).
+     * 따라서 OMIT 하지 않고 `geometryKeys` 로 별도 노출 → LLM 이 type 별 좌표 키 사용 가능.
+     */
+    private _componentSchemasCache?;
+    private get componentSchemas();
     private board;
+    private _loadTracker?;
     private _fontCtrl;
     modeller?: BoardModeller;
     get context(): {
@@ -31,6 +67,104 @@ export declare class BoardModellerPage extends PageView {
         description: string;
     };
     refresh(): Promise<void>;
+    /** 패널 토글 시 호출 — 열 때만 chatSession 보장 (세션 리스트 로드 + 활성 세션 결정) */
+    private toggleAIPanel;
+    /** 보드의 모든 ChatSession 목록을 로드 + 활성 세션 보장.
+     *  - 세션이 0 개면 startBoardAISession 으로 첫 세션 생성 (단일 세션 UX 호환)
+     *  - 활성 세션 미설정 시 첫 번째 세션을 활성으로
+     *  - 이미 활성 세션 set 돼있고 list 에 포함되면 유지 */
+    private ensureChatSession;
+    /** `@` mention popup 의 도메인 사용자 후보 — chat 의 userProvider prop 으로 wire.
+     *  query 변할 때마다 호출되므로 server query (`domainUsersForMention`) 를 그대로 위임. */
+    private fetchDomainUsersForMention;
+    /** 채팅 패널의 탭 클릭 — 활성 세션 전환. */
+    private onChatSessionSwitch;
+    /** 채팅 패널의 "+" 버튼 — 새 세션 생성 후 활성으로 전환. */
+    private onChatSessionCreate;
+    /**
+     * 모델러의 selected (things-scene Component 인스턴스 배열) 에서 refid 추출.
+     *
+     * refid 는 things-scene 이 모든 컴포넌트에 자동 발급하는 universal numeric handle.
+     * AI 의 selection 표현은 항상 refid 기반 (id 는 데이터 바인딩 이름이며 unique 가
+     * 아니라 targeting 에 부적합).
+     */
+    private extractSelectedRefids;
+    /**
+     * AI 채팅 mention popup (`#`) 검색 위임 — things-scene SceneSearchEngine 으로 wrap.
+     *
+     * F-key Finder 와 동일한 검색 룰 (id → name → tag → type → class → text → data → property)
+     * 을 그대로 mention popup 에 재사용. 컴포넌트 트리를 직접 순회하므로 model JSON 으로
+     * 변환할 필요 없음 — 일관성 + 성능 이점.
+     *
+     * 반환 구조 (FilterResult) 는 chat 의 mention-popup 표시 모델. host 는 things-scene
+     * Component 에서 refid/id/type/tag/class/text 를 뽑아 candidate 로 채워 넘긴다.
+     */
+    private searchSceneForMention;
+    /**
+     * 라이브 보드 모델 — things-scene 캔버스가 들고 있는 가장 최신 상태의 deep clone.
+     *
+     * 사용자 수작업 편집은 scene.model 에만 반영되고 this.model property 에는 자동
+     * 동기화되지 않는다. AI 한테 보드 상태를 넘기거나 patch 를 적용할 때는 반드시
+     * 이쪽을 쓴다.
+     *
+     * id 와 refid 는 별개 필드 — 컴포넌트는 model.id (선택, 사용자/AI 가 명시 설정)
+     * 와 model.refid (필수, things-scene 자동 발급) 를 둘 다 가질 수 있고 AI 가
+     * 양쪽을 구별해서 다룬다 (tool 인자가 분리됨). 따라서 여기서는 model 을 mutate
+     * 하지 않고 raw deep clone 만 반환.
+     */
+    private getLiveBoard;
+    /**
+     * 채팅에서 patch 도착 — things-scene 에 in-place 적용.
+     *
+     * 핵심: `this.model = next` 로 모델을 통째 교체하면 ox-scene-viewer 가 scene 을
+     * dispose → 재생성 → undo 히스토리/dirty 플래그가 모두 초기화된다.
+     * 따라서 일반 add/modify/remove 는 scene 의 in-place mutation API 로 적용 →
+     * commander 가 자동으로 snapshot push → CMD+Z 와 저장 안내 팝업이 정상 동작.
+     *
+     * 'replace' op (보드 전체 교체) 만은 부득이 wholesale 경로로 빠진다 — 이 경우는
+     * 사용자에게 명시적으로 안내 후 진행.
+     */
+    private onBoardEditPatch;
+    /**
+     * 'replace' op 적용 — scene 통째로 재생성 (undo 히스토리 초기화).
+     *
+     * AI 가 보드 전체 재구성을 요청한 경우. 사용자에게 history 손실 안내.
+     * board-import 데이터 wholesale 적용 등 드문 케이스에 한정.
+     *
+     * Revert 지원 — replace 직전 보드 model 을 inverse 로 보관 (또 다른 replace).
+     */
+    private applyPatchWholesale;
+    /**
+     * 채팅에서 board-edit-revert 도착 — 누적된 inverse 를 역순 in-place 적용.
+     *
+     * - 메모리상 patchInverses Map 만 본다. 페이지 reload 후엔 inverse 가 없어
+     *   되돌릴 수 없음 (사용자에게 안내).
+     * - 성공 시 서버 revertPatch mutation 호출 → PatchEntry.reverted=true 영속.
+     * - in-place 적용이라 undo/dirty/selection 보존 (chatViaTools 의 모든 강점 그대로).
+     */
+    private onBoardEditRevert;
+    /**
+     * inverse op 시퀀스를 things-scene 위에 in-place 적용 (snapshot/undo 보존).
+     * dispatcher 재사용 — inverse 누적은 무시 (revert 의 revert 는 redo, 별개 기능).
+     */
+    private applyInverseOpsInPlace;
+    /** 서버 PatchEntry.reverted=true 영속 — fail 해도 UI 는 이미 되돌렸으니 warn 만. */
+    private recordRevertOnServer;
+    /**
+     * AI 가 ephemeral scene action (selection / view / mode) 을 실행하라고 요청.
+     *
+     * board-edit-patch 와 별개 채널 — 모델 변경 X, undo 영향 X, dirty flag 무관.
+     * things-scene API 직접 호출. 잘못된 action / 누락된 컴포넌트는 console.warn 만.
+     */
+    private onBoardActionExecute;
+    /**
+     * AI 가 만든 컴포넌트를 things-scene 이 기대하는 완전한 형태로 normalize.
+     * BoardModeller 에 등록된 template.model (default 값) 위에 AI 응답을 덮어쓴다.
+     * 이 단계 없이 things-scene 에 넣으면 필수 속성 누락 시 render 에서 crash 가능
+     * (예: gauge-circle 의 value 가 undefined → toString() TypeError).
+     */
+    private normalizeComponent;
+    private findTemplateByType;
     updated(changes: any): Promise<void>;
     pageUpdated(changes: any, lifecycle: any): void;
     render(): import("lit-html").TemplateResult<1>;