@hatiolab/things-scene 10.0.0-beta.14 → 10.0.0-beta.140

package/dist-types/threed/managers/gizmo-operation-manager.d.ts

@@ -5,6 +5,8 @@ import { GizmoManager } from './gizmo-manager.js';
 export interface GizmoOperationHost {
     readonly root: any;
     readonly app: any;
+    /** Host DOM element for overlay positioning */
+    readonly hostElement?: HTMLElement;
     invalidate(): void;
 }
 /**
@@ -17,12 +19,16 @@ export declare class GizmoOperationManager {
     private _preDragDimension?;
     private _preDragScale?;
     private _preDragEffectiveDepth?;
+    private _scaleAnchorSign?;
+    private _preDragAttachedPosition?;
     private _altDragDuplicates?;
     private _mouseDownAltKey;
     private _multiSelectOffsets?;
     private _gizmoInitialRotation?;
     private _multiSelectInitialRotations?;
     private _multiSelectPreDragDimensions?;
+    private _infoOverlay?;
+    private _dragStartPosition?;
     /**
      * mousedown 시 altKey를 캡처한다.
      * forwardEvent보다 먼저 호출되어야 한다.
@@ -37,21 +43,68 @@ export declare class GizmoOperationManager {
         setEnabled(enabled: boolean): void;
     }, getHost: () => GizmoOperationHost | undefined, callbacks?: {
         onAttachChanged?: (isAttached: boolean) => void;
+        onDraggingChanged?: (isDragging: boolean) => void;
     }): void;
     private _onDragStart;
     private _performAltDragDuplicate;
     private _captureMultiSelectState;
     private _captureScalePreDrag;
+    /**
+     * 드래그한 기즈모 핸들의 축별 부호를 계산한다.
+     * - controls.axis: 드래그 축 이름 ('X'/'Y'/'Z'/'XY'/'XZ'/'YZ'/'XYZ'/'XYZE' 등)
+     * - controls.pointStart: 드래그 시작 시 pointer의 월드 위치(object 원점 기준 상대)
+     *
+     * 반환 부호: 해당 축 pointStart의 로컬 좌표 성분 부호
+     *   +1 → 드래그한 +방향 핸들 → pre.edge(left/top/zPos)를 고정하고 +방향 확장
+     *   -1 → 드래그한 -방향 핸들 → 반대편 edge 고정, -방향 확장
+     *    0 → 방향성 없음 (uniform handle) 또는 축 미해당 → 기존 center 동작 유지
+     *
+     * 주의: TransformControls 내부 API(pointStart)에 의존. three.js 업그레이드 시
+     * node_modules/three/examples/jsm/controls/TransformControls.js 확인 필요.
+     */
+    private _computeAnchorSign;
     private _onDragEnd;
     /**
      * 기즈모 드래그 결과를 컴포넌트 속성에 역변환하여 반영한다.
      */
     private _syncFromGizmo;
+    /**
+     * 오브젝트 바닥면이 Y=0(바닥)에 가까우면 스냅한다.
+     * Object3D.position.y는 오브젝트 중심이므로, 바닥면 = position.y - effectiveDepth/2.
+     */
+    private _applyGroundSnap;
     /**
      * scale 기즈모 드래그를 dimension 변경으로 역산한다.
      * 축 매핑: scale.x → width, scale.y → depth, scale.z → height
-     * center 기준 양방향 확장.
+     * anchor sign에 따라 한쪽 edge 고정(드래그 방향으로만 확장) 또는 center 확장.
+     *
+     * @returns 멀티셀렉트에서 동일 로직 적용하기 위해 ratioLock 반영된 ratio/sign 반환
      */
     private _syncDimensionFromGizmo;
+    /**
+     * anchor sign 기반 dimension props 계산.
+     *   sign > 0: pre.left/top/zPos 고정, 드래그 방향으로만 확장
+     *   sign < 0: 반대편 edge 고정, 반대 방향으로 확장
+     *   sign = 0: center 기준 양방향 확장 (기존 동작)
+     */
+    private _computeAnchorProps;
+    /**
+     * TransformControls는 scale 드래그 시 object.scale만 변경(center-scale).
+     * anchor edge가 실제로 고정되어 보이려면 object.position을 매 프레임 역보정한다.
+     *   shift_local = sign * (S' - preScale) * (pre_size / 2)
+     * 오브젝트 회전이 있으면 로컬 shift를 월드 축으로 변환.
+     */
+    private _applyAnchorPositionCorrection;
+    private _showInfoOverlay;
+    private _updateInfoOverlay;
+    /**
+     * scale 모드 info 오버레이 포맷 — 델타 + 최종값 병기.
+     *   - 단일 축 핸들(X/Y/Z): `⤢ W 150px (+50)` — 최종 치수 + 델타
+     *   - 중앙 uniform 핸들 또는 세 축 거의 동일 배율: `⤢ ×1.50 (150×75×100)`
+     *   - 비균일 멀티축: `⤢ W:150(+50) D:130(+30) H:120(+20)`
+     * 축 매핑: scale.x→width, scale.y→depth, scale.z→height
+     */
+    private _formatScaleInfo;
+    private _hideInfoOverlay;
 }
 //# sourceMappingURL=gizmo-operation-manager.d.ts.map

package/dist-types/threed/managers/gizmo-operation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gizmo-operation-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/gizmo-operation-manager.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAA;IAClB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IACjB,UAAU,IAAI,IAAI,CAAA;CACnB;AAcD;;;;;GAKG;AACH,qBAAa,qBAAqB;IAEhC,OAAO,CAAC,iBAAiB,CAAC,CAAkB;IAC5C,OAAO,CAAC,aAAa,CAAC,CAAqC;IAE3D,OAAO,CAAC,sBAAsB,CAAC,CAAQ;IAGvC,OAAO,CAAC,kBAAkB,CAAC,CAAoD;IAC/E,OAAO,CAAC,gBAAgB,CAAQ;IAGhC,OAAO,CAAC,mBAAmB,CAAC,CAAgC;IAC5D,OAAO,CAAC,qBAAqB,CAAC,CAAa;IAC3C,OAAO,CAAC,4BAA4B,CAAC,CAA8B;IACnE,OAAO,CAAC,6BAA6B,CAAC,CAAqC;IAE3E;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIpC;;;;OAIG;IACH,cAAc,CACZ,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE;QAAE,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,EACvD,OAAO,EAAE,MAAM,kBAAkB,GAAG,SAAS,EAC7C,SAAS,CAAC,EAAE;QACV,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAA;KAChD,GACA,IAAI;IA6BP,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,wBAAwB;IA2ChC,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,UAAU;IAuClB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiEtB;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;CAsBhC"}
+{"version":3,"file":"gizmo-operation-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/gizmo-operation-manager.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAA;IAClB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IACjB,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAA;IAClC,UAAU,IAAI,IAAI,CAAA;CACnB;AAcD;;;;;GAKG;AACH,qBAAa,qBAAqB;IAEhC,OAAO,CAAC,iBAAiB,CAAC,CAAkB;IAC5C,OAAO,CAAC,aAAa,CAAC,CAAqC;IAE3D,OAAO,CAAC,sBAAsB,CAAC,CAAQ;IAGvC,OAAO,CAAC,gBAAgB,CAAC,CAAqC;IAE9D,OAAO,CAAC,wBAAwB,CAAC,CAAe;IAGhD,OAAO,CAAC,kBAAkB,CAAC,CAAoD;IAC/E,OAAO,CAAC,gBAAgB,CAAQ;IAGhC,OAAO,CAAC,mBAAmB,CAAC,CAAgC;IAC5D,OAAO,CAAC,qBAAqB,CAAC,CAAa;IAC3C,OAAO,CAAC,4BAA4B,CAAC,CAA8B;IACnE,OAAO,CAAC,6BAA6B,CAAC,CAAqC;IAE3E,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,kBAAkB,CAAC,CAAe;IAE1C;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIpC;;;;OAIG;IACH,cAAc,CACZ,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE;QAAE,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,EACvD,OAAO,EAAE,MAAM,kBAAkB,GAAG,SAAS,EAC7C,SAAS,CAAC,EAAE;QACV,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAA;QAC/C,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAA;KAClD,GACA,IAAI;IAuCP,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,wBAAwB;IA2ChC,OAAO,CAAC,oBAAoB;IAiB5B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IA6B1B,OAAO,CAAC,UAAU;IA4ElB;;OAEG;IACH,OAAO,CAAC,cAAc;IAwDtB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAmC/B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA8B3B;;;;;OAKG;IACH,OAAO,CAAC,8BAA8B;IA0BtC,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,kBAAkB;IA2C1B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,gBAAgB;CAMzB"}

package/dist-types/threed/managers/index.d.ts

@@ -1,4 +1,4 @@
-export { SceneManager } from './scene-manager.js';
+export { SceneManager, recommendsLogarithmicDepthForSky } from './scene-manager.js';
 export { CameraManager, type CameraViewName } from './camera-manager.js';
 export { RendererManager } from './renderer-manager.js';
 export { LightManager } from './light-manager.js';
@@ -9,5 +9,7 @@ export { GizmoOperationManager, type GizmoOperationHost } from './gizmo-operatio
 export { InteractionManager, type InteractionDelegate } from './interaction-manager.js';
 export { PlacementManager, type PlacementDelegate } from './placement-manager.js';
 export { CameraBookmarkManager, type CameraBookmark } from './camera-bookmark-manager.js';
+export { BoxSelectionManager } from './box-selection-manager.js';
+export { VertexGizmoManager } from './vertex-gizmo-manager.js';
 export type { CameraConfig, RendererConfig, LightingConfig } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist-types/threed/managers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAC7F,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACvF,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AACjF,OAAO,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAA;AACzF,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAC7F,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACvF,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AACjF,OAAO,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAA;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist-types/threed/managers/interaction-manager.d.ts

@@ -32,6 +32,22 @@ export interface InteractionDelegate {
     handleTouchEnd(e: TouchEvent): void;
     /** 키 입력. 처리했으면 true, 상위로 전파해야 하면 false */
     handleKeyDown(e: KeyboardEvent): boolean;
+    /** 키 해제. 처리했으면 true */
+    handleKeyUp?(e: KeyboardEvent): boolean;
+    /** Space 키 패닝 모드 여부 */
+    isSpacePanning?(): boolean;
+    /** 박스 셀렉션 시작 */
+    handleBoxSelectionStart?(x: number, y: number): void;
+    /** 박스 셀렉션 업데이트 */
+    handleBoxSelectionUpdate?(x: number, y: number): void;
+    /** 박스 셀렉션 종료 (additive: Shift 유지 여부, typeFiltered: Ctrl/Cmd 유지 여부) */
+    handleBoxSelectionEnd?(additive: boolean, typeFiltered?: boolean): void;
+    /** vertex 핸들 드래그 시작 시도. 성공 시 true 반환 */
+    tryVertexDragStart?(e: MouseEvent): boolean;
+    /** vertex 핸들 드래그 이동 */
+    handleVertexDragMove?(e: MouseEvent): void;
+    /** vertex 핸들 드래그 종료 */
+    handleVertexDragEnd?(e: MouseEvent): void;
 }
 /**
  * DOM 이벤트 핸들링과 드래그 상태 관리를 담당하는 매니저.
@@ -45,6 +61,7 @@ export declare class InteractionManager {
     private _hostElement?;
     private _mouseIsDown;
     private _isDragging;
+    private _touchGizmoCaptured;
     private _mouseDownPos;
     private _boundHandlers?;
     private _docMoveHandler?;

package/dist-types/threed/managers/interaction-manager.d.ts.map

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

package/dist-types/threed/managers/light-manager.d.ts

@@ -18,6 +18,21 @@ export declare class LightManager {
         color?: number | string;
         intensity?: number;
     }): void;
+    /**
+     * directional light를 camera에 붙일지, scene에 독립 배치할지 전환한다.
+     * - follow=true: camera에 attach — light는 카메라 이동에 따라 함께 이동 (기본 동작)
+     * - follow=false: scene에 attach — light는 고정 월드 위치, angle 기반 조명 가능
+     */
+    setDirectionalFollowCamera(follow: boolean): void;
+    /**
+     * directional light의 방향을 방위각/고도각으로 설정 (world-space).
+     * - azimuth: 수평면 회전 (deg, 0=+Z/정면, 90=+X/우측)
+     * - elevation: 수직 고도 (deg, 0=수평, 90=정수리)
+     * - distance: 중심으로부터의 거리 (기본 1000)
+     *
+     * follow-camera 모드일 땐 설정해도 효과 없음 (camera 좌표계 기준으로 재계산됨).
+     */
+    setDirectionalAngle(azimuthDeg: number, elevationDeg: number, distance?: number): void;
     setDirectionalEnabled(enabled: boolean, config?: {
         color?: number | string;
         intensity?: number;

package/dist-types/threed/managers/light-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"light-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/light-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,UAAU,CAAC,CAAuB;IAC1C,OAAO,CAAC,SAAS,CAAC,CAAwB;IAC1C,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAc;IAE9B,IAAI,SAAS,IAAI,KAAK,CAAC,eAAe,GAAG,SAAS,CAEjD;IAED,IAAI,QAAQ,IAAI,KAAK,CAAC,gBAAgB,GAAG,SAAS,CAEjD;IAED,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc;IAoDtE,gBAAgB,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAOhH,iBAAiB,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAM/E,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAevG,OAAO;CAQR"}
+{"version":3,"file":"light-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/light-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,UAAU,CAAC,CAAuB;IAC1C,OAAO,CAAC,SAAS,CAAC,CAAwB;IAC1C,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAc;IAE9B,IAAI,SAAS,IAAI,KAAK,CAAC,eAAe,GAAG,SAAS,CAEjD;IAED,IAAI,QAAQ,IAAI,KAAK,CAAC,gBAAgB,GAAG,SAAS,CAEjD;IAED,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc;IAwDtE,gBAAgB,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAOhH,iBAAiB,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAM/E;;;;OAIG;IACH,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAOjD;;;;;;;OAOG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,IAAI;IAiBpF,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAiBvG,OAAO;CAQR"}

package/dist-types/threed/managers/renderer-manager.d.ts

@@ -9,35 +9,72 @@ export declare class RendererManager {
     private _composer?;
     private _outlinePass?;
     private _noSupportWebgl;
+    private _hudScene?;
+    private _hudCamera?;
+    private _hudCSS3DRenderer?;
+    private _hudCSS3DScene?;
+    private _hudCSS3DCamera?;
     get renderer(): THREE.WebGLRenderer | undefined;
+    /**
+     * 런타임에 tone mapping exposure만 갱신한다. property-panel에서 slider로
+     * 조정할 때 호출 — renderer 재생성 없이 다음 renderThreeD()부터 반영.
+     */
+    setExposure(value: number): void;
     get css3DRenderer(): CSS3DRenderer;
     get css3DScene(): THREE.Scene;
     get composer(): EffectComposer | undefined;
     get noSupportWebgl(): boolean;
     get domElement(): HTMLCanvasElement | undefined;
+    get hudScene(): THREE.Scene;
+    get hudCSS3DScene(): THREE.Scene;
+    get hudCamera(): THREE.OrthographicCamera | undefined;
+    /**
+     * HUD 직교 카메라를 초기화한다.
+     * 2D 좌표계와 동일: 원점 = 좌상단, X→오른쪽, Y→아래
+     */
+    setupHUD(width: number, height: number): void;
+    /**
+     * HUD 카메라 프러스텀을 캔버스 크기에 맞춘다.
+     */
+    resizeHUD(width: number, height: number): void;
     setupWebGL(width: number, height: number, config: RendererConfig): boolean;
     setupCSS3D(isViewMode: boolean, sceneAttr?: string): void;
     private createCSS3DRenderer;
     setupComposer(scene: THREE.Scene, camera: THREE.Camera, width: number, height: number, gizmoHelper?: THREE.Object3D): EffectComposer;
+    setupLightComposer(scene: THREE.Scene, camera: THREE.Camera, width: number, height: number): EffectComposer;
+    get hasOutlinePass(): boolean;
     updateRenderPassCamera(camera: THREE.Camera): void;
     /**
      * 아웃라인을 표시할 오브젝트 목록을 설정한다.
      */
     setOutlineObjects(objects: THREE.Object3D[]): void;
+    /**
+     * 아웃라인 색을 설정한다. visibleEdge / hiddenEdge 둘 다 같은 색으로.
+     * Tracker 등 외부 모듈이 selection/tracking outline 색을 자기 정책으로
+     * 동기화할 때 사용. 기본 색 (#f26522) 복원도 같은 메서드.
+     */
+    setOutlineColor(color: number): void;
     resize(width: number, height: number): void;
     private _scene?;
     private _camera?;
+    /**
+     * 경량 composer를 해제하고 direct render 모드로 복귀한다.
+     */
+    teardownLightComposer(): void;
     /**
      * 포스트프로세싱 없이 직접 렌더링할 때 사용할 scene/camera를 설정한다.
      */
     setDirectRenderTargets(scene: THREE.Scene, camera: THREE.Camera): void;
     render(): void;
+    private renderHUD;
     renderCSS3D(camera: THREE.Camera): void;
+    get hudCSS3DRenderer(): CSS3DRenderer | undefined;
     getSize(): {
         width: number;
         height: number;
     };
     destroy(): void;
+    disposeHUD(): void;
     disposeCSS3DScene(): void;
 }
 //# sourceMappingURL=renderer-manager.d.ts.map

package/dist-types/threed/managers/renderer-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/renderer-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,qDAAqD,CAAA;AAKpF,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAA;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAqB;IACvC,OAAO,CAAC,cAAc,CAAC,CAAe;IACtC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,SAAS,CAAC,CAAgB;IAClC,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,OAAO,CAAC,eAAe,CAAQ;IAE/B,IAAI,QAAQ,oCAEX;IAED,IAAI,aAAa,kBAKhB;IAED,IAAI,UAAU,gBAKb;IAED,IAAI,QAAQ,+BAEX;IAED,IAAI,cAAc,YAEjB;IAED,IAAI,UAAU,kCAEb;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO;IA8C1E,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM;IAmBlD,OAAO,CAAC,mBAAmB;IAI3B,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,CAAC,QAAQ;IA4CnH,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM;IAa3C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE;IAM3C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAOpC,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAc;IAE9B;;OAEG;IACH,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM;IAK/D,MAAM;IAmBN,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM;IAIhC,OAAO,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAM5C,OAAO;IAQP,iBAAiB;CAMlB"}
+{"version":3,"file":"renderer-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/renderer-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,qDAAqD,CAAA;AAKpF,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAA;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAqB;IACvC,OAAO,CAAC,cAAc,CAAC,CAAe;IACtC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,SAAS,CAAC,CAAgB;IAClC,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,OAAO,CAAC,eAAe,CAAQ;IAG/B,OAAO,CAAC,SAAS,CAAC,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAC,CAA0B;IAE7C,OAAO,CAAC,iBAAiB,CAAC,CAAe;IACzC,OAAO,CAAC,cAAc,CAAC,CAAa;IACpC,OAAO,CAAC,eAAe,CAAC,CAA0B;IAElD,IAAI,QAAQ,oCAEX;IAED;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC,IAAI,aAAa,kBAKhB;IAED,IAAI,UAAU,gBAKb;IAED,IAAI,QAAQ,+BAEX;IAED,IAAI,cAAc,YAEjB;IAED,IAAI,UAAU,kCAEb;IAED,IAAI,QAAQ,gBAKX;IAED,IAAI,aAAa,gBAKhB;IAED,IAAI,SAAS,yCAEZ;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IA4CtC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAQvC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO;IAmD1E,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM;IAmBlD,OAAO,CAAC,mBAAmB;IAI3B,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,CAAC,QAAQ;IA4CnH,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAsB1F,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM;IAa3C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE;IAM3C;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM;IAO7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAkBpC,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAc;IAE9B;;OAEG;IACH,qBAAqB;IAQrB;;OAEG;IACH,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM;IAK/D,MAAM;IAsBN,OAAO,CAAC,SAAS;IAcjB,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM;IAchC,IAAI,gBAAgB,8BAEnB;IAED,OAAO,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAM5C,OAAO;IAYP,UAAU;IAkCV,iBAAiB;CAMlB"}

package/dist-types/threed/managers/scene-manager.d.ts

@@ -1,5 +1,11 @@
 import * as THREE from 'three';
 import type Component from '../../components/component.js';
+/**
+ * 환경 프리셋의 logarithmicDepthBuffer 추천 여부.
+ * 실내 (warehouse/factory/office/home) = true. 그 외 / unknown = false.
+ * Renderer 생성 시 사용자가 명시 override 안 했을 때 default 로 적용.
+ */
+export declare function recommendsLogarithmicDepthForSky(sky?: string): boolean;
 export declare class SceneManager {
     private _scene?;
     private _mixer?;
@@ -16,8 +22,12 @@ export declare class SceneManager {
      */
     private _applyEnvironment;
     /**
-     * 3D 씬 배경(sky)을 설정한다.
-     * @param sky - 프리셋 이름('studio'|'warehouse'|'factory'|'office') | 'color' | '' (none)
+     * 환경맵을 해제한다. (IBL 기여 제거)
+     */
+    private _clearEnvironment;
+    /**
+     * 3D 씬 배경(sky)을 설정한다. environment(IBL)도 함께 관리한다.
+     * @param sky - 프리셋 이름 (studio/warehouse/factory/office/home | sunny/cloudy/rainy) | 'color' | '' (none)
      * @param skyColor - sky='color'일 때 사용할 색상
      */
     setSky(sky?: string, skyColor?: string): void;

package/dist-types/threed/managers/scene-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/scene-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,SAAS,MAAM,+BAA+B,CAAA;AAmB1D,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,SAAS,CAAC,CAAqB;IAEvC,IAAI,KAAK,4BAER;IAED,IAAI,KAAK,qCAER;IAED,KAAK;IAKL,UAAU;IAOV,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa;IAK9C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAetC,QAAQ,CAAC,SAAS,EAAE,SAAS;IAO7B;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS;IAYhC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ;IAI/B,eAAe;IAOf,OAAO;CAyBR"}
+{"version":3,"file":"scene-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/scene-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,SAAS,MAAM,+BAA+B,CAAA;AA2B1D;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAItE;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,SAAS,CAAC,CAAqB;IAEvC,IAAI,KAAK,4BAER;IAED,IAAI,KAAK,qCAER;IAED,KAAK;IAKL,UAAU;IAOV,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa;IAO9C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAmBtC,QAAQ,CAAC,SAAS,EAAE,SAAS;IAO7B;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS;IAYhC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ;IAI/B,eAAe;IAOf,OAAO;CAyBR"}

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

@@ -11,6 +11,8 @@ export interface RendererConfig {
     antialias: boolean;
     exposure: number;
     postprocessing?: boolean;
+    shadowMap?: boolean;
+    logarithmicDepthBuffer?: boolean;
 }
 export interface LightingConfig {
     hemisphere: {
@@ -21,7 +23,8 @@ export interface LightingConfig {
     directional?: {
         color: number;
         intensity: number;
-        attachToCamera: boolean;
+        attachToCamera?: boolean;
+        position?: [number, number, number];
         castShadow?: boolean;
         shadowMapSize?: number;
         shadowBias?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACxE,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,OAAO,CAAA;QACvB,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,OAAO,CAAA;QACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QAClC,UAAU,EAAE,MAAM,CAAA;QAClB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,sBAAsB,CAAC,EAAE,OAAO,CAAA;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACxE,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QACnC,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,OAAO,CAAA;QACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QAClC,UAAU,EAAE,MAAM,CAAA;QAClB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;CACF"}

package/dist-types/threed/managers/vertex-gizmo-manager.d.ts

@@ -0,0 +1,154 @@
+import * as THREE from 'three';
+import type Component from '../../components/component.js';
+/**
+ * 선택된 path 기반 컴포넌트의 각 vertex에 드래그 가능한 핸들을 표시하는 매니저.
+ *
+ * polyline, line, polygon, path 등 mutable+path 속성을 가진 컴포넌트에 공통 적용.
+ * 멀티셀렉트 시 모든 mutable+path 컴포넌트의 핸들을 표시한다.
+ *
+ * 기능:
+ * - vertex 핸들 드래그: vertex 이동
+ * - midpoint 핸들 드래그: 세그먼트 중간에 새 vertex 삽입
+ * - Alt+드래그 끝점: 끝에 새 vertex 추가 (pathExtendable인 경우)
+ * - 더블클릭 vertex: vertex 삭제 (pathExtendable이고 path.length > 2)
+ */
+export declare class VertexGizmoManager {
+    private _componentHandles;
+    private _handleGroup?;
+    private _scene3d?;
+    private _commander?;
+    private _activeComponent?;
+    private _activeVertexHandles;
+    private _activeHandleIndex;
+    private _activeKind;
+    private _activeHandle?;
+    private _isDragging;
+    private _isPending;
+    private _pendingHit?;
+    private _pendingHandleType?;
+    private _pendingScreenStart;
+    private _dragPlane;
+    private _dragOffset;
+    private _raycaster;
+    private _intersection;
+    get isDragging(): boolean;
+    get isAttached(): boolean;
+    /** 핸들 표시/숨김 (기즈모 드래그 중에는 숨김) */
+    setVisible(visible: boolean): void;
+    /**
+     * 선택된 컴포넌트들에 vertex 핸들을 표시한다.
+     */
+    attachMultiple(components: Component[], scene: THREE.Scene, commander?: any): void;
+    /** 하위 호환: 단일 컴포넌트 attach */
+    attach(component: Component, scene: THREE.Scene, commander?: any): void;
+    /**
+     * 핸들을 제거한다.
+     */
+    detach(): void;
+    /**
+     * 컴포넌트에 대한 핸들을 생성한다.
+     */
+    private _buildComponentHandles;
+    /**
+     * 특정 컴포넌트의 핸들만 재생성한다.
+     */
+    private _rebuildComponentHandles;
+    private _createVertexHandle;
+    private _createMidpointHandle;
+    private _createCornerHandle;
+    private _createBulgeHandle;
+    /**
+     * 3D 핸들 위치 → 2D path 포인트 역변환
+     */
+    private _handlePosToPoint;
+    /**
+     * mutatePath를 commander undo 지원과 함께 실행
+     */
+    private _execMutatePath;
+    /** 모든 핸들을 flat 배열로 반환 */
+    private _getAllHandles;
+    /** 컴포넌트에 속하는 ComponentHandles를 찾는다 */
+    private _findComponentHandles;
+    /**
+     * 마우스 다운: 핸들 raycast hit 감지 → **pending 상태 진입** (드래그 시작 X).
+     *
+     * 2D `ua-event-handler.ts` 와 동일 컨벤션: mousedown 만으로 path mutation 을 일으키지
+     * 않고, mousemove 가 DRAG_THRESHOLD_PX2 를 넘는 순간 dragstart 처리.
+     * 이전엔 midpoint 핸들 클릭만 해도 vertex 가 즉시 추가되었고, vertex 클릭만 해도
+     * mouseup 에서 no-op CommandChange 가 쌓였다 — 두 케이스 모두 2D 와 다른 거동.
+     *
+     * vertex/midpoint 우선 raycast — corner/bulge 는 vertex 가 hit 안 될 때만 검사.
+     * 같은 ray 위에 vertex 와 corner 가 겹칠 때 vertex 가 우선되도록.
+     *
+     * @returns true이면 이벤트를 소비
+     */
+    onPointerDown(ndc: THREE.Vector2, camera: THREE.Camera, event: MouseEvent): boolean;
+    /**
+     * pending 상태에서 임계값 통과 시점에 호출 — kind 별 dragstart 처리.
+     * `_startMidpointDrag` 는 vertex 를 splice 하므로 이 시점까지 path mutation 이 미뤄진다.
+     */
+    private _beginDrag;
+    /**
+     * corner radius 핸들 드래그 시작 — 보드 평면 ray-cast 로 드래그 좌표를 받아
+     * cornerRadiusFromDrag 으로 새 radius 계산.
+     */
+    private _startCornerDrag;
+    /**
+     * bulge 핸들 드래그 시작.
+     */
+    private _startBulgeDrag;
+    /**
+     * midpoint 핸들 드래그 시작: 세그먼트 중간에 새 vertex를 삽입
+     */
+    private _startMidpointDrag;
+    /**
+     * Alt+드래그 끝점: 끝에 새 vertex를 추가하고 드래그 시작
+     */
+    private _startEndpointExtend;
+    /**
+     * 카메라 방향 기반 드래그 평면 설정
+     */
+    private _setupDragPlane;
+    /**
+     * 마우스 이동: pending 인 경우 임계값 검사 후 dragstart, 그 후 dragmove 처리.
+     *
+     * 첫 mousemove 가 임계값을 넘는 순간 `_beginDrag` 호출 — 이 함수가 _setupDragPlane 까지
+     * 처리하므로 같은 mousemove 내에서 fallthrough 로 dragmove 까지 이어지면 된다.
+     */
+    onPointerMove(ndc: THREE.Vector2, camera: THREE.Camera, event: MouseEvent): boolean;
+    /** corner 드래그 라이브 갱신 — 보드 좌표 변환 후 cornerRadiusFromDrag */
+    private _dragCornerLive;
+    /** bulge 드래그 라이브 갱신 */
+    private _dragBulgeLive;
+    /**
+     * 현재 활성 컴포넌트의 vertex 핸들 위치로부터 Line2 geometry를 실시간 업데이트한다.
+     */
+    private _updateLinePreview;
+    /**
+     * 마우스 업: 드래그 종료 → component.mutatePath() 호출.
+     *
+     * pending 만 있고 드래그가 시작 안 된 경우 = 클릭만. mutation 없이 정리만 한다
+     * (2D 와 동일 — 클릭은 path 를 더럽히지 않음). dblclick 은 별개 이벤트라 정리해도 무방.
+     */
+    onPointerUp(): boolean;
+    /**
+     * 더블클릭:
+     *   - vertex 핸들 → vertex 삭제 (기존)
+     *   - corner 핸들 → radius 제거 (직각 복귀)
+     *   - bulge 핸들 → bulge 제거 (직선 복귀)
+     *
+     * vertex 우선 raycast — corner/bulge 는 vertex 가 hit 안 될 때만 검사.
+     * onPointerDown 과 동일 컨벤션 (vertex 위 클릭이 corner 로 떨어지지 않도록).
+     */
+    onDblClick(ndc: THREE.Vector2, camera: THREE.Camera): boolean;
+    /**
+     * 핸들 위치를 현재 path 데이터에서 갱신한다.
+     */
+    syncHandles(): void;
+    /**
+     * 카메라 거리에 따라 핸들 크기를 조절하여 화면상 일정한 크기를 유지한다.
+     */
+    updateHandleScales(camera: THREE.Camera): void;
+    destroy(): void;
+}
+//# sourceMappingURL=vertex-gizmo-manager.d.ts.map

package/dist-types/threed/managers/vertex-gizmo-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex-gizmo-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/vertex-gizmo-manager.ts"],"names":[],"mappings":"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"}

package/dist-types/threed/material-3d.d.ts

@@ -10,8 +10,6 @@ export interface Material3D {
     side?: 'double' | 'front' | 'back';
     castShadow?: boolean;
     receiveShadow?: boolean;
-    spriteMode?: 'billboard' | 'plane';
-    renderMode?: 'css3d' | 'texture';
 }
 export interface ResolvedMaterial3D {
     metalness: number;
@@ -33,4 +31,9 @@ export interface MaterialPreset {
 export declare const MATERIAL_PRESETS: Record<string, MaterialPreset>;
 export declare function resolveMaterial3d(material3d?: Material3D): ResolvedMaterial3D;
 export declare function toThreeSide(side: ResolvedMaterial3D['side']): THREE.Side;
+/**
+ * resolved material3d 속성을 MeshStandardMaterial에 일괄 적용한다.
+ * createMaterials / updateMaterial3d 에서 공통으로 사용.
+ */
+export declare function applyMaterial3dProps(material: THREE.MeshStandardMaterial, resolved: ResolvedMaterial3D): void;
 //# sourceMappingURL=material-3d.d.ts.map

package/dist-types/threed/material-3d.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"material-3d.d.ts","sourceRoot":"","sources":["../../src/threed/material-3d.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,MAAM,WAAW,UAAU;IAEzB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAG1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;IAGlC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,CAAA;IAGvB,UAAU,CAAC,EAAE,WAAW,GAAG,OAAO,CAAA;IAGlC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB,EAAE,MAAM,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;IACjC,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAQ3D,CAAA;AAED,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,kBAAkB,CA4B7E;AAQD,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAExE"}
+{"version":3,"file":"material-3d.d.ts","sourceRoot":"","sources":["../../src/threed/material-3d.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,MAAM,WAAW,UAAU;IAEzB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAG1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;IAGlC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB,EAAE,MAAM,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;IACjC,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAQ3D,CAAA;AAED,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,kBAAkB,CA4B7E;AAQD,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAExE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,oBAAoB,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAS7G"}

package/dist-types/threed/material-bank.d.ts

@@ -0,0 +1,42 @@
+import * as THREE from 'three';
+/**
+ * 코어 공통 **Material Bank** — 이름(key) + intrinsic spec 으로 base material 을 등록·공유한다.
+ *
+ * base 캐시 키 = `key + spec 시그니처`. 같은 key 라도 **spec(재질 속성)이 다르면 별도 base**(예:
+ * 인스턴스별 material3d 커스터마이즈)이고, spec 이 같으면 컴포넌트 종류를 넘어 **공유**된다. key 관례는
+ * `"{컴포넌트명}|{용도}"` (예: `"conveyor|belt"`, `"chute|body"`).
+ *
+ * 상태색은 `material(key, spec, color)` — base(색 없는 intrinsic)에 색 overlay(색상별 공유 변형).
+ * faint 는 색을 버리고 base 로 수렴(코어 applyFocusDim 자동). 예) 상태색 4종 컴포넌트(같은 intrinsic)
+ * → base 1 + 색 4 + faint 1 = 6개, 인스턴스 무관.
+ *
+ * material 은 미리 만들지 않고 lazy 생성, 앱 수명 공유. dispose 는 앱/씬 종료 시 MaterialBank.dispose().
+ */
+export interface MaterialSpec {
+    color?: THREE.ColorRepresentation;
+    metalness?: number;
+    roughness?: number;
+    opacity?: number;
+    transparent?: boolean;
+    emissive?: THREE.ColorRepresentation;
+    emissiveIntensity?: number;
+    envMapIntensity?: number;
+    side?: THREE.Side;
+    map?: THREE.Texture | null;
+    flatShading?: boolean;
+    depthWrite?: boolean;
+}
+export declare const MaterialBank: {
+    /**
+     * key + spec 으로 공유 base material 을 얻는다(같은 (key, spec)이면 공유, spec 다르면 별도 base).
+     * color 를 주면 base 의 색 overlay 변형(같은 색끼리 공유), 안 주면 base 자체. faint 는 코어 자동.
+     */
+    material(key: string, spec: MaterialSpec, color?: THREE.ColorRepresentation): THREE.MeshStandardMaterial;
+    /** 등록된 base 개수(테스트/진단용). */
+    readonly size: number;
+    /** key 로 등록된 base 존재 여부(spec 무관, prefix 매칭). */
+    has(key: string): boolean;
+    /** 전체 해제 — 앱/씬 종료 시. 각 base 의 변형(색·faint)까지 dispose. */
+    dispose(): void;
+};
+//# sourceMappingURL=material-bank.d.ts.map

package/dist-types/threed/material-bank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-bank.d.ts","sourceRoot":"","sources":["../../src/threed/material-bank.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAA;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,CAAA;IACjB,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAgDD,eAAO,MAAM,YAAY;IACvB;;;OAGG;kBACW,MAAM,QAAQ,YAAY,UAAU,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC,oBAAoB;IAOxG,4BAA4B;mBAChB,MAAM;IAIlB,gDAAgD;aACvC,MAAM,GAAG,OAAO;IAMzB,wDAAwD;eAC7C,IAAI;CAOhB,CAAA"}

package/dist-types/threed/material-variant.d.ts

@@ -0,0 +1,43 @@
+import * as THREE from 'three';
+/**
+ * 파생 material 변형(variant) 공유 레지스트리 — **base material 하나**에서 `(base × spec)` 로 변형을
+ * lazy 생성·공유한다. 상태색과 faint 를 같은 메커니즘으로 다룬다:
+ *   - 상태색 : resolveVariant(base, { color })          → 같은 색 인스턴스들이 변형 하나 공유
+ *   - faint  : resolveVariant(base, { opacityFactor:0.5 }) → color 없음(=base 색) → base 당 1개, 색 무관 수렴
+ *
+ * 예) 상태색 4종 컴포넌트 → base 1 + 색 변형 4 + faint 1 = **6개**(인스턴스 수 무관). faint 는 색을
+ * 버리고 base 로 모이므로 색상 수만큼 늘지 않는다.
+ *
+ * base 는 절대 변경하지 않으므로 공유 안전(오염 없음). content alpha 등 base.opacity 변화는 스왑
+ * 시점에 곱해 반영된다.
+ *
+ * 수명 2층: 캐시 WeakMap<base, Map<sig, variant>>(base GC 시 소멸) + 명시적 GPU 해제(base dispose 시
+ * disposeVariantsOf; 텍스처는 base 참조공유라 제외). dispose 전 restoreCanonicalMaterials 로 원복.
+ */
+export interface MaterialVariantSpec {
+    color?: THREE.ColorRepresentation;
+    /** base.opacity 에 곱할 배율(content alpha 등). 1 이상이면 무변형. */
+    opacityFactor?: number;
+}
+/** `base × spec` 공유 변형을 돌려준다. 무변형 spec 이면 base 그대로. */
+export declare function resolveVariant(base: any, spec: MaterialVariantSpec): any;
+/**
+ * mesh.material 을 faint(흐림)로 스왑하거나(faint=true) 원복(false). **faint 는 색을 버리고 base 로
+ * 수렴**한다 — 현재 material 이 색 변형이면 그 base 의 faint 변형(색 무관 1개)을 공유한다. base 선언이
+ * 없으면 material 자신이 base(하위호환: material 별 faint). 복원은 표시 material 로(색 정확히 되돌림).
+ */
+export declare function setFaint(mesh: any, faint: boolean): void;
+/**
+ * content alpha × faint 를 mesh.material 에 **opacity 오버레이**로 반영 — 코어가 모든 컴포넌트에 일괄.
+ * canonical(=컴포넌트가 만든 설계 material, 설계 opacity 유지) 을 base 로 삼아 variant 스왑:
+ *  - faint: 색·contentAlpha·emissive 무관하게 base 당 하나로 수렴(opacity = 설계 × 0.5).
+ *  - 비-faint & contentAlpha<1: 색 유지 + opacity = 설계 × contentAlpha.
+ *  - 무변형(contentAlpha≥1, 비-faint): canonical 그대로(스왑 없음).
+ * 컴포넌트는 alpha 를 material 에 굽지 않는다(설계 opacity 만) — 코어가 여기서 한 번만 곱한다.
+ */
+export declare function applyMeshOpacity(mesh: any, contentAlpha: number, faint: boolean): void;
+/** dispose 전 호출 — 변형을 벗기고 표시 material 복원. 공유 변형/base 텍스처의 조기 파괴 방지. */
+export declare function restoreCanonicalMaterials(root: any): void;
+/** base material dispose 시 그 변형들의 GPU program 도 해제(텍스처는 base 소유라 제외). */
+export declare function disposeVariantsOf(base: any): void;
+//# sourceMappingURL=material-variant.d.ts.map

package/dist-types/threed/material-variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-variant.d.ts","sourceRoot":"","sources":["../../src/threed/material-variant.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAA;IACjC,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAuCD,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,mBAAmB,GAAG,GAAG,CAexE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAexD;AAID;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAgBtF;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAQzD;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAKjD"}