@hatiolab/things-scene 10.0.0-beta.12 → 10.0.0-beta.120

package/dist-types/decorator/decorators/data-spread-decorator.d.ts

@@ -22,15 +22,31 @@ export declare class DataSpreadDecorator extends VectorDecorator {
     protected static readonly DECORATOR_TYPE: string;
     private static readonly ARROW_ANGLE_1;
     private static readonly ARROW_ANGLE_2;
+    private static readonly INCOMING_ARROW_COLOR;
     private currentMappings;
+    private cachedArrows;
+    private _incomingTimer;
+    private static readonly INCOMING_DEBOUNCE_MS;
     /**
      * 생성자
      */
     constructor(overlay: HTMLElement, target: Component, options?: DataSpreadDecoratorOptions);
+    /**
+     * 현재 컴포넌트를 target으로 하는 incoming 소스를 역검색한다.
+     */
+    private findIncomingSources;
+    /**
+     * 화살표를 SVG 컨테이너에 추가하는 헬퍼
+     */
+    private appendArrow;
     /**
      * DOM 요소 생성 메서드 구현 (VectorDecorator 추상 메서드)
      */
     protected createDOMElements(): void;
+    /**
+     * SVG linearGradient 요소 생성 헬퍼
+     */
+    private createGradient;
     /**
      * 화살표 경로와 헤드 데이터 생성
      */

package/dist-types/decorator/decorators/data-spread-decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-spread-decorator.d.ts","sourceRoot":"","sources":["../../../src/decorator/decorators/data-spread-decorator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAChF,OAAO,SAAS,MAAM,+BAA+B,CAAA;AAGrD;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;IAEtD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAgB;IAGhE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAwB;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAwB;IAG7D,OAAO,CAAC,eAAe,CAAY;IAKnC;;OAEG;gBACS,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,0BAA+B;IAgB7F;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IA0InC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAsBnC;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAgFhC;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IA0C5B,UAAU,IAAI,IAAI;CAG1B"}
+{"version":3,"file":"data-spread-decorator.d.ts","sourceRoot":"","sources":["../../../src/decorator/decorators/data-spread-decorator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAChF,OAAO,SAAS,MAAM,+BAA+B,CAAA;AAGrD;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;IAEtD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAgB;IAGhE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAwB;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAwB;IAE7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAY;IAGxD,OAAO,CAAC,eAAe,CAAY;IAGnC,OAAO,CAAC,YAAY,CAA2C;IAG/D,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAM;IAElD;;OAEG;gBACS,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,0BAA+B;IAgB7F;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAkCnB;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IA0FnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAsBnC;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAoChC;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAiD5B,UAAU,IAAI,IAAI;CAG1B"}

package/dist-types/diagnostics/contract-inspector.d.ts

@@ -0,0 +1,103 @@
+import { transferLog } from '../transfer/transfer.js';
+import type { Reservation } from '../navigation/types.js';
+export interface InspectorComponentSummary {
+    type: string;
+    id: string;
+    category?: string;
+    parentId?: string;
+    parentPath?: string;
+    pose?: {
+        position: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        rotation: {
+            x: number;
+            y: number;
+            z: number;
+            w: number;
+        };
+    };
+    state?: Record<string, unknown>;
+    isCarriable?: boolean;
+    isPickable?: boolean;
+    isMover?: boolean;
+    isHolder?: boolean;
+    toolType?: string;
+    childIds?: string[];
+}
+export interface InspectorSimStatus {
+    simTime: number;
+    realTime: number;
+    speed: number;
+    paused: boolean;
+    carrierCount: number;
+}
+export interface ContractInspector {
+    /** Scene 의 모든 component 를 평탄화한 list — 각자 contract markers + parent path. */
+    collectComponents(): InspectorComponentSummary[];
+    /** ID 로 단일 컴포넌트 조회 — 더 풍부한 정보 (e.g. pickupFrames, slots). */
+    getComponent(id: string): (InspectorComponentSummary & {
+        pickupFrames?: any[];
+        slots?: any[];
+        acceptanceWorldQuat?: {
+            x: number;
+            y: number;
+            z: number;
+            w: number;
+        };
+        deliveryWorldPosition?: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    }) | null;
+    /** Sim clock 상태. */
+    simStatus(): InspectorSimStatus;
+    /** TransferLog snapshot (read-only). */
+    transferLog(): {
+        entries: ReturnType<typeof transferLog.toJSON>;
+        stats: ReturnType<typeof transferLog.stats>;
+    };
+    /**
+     * Phase K — ReservationTable snapshot. Atlas 의 Reservations / Conflicts /
+     * Heat 모드가 활용. all reservations + per-resource grouped + 현재 sim time.
+     */
+    reservations(): {
+        simTime: number;
+        all: Reservation[];
+        byResource: Record<string, Reservation[]>;
+        byReserver: Record<string, Reservation[]>;
+    };
+    /**
+     * Phase K — 충돌 누적 로그 + 통계. Atlas 의 Conflicts mode 가 활용.
+     */
+    conflicts(): {
+        simTime: number;
+        log: readonly any[];
+        total: number;
+        rejected: number;
+        preempted: number;
+        byResource: Record<string, number>;
+        byReserver: Record<string, number>;
+    };
+    /** Inspector 의 self-version (extension 의 호환성 검사용). */
+    readonly version: string;
+}
+/**
+ * ContractInspector 인스턴스 빌드 — root 컴포넌트 (rootModel) 를 받아 inspector
+ * 객체 반환. install(rootModel) 로 window.__SCENE_INSPECTOR__ 에 연결.
+ */
+export declare function buildContractInspector(rootModel: any): ContractInspector;
+/**
+ * Inspector 를 window.__SCENE_INSPECTOR__ 에 설치. browser 환경에서만.
+ * Chrome extension 의 content script 가 이걸 query.
+ *
+ * usage:
+ *   import { installContractInspector } from '@hatiolab/things-scene'
+ *   const scene = create(model, { isViewMode: true })
+ *   installContractInspector(scene)  // 또는 scene.rootModel
+ */
+export declare function installContractInspector(rootModel: any): ContractInspector;
+//# sourceMappingURL=contract-inspector.d.ts.map

package/dist-types/diagnostics/contract-inspector.d.ts.map

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

package/dist-types/diagnostics/data-lag-tracker.d.ts

@@ -0,0 +1,44 @@
+export interface LagMonitorConfig {
+    tag: string;
+    timestampField: string;
+    warnThreshold?: number;
+    criticalThreshold?: number;
+}
+export type LagTrend = 'stable' | 'increasing' | 'decreasing' | 'spike';
+export type LagLevel = 'normal' | 'warn' | 'critical';
+export interface LagStats {
+    tag: string;
+    currentDelta: number;
+    baseline: number;
+    drift: number;
+    driftAvg: number;
+    driftMax: number;
+    trend: LagTrend;
+    sampleCount: number;
+    level: LagLevel;
+}
+export declare class DataLagTracker {
+    private _monitors;
+    private _disposed;
+    /** level 변경 시 콜백 (evaluateAll 호출 시 트리거) */
+    onLevelChange?: (tag: string, level: LagLevel, stats: LagStats) => void;
+    configure(config: LagMonitorConfig | LagMonitorConfig[]): void;
+    isMonitored(tag: string): boolean;
+    /**
+     * 핫 패스 진입점.
+     * 대상 태그가 아니면 Map.get() 1회로 즉시 리턴.
+     */
+    recordIfMonitored(tag: string, data: any): void;
+    getStats(tag: string): LagStats | null;
+    getAllStats(): LagStats[];
+    /**
+     * UI 갱신 주기에 호출. threshold 판정 + onLevelChange 콜백 발생.
+     */
+    evaluateAll(): void;
+    dispose(): void;
+    private _extractField;
+    private _getRecentDrifts;
+    private _calcTrend;
+    private _calcLevel;
+}
+//# sourceMappingURL=data-lag-tracker.d.ts.map

package/dist-types/diagnostics/data-lag-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-lag-tracker.d.ts","sourceRoot":"","sources":["../../src/diagnostics/data-lag-tracker.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,OAAO,CAAA;AACvE,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;AAErD,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,QAAQ,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,QAAQ,CAAA;CAChB;AAkBD,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,SAAS,CAAQ;IAEzB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;IAEvE,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,GAAG,IAAI;IAuB9D,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIjC;;;OAGG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IA4B/C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IA4CtC,WAAW,IAAI,QAAQ,EAAE;IASzB;;OAEG;IACH,WAAW,IAAI,IAAI;IAcnB,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,UAAU;IA8BlB,OAAO,CAAC,UAAU;CAKnB"}

package/dist-types/diagnostics/inspector.d.ts

@@ -7,12 +7,9 @@ interface ThreedInfo {
     resolved?: ResolvedMaterial3D;
     nodeNames?: string[];
     animationNames?: string[];
-    autoPlay?: boolean;
     nodes?: Record<string, any>;
     animations?: Record<string, any>;
     fillStyleTargets?: string[];
-    spriteMode?: 'billboard' | 'plane';
-    renderMode?: 'css3d' | 'texture';
 }
 interface ComponentTreeNode {
     id: string;
@@ -50,6 +47,19 @@ declare class SceneInspector {
      * 모니터링 확장에서 설정하여 Inspector UI를 자동 갱신한다.
      */
     onSceneChange: ((sceneCount: number) => void) | null;
+    private _watchedComponent;
+    private _watchedHandler;
+    /**
+     * 선택된 컴포넌트의 change 이벤트 콜백.
+     * 모니터링 확장에서 설정하여 Inspector UI를 재렌더한다.
+     */
+    onWatchedComponentChange: ((componentId: string, after: any, before: any) => void) | null;
+    /**
+     * 선택된 컴포넌트를 설정/해제한다. 이전 구독은 자동 해제된다.
+     * componentId === null 이면 구독만 해제.
+     */
+    setWatchedComponent(componentId: string | null, sceneIndex?: number): boolean;
+    private _clearWatched;
     /**
      * Scene 인스턴스를 등록한다 (Scene constructor에서 호출).
      */
@@ -127,7 +137,7 @@ declare class SceneInspector {
     getComponentPath(componentId: string, sceneIndex?: number): string[];
     /**
      * 컴포넌트의 3D 관련 정보를 반환한다.
-     * Material3D, GLTF 노드/애니메이션, spriteMode, renderMode 등.
+     * Material3D, GLTF 노드/애니메이션 등.
      */
     getThreedInfo(componentId: string, sceneIndex?: number): ThreedInfo | null;
     private _getScene;
@@ -141,6 +151,119 @@ declare class SceneInspector {
     private _safeBounds;
     private _safeClone;
     private _safeValue;
+    /** TransferLog 의 entries + stats snapshot. */
+    transferLog(): {
+        entries: any[];
+        stats: {
+            total: number;
+            committed: number;
+            rolledBack: number;
+            rejectionRate: number;
+            avgTransferDurationMs: number;
+            byPhase: Record<string, number>;
+        };
+    } | null;
+    /** ReservationTable 의 active reservations + groupings. */
+    reservations(): {
+        simTime: number;
+        all: any[];
+        byResource: Record<string, any[]>;
+        byReserver: Record<string, any[]>;
+    } | null;
+    /** Conflict 누적 + outcome 통계. */
+    conflicts(): {
+        simTime: number;
+        log: any[];
+        total: number;
+        rejected: number;
+        preempted: number;
+        byResource: Record<string, number>;
+        byReserver: Record<string, number>;
+    } | null;
+    /**
+     * 단일 component 의 contract 요약 — Phase H/G2 의 markers.
+     * existing getComponentInfo 보다 contract 측면에 특화.
+     */
+    contractSummary(componentId: string, sceneIndex?: number): {
+        type: string;
+        id: string;
+        isCarriable?: boolean;
+        isPickable?: boolean;
+        isMover?: boolean;
+        isHolder?: boolean;
+        toolType?: string;
+        pickupFrames?: any[];
+        slots?: any[];
+    } | null;
+    /**
+     * Capability discovery — 컴포넌트 인스턴스의 class chain (constructor + 상위
+     * prototype) 을 따라가며 static `capabilities` 의 합집합 반환. 컴포넌트가 자기
+     * 입으로 선언한 capability 만 사용 (외부 duck-typing 아님).
+     *
+     * 사용:
+     *   class Foo extends Component { static capabilities = [...Component.capabilities, 'Foo'] }
+     *   inspector.getComponentCapabilities(componentId) → ['Foo']
+     */
+    getComponentCapabilities(componentId: string, sceneIndex?: number): string[];
+    /**
+     * 단일 컴포넌트의 capability 목록 + 각 capability 의 정적 metadata + 구현자
+     * self-description 의 결합 report. 도구가 "이 컴포넌트의 작동 방식 전모" 패널을
+     * 그리는 데이터.
+     *
+     * 각 항목:
+     *   { name, description, methods, models, sourceFile, instance: { policies, config, ... } }
+     *
+     * - description/methods/models/sourceFile: capability 자체의 정적 metadata
+     *   (registerCapabilityMeta 로 등록된 것)
+     * - instance: 컴포넌트가 describeCapability(name) 메서드 노출 시 그 결과 — 자기
+     *   특화 (정책 / 설정 / 통계)
+     */
+    componentCapabilityReports(componentId: string, sceneIndex?: number): Promise<any[]>;
+    /**
+     * System topology — 모든 컴포넌트 + capability-mediated 연결을 한 번에 반환.
+     * Monitor 의 Topology panel 이 그래프 한 장 그리는 데 사용.
+     *
+     * nodes: { id, type, bounds, capabilities }[]
+     * edges: { source, target, via }[]
+     *   via = 'routing-capability' (명시 outbound) | 'data-binding' | 'parent-child'
+     */
+    systemTopology(sceneIndex?: number): Promise<{
+        nodes: any[];
+        edges: any[];
+    }>;
+    /**
+     * Topology panel 의 *동적 layer* 데이터 — flow (transferLog 의 carrier 이동량) +
+     * utilization (각 컴포넌트의 점유율). 1초 polling 부담을 줄이려고 한번에 묶어 반환.
+     *
+     *   flows: { "source>target": count }
+     *   utilization: { id: { occupied, capacity, ratio } }
+     *   conflicts: { id: count }  // 최근 시간창 안 충돌 카운트
+     */
+    topologyStats(sceneIndex?: number): Promise<{
+        flows: Record<string, number>;
+        utilization: Record<string, {
+            occupied: number;
+            capacity?: number;
+            ratio?: number;
+        }>;
+        conflicts: Record<string, number>;
+    }>;
+    /**
+     * 단일 carrier 의 *transfer 여정* — transferLog 에서 그 carrierId 의 entries 를
+     * 시간순 정렬해 source → target sequence 반환. Topology 의 Journey 시각화 용.
+     *
+     * 응답:
+     *   { carrierId, steps: [{ from, to, at, phase, slotId?, rejectReason? }] }
+     */
+    carrierJourney(carrierId: string, sceneIndex?: number): Promise<{
+        carrierId: string;
+        steps: any[];
+    }>;
+    /**
+     * 현재 active 한 carrier id 목록 — Topology UI 의 carrier picker 에 사용.
+     * transferLog 에서 *최근 시간창* 안의 unique carrier id 들.
+     */
+    activeCarrierIds(sceneIndex?: number, limit?: number): Promise<string[]>;
 }
 export declare const inspector: SceneInspector;
 export {};

package/dist-types/diagnostics/inspector.d.ts.map

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

package/dist-types/diagnostics/load-tracker.d.ts

@@ -0,0 +1,82 @@
+export type LoadPhase = 'fetch' | 'parse' | 'init' | 'compile' | 'assets' | 'data' | 'render' | 'complete';
+/** 자동 팝업 표시까지의 대기 시간 (ms) */
+export declare const OVERLAY_DELAY = 5000;
+export interface LoadEntry {
+    id: string;
+    type: string;
+    url: string;
+    startTime: number;
+    status: 'pending' | 'loaded' | 'timeout' | 'error' | 'cancelled';
+    elapsed: number;
+}
+export interface LoadingOptions {
+    /** 전체 에셋 로딩 제한 (ms), 0 = 무제한 */
+    timeout?: number;
+    /** 개별 에셋 제한 (ms), 0 = 무제한 */
+    assetTimeout?: number;
+    /** 앱에서 미리 생성한 LoadTracker — create()가 새로 만들지 않고 재사용 */
+    tracker?: LoadTracker;
+}
+export interface LoadStats {
+    total: number;
+    loaded: number;
+    timeout: number;
+    error: number;
+    cancelled: number;
+    elapsed: number;
+    pending: number;
+}
+export interface PhaseRecord {
+    phase: LoadPhase;
+    timestamp: number;
+    elapsed: number;
+    duration?: number;
+}
+export declare class LoadTracker {
+    private _entries;
+    private _phase;
+    private _phaseHistory;
+    private _options;
+    private _startTime;
+    private _completedElapsed?;
+    private _disposed;
+    private _promiseResolve;
+    private _promise;
+    private _globalTimerId?;
+    private _slowTimerId?;
+    /** OVERLAY_DELAY 이상 로딩이 지속되었음을 표시 — overlay가 나중에 attach돼도 확인 가능 */
+    needsOverlay: boolean;
+    /** overlay 표시가 필요할 때 호출되는 콜백 */
+    onNeedsOverlay?: () => void;
+    /** 콜백 — phase 변경 시 */
+    onPhase?: (phase: LoadPhase) => void;
+    /** 콜백 — 에셋 완료/에러 시 */
+    onProgress?: (stats: LoadStats) => void;
+    /** 콜백 — 개별 에셋 타임아웃 시 */
+    onTimeout?: (entry: LoadEntry) => void;
+    /** 콜백 — complete 시 */
+    onComplete?: (stats: LoadStats) => void;
+    constructor(options?: LoadingOptions);
+    get phase(): LoadPhase;
+    get phaseHistory(): PhaseRecord[];
+    get progress(): number;
+    get pending(): LoadEntry[];
+    get entries(): LoadEntry[];
+    get stats(): LoadStats;
+    get promise(): Promise<void>;
+    private _firstRenderDone;
+    /** 첫 렌더링 완료 알림 — Layer.__draw__에서 호출 */
+    markFirstRender(): void;
+    setPhase(phase: LoadPhase): void;
+    track(id: string, type: string, url: string, promise: Promise<any>): void;
+    checkComplete(): void;
+    startGlobalTimeout(): void;
+    abort(): void;
+    reset(): void;
+    dispose(): void;
+    private _onEntryDone;
+    private _doComplete;
+    private _clearEntryTimer;
+    private _toPublicEntry;
+}
+//# sourceMappingURL=load-tracker.d.ts.map

package/dist-types/diagnostics/load-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-tracker.d.ts","sourceRoot":"","sources":["../../src/diagnostics/load-tracker.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;AAE1G,6BAA6B;AAC7B,eAAO,MAAM,aAAa,OAAO,CAAA;AAEjC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAA;IAChE,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAYD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,iBAAiB,CAAC,CAAQ;IAClC,OAAO,CAAC,SAAS,CAAQ;IAEzB,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAe;IAE/B,OAAO,CAAC,cAAc,CAAC,CAA+B;IACtD,OAAO,CAAC,YAAY,CAAC,CAA+B;IAEpD,mEAAmE;IACnE,YAAY,UAAQ;IACpB,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAE3B,sBAAsB;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IACpC,sBAAsB;IACtB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IACvC,wBAAwB;IACxB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IACtC,sBAAsB;IACtB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;gBAE3B,OAAO,CAAC,EAAE,cAAc;IAqBpC,IAAI,KAAK,IAAI,SAAS,CAErB;IAED,IAAI,YAAY,IAAI,WAAW,EAAE,CAEhC;IAED,IAAI,QAAQ,IAAI,MAAM,CASrB;IAED,IAAI,OAAO,IAAI,SAAS,EAAE,CASzB;IAED,IAAI,OAAO,IAAI,SAAS,EAAE,CAOzB;IAED,IAAI,KAAK,IAAI,SAAS,CAoBrB;IAED,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAID,OAAO,CAAC,gBAAgB,CAAQ;IAEhC,wCAAwC;IACxC,eAAe,IAAI,IAAI;IAOvB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IA8BhC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI;IA8CzE,aAAa,IAAI,IAAI;IAmBrB,kBAAkB,IAAI,IAAI;IAuB1B,KAAK,IAAI,IAAI;IAgBb,KAAK,IAAI,IAAI;IAkCb,OAAO,IAAI,IAAI;IA2Bf,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,cAAc;CAgBvB"}

package/dist-types/diagnostics/loading-overlay.d.ts

@@ -0,0 +1,41 @@
+import type { LoadTracker } from './load-tracker.js';
+import type { DataLagTracker } from './data-lag-tracker.js';
+export declare class LoadingOverlay {
+    private _tracker?;
+    private _lagTracker?;
+    private _container?;
+    private _targetElement?;
+    private _updateTimer?;
+    private _visible;
+    private _manualOpen;
+    private _headerEl?;
+    private _progressFillEl?;
+    private _progressTextEl?;
+    private _phaseListEl?;
+    private _phaseRenderedCount;
+    private _pendingListEl?;
+    private _lagSectionEl?;
+    private _elapsedEl?;
+    attach(targetElement: HTMLElement, tracker?: LoadTracker, lagTracker?: DataLagTracker): void;
+    toggle(): void;
+    show(): void;
+    hide(): void;
+    destroy(): void;
+    get isVisible(): boolean;
+    get isAttached(): boolean;
+    private _show;
+    private _hide;
+    private _update;
+    private _updateProgress;
+    private _updatePhaseList;
+    private _updateAssetList;
+    private _updateLagDisplay;
+    private _renderHistorySummary;
+    private _renderLagSection;
+    private _createPendingRow;
+    private _updatePendingRow;
+    private _updateLagSection;
+    private _shortUrl;
+    private _buildDOM;
+}
+//# sourceMappingURL=loading-overlay.d.ts.map

package/dist-types/diagnostics/loading-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading-overlay.d.ts","sourceRoot":"","sources":["../../src/diagnostics/loading-overlay.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,mBAAmB,CAAA;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,uBAAuB,CAAA;AA6BrE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,cAAc,CAAC,CAAa;IACpC,OAAO,CAAC,YAAY,CAAC,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,WAAW,CAAQ;IAG3B,OAAO,CAAC,SAAS,CAAC,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,OAAO,CAAC,mBAAmB,CAAI;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAa;IACpC,OAAO,CAAC,aAAa,CAAC,CAAa;IACnC,OAAO,CAAC,UAAU,CAAC,CAAa;IAEhC,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,cAAc,GAAG,IAAI;IAsC5F,MAAM,IAAI,IAAI;IAUd,IAAI,IAAI,IAAI;IAKZ,IAAI,IAAI,IAAI;IAKZ,OAAO,IAAI,IAAI;IAYf,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAID,OAAO,CAAC,KAAK;IA4Bb,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,OAAO;IAkCf,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,gBAAgB;IAsDxB,OAAO,CAAC,gBAAgB;IAwCxB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,qBAAqB;IA8B7B,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,SAAS;CAsGlB"}

package/dist-types/diagnostics/metrics.d.ts

@@ -8,6 +8,12 @@ interface ResidentData {
     }>;
 }
 declare class SceneMetrics {
+    /**
+     * Opt-in 게이트. 디폴트 OFF — Chrome 확장이 없을 때 hot path 측정 비용 0.
+     * 확장의 injected.js 가 scene 발견 시 enable() 호출.
+     * 확장 미설치 사용자는 카운터 증가 / performance.now() / FrameClock 측정 모두 건너뜀.
+     */
+    enabled: boolean;
     drawCount: number;
     drawTimeSum: number;
     drawTimeLast: number;
@@ -18,6 +24,10 @@ declare class SceneMetrics {
     private _lastSnapshotTime;
     private _frameCount;
     private _getResidents;
+    /** 측정 활성화 — 누적된 stale 카운터를 리셋하고 게이트를 켠다. */
+    enable(): void;
+    /** 측정 비활성화 — hot path 다시 0 비용. */
+    disable(): void;
     /**
      * Component/Scene/ReferenceMap에서 resident 데이터를 제공하는 함수를 등록한다.
      * things-scene/index.ts에서 모든 모듈 로드 후 1회 호출.

package/dist-types/diagnostics/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/diagnostics/metrics.ts"],"names":[],"mappings":"AAQA,UAAU,YAAY;IACpB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,0BAA0B,EAAE,MAAM,CAAA;IAClC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7D;AAED,cAAM,YAAY;IAEhB,SAAS,SAAI;IACb,WAAW,SAAI;IACf,YAAY,SAAI;IAGhB,eAAe,SAAI;IAGnB,YAAY,SAAI;IAGhB,QAAQ,SAAI;IACZ,SAAS,SAAI;IAGb,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,WAAW,CAAI;IAGvB,OAAO,CAAC,aAAa,CAAoC;IAEzD;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,YAAY;IAI5C;;;OAGG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,QAAQ;;;;;gBA/C6B,MAAM;kBAAQ,MAAM;;;;;;;;;;CAwF1D;AAED,eAAO,MAAM,OAAO,cAAqB,CAAA"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/diagnostics/metrics.ts"],"names":[],"mappings":"AAQA,UAAU,YAAY;IACpB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,0BAA0B,EAAE,MAAM,CAAA;IAClC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7D;AAED,cAAM,YAAY;IAChB;;;;OAIG;IACH,OAAO,UAAQ;IAGf,SAAS,SAAI;IACb,WAAW,SAAI;IACf,YAAY,SAAI;IAGhB,eAAe,SAAI;IAGnB,YAAY,SAAI;IAGhB,QAAQ,SAAI;IACZ,SAAS,SAAI;IAGb,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,WAAW,CAAI;IAGvB,OAAO,CAAC,aAAa,CAAoC;IAEzD,4CAA4C;IAC5C,MAAM,IAAI,IAAI;IAad,kCAAkC;IAClC,OAAO,IAAI,IAAI;IAIf;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,YAAY;IAI5C;;;OAGG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,QAAQ;;;;;gBAzE6B,MAAM;kBAAQ,MAAM;;;;;;;;;;CAsH1D;AAED,eAAO,MAAM,OAAO,cAAqB,CAAA"}

package/dist-types/effect/shadow.d.ts

@@ -1,3 +1,5 @@
-export declare function setShadow(context: CanvasRenderingContext2D, shadow: any, component: any): void;
+import type { Component } from '../types/component';
+import type { Shadow } from '../interfaces/rendering';
+export declare function setShadow(context: CanvasRenderingContext2D, shadow: Shadow, component: Component): void;
 export declare function resetShadow(context: CanvasRenderingContext2D): void;
 //# sourceMappingURL=shadow.d.ts.map

package/dist-types/effect/shadow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shadow.d.ts","sourceRoot":"","sources":["../../src/effect/shadow.ts"],"names":[],"mappings":"AAWA,wBAAgB,SAAS,CAAC,OAAO,EAAE,wBAAwB,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,QASvF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,wBAAwB,QAE5D"}
+{"version":3,"file":"shadow.d.ts","sourceRoot":"","sources":["../../src/effect/shadow.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AA6CrD,wBAAgB,SAAS,CACvB,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GACnB,IAAI,CAWN;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAEnE"}

package/dist-types/event-map/index.d.ts

@@ -4,5 +4,6 @@ import './shift-handler.js';
 import './zoom-handler.js';
 import './paste-handler.js';
 import './waypoint-handler.js';
+import './transition-handler.js';
 export { default as EventMap } from './event-map.js';
 //# sourceMappingURL=index.d.ts.map

package/dist-types/event-map/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event-map/index.ts"],"names":[],"mappings":"AAIA,OAAO,uBAAuB,CAAA;AAC9B,OAAO,mBAAmB,CAAA;AAC1B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,mBAAmB,CAAA;AAC1B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,uBAAuB,CAAA;AAE9B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event-map/index.ts"],"names":[],"mappings":"AAIA,OAAO,uBAAuB,CAAA;AAC9B,OAAO,mBAAmB,CAAA;AAC1B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,mBAAmB,CAAA;AAC1B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,uBAAuB,CAAA;AAC9B,OAAO,yBAAyB,CAAA;AAEhC,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA"}

package/dist-types/event-map/transition-handler.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transition-handler.d.ts.map

package/dist-types/event-map/transition-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-handler.d.ts","sourceRoot":"","sources":["../../src/event-map/transition-handler.ts"],"names":[],"mappings":""}

package/dist-types/interfaces/event-handler.d.ts

@@ -0,0 +1,40 @@
+/** 지원 trigger — DOM 이벤트 + 의미적 alias. */
+export type EventTrigger = 'click' | 'tap' | 'dblclick' | 'mouseenter' | 'hover' | 'mouseleave' | 'longpress' | 'mousedown' | 'mouseup' | 'pressed';
+/** 단일 이벤트 핸들러 spec. */
+export interface EventHandler {
+    /** trigger — 어느 DOM 이벤트에 반응할지. */
+    trigger: EventTrigger;
+    /**
+     * action — 'script' 자유 코드 또는 declarative action name.
+     * 'script' / 'data-toggle' / 'data-set' / 'emphasize' / 'info-window' / ...
+     * 빈 문자열 또는 미설정 시 no-op.
+     */
+    action?: string;
+    /** action='script' 시 JS 코드 (await 지원). */
+    code?: string;
+    /** Target selector — script 의 `targets` 또는 declarative action 의 대상. */
+    target?: string;
+    /** Value — script 의 `value` 또는 action 의 value (`component.access(value)` 적용). */
+    value?: any;
+    /** action 의 부가 옵션 (emphasize / restore / pressed / options 등). */
+    options?: Record<string, any>;
+    /** 비활성화. UI 토글용. */
+    disabled?: boolean;
+}
+/**
+ * legacy `{ tap, hover, dblclick, longpress }` 객체를 `EventHandler[]` 로 변환.
+ * Component constructor 의 *자동 마이그레이션* + UI 의 fallback 변환 모두 사용.
+ */
+export declare function migrateLegacyEvent(legacy: any): EventHandler[];
+/**
+ * 두 속성 통합 — 신규 `state.eventHandlers` 우선, 없으면 legacy `state.event`
+ * (객체) 를 *read-only* 변환해 반환. 컴포넌트 constructor 의 자동 마이그레이션이
+ * 처리 못 한 케이스 (런타임 state mutation 등) 의 fallback.
+ *
+ * 정책:
+ *   - `state.event` (legacy) — *손대지 않음* (rollback 안전망 + 옛 코드 호환)
+ *   - `state.eventHandlers` (신규) — UI / 자동 마이그레이션이 write
+ *   - dispatcher: 신규 우선 / 없으면 legacy fallback
+ */
+export declare function normalizeEventHandlers(state: any): EventHandler[];
+//# sourceMappingURL=event-handler.d.ts.map

package/dist-types/interfaces/event-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.d.ts","sourceRoot":"","sources":["../../src/interfaces/event-handler.ts"],"names":[],"mappings":"AAiBA,wCAAwC;AACxC,MAAM,MAAM,YAAY,GACpB,OAAO,GAAG,KAAK,GACf,UAAU,GACV,YAAY,GAAG,OAAO,GACtB,YAAY,GACZ,WAAW,GACX,WAAW,GAAG,SAAS,GACvB,SAAS,CAAA;AAEb,uBAAuB;AACvB,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,OAAO,EAAE,YAAY,CAAA;IACrB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iFAAiF;IACjF,KAAK,CAAC,EAAE,GAAG,CAAA;IACX,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,oBAAoB;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,YAAY,EAAE,CAoC9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,GAAG,GAAG,YAAY,EAAE,CAKjE"}

package/dist-types/interfaces/index.d.ts

@@ -2,4 +2,6 @@ export * from './types';
 export * from './providers';
 export * from './layout';
 export type { IRealObject } from './real-object.js';
+export type { EventHandler, EventTrigger } from './event-handler.js';
+export { normalizeEventHandlers } from './event-handler.js';
 //# sourceMappingURL=index.d.ts.map

package/dist-types/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA"}