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

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

@@ -1 +1 @@
-{"version":3,"file":"floor.d.ts","sourceRoot":"","sources":["../../../src/threed/floor/floor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,SAAS,MAAM,+BAA+B,CAAA;AAe1D,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,KAAK,CAAC,IAAI,GAAG,SAAS,CAuDxE"}
+{"version":3,"file":"floor.d.ts","sourceRoot":"","sources":["../../../src/threed/floor/floor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,SAAS,MAAM,+BAA+B,CAAA;AAqB1D,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,KAAK,CAAC,IAAI,GAAG,SAAS,CAuExE"}

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

@@ -0,0 +1,21 @@
+import * as THREE from 'three';
+import type Component from '../components/component.js';
+export interface SelectionHandleOptions {
+    /** Sphere radius (scene units). Default 5. */
+    size?: number;
+    /** Diffuse color (hex int). Default 0x44aacc (cyan). */
+    color?: number;
+    /** Emissive accent color (hex int). Default 0x224466. */
+    emissive?: number;
+    /** Position relative to parent. Default [0, 0, 0]. */
+    position?: [number, number, number];
+    /** Initial visibility. Default = `component.app.isEditMode`. */
+    visible?: boolean;
+}
+/**
+ * Creates a small handle mesh suitable for selecting an otherwise non-
+ * raycastable 3D component. Returns the mesh — caller adds it to their
+ * scene-graph root (typically `this.object3d.add(handle)`).
+ */
+export declare function createSelectionHandle3D(component: Component, options?: SelectionHandleOptions): THREE.Mesh;
+//# sourceMappingURL=handle-3d.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handle-3d.d.ts","sourceRoot":"","sources":["../../src/threed/handle-3d.ts"],"names":[],"mappings":"AAwDA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AAEvD,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAWD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,sBAA2B,GACnC,KAAK,CAAC,IAAI,CA0DZ"}

package/dist-types/threed/html/elements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elements.d.ts","sourceRoot":"","sources":["../../../src/threed/html/elements.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAWpB,CAAA;AAEJ,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAS7E"}
+{"version":3,"file":"elements.d.ts","sourceRoot":"","sources":["../../../src/threed/html/elements.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,WAAW,QAAsB,CAAA;AAE9C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAS7E"}

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

@@ -15,17 +15,27 @@ import './factories/camera.js';
 import './factories/gltf-object.js';
 import './factories/light.js';
 import './factories/wall.js';
+import './factories/floor-plate.js';
+import './factories/decal.js';
+import './factories/backdrop.js';
+import './factories/line.js';
+import './factories/polyline.js';
+import './factories/ortholine.js';
+import './factories/group.js';
 export * from './common.js';
 export * from './interfaces.js';
 export * from './material-3d.js';
 export * from './three-dimensional-container.js';
 export * from './real-object.js';
+export { Z_PRIORITY, applyZPriorityToMaterials, polygonOffsetForPriority } from './z-priority.js';
+export type { ZPriorityValue } from './z-priority.js';
 export { registerRealObjectFactory, registerDefaultRealObjectFactory, createRealObjectFor } from './real-object-registry.js';
 export * from './real-object-dummy.js';
 export * from './real-object-extrude.js';
 export * from './real-object-camera.js';
 export * from './real-object-dom-element.js';
 export * from './real-object-dom-texture.js';
+export * from './real-object-external-model.js';
 export * from './real-object-gltf.js';
 export * from './real-object-group.js';
 export * from './real-object-mesh.js';
@@ -34,6 +44,7 @@ export * from './real-object-scene.js';
 export * from './real-object-sprite-2d.js';
 export * from './real-object-plane-2d.js';
 export * from './real-object-sprite.js';
+export * from './real-object-service.js';
 export * from './real-object-text.js';
 export { EllipseExtrude } from './factories/ellipse.js';
 export { RectExtrude } from './factories/rect.js';
@@ -50,14 +61,27 @@ export { Camera3D, Camera } from './factories/camera.js';
 export { GLTFObject } from './factories/gltf-object.js';
 export { LightObject, PointLight } from './factories/light.js';
 export { Wall3D, Wall } from './factories/wall.js';
+export { FloorPlate } from './factories/floor-plate.js';
+export { Line3D } from './factories/line.js';
+export { Polyline3D } from './factories/polyline.js';
+export { OrthoLine3D } from './factories/ortholine.js';
+export * from './real-object-line.js';
 export { ThreeCapability } from './three-capability.js';
 export type { ThreeCapabilityHost } from './three-capability.js';
 export { ThreeContainer } from './three-container.js';
 export * from './managers/index.js';
 export { buildArrow3D } from './arrow-3d.js';
 export type { ArrowStyle3D, TipType, TipSize, LineDash } from './arrow-3d.js';
+export { createSelectionHandle3D } from './handle-3d.js';
+export type { SelectionHandleOptions } from './handle-3d.js';
 export { disposeObject3D } from './utils/dispose.js';
 export { projectToScreen } from './utils/project.js';
+export { buildShapeFromPolygonPath } from './utils/polygon-shape.js';
+export type { BuildShapeOptions } from './utils/polygon-shape.js';
+export { resolveAnchorWorldPosition } from './utils/anchor.js';
+export type { AnchorPin, AnchorOffset } from './utils/anchor.js';
+export { buildTether, updateTether, clearTether, disposeTether } from './utils/tether.js';
+export type { TetherElements } from './utils/tether.js';
 export { createCanvasTexture, renderCanvasTexture } from './texture/canvas-texture.js';
 export { textTexture, textBounds, drawTextTexture, fontStyle } from './texture/text-texture.js';
 export { createCanvas, PIXEL_RATIO } from './html/elements.js';

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

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

package/dist-types/threed/managers/box-selection-manager.d.ts

@@ -0,0 +1,26 @@
+import * as THREE from 'three';
+import Component from '../../components/component.js';
+/**
+ * 3D 편집 모드에서 Space+드래그로 사각형 영역 선택을 지원하는 매니저.
+ *
+ * DOM 오버레이로 선택 사각형을 표시하고, 각 오브젝트의 3D 위치를
+ * 카메라로 투영하여 사각형 내에 있는 오브젝트를 선택한다.
+ */
+export declare class BoxSelectionManager {
+    private _overlay;
+    private _hostElement;
+    private _startX;
+    private _startY;
+    private _currentX;
+    private _currentY;
+    private _active;
+    get isActive(): boolean;
+    setup(hostElement: HTMLElement): void;
+    startSelection(x: number, y: number): void;
+    updateSelection(x: number, y: number): void;
+    endSelection(camera: THREE.Camera, scene: THREE.Scene, components: Component[]): Component[];
+    cancelSelection(): void;
+    destroy(): void;
+    private _updateOverlay;
+}
+//# sourceMappingURL=box-selection-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"box-selection-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/box-selection-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,SAAS,MAAM,+BAA+B,CAAA;AAGrD;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,OAAO,CAAQ;IAEvB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAIrC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAsB1C,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAO3C,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE;IAwD5F,eAAe,IAAI,IAAI;IAQvB,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,cAAc;CAavB"}

package/dist-types/threed/managers/camera-bookmark-manager.d.ts

@@ -0,0 +1,127 @@
+import * as THREE from 'three';
+export type EasingType = 'ease-in-out' | 'ease-in' | 'ease-out' | 'linear';
+export interface SplineContext {
+    prevPos: THREE.Vector3;
+    nextPos: THREE.Vector3;
+}
+export interface CameraBookmark {
+    name?: string;
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    target: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** 이 슬롯에서 머무르는 시간 (ms, 기본 2000) */
+    holdDuration?: number;
+    /** 이 슬롯으로 이동하는 전환 시간 (ms, 기본 1200) */
+    transitionDuration?: number;
+    /** 전환 이징 함수 (기본 ease-in-out) */
+    easing?: EasingType;
+    /** 재생 목록에서 제외 */
+    excludeFromPlay?: boolean;
+}
+export declare class CameraBookmarkManager {
+    private _slots;
+    private _animating;
+    private _animationId?;
+    private _animationProgress;
+    private _playStartOffset;
+    private _lastPlayProgress;
+    private _playIndex;
+    private _playing;
+    private _orbitRotating;
+    private _orbitPaused;
+    private _onInvalidate?;
+    private _onAnimationComplete?;
+    get isAnimating(): boolean;
+    get isPlaying(): boolean;
+    get isOrbitRotating(): boolean;
+    get isOrbitPaused(): boolean;
+    get playIndex(): number;
+    get lastPlayProgress(): number;
+    /**
+     * 전체 경로 진행률 0~1 (재생 중: 세그먼트 + 세그먼트 내 진행률)
+     */
+    get playProgress(): number;
+    setCallbacks(onInvalidate: () => void, onAnimationComplete?: () => void): void;
+    /**
+     * 슬롯에 카메라 위치를 저장한다.
+     * bookmark에 name 프로퍼티가 없으면 기존 이름을 보존한다 (카메라 위치만 갱신).
+     * name 프로퍼티가 있으면 (undefined 포함) 그대로 사용한다 (리오더 등).
+     */
+    saveSlot(index: number, bookmark: CameraBookmark): void;
+    renameSlot(index: number, name: string): void;
+    clearSlot(index: number): void;
+    getSlot(index: number): CameraBookmark | undefined;
+    exportSlots(): (CameraBookmark | null)[];
+    importSlots(data: (CameraBookmark | null | undefined)[]): void;
+    resetAll(): void;
+    getPlayableSlots(): number[];
+    swapSlots(a: number, b: number): void;
+    moveSlot(from: number, to: number): void;
+    /**
+     * 카메라를 슬롯 위치로 애니메이션 이동한다.
+     * splineContext가 제공되면 Catmull-Rom 곡선으로 보간, 없으면 직선+slerp.
+     */
+    animateToSlot(index: number, camera: THREE.PerspectiveCamera, controls: {
+        target: THREE.Vector3;
+        restoreTarget(t: THREE.Vector3): void;
+        update(): boolean;
+    }, duration?: number, splineContext?: SplineContext): boolean;
+    /**
+     * evaluatePath를 따라 fromT→targetT 구간을 애니메이션한다 (부분 세그먼트 resume용).
+     */
+    private _animatePathSegment;
+    /**
+     * 공통 rAF 애니메이션 루프. onFrame에 eased progress를 전달한다.
+     */
+    private _runAnimation;
+    /**
+     * progress 값으로부터 playIndex와 playStartOffset을 계산한다.
+     */
+    private _initFromProgress;
+    /**
+     * playOrder 기준 순회 플레이. excludeFromPlay 슬롯은 건너뛴다.
+     * 3개 이상 슬롯이면 Catmull-Rom 스플라인으로 곡선 경로를 따른다.
+     */
+    startPlay(camera: THREE.PerspectiveCamera, controls: {
+        target: THREE.Vector3;
+        restoreTarget(t: THREE.Vector3): void;
+        update(): boolean;
+    }, defaultHold?: number, defaultTransition?: number, startFromProgress?: number, fromBeginning?: boolean): void;
+    /**
+     * 현재 재생 상태에 맞는 SplineContext를 생성한다.
+     */
+    private _buildSplineContext;
+    /**
+     * 슬롯 인덱스에 해당하는 경로상 진행률을 _lastPlayProgress에 설정한다.
+     */
+    setProgressForSlot(slotIndex: number): void;
+    stopPlay(): void;
+    /** stopPlay + lastPlayProgress 초기화 (모드 전환 시 사용) */
+    resetPlay(): void;
+    toggleOrbitRotation(controls: {
+        isAutoRotating(): boolean;
+        setAutoRotate(enabled: boolean): void;
+    }): void;
+    /** 모드 전환(P키 등)에서 사용 — orbit 완전 초기화 */
+    stopOrbitRotation(controls: {
+        setAutoRotate(enabled: boolean): void;
+    }): void;
+    /**
+     * 전체 재생 경로의 t∈[0,1] 지점에서의 카메라 position/target을 계산한다.
+     * 3개 이상 슬롯이면 Catmull-Rom 스플라인(루프), 2개면 직선 보간.
+     */
+    evaluatePath(t: number): {
+        position: THREE.Vector3;
+        target: THREE.Vector3;
+    } | null;
+    stopAnimation(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=camera-bookmark-manager.d.ts.map

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

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

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

@@ -9,7 +9,6 @@ export declare class CameraManager {
     get camera(): THREE.PerspectiveCamera | undefined;
     get activeCamera(): THREE.Camera;
     get activeView(): CameraViewName;
-    get zoom(): number | undefined;
     get cameraZPos(): number;
     setup(width: number, height: number, config: CameraConfig): THREE.PerspectiveCamera;
     addToScene(scene: THREE.Scene): void;
@@ -19,12 +18,19 @@ export declare class CameraManager {
      * 직교 투영 카메라로 특정 뷰를 설정한다.
      * Top/Front/Back/Right/Left — 원근법 없는 정사영 뷰.
      */
-    setOrthoView(view: CameraViewName, width: number, height: number): THREE.OrthographicCamera;
+    setOrthoView(view: CameraViewName, width: number, height: number, viewportWidth?: number, viewportHeight?: number): THREE.OrthographicCamera;
     /**
      * Perspective 카메라로 복귀한다.
      */
     restorePerspective(): THREE.PerspectiveCamera;
-    private _updateOrthoFrustum;
+    /**
+     * 직교 카메라 frustum을 업데이트한다.
+     * @param sceneWidth 씬 모델 너비
+     * @param sceneHeight 씬 모델 높이
+     * @param viewportWidth 실제 뷰포트 너비 (옵션)
+     * @param viewportHeight 실제 뷰포트 높이 (옵션)
+     */
+    updateOrthoFrustum(sceneWidth: number, sceneHeight: number, viewportWidth?: number, viewportHeight?: number): void;
     destroy(): void;
 }
 //# sourceMappingURL=camera-manager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"camera-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/camera-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAExF,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAC,CAAyB;IAC9C,OAAO,CAAC,YAAY,CAAC,CAA0B;IAC/C,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,WAAW,CAAY;IAE/B,IAAI,MAAM,wCAET;IAED,IAAI,YAAY,IAAI,KAAK,CAAC,MAAM,CAK/B;IAED,IAAI,UAAU,IAAI,cAAc,CAE/B;IAED,IAAI,IAAI,uBAEP;IAED,IAAI,UAAU,WAEb;IAED,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY;IAsBzD,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK;IAK7B,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAU1C,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;IAW9C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,kBAAkB;IAyC3F;;OAEG;IACH,kBAAkB,IAAI,KAAK,CAAC,iBAAiB;IAK7C,OAAO,CAAC,mBAAmB;IAW3B,OAAO;CAKR"}
+{"version":3,"file":"camera-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/camera-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAExF,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAC,CAAyB;IAC9C,OAAO,CAAC,YAAY,CAAC,CAA0B;IAC/C,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,WAAW,CAAY;IAE/B,IAAI,MAAM,wCAET;IAED,IAAI,YAAY,IAAI,KAAK,CAAC,MAAM,CAK/B;IAED,IAAI,UAAU,IAAI,cAAc,CAE/B;IAED,IAAI,UAAU,WAEb;IAED,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY;IA+BzD,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK;IAK7B,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAgB1C,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;IAU9C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,kBAAkB;IAyC5I;;OAEG;IACH,kBAAkB,IAAI,KAAK,CAAC,iBAAiB;IAK7C;;;;;;OAMG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;IAyB3G,OAAO;CAKR"}

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

@@ -7,10 +7,14 @@ export declare class ControlsManager {
     private _state;
     private _autoRotate;
     private _autoRotateSpeed;
+    private _onUserInteraction?;
     private _dampingFactor;
     private _rotateSpeed;
     private _panSpeed;
+    private _dollyStart;
     private _lastScale;
+    /** true이면 카메라와 타겟이 Y=0 아래로 내려가지 못한다 (뷰어 전용). */
+    private _floorConstraint;
     private _spherical;
     private _sphericalDelta;
     private _panOffset;
@@ -38,6 +42,7 @@ export declare class ControlsManager {
     private get _isOrthoLocked();
     setup(camera: THREE.Camera, host: Component): void;
     setEnabled(enabled: boolean): void;
+    setOnUserInteraction(cb: (() => void) | undefined): void;
     onDragStart(e: DragEvent): void;
     onDragMove(e: DragEvent): void;
     onDragEnd(_e: DragEvent): void;
@@ -47,15 +52,23 @@ export declare class ControlsManager {
     onKeyDown(e: KeyboardEvent): void;
     update(): boolean;
     reset(): void;
+    /**
+     * 현재 카메라 위치/타겟을 리셋 기준점으로 저장한다.
+     * Pin Camera View 등으로 기본 위치를 변경한 후 호출.
+     */
+    pinResetPosition(): void;
     setCamera(camera: THREE.Camera): void;
+    isAutoRotating(): boolean;
     setAutoRotate(enabled: boolean): void;
+    setFloorConstraint(enabled: boolean): void;
     markCameraChanged(): void;
     /**
-     * Perspective 뷰 줌: 마우스 커서 위치를 기준으로 확대/축소.
-     * orbit target 거리에서의 frustum 크기로 오프셋을 계산한다.
-     * oldCamZoom/newCamZoom: camera.zoom 단위 (state.zoom * 0.01)
+     * Perspective dolly zoom: 카메라를 target 방향으로 이동 (실제 거리 변화).
+     * projection zoom이 아닌 물리적 접근/후퇴로 자연스러운 3D 줌 제공.
+     * 커서 위치 기준 target 이동으로 커서 아래 월드 좌표가 고정된다.
+     * factor < 1: 가까이 (zoom in), factor > 1: 멀어짐 (zoom out)
      */
-    zoomPerspAtCursor(oldCamZoom: number, newCamZoom: number, ndcX: number, ndcY: number): void;
+    dollyAtCursor(factor: number, ndcX: number, ndcY: number): void;
     /**
      * 직교 뷰 줌: 마우스 커서 위치를 기준으로 확대/축소.
      * 커서 아래의 월드 좌표가 줌 후에도 동일한 화면 위치에 유지된다.
@@ -63,6 +76,12 @@ export declare class ControlsManager {
      */
     zoomOrthoAtCursor(factor: number, ndcX: number, ndcY: number): void;
     destroy(): void;
+    /**
+     * 뷰포트의 CSS 표시 크기를 반환한다.
+     * element의 getBoundingClientRect()를 우선 사용하되,
+     * element가 없거나 rect가 0x0이면 bounds로 폴백한다.
+     */
+    private _getViewportSize;
     private _handleRotateMove;
     private _handlePanMove;
     /**
@@ -71,6 +90,8 @@ export declare class ControlsManager {
      * deltaX/deltaY는 CSS 픽셀 단위이므로, DOM element의 실제 표시 크기를 분모로 사용한다.
      */
     private _panOrtho;
+    /** 픽셀 단위 패닝 (트랙패드 스크롤 등 외부 호출용) */
+    panByPixels(deltaX: number, deltaY: number): void;
     private _pan;
 }
 //# sourceMappingURL=controls-manager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"controls-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/controls-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,+BAA+B,CAAA;AAC1D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAY9B,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,KAAK,CAAC,CAAW;IAEzB,OAAO,CAAC,QAAQ,CAAO;IACvB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,UAAU,CAAI;IAGtB,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,OAAO,CAAsB;IAGrC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,UAAU,CAAsB;IAGxC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,SAAS,CAAsB;IAGvC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,eAAe,CAAyB;IAGhD,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,cAAc,CAAsB;IAE5C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAE1B;IAED,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO;IAMnC,+BAA+B;IAC/B,OAAO,KAAK,cAAc,GAEzB;IAED,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS;IAqB3C,UAAU,CAAC,OAAO,EAAE,OAAO;IAM3B,WAAW,CAAC,CAAC,EAAE,SAAS;IAkBxB,UAAU,CAAC,CAAC,EAAE,SAAS;IAevB,SAAS,CAAC,EAAE,EAAE,SAAS;IAQvB,YAAY,CAAC,CAAC,EAAE,UAAU;IA2B1B,WAAW,CAAC,CAAC,EAAE,UAAU;IAyBzB,UAAU,CAAC,EAAE,EAAE,UAAU;IAOzB,SAAS,CAAC,CAAC,EAAE,aAAa;IAgB1B,MAAM,IAAI,OAAO;IAgEjB,KAAK;IAUL,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM;IAmB9B,aAAa,CAAC,OAAO,EAAE,OAAO;IAK9B,iBAAiB;IAIjB;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAiBpF;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAoB5D,OAAO;IAOP,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,cAAc;IActB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IA0BjB,OAAO,CAAC,IAAI;CA6Bb"}
+{"version":3,"file":"controls-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/controls-manager.ts"],"names":[],"mappings":"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"}

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

@@ -13,7 +13,15 @@ export declare class EventManager3D {
     set lastHovered(value: IThreeRealObject | undefined);
     updateMouseNDC(px: number, py: number, left: number, top: number, width: number, height: number): void;
     getObjectByRaycast(camera: THREE.Camera, scene: THREE.Scene): THREE.Object3D | undefined;
+    /**
+     * Object3D의 전체 조상 체인이 visible인지 확인한다.
+     * Three.js raycaster는 visible을 자동으로 확인하지 않기 때문에 수동 필터링이 필요하다.
+     */
+    private _isWorldVisible;
     getObjectsByRaycast(camera: THREE.Camera, scene: THREE.Scene): THREE.Intersection[];
+    private _hudScene?;
+    private _hudCamera?;
+    setHUD(scene: THREE.Scene, camera: THREE.Camera): void;
     handleClick(camera: THREE.Camera, scene: THREE.Scene, event: MouseEvent): IThreeRealObject | undefined;
     handleHover(camera: THREE.Camera, scene: THREE.Scene, event: MouseEvent): void;
     destroy(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"event-manager3d.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/event-manager3d.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,YAAY,CAAC,CAAkB;IACvC,OAAO,CAAC,YAAY,CAAC,CAAkB;;IAIvC,IAAI,KAAK,kBAER;IAED,IAAI,WAAW,IAIQ,gBAAgB,GAAG,SAAS,CAFlD;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EAElD;IAED,IAAI,WAAW,IAIQ,gBAAgB,GAAG,SAAS,CAFlD;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EAElD;IAED,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK/F,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,GAAG,SAAS;IAmBxF,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,YAAY,EAAE;IAKnF,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,GAAG,gBAAgB,GAAG,SAAS;IAiBtG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU;IAiBvE,OAAO;CAIR"}
+{"version":3,"file":"event-manager3d.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/event-manager3d.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,YAAY,CAAC,CAAkB;IACvC,OAAO,CAAC,YAAY,CAAC,CAAkB;;IAIvC,IAAI,KAAK,kBAER;IAED,IAAI,WAAW,IAIQ,gBAAgB,GAAG,SAAS,CAFlD;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EAElD;IAED,IAAI,WAAW,IAIQ,gBAAgB,GAAG,SAAS,CAFlD;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EAElD;IAED,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK/F,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,GAAG,SAAS;IAsBxF;;;OAGG;IACH,OAAO,CAAC,eAAe;IASvB,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,YAAY,EAAE;IAMnF,OAAO,CAAC,SAAS,CAAC,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAc;IAEjC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM;IAK/C,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,GAAG,gBAAgB,GAAG,SAAS;IA0BtG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU;IAyBvE,OAAO;CAMR"}

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

@@ -26,6 +26,8 @@ export declare class GizmoManager {
     get attached(): THREE.Object3D<THREE.Object3DEventMap> | undefined;
     get isAttached(): boolean;
     get isDragging(): boolean;
+    /** true if a gizmo handle has focus — hovered (yellow) or dragging. axis stays non-null during drag. */
+    get isEngaged(): boolean;
     setup(camera: THREE.Camera, domElement: HTMLElement, scene: THREE.Scene): void;
     /**
      * things-scene 이벤트를 TransformControls의 프록시 element로 전달한다.
@@ -36,9 +38,13 @@ export declare class GizmoManager {
      * pointermove일 때 button을 -1로 설정해야 한다.
      */
     forwardEvent(e: MouseEvent, type: 'pointerdown' | 'pointermove' | 'pointerup'): void;
+    /** Touch event → PointerEvent 변환 후 기즈모에 전달 (iPad/모바일 지원) */
+    forwardTouch(touch: Touch, type: 'pointerdown' | 'pointermove' | 'pointerup'): void;
     setMode(mode: GizmoMode): void;
     attach(object: THREE.Object3D): void;
     detach(): void;
+    /** Shift 키에 따라 회전 스냅을 토글한다 (15° 단위) */
+    setRotationSnap(enabled: boolean): void;
     updateCamera(camera: THREE.Camera): void;
     destroy(): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"gizmo-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/gizmo-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAA;AAEpF,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAA;AAExD;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAC,CAAmB;IACrC,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAa;IACnC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,SAAS,CAAC,CAAgB;IAClC,OAAO,CAAC,WAAW,CAAQ;IAE3B,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAA;IACjD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAA;IACjD,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAA;IAE/C,IAAI,QAAQ,kCAA4B;IACxC,IAAI,IAAI,cAAwB;IAChC,IAAI,QAAQ,uDAA4B;IACxC,IAAI,UAAU,YAA8B;IAC5C,IAAI,UAAU,YAA8B;IAE5C,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK;IAoCvE;;;;;;;OAOG;IACH,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,WAAW;IAc7E,OAAO,CAAC,IAAI,EAAE,SAAS;IAKvB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ;IAW7B,MAAM;IAMN,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM;IAMjC,OAAO;CAgBR"}
+{"version":3,"file":"gizmo-manager.d.ts","sourceRoot":"","sources":["../../../src/threed/managers/gizmo-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAA;AAEpF,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAA;AAKxD;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAC,CAAmB;IACrC,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAa;IACnC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,SAAS,CAAC,CAAgB;IAClC,OAAO,CAAC,WAAW,CAAQ;IAE3B,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAA;IACjD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAA;IACjD,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAA;IAE/C,IAAI,QAAQ,kCAA4B;IACxC,IAAI,IAAI,cAAwB;IAChC,IAAI,QAAQ,uDAA4B;IACxC,IAAI,UAAU,YAA8B;IAC5C,IAAI,UAAU,YAA8B;IAC5C,wGAAwG;IACxG,IAAI,SAAS,YAAoC;IAEjD,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK;IAoCvE;;;;;;;OAOG;IACH,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,WAAW;IAmB7E,4DAA4D;IAC5D,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,WAAW;IAc5E,OAAO,CAAC,IAAI,EAAE,SAAS;IAKvB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ;IAW7B,MAAM;IAMN,uCAAuC;IACvC,eAAe,CAAC,OAAO,EAAE,OAAO;IAMhC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM;IAMjC,OAAO;CAgBR"}

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,17 @@ 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 _infoHostElement?;
+    private _dragStartPosition?;
     /**
      * mousedown 시 altKey를 캡처한다.
      * forwardEvent보다 먼저 호출되어야 한다.
@@ -37,21 +44,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,gBAAgB,CAAC,CAAa;IACtC,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;IAqBxB,OAAO,CAAC,kBAAkB;IA2C1B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,gBAAgB;CAOzB"}

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';
@@ -8,5 +8,8 @@ export { GizmoManager, type GizmoMode } from './gizmo-manager.js';
 export { GizmoOperationManager, type GizmoOperationHost } from './gizmo-operation-manager.js';
 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,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?;