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

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

@@ -1,44 +1,50 @@
 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;
+    current: number;
     baseline: number;
     drift: number;
-    driftAvg: number;
-    driftMax: number;
-    trend: LagTrend;
+    min: number;
+    max: number;
     sampleCount: number;
     level: LagLevel;
 }
 export declare class DataLagTracker {
-    private _monitors;
+    private _current;
+    private _min;
+    private _max;
+    private _count;
+    private _baseline;
+    private _baselineSet;
+    private _baselineSum;
+    private _baselineCount;
+    private _warn;
+    private _critical;
+    private _lastLevel;
     private _disposed;
-    /** level 변경 시 콜백 (evaluateAll 호출 시 트리거) */
-    onLevelChange?: (tag: string, level: LagLevel, stats: LagStats) => void;
-    configure(config: LagMonitorConfig | LagMonitorConfig[]): void;
-    isMonitored(tag: string): boolean;
+    /** level 변경 시 콜백 (evaluate() 호출 시 트리거). */
+    onLevelChange?: (level: LagLevel, stats: LagStats) => void;
+    /** 임계값 설정 (선택). */
+    configure(config?: LagMonitorConfig | LagMonitorConfig[]): void;
     /**
-     * 핫 패스 진입점.
-     * 대상 태그가 아니면 Map.get() 1회로 즉시 리턴.
+     * 발행 시각(epoch-ms)을 받아 갭을 기록.
+     * `record(ts)` 또는 `record(tag, ts)` 둘 다 허용 — tag 인자는 무시(단일 채널 집계).
      */
-    recordIfMonitored(tag: string, data: any): void;
-    getStats(tag: string): LagStats | null;
-    getAllStats(): LagStats[];
-    /**
-     * UI 갱신 주기에 호출. threshold 판정 + onLevelChange 콜백 발생.
-     */
-    evaluateAll(): void;
+    record(a: any, b?: any): void;
+    getStats(): LagStats;
+    /** UI 갱신 주기 호출 — level 변경 시 콜백 발생. */
+    evaluate(): void;
+    reset(): void;
     dispose(): void;
-    private _extractField;
-    private _getRecentDrifts;
-    private _calcTrend;
     private _calcLevel;
 }
+/**
+ * 모듈 레벨 싱글톤 — frameClock 패턴. `globalThis.scene.dataLagTracker` 로 노출되어
+ * 모니터 익스텐션/오버레이/구독 핸들러가 동일 인스턴스를 공유한다.
+ * (app.lagTracker 도 이 싱글톤을 가리킨다.)
+ */
+export declare const dataLagTracker: DataLagTracker;
 //# sourceMappingURL=data-lag-tracker.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"data-lag-tracker.d.ts","sourceRoot":"","sources":["../../src/diagnostics/data-lag-tracker.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;AAErD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,QAAQ,CAAA;CAChB;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,KAAK,CAAO;IACpB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAAQ;IAEzB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;IAE1D,mBAAmB;IACnB,SAAS,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,GAAG,IAAI;IAO/D;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI;IAsB7B,QAAQ,IAAI,QAAQ;IAuBpB,sCAAsC;IACtC,QAAQ,IAAI,IAAI;IAShB,KAAK,IAAI,IAAI;IAYb,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,UAAU;CAKnB;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAA"}

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

@@ -22,6 +22,9 @@ interface ComponentTreeNode {
     name?: string;
     hidden?: boolean;
     clazz?: string;
+    /** 부모의 *_items (Holdable mixin)_* 자식 — _components 자식과 직교 (Phase 7.2,
+     *  2026-06-18). UI 가 별도 marker (icon / color) 로 구분 가능. */
+    isItem?: boolean;
 }
 interface ComponentInfo {
     model: object;
@@ -39,6 +42,17 @@ interface ComponentInfo {
     isContainer: boolean;
     is3dMode?: boolean;
     hidden?: boolean;
+    /** Holdable mixin 자손 holder 가 _items 보유 시 — runtime carrier 통합 발견.
+     *  Container-Component 자식 트리 (_components) 와 직교한 별도 자식 시스템. */
+    items?: ComponentTreeNode[];
+    /** SlottedHolder duck (Phase 7.3, 2026-06-18) — slot 별 점유 상태.
+     *  duck 자격 = slotIds + occupiedSlotIds + emptySlotIds + hasCarrierAt 의 4 메서드.
+     *  panel UI 가 *_holder 의 slot 상태 시각화_* (occupied / empty / capacity ratio). */
+    slottedHolder?: {
+        slotIds: string[];
+        occupiedSlotIds: string[];
+        emptySlotIds: string[];
+    };
 }
 declare class SceneInspector {
     private _scenes;
@@ -91,8 +105,35 @@ declare class SceneInspector {
     /**
      * 특정 컴포넌트의 상세 정보를 반환한다.
      * componentId가 'root'/'__root__'이면 model_layer 정보를 반환.
+     *
+     * @param options.includeItems — true 시 _items 자식 시각화 포함 (Phase 7.2).
+     *   default = false: 자식 tree 의 *_혼동 회피 + 성능 회피_* (carrier 다수 시 매
+     *   query 마다 _items 자식 모두 traverse). carrier 통합 발견 필요 시 별도 query
+     *   (`getItems`) 또는 옵션 활성.
      */
-    getComponentInfo(componentId: string, sceneIndex?: number): ComponentInfo | null;
+    getComponentInfo(componentId: string, sceneIndex?: number, options?: {
+        includeItems?: boolean;
+    }): ComponentInfo | null;
+    /**
+     * 컴포넌트의 items list 별도 query — Inspector panel 의 carrier 통합 발견.
+     * 자식 트리 (`_components`) 와 직교한 자식 시스템. Holdable mixin 자손만 해당.
+     */
+    getItems(componentId: string, sceneIndex?: number): ComponentTreeNode[];
+    /**
+     * 컴포넌트의 records snapshot — `holder.data` 표준 entry (Phase D-7, 2026-06-20).
+     *
+     * 사용자 vision: *_FlowNode 의 items 는 결국 해당 컴포넌트의 data 로 import/export_*.
+     * FlowNode 자손은 ItemsDataBinding 통해 records[] 자동 export (`_items → SlotRecord[]`).
+     * RecordStorage 자손은 state.data 직접 반환 (records-only path).
+     *
+     * monitor-extension panel 측이 이 query 통해 holder 의 records 시각화 — DataSource
+     * bind / WMS export 와 같은 schema (`SlotRecord[]`).
+     *
+     * Inspector 측 carrier 트리 (`getItems` — 인스턴스 list) 와 직교:
+     *   - getItems → carrier 인스턴스 list (시각 / 도메인)
+     *   - getRecords → records list (데이터 / 외부 bind 어휘)
+     */
+    getRecords(componentId: string, sceneIndex?: number): any[];
     /**
      * 컴포넌트를 선택한다 (root.selected 설정).
      * 3D 모드에서 기즈모 attach, 2D 모드에서 selection-layer 연동.
@@ -151,8 +192,15 @@ declare class SceneInspector {
     private _safeBounds;
     private _safeClone;
     private _safeValue;
-    /** TransferLog 의 entries + stats snapshot. */
+    /**
+     * TransferLog 의 aggregated snapshot — Step 1 정공 (2026-06-20).
+     *
+     * raw 보관 폐기 후 entries 는 항상 빈 array (deprecated, back-compat). 진정한 source =
+     * stats / flows / targetCounts / rejectReasonCounts (모두 aggregated O(1)). carrier 별
+     * raw timeline 이 필요한 도구는 extension/devtools 가 subscribe 로 자체 누적.
+     */
     transferLog(): {
+        /** @deprecated raw 보관 폐기. 항상 빈 array. */
         entries: any[];
         stats: {
             total: number;
@@ -162,6 +210,9 @@ declare class SceneInspector {
             avgTransferDurationMs: number;
             byPhase: Record<string, number>;
         };
+        flows: Record<string, number>;
+        targetCounts: Record<string, number>;
+        rejectReasonCounts: Record<string, number>;
     } | null;
     /** ReservationTable 의 active reservations + groupings. */
     reservations(): {
@@ -187,7 +238,7 @@ declare class SceneInspector {
     contractSummary(componentId: string, sceneIndex?: number): {
         type: string;
         id: string;
-        isCarriable?: boolean;
+        isItem?: boolean;
         isPickable?: boolean;
         isMover?: boolean;
         isHolder?: boolean;
@@ -195,6 +246,88 @@ declare class SceneInspector {
         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, options?: {
+        force?: boolean;
+    }): Promise<{
+        nodes: any[];
+        edges: any[];
+        issues?: any[];
+    }>;
+    /**
+     * Topology panel 의 *동적 layer* 데이터 — flow (transferLog 의 carrier 이동량) +
+     * utilization (각 컴포넌트의 점유율). 1초 polling 부담을 줄이려고 한번에 묶어 반환.
+     *
+     *   flows: { "source>target": count }
+     *   utilization: { id: { occupied, capacity, ratio } }
+     *   conflicts: { id: count }  // 최근 시간창 안 충돌 카운트
+     *   distribution: { id: { count, destination?, share?, deviation? } }
+     *     — Flow Balancing B5: target 별 carrier 도착 누적 + destination 그룹화.
+     *     같은 destination 그룹 내 sink 들의 균등성 시각화. share = 그룹 내 비율,
+     *     deviation = 평균 대비 편차 (0 = 균등, 1 = 단독 점유).
+     */
+    topologyStats(sceneIndex?: number): Promise<{
+        flows: Record<string, number>;
+        utilization: Record<string, {
+            occupied: number;
+            capacity?: number;
+            ratio?: number;
+        }>;
+        conflicts: Record<string, number>;
+        distribution: Record<string, {
+            count: number;
+            destination?: string;
+            share?: number;
+            deviation?: 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/loading-overlay.d.ts

@@ -1,21 +1,52 @@
+import type { LoadEntry, LoadStats, LoadPhase, PhaseRecord } from './load-tracker.js';
 import type { LoadTracker } from './load-tracker.js';
-import type { DataLagTracker } from './data-lag-tracker.js';
+import type { DataLagTracker, LagStats } from './data-lag-tracker.js';
+/** 매 tick 렌더러에 전달되는 데이터 스냅샷(코어가 tracker 에서 조립). */
+export interface LoadingOverlayState {
+    phase: LoadPhase;
+    isComplete: boolean;
+    stats: LoadStats;
+    phaseHistory: PhaseRecord[];
+    pending: LoadEntry[];
+    entries: LoadEntry[];
+    /** 데이터 래깅 통계 — lagTracker 미제공 또는 표본 없으면 undefined. */
+    lag?: LagStats;
+}
+/** 렌더러가 오버레이 수명주기를 제어하는 훅(닫기/취소 버튼 등). */
+export interface LoadingOverlayHost {
+    hide(): void;
+    cancel(): void;
+}
+/**
+ * 로딩 오버레이 렌더러 — DOM 표현을 전담. 코어(LoadingOverlay)가 build()로 1회 DOM 을 만들게 하고,
+ * 표시 중 매 tick update(state)로 갱신한다. 호스트는 이 인터페이스 구현체를 주입해 형태를 커스터마이즈.
+ */
+export interface LoadingOverlayRenderer {
+    /** container(전체 크기 오버레이 레이어) 안에 DOM 을 1회 구성. host 로 닫기/취소 연결. */
+    build(container: HTMLElement, host: LoadingOverlayHost): void;
+    /** 현재 상태로 DOM 갱신(표시 중 500ms 주기). */
+    update(state: LoadingOverlayState): void;
+    /** 정리(선택). */
+    destroy?(): void;
+}
 export declare class LoadingOverlay {
     private _tracker?;
     private _lagTracker?;
     private _container?;
+    private _built;
     private _targetElement?;
     private _updateTimer?;
     private _visible;
     private _manualOpen;
-    private _headerEl?;
-    private _progressFillEl?;
-    private _progressTextEl?;
-    private _phaseListEl?;
-    private _phaseRenderedCount;
-    private _pendingListEl?;
-    private _lagSectionEl?;
-    private _elapsedEl?;
+    private _renderer;
+    /**
+     * 로딩 취소 콜백. 호스트(앱)가 "무엇이 취소인지"를 정의한다.
+     * 미지정 시 window.history.back()(뒤로가기)으로 폴백한다.
+     */
+    onCancel?: () => void;
+    /** 표현 렌더러 — 교체 시 다음 표시에서 새 렌더러로 재구성. 기본은 DefaultLoadingOverlayRenderer. */
+    get renderer(): LoadingOverlayRenderer;
+    set renderer(r: LoadingOverlayRenderer);
     attach(targetElement: HTMLElement, tracker?: LoadTracker, lagTracker?: DataLagTracker): void;
     toggle(): void;
     show(): void;
@@ -23,19 +54,45 @@ export declare class LoadingOverlay {
     destroy(): void;
     get isVisible(): boolean;
     get isAttached(): boolean;
+    private _teardownContainer;
+    private get _host();
     private _show;
     private _hide;
     private _update;
+    /** tracker 들에서 렌더러가 소비할 상태 스냅샷을 조립(lagTracker 는 evaluate 부작용 포함). */
+    private _assembleState;
+    /** 로딩 취소 — 오버레이를 닫고, onCancel 지정 시 그것을, 아니면 브라우저 뒤로가기. */
+    private _cancel;
+}
+export declare class DefaultLoadingOverlayRenderer implements LoadingOverlayRenderer {
+    private _headerEl?;
+    private _progressFillEl?;
+    private _progressTextEl?;
+    private _phaseListEl?;
+    private _phaseRenderedCount;
+    private _pendingListEl?;
+    private _lagSectionEl?;
+    private _footerRowEl?;
+    build(container: HTMLElement, host: LoadingOverlayHost): void;
+    update(state: LoadingOverlayState): void;
+    destroy(): void;
     private _updateProgress;
     private _updatePhaseList;
     private _updateAssetList;
     private _updateLagDisplay;
     private _renderHistorySummary;
+    /**
+     * 게이지 좌표 계산 — baseline 은 항상 트랙 중심(50%), 좌우 대칭 스케일로 매핑.
+     * 반경 R = 중심에서 더 먼 극단까지 거리, 최소 ±1초 floor.
+     * cur<baseline→왼쪽(leading), cur>baseline→오른쪽(lagging).
+     */
+    private _lagGauge;
+    /** 중심(50%)→cur 채움 막대의 left/width CSS. */
+    private _lagFill;
     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

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

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/flow/auto-route.d.ts

@@ -0,0 +1,36 @@
+import { type SegmentTopology, type SegmentBounds, type MatchTolerance } from './segment-topology.js';
+interface SegmentLike {
+    state?: {
+        id?: string;
+    };
+    parent?: any;
+    rootModel?: any;
+    root?: any;
+    getSegmentTopology(): SegmentTopology;
+}
+/**
+ * Component tree 의 *_getSegmentTopology 를 노출하는 component_* 모두 수집.
+ * 자기 자신 제외. id 없는 컴포넌트 제외 (= downstreamRef target 으로 사용 불가).
+ *
+ * traversal 시작점 — *_self.parent_* (= model-layer 등 sibling 영역). 만약
+ * sibling 만으로 부족하면 *_rootModel 또는 root 의 재귀 descend_* 까지. things-
+ * scene 의 root 는 RootContainer 라 *_.components 가 layer 들_*만 — 우리 segment
+ * 는 model-layer 자식 이므로 sibling 또는 재귀 필요.
+ */
+export declare function collectAdjacentSegments(startRoot: any, exclude: any): Array<{
+    id: string;
+    topology: SegmentTopology;
+    bounds?: SegmentBounds;
+}>;
+/**
+ * 자기 outbound 의 *_가장 가까운 downstream segment id_*. inbound 가진 후보들
+ * 만 매칭. multi-outbound segment 의 경우 outbound[0] 만 — 분기 segment 는
+ * 자체 logic 으로 override 권장.
+ *
+ * traversal 시작점: self.parent (= 직접 sibling 영역) 우선, 부재 시 rootModel
+ * → root fallback. RootContainer 의 .components 가 layer 들이라 *_재귀 descend_*
+ * 까지 처리하는 collectAdjacentSegments 사용.
+ */
+export declare function inferDownstreamId(self: SegmentLike, tolerance?: MatchTolerance): string | null;
+export {};
+//# sourceMappingURL=auto-route.d.ts.map

package/dist-types/flow/auto-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-route.d.ts","sourceRoot":"","sources":["../../src/flow/auto-route.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAkB,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAErH,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACvB,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,SAAS,CAAC,EAAE,GAAG,CAAA;IACf,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,kBAAkB,IAAI,eAAe,CAAA;CACtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,GAAG,GACX,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,CAmC1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,SAAS,CAAC,EAAE,cAAc,GACzB,MAAM,GAAG,IAAI,CAwBf"}

package/dist-types/flow/capability-inference.d.ts

@@ -0,0 +1,19 @@
+export interface CapabilityMatch {
+    id: string;
+    component: any;
+    distance: number;
+}
+/**
+ * 기하 바인딩 대상 자격 — board 좌표 거리 측정(distanceToBoardPoint) 가능한 노드. capability 무관의
+ * *기하* 자격만 판정(그래프 노드 강제 수집 등에 사용). capability 한정은 findNearestWithCapability 가.
+ */
+export declare function isGeometricHost(c: any): boolean;
+/**
+ * root 트리에서 `capabilityName` 을 선언(@capability)한 가장 가까운 기하 host 를 찾는다.
+ * 거리 = host.distanceToBoardPoint(entry). 미발견 시 null. exclude 는 자기 자신 제외.
+ */
+export declare function findNearestWithCapability(root: any, capabilityName: string, entry: {
+    x: number;
+    y: number;
+}, exclude?: any): CapabilityMatch | null;
+//# sourceMappingURL=capability-inference.d.ts.map

package/dist-types/flow/capability-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-inference.d.ts","sourceRoot":"","sources":["../../src/flow/capability-inference.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,GAAG,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AASD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,GAAG,EACT,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/B,OAAO,CAAC,EAAE,GAAG,GACZ,eAAe,GAAG,IAAI,CAgBxB"}

package/dist-types/flow/face-anchors.d.ts

@@ -0,0 +1,26 @@
+/** XZ 평면 anchor (scene world 좌표; Y=floor-level 무시). */
+export interface FaceAnchor {
+    worldPos: {
+        x: number;
+        z: number;
+    };
+    /** 진행 방향 단위 vector (carrier 속도 vector 와 일치). */
+    direction: {
+        x: number;
+        z: number;
+    };
+    /** 면 절반 길이 — segment 겹침 판정용. */
+    halfSpan?: number;
+}
+/**
+ * state(left/top/width/height/rotation) → 4면 anchor. kind='inbound' 면 inward(받는 면),
+ * 'outbound' 면 outward(내보내는 면). 회전 반영.
+ */
+export declare function rectFaceAnchors(state: {
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    rotation?: number;
+}, kind: 'inbound' | 'outbound'): FaceAnchor[];
+//# sourceMappingURL=face-anchors.d.ts.map

package/dist-types/flow/face-anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"face-anchors.d.ts","sourceRoot":"","sources":["../../src/flow/face-anchors.ts"],"names":[],"mappings":"AASA,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAClC,gDAAgD;IAChD,SAAS,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACnC,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1F,IAAI,EAAE,SAAS,GAAG,UAAU,GAC3B,UAAU,EAAE,CAiCd"}