@hatiolab/things-scene 10.0.0-beta.13 → 10.0.0-beta.130

package/dist-types/decorator/decorators/border-highlighting-decorator.d.ts

@@ -40,10 +40,6 @@ export declare class BorderHighlightingDecorator extends VectorDecorator {
      * 애니메이션 시작
      */
     private startAnimations;
-    /**
-     * defs 요소 생성
-     */
-    private createDefsElement;
     /**
      * 컴포넌트의 경로 좌표 가져오기
      */

package/dist-types/decorator/decorators/border-highlighting-decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"border-highlighting-decorator.d.ts","sourceRoot":"","sources":["../../../src/decorator/decorators/border-highlighting-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,yBAA0B,SAAQ,sBAAsB;IAEvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,eAAe;IAE9D,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAwB;IAExE,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,SAAS,CAAa;IAE9B;;OAEG;gBACS,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,yBAA8B;IAY5F;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAmEnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACH,OAAO,CAAC,eAAe;IA+CvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgDxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoCpB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0CtB;;OAEG;IACH,OAAO,CAAC,UAAU;IAgBlB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAiChB;;OAEG;IACH,OAAO,CAAC,QAAQ;IA0BhB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;CAkCpC"}
+{"version":3,"file":"border-highlighting-decorator.d.ts","sourceRoot":"","sources":["../../../src/decorator/decorators/border-highlighting-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,yBAA0B,SAAQ,sBAAsB;IAEvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,eAAe;IAE9D,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAwB;IAExE,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,SAAS,CAAa;IAE9B;;OAEG;gBACS,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,yBAA8B;IAY5F;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAiEnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACH,OAAO,CAAC,eAAe;IA8CvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgDxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoCpB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0CtB;;OAEG;IACH,OAAO,CAAC,UAAU;IAgBlB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAiChB;;OAEG;IACH,OAAO,CAAC,QAAQ;IA0BhB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;CAkCpC"}

package/dist-types/decorator/decorators/bouncing-arrow-decorator.d.ts

@@ -15,9 +15,6 @@ export interface BouncingArrowOptions extends VectorDecoratorOptions {
  */
 export declare class BouncingArrowDecorator extends VectorDecorator {
     protected static readonly DECORATOR_TYPE: string;
-    private arrowElement;
-    private labelElement;
-    private decoratorGroup;
     /**
      * 생성자
      */

package/dist-types/decorator/decorators/bouncing-arrow-decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bouncing-arrow-decorator.d.ts","sourceRoot":"","sources":["../../../src/decorator/decorators/bouncing-arrow-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,oBAAqB,SAAQ,sBAAsB;IAElE,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,eAAe;IAEzD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAmB;IAEnE,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,cAAc,CAA2B;IAEjD;;OAEG;gBACS,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,oBAAyB;IAWvF;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAwFnC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAehB,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;CAYjC"}
+{"version":3,"file":"bouncing-arrow-decorator.d.ts","sourceRoot":"","sources":["../../../src/decorator/decorators/bouncing-arrow-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,oBAAqB,SAAQ,sBAAsB;IAElE,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,eAAe;IAEzD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAmB;IAEnE;;OAEG;gBACS,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,oBAAyB;IAWvF;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAqFnC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAehB,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;CAYjC"}

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,110 @@
+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>;
+    isItem?: 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) — Step 1 정공 (2026-06-20).
+     * raw 보관 폐기 후 entries 는 항상 빈 array (deprecated, back-compat). aggregated 가 source.
+     */
+    transferLog(): {
+        /** @deprecated raw 보관 폐기. 항상 빈 array. */
+        entries: ReturnType<typeof transferLog.toJSON>;
+        stats: ReturnType<typeof transferLog.stats>;
+        flows: Record<string, number>;
+        targetCounts: Record<string, number>;
+        rejectReasonCounts: Record<string, number>;
+    };
+    /**
+     * 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,50 @@
+export interface LagMonitorConfig {
+    warnThreshold?: number;
+    criticalThreshold?: number;
+}
+export type LagLevel = 'normal' | 'warn' | 'critical';
+export interface LagStats {
+    current: number;
+    baseline: number;
+    drift: number;
+    min: number;
+    max: number;
+    sampleCount: number;
+    level: LagLevel;
+}
+export declare class DataLagTracker {
+    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 변경 시 콜백 (evaluate() 호출 시 트리거). */
+    onLevelChange?: (level: LagLevel, stats: LagStats) => void;
+    /** 임계값 설정 (선택). */
+    configure(config?: LagMonitorConfig | LagMonitorConfig[]): void;
+    /**
+     * 발행 시각(epoch-ms)을 받아 갭을 기록.
+     * `record(ts)` 또는 `record(tag, ts)` 둘 다 허용 — tag 인자는 무시(단일 채널 집계).
+     */
+    record(a: any, b?: any): void;
+    getStats(): LagStats;
+    /** UI 갱신 주기 호출 — level 변경 시 콜백 발생. */
+    evaluate(): void;
+    reset(): void;
+    dispose(): void;
+    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

@@ -0,0 +1 @@
+{"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

@@ -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;
@@ -25,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;
@@ -42,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;
@@ -50,6 +61,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에서 호출).
      */
@@ -81,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, 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 어휘)
      */
-    getComponentInfo(componentId: string, sceneIndex?: number): ComponentInfo | null;
+    getRecords(componentId: string, sceneIndex?: number): any[];
     /**
      * 컴포넌트를 선택한다 (root.selected 설정).
      * 3D 모드에서 기즈모 attach, 2D 모드에서 selection-layer 연동.
@@ -127,7 +178,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 +192,142 @@ declare class SceneInspector {
     private _safeBounds;
     private _safeClone;
     private _safeValue;
+    /**
+     * 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;
+            committed: number;
+            rolledBack: number;
+            rejectionRate: number;
+            avgTransferDurationMs: number;
+            byPhase: Record<string, number>;
+        };
+        flows: Record<string, number>;
+        targetCounts: Record<string, number>;
+        rejectReasonCounts: 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;
+        isItem?: 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, 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/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":"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"}