@fmsim/board 2.0.0-beta.9 → 2.0.0-beta.93

package/dist/src/ox-board-viewer.d.ts

@@ -3,8 +3,9 @@ import '@material/web/icon/icon.js';
 import './layers/movement-layer.js';
 import './ox-board-component-info.js';
 import './layers/mcs-mouse-event-handler.js';
+import './ox-playback-controls.js';
 import { LitElement, PropertyValues } from 'lit';
-import { Component, ReferenceProvider } from '@hatiolab/things-scene';
+import { Component, LoadTracker, ReferenceProvider } from '@hatiolab/things-scene';
 export declare class BoardViewer extends LitElement {
     static styles: import("lit").CSSResult[];
     baseUrl: string;
@@ -12,26 +13,29 @@ export declare class BoardViewer extends LitElement {
     provider: ReferenceProvider | null;
     data: any;
     values: any;
+    /** 앱에서 미리 생성한 LoadTracker — fetch 시작 전 생성하면 네트워크 시간도 추적 */
+    loadTracker?: LoadTracker;
     hideFullscreen: boolean;
     hideNavigation: boolean;
-    _scene: any;
-    _forward: {
-        id: string;
-        scene: any;
-    }[];
-    _backward: {
-        id: string;
-        scene: any;
-    }[];
-    _oldtarget: HTMLElement | null;
-    _fade_animations?: Array<Animation>;
+    private _scene;
+    private _forward;
+    private _backward;
+    private _loadingOverlay?;
+    private _oldtarget;
+    private _fade_animations?;
+    _fabExpanded: boolean;
+    _playbackActive: boolean;
+    get _is3dMode(): boolean;
     currentBoardId?: string;
     _target: HTMLElement;
     _prev: HTMLElement;
     _next: HTMLElement;
-    _fullscreen: HTMLElement;
+    _fabGroup: HTMLElement;
     private popup;
     private lastComponent;
+    /** SearchOverlay 의 query-submit 시 사용할 추적 색깔. things-scene 의 Scene.tracker
+     *  가 폴링/데코/3D outline 색 동기화 일괄 관리. */
+    private static readonly TRACKING_COLOR;
     render(): import("lit-html").TemplateResult<1>;
     fetchIFactsDataHandler: (e: Event) => void;
     fmbShowMovementHandler: (e: Event) => void;
@@ -43,14 +47,25 @@ export declare class BoardViewer extends LitElement {
     fmbShowFloatingContainerHandler: (e: Event) => void;
     fmbHideFloatingContainerHandler: (e: Event) => void;
     clickComponentHandler: (e: Event) => void;
+    /** 마우스 클릭/popup 의 selected highlight 해제. */
+    private _clearClickHighlight;
     fmbStartAnimation: (e: Event) => void;
     fmbStopAnimation: (e: Event) => void;
     fmbResetAnimation: () => void;
+    private _pointerMoveHandler;
+    /**
+     * playback 모드는 전체화면 모드와 한 몸 — 어떤 경로로든 전체화면이 해제되면
+     * playback 도 함께 종료. (단독 전체화면 토글은 기존처럼 동작하도록 `_playbackActive` 가드.)
+     */
+    private _fullscreenChangeHandler;
+    /** connect/disconnect 시 일괄 등록/해제할 window 이벤트 목록 (모니터링 연동) */
+    private get _monitoringEvents();
     connectedCallback(): void;
     disconnectedCallback(): void;
     updated(changes: PropertyValues<this>): void;
     initSceneAsync(): Promise<void>;
     initScene(): void;
+    private _ensureOverlay;
     closeScene(): void;
     releaseScene(): void;
     setupScene({ id, scene }: {
@@ -60,11 +75,96 @@ export declare class BoardViewer extends LitElement {
     showScene(boardId: string, bindingData?: any): Promise<void>;
     private resizeHandler;
     bindSceneEvents(): void;
+    /**
+     * Tracker fallback resolver — 플레이백 시각의 carrier 위치를 컴포넌트로 변환.
+     * NA / 정보 없음 / 머신 미존재 → null (Tracker 가 highlight 없이 추적만 유지).
+     *
+     * 매 1초 polling 마다 호출되며, 결과 target 이 직전과 동일하면 로그 skip.
+     */
+    private _resolveCarrierFallback;
+    /**
+     * deco-arrow 라이프사이클 — 이전 target 끄고 새 target 에 bouncing arrow 부착.
+     * 둘 다 null 가능 (해제만, 부착만).
+     */
+    private _setFallbackArrow;
+    /**
+     * 1초 polling — 화살표 부착 대상을 결정.
+     *   1) 플레이백 종료 / 추적 ID 없음 → 화살표 해제
+     *   2) carrier 가 scene 에 직접 존재 → **carrier 자체에 화살표 부착**
+     *      (things-scene Tracker 가 carrier 발견 시 fallback 콜백 호출을 멈춰
+     *       resolver 경로로는 우리가 모름. monitor 에서 직접 책임)
+     *   3) carrier 없음 + resolver 가 3초 이상 호출 안 됨 → 화살표 해제
+     *      (그 외엔 resolver 의 logIfChanged 가 fallback target 으로 부착 중)
+     */
+    private _startFallbackArrowMonitor;
+    private _stopFallbackArrowMonitor;
+    /** 부착된 deco-arrow 강제 해제 + dedupe 상태 초기화. */
+    private _clearFallbackArrow;
+    /**
+     * onSearchSubmit hook — 영구추적 carrierName 이 설정되는 순간.
+     * 플레이백 윈도우가 잡혀 있으면 즉시 store 충전. 윈도우가 없으면
+     * 플레이백 시작 시 (_onPlaybackStart) 에 충전.
+     */
+    private _onCarrierTrackingSubmit;
     unbindSceneEvents(scene: any): void;
     transientShowButtons(stop?: boolean): void;
     onTapNext(): void;
     onTapPrev(): void;
     onTapFullscreen(): void;
+    onTapToggle3D(): void;
+    private _dataSubscriptionProvider;
+    private _playbackEngine?;
+    /**
+     * 영구추적 fallback 데이터 캐시 — 플레이백 윈도우 × carrierName 단위로
+     * carrier 위치 이력을 보관. carrier 가 scene 에 직접 안 보일 때
+     * Tracker fallback 콜백이 lookupAt 으로 머신/유닛을 찾아 반환.
+     */
+    private _carrierTrackingStore;
+    /** 마지막으로 시작한 플레이백 윈도우 (carrier store load 트리거용). */
+    private _playbackWindow?;
+    /**
+     * fallback 결과(target 컴포넌트) dedupe — 직전과 동일한 target 일 땐 로그 skip
+     * + deco-arrow 라이프사이클 (target 변경 시 이전 끄고 새로 부착).
+     */
+    private _lastFallbackTarget;
+    /** _resolveCarrierFallback 마지막 호출 timestamp — carrier 발견 감지용. */
+    private _lastFallbackResolvedAt;
+    /** carrier 발견 감지 / deco-arrow 자동 해제용 1초 polling 타이머. */
+    private _fallbackArrowMonitor?;
+    onTapPlayback(): void;
+    private _onPlaybackStart;
+    private _onPlaybackPause;
+    private _onPlaybackResume;
+    private _onPlaybackStop;
+    /**
+     * 플레이백 시작 시: RESTful data-subscription 컴포넌트의 WebSocket 을 실제 disconnect.
+     * GraphQL 경로는 _dataSubscriptionProvider.pause() 에서 일괄 처리.
+     */
+    private _unsubscribeSceneData;
+    /**
+     * 플레이백 종료 시: RESTful data-subscription 컴포넌트의 WebSocket 을 재연결.
+     * GraphQL 경로는 _dataSubscriptionProvider.resume() 에서 일괄 처리.
+     */
+    private _resubscribeSceneData;
+    private _resetSceneData;
+    private _onPlaybackSeek;
+    /**
+     * 드래그 시작 신호 — 엔진의 재생 타이머 정지해서 스크러빙 동안
+     * scene 이 엔진 시간으로 독립 갱신되지 않도록 함. _state 는 유지되므로
+     * 드래그 종료 시 seekTo 가 원래 재생/일시정지 상태로 복원.
+     */
+    private _onPlaybackSeekStart;
+    /**
+     * 드래그 중 디바운스된 seek preview. 해당 시간의 snapshot 만 scene 에 적용.
+     * 보드 리셋 없음, 애니메이션 억제.
+     */
+    private _onPlaybackSeekPreview;
+    private _onPlaybackSpeed;
+    /**
+     * 페이지에서 주입하는 playback 데이터 fetch 함수.
+     * 2-arg 호출은 청크 프리페치, 4-arg 호출은 preview snapshot (count=1).
+     */
+    _fetchPlaybackData?: (startTime: string, endTime?: string, includeSnapshot?: boolean, count?: number) => Promise<any>;
     onRunBoard(): void;
     onLinkGoto(targetBoardId: string, options: any, fromComponent: any): void;
     onLinkOpen(url: string, value: any, fromComponent: Component): void;