@hatiolab/things-scene 10.0.0-beta.98 → 10.0.0

package/dist-types/search/search-overlay.d.ts

@@ -40,7 +40,6 @@ export declare class SearchOverlay {
     private _historyIndex;
     private _savedInput;
     private static MAX_HISTORY;
-    private _keyboardNav;
     get isVisible(): boolean;
     get engine(): SceneSearchEngine;
     setup(host: SearchOverlayHost): void;
@@ -52,12 +51,38 @@ export declare class SearchOverlay {
     hide(): void;
     destroy(): void;
     private _buildDOM;
+    /**
+     * 드래그 핸들 설정. mousedown on `handle` 에서 시작, document 의 mousemove 로
+     * container 위치 추적, mouseup 으로 종료. input/button/icon 같은 인터랙티브
+     * 요소 위에서 시작된 mousedown 은 드래그로 잡지 않음 (본연의 click/focus 보존).
+     */
+    private _setupDrag;
     private _buttonStyle;
     private _doSearch;
     private _addToHistory;
     private _navigateHistory;
     private _isHistoryMode;
+    /**
+     * input 의 raw 값을 host 에 query-submit 으로 전달. Enter 키 / 돋보기 아이콘 클릭
+     * 공통 진입점.
+     * - VIEW 모드: input 의 raw 값을 query-submit 으로 host 에 dispatch. 결과 유무
+     *   무관하게 입력값 자체를 정확한 ID 로 host 가 처리 (예: 미래 ID 영구 추적).
+     * - EDIT 모드: things-scene 기본 동작 위임 — 결과가 있으면 첫 결과 _selectResult.
+     * @returns input value 가 비어있지 않아 submit 처리했으면 true.
+     */
+    private _submitQuery;
+    /**
+     * VIEW 모드의 디폴트 query-submit 동작 — application 의 onSearchSubmit override
+     * 가 있으면 그것 호출. 반환 true 시 디폴트 (host.tracker.start) skip.
+     */
+    private _invokeViewSubmit;
+    /**
+     * VIEW 모드의 디폴트 close 동작 — application override (onSearchClose) 가 있으면
+     * 호출. 반환 true 시 디폴트 (host.tracker.stop) skip.
+     */
+    private _invokeViewClose;
     private _focusResult;
+    private _isEditMode;
     private _selectResult;
     private _clearHighlight;
     private _updateStatus;

package/dist-types/search/search-overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-overlay.d.ts","sourceRoot":"","sources":["../../src/search/search-overlay.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAqB,MAAM,0BAA0B,CAAA;AAE/E;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG;QAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAA;KAAE,CAAA;IACrD,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IACpC,uBAAuB;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACxD,YAAY;IACZ,WAAW,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IAC1C,6BAA6B;IAC7B,sBAAsB,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IACtD,oBAAoB;IACpB,UAAU,CAAC,IAAI,IAAI,CAAA;CACpB;AAaD;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAC,CAAmB;IACjC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,MAAM,CAAC,CAAkB;IACjC,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,cAAc,CAAC,CAA+B;IAGtD,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAK;IAG/B,OAAO,CAAC,YAAY,CAAQ;IAE5B,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,MAAM,IAAI,iBAAiB,CAE9B;IAED,KAAK,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAKpC;;OAEG;IACH,MAAM,IAAI,IAAI;IAad,IAAI,IAAI,IAAI;IAqBZ,IAAI,IAAI,IAAI;IAYZ,OAAO,IAAI,IAAI;IAaf,OAAO,CAAC,SAAS;IAuIjB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,SAAS;IAmBjB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,iBAAiB;IA+HzB,OAAO,CAAC,0BAA0B;IAmBlC,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,SAAS;CAGlB"}
+{"version":3,"file":"search-overlay.d.ts","sourceRoot":"","sources":["../../src/search/search-overlay.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAE5D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG;QAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAA;KAAE,CAAA;IACrD,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IACpC,uBAAuB;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACxD,YAAY;IACZ,WAAW,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IAC1C,6BAA6B;IAC7B,sBAAsB,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IACtD,oBAAoB;IACpB,UAAU,CAAC,IAAI,IAAI,CAAA;CACpB;AAaD;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAC,CAAmB;IACjC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,MAAM,CAAC,CAAkB;IACjC,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,cAAc,CAAC,CAA+B;IAGtD,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAK;IAE/B,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,MAAM,IAAI,iBAAiB,CAE9B;IAED,KAAK,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAKpC;;OAEG;IACH,MAAM,IAAI,IAAI;IAad,IAAI,IAAI,IAAI;IAqBZ,IAAI,IAAI,IAAI;IAkBZ,OAAO,IAAI,IAAI;IAaf,OAAO,CAAC,SAAS;IA8JjB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAqClB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,SAAS;IAmBjB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,cAAc;IAItB;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IAoBpB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,aAAa;IA8CrB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,iBAAiB;IA8HzB,OAAO,CAAC,0BAA0B;IAmBlC,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,SAAS;CAGlB"}

package/dist-types/things-scene/api/clipboard.d.ts

@@ -1,4 +1,4 @@
 export declare function copy(this: any): string | undefined;
 export declare function cut(this: any): string | undefined;
-export declare function paste(this: any, copied: string): void;
+export declare function paste(this: any, copied?: string): void;
 //# sourceMappingURL=clipboard.d.ts.map

package/dist-types/things-scene/api/clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/clipboard.ts"],"names":[],"mappings":"AAWA,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,sBAU7B;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,sBAO5B;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,QAS9C"}
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/clipboard.ts"],"names":[],"mappings":"AAWA,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,sBAU7B;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,sBAO5B;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,QAS/C"}

package/dist-types/things-scene/api/listener.d.ts

@@ -1,4 +1,4 @@
 export declare function on(this: any, event: string, listener: any, context?: any): void;
 export declare function once(this: any, event: string, listener: any, context?: any): void;
-export declare function off(this: any, event: string, listener: any, context?: any): void;
+export declare function off(this: any, event?: string, listener?: any, context?: any): void;
 //# sourceMappingURL=listener.d.ts.map

package/dist-types/things-scene/api/listener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/listener.ts"],"names":[],"mappings":"AAmBA,wBAAgB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAExE;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAE1E;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAEzE"}
+{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/listener.ts"],"names":[],"mappings":"AAmBA,wBAAgB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAExE;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAE1E;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAE3E"}

package/dist-types/things-scene/api/to-data-url.d.ts

@@ -1,2 +1,2 @@
-export declare function toDataURL(this: any, type: string, encoderOptions: any, width: number, height: number): Promise<unknown>;
+export declare function toDataURL(this: any, type?: string, encoderOptions?: any, width?: number, height?: number): Promise<unknown>;
 //# sourceMappingURL=to-data-url.d.ts.map

package/dist-types/things-scene/api/to-data-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-data-url.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/to-data-url.ts"],"names":[],"mappings":"AASA,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,oBA8EpG"}
+{"version":3,"file":"to-data-url.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/to-data-url.ts"],"names":[],"mappings":"AASA,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,oBA8ExG"}

package/dist-types/things-scene/api/zorder.d.ts

@@ -1,3 +1,3 @@
-export declare function move(this: any, component: any, to_container: any, to_index: number): void;
+export declare function move(this: any, component?: any, to_container?: any, to_index?: number): void;
 export declare function zorder(this: any, type: string): void;
 //# sourceMappingURL=zorder.d.ts.map

package/dist-types/things-scene/api/zorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zorder.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/zorder.ts"],"names":[],"mappings":"AAQA,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,QAYlF;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,QAwD7C"}
+{"version":3,"file":"zorder.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/zorder.ts"],"names":[],"mappings":"AAQA,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,QAYrF;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,QAsD7C"}

package/dist-types/things-scene/application-context.d.ts

@@ -26,11 +26,17 @@ export default class ApplicationContext {
     _commander: unknown;
     _loadTracker?: LoadTracker;
     _loadTrackerOwned: boolean;
-    _lagTracker?: DataLagTracker;
     /** 영구 플래그 (런타임 setter로 조작) */
     _suppressAnimationsFlag: boolean;
     /** 스코프드 API 의 중첩 호출용 ref count */
     _suppressScopeCount: number;
+    /**
+     * 모델링 포커스 dim 필터 — 반환 false 인 컴포넌트는 **편집 모드에서** dim + pick 제외된다.
+     * transient(비영속) view 상태: 모델(hidden)·저장물·undo 와 무관. undefined = 미적용.
+     */
+    _focusFilter?: (component: any) => boolean;
+    /** 마퀴(selbox) 영역 선택 드래그 진행 중 — 드래그 중 UI 갱신 억제용(transient, 비영속). */
+    isSelecting: boolean;
     trigger: (event: string, ...args: unknown[]) => void;
     constructor(mode: number, refProvider: unknown);
     initLoadTracker(options?: LoadingOptions): LoadTracker;
@@ -38,7 +44,12 @@ export default class ApplicationContext {
     /** 앱에서 미리 생성한 LoadTracker를 받아서 사용 (dispose 책임은 앱에 있음) */
     adoptLoadTracker(tracker: LoadTracker): void;
     initLagTracker(config: LagMonitorConfig | LagMonitorConfig[]): DataLagTracker;
-    get lagTracker(): DataLagTracker | undefined;
+    /**
+     * 데이터 지연 트래커 — 모듈 싱글톤(dataLagTracker)을 가리킨다. 그래야
+     * globalThis.scene.dataLagTracker(모듈)와 app.lagTracker(인스턴스)가 동일 인스턴스를
+     * 공유해서, 모니터 익스텐션/오버레이/구독 핸들러가 같은 통계를 본다.
+     */
+    get lagTracker(): DataLagTracker;
     dispose(): void;
     _calcScreen(): void;
     subscribe(tag: string, component: unknown): unknown;
@@ -62,6 +73,8 @@ export default class ApplicationContext {
     set mode(mode: number);
     get isViewMode(): boolean;
     get isEditMode(): boolean;
+    get focusFilter(): ((component: any) => boolean) | undefined;
+    set focusFilter(filter: ((component: any) => boolean) | undefined);
     get baseUrl(): string | null;
     set baseUrl(baseUrl: string | null);
     url(x: string): any;

package/dist-types/things-scene/application-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application-context.d.ts","sourceRoot":"","sources":["../../src/things-scene/application-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"application-context.d.ts","sourceRoot":"","sources":["../../src/things-scene/application-context.ts"],"names":[],"mappings":"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"}

package/dist-types/things-scene/create.d.ts

@@ -56,5 +56,29 @@ export interface SceneCreateOptions {
     /** Loading monitor options */
     loading?: LoadingOptions;
 }
+/**
+ * Create and mount a {@link Scene} — the primary entry point of the library.
+ *
+ * Instantiates the root container, application context, and (when a `target` is given)
+ * renders the board into that DOM element. The returned scene manages the full lifecycle;
+ * call {@link Scene.dispose} when done to release resources.
+ *
+ * @param options - See {@link SceneCreateOptions}. `target` may be omitted for headless
+ *   (off-screen / SSR) rendering.
+ * @returns A mounted {@link Scene} instance.
+ * @throws If `target` is a string that resolves to no element, or to a non-empty element.
+ *
+ * @example
+ * ```ts
+ * import { create, SCENE_MODE } from '@hatiolab/things-scene'
+ *
+ * const scene = create({
+ *   target: document.getElementById('board'),
+ *   model: JSON.parse(boardJson),
+ *   mode: SCENE_MODE.VIEW,
+ * })
+ * scene.data = { sensor1: { value: 42 } } // live data binding
+ * ```
+ */
 export default function create({ target, model, style, layers, handlers, mode, refProvider, dataSubscriptionProvider, dataStorage, baseUrl, fitMode, postprocessing, logarithmicDepth, loading: loadingOptions }: SceneCreateOptions): Scene;
 //# sourceMappingURL=create.d.ts.map

package/dist-types/things-scene/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/things-scene/create.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACpH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,KAAK,MAAM,YAAY,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;IAC7B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC3B,0EAA0E;IAC1E,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,EAAE,CAAA;IAC5D,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,uEAAuE;IACvE,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;IACnD,6DAA6D;IAC7D,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAUD,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,EAC7B,MAAM,EACN,KAAK,EACL,KAAK,EACL,MAAW,EACX,QAAa,EACb,IAAsB,EACtB,WAAW,EACX,wBAAwB,EACxB,WAAkC,EAClC,OAAO,EACP,OAAO,EACP,cAAqB,EACrB,gBAAgB,EAChB,OAAO,EAAE,cAAc,EACxB,EAAE,kBAAkB,SAkDpB"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/things-scene/create.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACpH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,KAAK,MAAM,YAAY,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;IAC7B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC3B,0EAA0E;IAC1E,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,EAAE,CAAA;IAC5D,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,uEAAuE;IACvE,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;IACnD,6DAA6D;IAC7D,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAUD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,EAC7B,MAAM,EACN,KAAK,EACL,KAAK,EACL,MAAW,EACX,QAAa,EACb,IAAsB,EACtB,WAAW,EACX,wBAAwB,EACxB,WAAkC,EAClC,OAAO,EACP,OAAO,EACP,cAAqB,EACrB,gBAAgB,EAChB,OAAO,EAAE,cAAc,EACxB,EAAE,kBAAkB,SAkDpB"}

package/dist-types/things-scene/index.d.ts

@@ -17,19 +17,24 @@ export declare namespace Model {
 export { default as Layer } from '../layer/layer.js';
 export { default as EventMap } from '../event-map/event-map.js';
 export type { ComponentEventMap } from '../types/event.js';
+export { capability, hasCapability, registerCapabilityMeta, getCapabilityMeta, getAllCapabilityMeta } from '../types/capability.js';
+export type { CapabilityMeta, CapabilityDescription } from '../types/capability.js';
 export * from '../const.js';
 export * from '../animation/index.js';
 export * from '../components/index.js';
 export * from '../layout/index.js';
 export * from '../types/index.js';
+export * from '../items/index.js';
+export * from '../flow/index.js';
+export { default as Holdable } from '../components/mixins/holdable.js';
 export type { POINT, SCALE, TRANSLATE, POSITION, LOCATION, ROTATION, DIMENSION, BOUNDS, DELTA, FITMODE, ComponentNature, Anchor, LinkEndConfig, ControlHandler, Control, Decorator, PopupOptions, ChangeFunction, Class, Properties, State, Style } from '../interfaces/types.js';
 export type { ReferenceProvider, DataSubscriptionProvider, PersistentDataStorage } from '../interfaces/providers.js';
 export type { SceneRenderContext, DrawOptions, StyleOptions, FillStyle, StrokeStyle, TextStyle, Shadow, IFillDrawer, IStrokeDrawer, ITextDrawer, ILineTipDrawer, IImageDrawer } from '../interfaces/rendering.js';
 export type { LinkEnd } from '../decorator/decorators/link-decorator.js';
 export type { LAYOUT, LayoutRegistry } from '../interfaces/layout.js';
 export type { IRealObject } from '../interfaces/real-object.js';
-export type { Vec3, Size3, Bounds3, SlotArrangement, GridShape, SlotDef, SlotAssignment, TransferOptions, StaticPolicy, DynamicPolicy, PendingPolicy, ConnectionPolicy, Port, TransferEventType, TransferEvent, CarrierAttachPoint, ArrangementStrategy, Transferable, NavigationTarget, NavigationOptions, Movable, ArticulatedCapability, MissionStatus, VehicleMission, MissionExecutor, SensorPoint, SpawnPoint, SinkPoint, SimulationClock, TransferPhase, TransferTimeline, TransferReceipt, TransferReceiptJSON, TransferLogStats, PhysicalRunner, TransferInit, QuatLike, PoseSerialized, PickupFrame, PickupRequester, Pickable, RectangularFootprintOptions, TopApproachOptions } from '../transfer/index.js';
-export { FixedSlotStrategy, CenteringSlotStrategy, ContainerCapacity, TRANSFER_SLOT_KEY, globalSimClock, Transfer, transferLog, receiptToJSON, quatFromYaw, rectangularFootprintFrames, topApproachFrame, filterByToolType, chooseNearestPickupFrame } from '../transfer/index.js';
+export type { Vec3, Size3, Bounds3, SlotArrangement, GridShape, SlotDef, SlotAssignment, TransferOptions, StaticPolicy, DynamicPolicy, PendingPolicy, ConnectionPolicy, Port, TransferEventType, TransferEvent, CarrierAttachPoint, ArrangementStrategy, Transferable, NavigationTarget, NavigationOptions, Movable, ArticulatedCapability, MissionStatus, VehicleMission, MissionExecutor, SensorPoint, SpawnPoint, SinkPoint, SimulationClock, TransferPhase, TransferTimeline, TransferReceipt, TransferReceiptJSON, TransferLogStats, PhysicalRunner, TransferInit, CarrierLine, CarrierReservation, CarrierSlotState, JoinPoint, QuatLike, PoseSerialized, PickupFrame, PickupRequester, Pickable, RectangularFootprintOptions, TopApproachOptions } from '../transfer/index.js';
+export { FixedSlotStrategy, CenteringSlotStrategy, TRANSFER_SLOT_KEY, applySeatingRotation, globalSimClock, Transfer, transferLog, receiptToJSON, transferTracer, quatFromYaw, rectangularFootprintFrames, topApproachFrame, filterByToolType, chooseNearestPickupFrame } from '../transfer/index.js';
 export { Pose6DOF, getPose, getWorldPose, setPose, setWorldPose } from '../math/index.js';
 export type { PoseLike } from '../math/index.js';
 export { ReservationTable, reservationTable, standardYieldPolicy, NavGraph, buildNavGraph, planPathAStar, planToReservations } from '../navigation/index.js';
@@ -38,6 +43,8 @@ export { buildContractInspector, installContractInspector } from '../diagnostics
 export type { ContractInspector, InspectorComponentSummary, InspectorSimStatus } from '../diagnostics/contract-inspector.js';
 export { frameClock } from '../clock/index.js';
 export type { FrameClock, TickHandler, Unsubscribe, SubscribeOptions, SubscriptionInfo, FrameClockSnapshot, ExternalAnimationInfo, ExternalAnimationHandle } from '../clock/index.js';
+export { Tracker } from '../tracker/tracker.js';
+export type { TrackerOptions } from '../tracker/tracker.js';
 export { default as ReferenceMap } from '../core/reference-map.js';
 export { default as ScriptLoader } from '../core/script-loader.js';
 export * from '../core/logger.js';
@@ -48,9 +55,10 @@ export { metrics } from '../diagnostics/metrics.js';
 export { inspector } from '../diagnostics/inspector.js';
 export { LoadTracker } from '../diagnostics/load-tracker.js';
 export type { LoadPhase, LoadEntry, LoadingOptions, LoadStats, PhaseRecord } from '../diagnostics/load-tracker.js';
-export { DataLagTracker } from '../diagnostics/data-lag-tracker.js';
-export type { LagMonitorConfig, LagTrend, LagLevel, LagStats } from '../diagnostics/data-lag-tracker.js';
-export { LoadingOverlay } from '../diagnostics/loading-overlay.js';
+export { DataLagTracker, dataLagTracker } from '../diagnostics/data-lag-tracker.js';
+export type { LagMonitorConfig, LagLevel, LagStats } from '../diagnostics/data-lag-tracker.js';
+export { LoadingOverlay, DefaultLoadingOverlayRenderer } from '../diagnostics/loading-overlay.js';
+export type { LoadingOverlayRenderer, LoadingOverlayState, LoadingOverlayHost } from '../diagnostics/loading-overlay.js';
 export { default as ScenePopup } from '../layer/action/popup.js';
 export { default as TransitionEffect } from '../transition/transition-effect.js';
 export * from '../placement/index.js';

package/dist-types/things-scene/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/things-scene/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/things-scene/index.ts"],"names":[],"mappings":"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"}

package/dist-types/things-scene/scene.d.ts

@@ -3,6 +3,7 @@ import * as API from './api/index.js';
 import type { LoadTracker } from '../diagnostics/load-tracker.js';
 import { LoadingOverlay } from '../diagnostics/loading-overlay.js';
 import { SearchOverlay } from '../search/search-overlay.js';
+import { Tracker, type TrackerOptions } from '../tracker/tracker.js';
 /**
  * The top-level API object for things-scene, managing the full lifecycle of a visual board:
  * creation, rendering (2D Canvas + 3D Three.js), interaction, and disposal.
@@ -29,6 +30,25 @@ declare class Scene {
     _commander: any;
     app: any;
     private _searchOverlay;
+    private _tracker?;
+    /**
+     * SearchOverlay 의 VIEW 모드 동작에 영향. Tracker 옵션 (color, fallback,
+     * fallbackColor, intervalMs) 을 application 이 제공. SearchOverlay 가 자동
+     * tracker.start 호출 시 이 옵션 사용.
+     */
+    trackerOptions?: TrackerOptions;
+    /**
+     * SearchOverlay 의 query-submit 시 호출되는 application override hook.
+     * - 반환 true: SearchOverlay 의 디폴트 동작 (자동 tracker.start) skip — application 이 모든 처리.
+     * - 반환 false/void: 디폴트 진행 (tracker.start 자동 호출).
+     * 미지정 시 디폴트 진행. application 은 폴백만 제공할 수도, 완전 override 할 수도.
+     */
+    onSearchSubmit?: (detail: any, scene: any) => boolean | void;
+    /**
+     * SearchOverlay close 시 호출되는 application override hook.
+     * 반환 true 시 디폴트 (tracker.stop) skip.
+     */
+    onSearchClose?: (scene: any) => boolean | void;
     private _loadingOverlay;
     onDataBindingToggle?: () => void;
     onMonitorToggle?: () => void;
@@ -39,11 +59,19 @@ declare class Scene {
      * @param {RootContainer} container - Root container
      */
     constructor(container: any);
+    /**
+     * Add one or more component models to the scene (undoable).
+     * @param models - A model or array of models to add.
+     * @param boundsOrOffset - Optional target bounds, or an `{x, y}` offset.
+     * @param onto - Optional target container to add into.
+     */
     add(models: any, boundsOrOffset?: any, onto?: any): void;
+    /** Duplicate the current selection (undoable). */
     duplicate(): void;
+    /** Remove the current selection (undoable). */
     remove(): void;
     animate(config: Parameters<typeof animate>[0]): import("./index.js").AnimationController;
-    fullscreen(fit?: any): void;
+    fullscreen(fit?: string): void;
     get target(): any;
     set target(target: any);
     get scale(): any;
@@ -59,11 +87,23 @@ declare class Scene {
     get screen(): any;
     set screen(size: any);
     resize(): void;
+    /** Alias for {@link dispose}. */
     release(): void;
+    /**
+     * Tear down the scene and release all resources — container, commander, overlays,
+     * tracker, 3D GLTF caches, and the global transfer log. Call this on board switch or
+     * unmount to avoid leaks. The scene must not be used after disposal.
+     */
     dispose(): void;
+    /** The currently selected components, as a snapshot array (safe to iterate/mutate). */
     get selected(): any;
     set selected(selected: any);
-    select(selector: any, ...others: any[]): any;
+    /**
+     * Select all components matching a selector, replacing the current selection.
+     * @param selector - A CSS-like selector (by type, id, class, etc.).
+     * @returns The resulting selection.
+     */
+    select(selector: string, ...others: any[]): any;
     get commander(): any;
     undo(): void;
     undoable(): any;
@@ -73,46 +113,102 @@ declare class Scene {
     hasUnpreservedChanges(): any;
     cut(): string | undefined;
     copy(): string | undefined;
-    paste(copied?: any): void;
+    paste(copied?: string): void;
     undoableChange(changeFunc?: any): void;
-    change(selector: any, value?: any, self?: any): any;
+    change(selector: string, value?: any, self?: any): any;
+    /**
+     * The scene's model as a plain, serializable component tree (volatile props stripped,
+     * numbers rounded). Assigning a new model rebuilds the entire scene content.
+     */
     get model(): any;
     set model(model: any);
     get rootContainer(): any;
     get root(): any;
-    findAll(selector: any, ...others: any[]): any;
-    findFirst(selector: any, ...others: any[]): any;
-    findById(id: any): any;
-    findAllById(id: any): any;
+    /** Find all components matching a CSS-like selector. */
+    findAll(selector: string, ...others: any[]): any;
+    /** Find the first component matching a CSS-like selector, or `undefined`. */
+    findFirst(selector: string, ...others: any[]): any;
+    /** Find the first component with the given `id`. */
+    findById(id: string): any;
+    /** Find all components sharing the given `id`. */
+    findAllById(id: string): any;
     serialize(): any;
-    align(type: any): void;
-    place(type: any): void;
-    distribute(type: any): void;
-    move(component?: any, to_container?: any, to_index?: any): void;
-    zorder(type: any): void;
+    align(type: string): void;
+    place(type: string): void;
+    distribute(type: string): void;
+    move(component?: any, to_container?: any, to_index?: number): void;
+    zorder(type: string): void;
     symmetryX(): void;
     symmetryY(): void;
-    on(event: any, listener: any, context?: any): void;
-    once(event: any, listener: any, context?: any): void;
-    off(event?: any, listener?: any, context?: any): any;
-    centerTo(component: any, animated?: any): any;
+    on(event: string, listener: any, context?: any): void;
+    once(event: string, listener: any, context?: any): void;
+    off(event?: string, listener?: any, context?: any): any;
+    centerTo(component: any, animated?: boolean): any;
+    /**
+     * 영구 추적 모듈. 단일 추적 — 한 번에 하나의 id 만 추적. 트리에서 매칭 컴포넌트가
+     * dispose/재등장 사이클을 타도 자동 재부착. 2D 는 deco-border, 3D 는 outline 으로
+     * 같은 색깔 시각화. 자세한 사용법은 Tracker 클래스 참고.
+     */
+    get tracker(): Tracker;
+    /**
+     * Scene mode: `MODE_VIEW` (0) for monitoring / runtime, `MODE_EDIT` (1) for the modeller.
+     * Switching mode changes interaction (selection, gizmos) and rendering behavior.
+     */
     get mode(): any;
     set mode(mode: any);
-    toDataURL(type?: any, encoderOptions?: any, width?: any, height?: any): Promise<unknown>;
+    /**
+     * 3D 기능을 쓸 수 있는지 — 프로세스 전역 스위치(setThreedEnabled)를 반영한다.
+     * false 이면 3D 는 전혀 켜지지 않는다. 인스턴스별로 다르지 않다.
+     */
+    get threedEnabled(): boolean;
+    /** 마퀴(영역) 선택 드래그 진행 중 여부 — 드래그 중 외부 UI 갱신 억제용. */
+    get isSelecting(): boolean;
+    get focusFilter(): ((component: any) => boolean) | undefined;
+    /**
+     * 포커스 필터 설정 — 반환 false 컴포넌트는 편집 모드에서 dim + pick 제외.
+     * 모델·저장물·undo 와 무관(transient). 설정 시 즉시 리드로우(2D). 3D 는 별도 갱신.
+     */
+    set focusFilter(filter: ((component: any) => boolean) | undefined);
+    /**
+     * 포커스 필터 변경 시 모델링 흐림(faint)을 canvas 외 채널(3D material, HTML DOM)에 즉시 재적용.
+     * canvas 는 invalidate 리드로우로 draw() 가 처리하지만, 3D material·DOM opacity 는 렌더 루프
+     * 밖이라 별도로 훑어 재적용한다. 재빌드 없이 opacity 스케일만 — 해당 채널을 가진 컴포넌트에만.
+     */
+    private _reapplyModelingFaint;
+    toDataURL(type?: string, encoderOptions?: any, width?: number, height?: number): Promise<unknown>;
     group(): void;
     ungroup(): void;
-    fit(type?: any): void;
+    fit(type?: string): void;
     get fitMode(): any;
+    /** All component `id`s in the scene, as a snapshot array. */
     get ids(): {
         key: any;
         value: any;
     }[];
+    /**
+     * Live data binding — the core mechanism for driving a scene from real-time data.
+     *
+     * Assigning a map propagates values into components by their `id`; each component's
+     * data mappings then update its visual state (color, text, animation, etc.). This is
+     * the primary way a monitoring dashboard reflects sensor / device data.
+     *
+     * @example
+     * ```ts
+     * scene.data = { conveyor1: { running: true }, gauge2: { value: 73 } }
+     * ```
+     */
     get data(): any;
     set data(data: any);
+    /** Like {@link data}, but keyed by component `refid` instead of `id`. */
     get dataByRefid(): any;
     set dataByRefid(data: any);
+    /**
+     * Per-component scalar values keyed by `id` — the simple form of data binding
+     * (a single value per component, vs. the structured map used by {@link data}).
+     */
     get values(): any;
     set values(values: any);
+    /** Like {@link values}, but keyed by component `refid` instead of `id`. */
     get valuesByRefid(): any;
     set valuesByRefid(values: any);
     get baseUrl(): any;
@@ -172,7 +268,6 @@ declare class Scene {
     toggleLoadingOverlay(): void;
     get searchOverlay(): SearchOverlay;
     private _setupSearchOverlay;
-    private _setupLoadingOverlay;
 }
 export default Scene;
 //# sourceMappingURL=scene.d.ts.map

package/dist-types/things-scene/scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/things-scene/scene.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/things-scene/scene.ts"],"names":[],"mappings":"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"}

package/dist-types/threed/common.d.ts

@@ -1,5 +1,10 @@
 export declare const SCALE_MIN = 0.001;
-export declare function applyAlpha(material: any, alpha: number, fillStyle: any): void;
+/**
+ * material 의 **설계(canonical) opacity** 를 fillStyle 로 정한다 — fillStyle 의 alpha 채널(rgba 등),
+ * 'none'/'transparent' 는 0. **content alpha(state.alpha)는 여기서 곱하지 않는다** — 코어의 opacity
+ * 오버레이(RealObject.applyMaterialOpacity)가 faint 와 함께 일괄로 곱한다(이중적용 방지).
+ */
+export declare function applyAlpha(material: any, _alpha: number, fillStyle: any): void;
 /**
  * rgba/hsla 등 alpha 포함 색상 문자열에서 alpha 없는 hex 색상을 반환한다.
  * THREE.Color는 alpha를 지원하지 않으므로 color.set() 전에 사용한다.

package/dist-types/threed/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/threed/common.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,QAAQ,CAAA;AAE9B,wBAAgB,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAWtE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,eAAO,MAAM,cAAc;;;;CAAoC,CAAA;AAC/D,eAAO,MAAM,UAAU;;;;CAAuB,CAAA;AAC9C,eAAO,MAAM,cAAc;;;;CAAuB,CAAA;AAClD,eAAO,MAAM,WAAW;;;;CAAuB,CAAA"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/threed/common.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,QAAQ,CAAA;AAE9B;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAUvE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,eAAO,MAAM,cAAc;;;;CAAoC,CAAA;AAC/D,eAAO,MAAM,UAAU;;;;CAAuB,CAAA;AAC9C,eAAO,MAAM,cAAc;;;;CAAuB,CAAA;AAClD,eAAO,MAAM,WAAW;;;;CAAuB,CAAA"}

package/dist-types/threed/factories/backdrop.d.ts

@@ -53,12 +53,14 @@ declare const Backdrop_base: {
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../../types/component.js").Container): void;
+        removed(parent: import("../../types/component.js").Container): void;
         ready(): Promise<void>;
+        _readyInvoked: boolean;
+        invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         dispose(): void;
         get nature(): ComponentNature;
@@ -76,16 +78,17 @@ declare const Backdrop_base: {
         isConnectable(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
+        getState(property: string): any;
         setState(props: Partial<import("../../index.js").State> | string, propval?: any): any;
         get model(): any;
         get state(): import("../../index.js").State;
+        get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("../../components/component.js").ApplyPropsOptions): /*elided*/ any;
         contains(x: number, y: number): boolean;
         move(offset: {
             x: number;
@@ -260,6 +263,7 @@ declare const Backdrop_base: {
         set element(_v: HTMLElement | null);
     };
     raycastTargetDefault: boolean;
+    requires3d: boolean;
 } & {
     new (...args: any[]): {
         contains(x: number, y: number): boolean;
@@ -299,12 +303,14 @@ declare const Backdrop_base: {
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../../types/component.js").Container): void;
+        removed(parent: import("../../types/component.js").Container): void;
         ready(): Promise<void>;
+        _readyInvoked: boolean;
+        invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         dispose(): void;
         get nature(): ComponentNature;
@@ -323,16 +329,17 @@ declare const Backdrop_base: {
         isConnectable(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
+        getState(property: string): any;
         setState(props: Partial<import("../../index.js").State> | string, propval?: any): any;
         get model(): any;
         get state(): import("../../index.js").State;
+        get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("../../components/component.js").ApplyPropsOptions): /*elided*/ any;
         move(offset: {
             x: number;
             y: number;