@hatiolab/things-scene 10.0.0-beta.4 → 10.0.0-beta.41

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

@@ -0,0 +1,109 @@
+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 _isDragging;
+    private _isExtending;
+    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;
+    /**
+     * 3D 핸들 위치 → 2D path 포인트 역변환
+     */
+    private _handlePosToPoint;
+    /**
+     * mutatePath를 commander undo 지원과 함께 실행
+     */
+    private _execMutatePath;
+    /** 모든 핸들을 flat 배열로 반환 */
+    private _getAllHandles;
+    /** 컴포넌트에 속하는 ComponentHandles를 찾는다 */
+    private _findComponentHandles;
+    /**
+     * 마우스 다운: vertex/midpoint 핸들 raycast hit 감지 → 드래그 시작.
+     * @returns true이면 이벤트를 소비
+     */
+    onPointerDown(ndc: THREE.Vector2, camera: THREE.Camera, event: MouseEvent): boolean;
+    /**
+     * midpoint 핸들 드래그 시작: 세그먼트 중간에 새 vertex를 삽입
+     */
+    private _startMidpointDrag;
+    /**
+     * Alt+드래그 끝점: 끝에 새 vertex를 추가하고 드래그 시작
+     */
+    private _startEndpointExtend;
+    /**
+     * 카메라 방향 기반 드래그 평면 설정
+     */
+    private _setupDragPlane;
+    /**
+     * 마우스 이동: 드래그 중이면 핸들 이동.
+     */
+    onPointerMove(ndc: THREE.Vector2, camera: THREE.Camera, event: MouseEvent): boolean;
+    /**
+     * 현재 활성 컴포넌트의 vertex 핸들 위치로부터 Line2 geometry를 실시간 업데이트한다.
+     */
+    private _updateLinePreview;
+    /**
+     * 마우스 업: 드래그 종료 → component.mutatePath() 호출.
+     */
+    onPointerUp(): boolean;
+    /**
+     * 더블클릭: vertex 핸들 위에서 더블클릭하면 해당 vertex 삭제.
+     * @returns true이면 이벤트를 소비
+     */
+    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":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,SAAS,MAAM,+BAA+B,CAAA;AA2B1D;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAK;IAGxB,OAAO,CAAC,gBAAgB,CAAC,CAAW;IACpC,OAAO,CAAC,oBAAoB,CAAmB;IAC/C,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,aAAa,CAAsB;IAE3C,IAAI,UAAU,YAA8B;IAC5C,IAAI,UAAU,YAA+C;IAE7D,gCAAgC;IAChC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAMlC;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,GAAG,IAAI;IAqBlF,4BAA4B;IAC5B,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvE;;OAEG;IACH,MAAM,IAAI,IAAI;IAiBd;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2C9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAmBhC,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB,yBAAyB;IACzB,OAAO,CAAC,cAAc;IAQtB,sCAAsC;IACtC,OAAO,CAAC,qBAAqB;IAI7B;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IAgDnF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IA6BnF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,WAAW,IAAI,OAAO;IA+BtB;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO;IA8B7D;;OAEG;IACH,WAAW,IAAI,IAAI;IAMnB;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI;IAuB9C,OAAO,IAAI,IAAI;CAGhB"}

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

@@ -33,4 +33,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;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;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,oBAAoB,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAS7G"}

package/dist-types/threed/ratio-lock-utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 3축의 변화율 중 가장 큰 것을 기준으로 균일 비율을 반환한다.
+ * 모든 변화가 threshold 미만이면 null 반환 (변경 없음).
+ *
+ * @param ratios - [x, y, z] 각 축의 변화 비율 (1.0 = 변화 없음)
+ * @returns 균일 비율 또는 null
+ */
+export declare function getUniformRatio(ratios: [number, number, number]): number | null;
+//# sourceMappingURL=ratio-lock-utils.d.ts.map

package/dist-types/threed/ratio-lock-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratio-lock-utils.d.ts","sourceRoot":"","sources":["../../src/threed/ratio-lock-utils.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAW/E"}

package/dist-types/threed/real-object-dom-element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"real-object-dom-element.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-dom-element.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAA;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,qBAAa,oBAAqB,SAAQ,UAAU,CAAC,WAAW,CAAC;IAC/D,sCAAsC;IACtC,SAAS,KAAK,cAAc,WAE3B;IAED,SAAS,CAAC,mBAAmB;IAI7B;;;OAGG;IACH,IAAI,QAAQ;;;;MAQX;IAED;;OAEG;IACH,gBAAgB;IA0BhB,KAAK;IAeL,eAAe;IAWf,WAAW;CAUZ"}
+{"version":3,"file":"real-object-dom-element.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-dom-element.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAA;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,qBAAa,oBAAqB,SAAQ,UAAU,CAAC,WAAW,CAAC;IAC/D,sCAAsC;IACtC,SAAS,KAAK,cAAc,WAE3B;IAED,SAAS,CAAC,mBAAmB;IAI7B;;;OAGG;IACH,IAAI,QAAQ;;;;MAQX;IAED;;OAEG;IACH,gBAAgB;IAiChB,KAAK;IAeL,eAAe;IAWf,WAAW;CAUZ"}

package/dist-types/threed/real-object-extrude.d.ts

@@ -27,6 +27,12 @@ export declare class RealObjectExtrude extends RealObject {
     updateAlpha(): void;
     updateStrokeStyle(): void;
     updateFillStyle(): void;
+    updateText(): void;
+    /**
+     * cap 면(앞/뒤)에 fillStyle + 텍스트를 합성한 텍스처를 적용한다.
+     * 텍스트가 없으면 fillStyle만 적용한다.
+     */
+    private _applyCapTexture;
     updateDimension(): void;
 }
 //# sourceMappingURL=real-object-extrude.d.ts.map

package/dist-types/threed/real-object-extrude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"real-object-extrude.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-extrude.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAMhE;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,iBAAiB,CAAC,EAAE,gBAAgB,CAAA;IACpC,OAAO,CAAC,KAAK,CAAC,CAAY;IAE1B,KAAK;IAKL,IAAI,KAAK,IAAI,GAAG,CAEf;IAED,IAAI,gBAAgB,qBAInB;IAED,KAAK;IAoCL,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,cAAc;IAoBxD,eAAe,IAAI,KAAK,CAAC,QAAQ,EAAE;IAuBnC,aAAa;IAoCb,OAAO,CAAC,YAAY;IAMpB,gBAAgB;IAqBhB,WAAW;IAUX,iBAAiB;IAQjB,eAAe;IAiBf,eAAe;CAKhB"}
+{"version":3,"file":"real-object-extrude.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-extrude.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAOhE;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,iBAAiB,CAAC,EAAE,gBAAgB,CAAA;IACpC,OAAO,CAAC,KAAK,CAAC,CAAY;IAE1B,KAAK;IAKL,IAAI,KAAK,IAAI,GAAG,CAEf;IAED,IAAI,gBAAgB,qBAInB;IAED,KAAK;IAoCL,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,cAAc;IAoBxD,eAAe,IAAI,KAAK,CAAC,QAAQ,EAAE;IAcnC,aAAa;IAqBb,OAAO,CAAC,YAAY;IAMpB,gBAAgB;IAYhB,WAAW;IAUX,iBAAiB;IAQjB,eAAe;IAIf,UAAU;IAIV;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA4DxB,eAAe;CAKhB"}

package/dist-types/threed/real-object-gltf.d.ts

@@ -1,6 +1,7 @@
 import * as THREE from 'three';
 import type { Properties } from '../interfaces/types.js';
 import { RealObject } from './real-object.js';
+import { GLTF, GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 export interface GLTFNodeState {
     color?: string;
     visible?: boolean;
@@ -16,17 +17,54 @@ export interface GLTFAnimationState {
     loop?: 'once' | 'repeat' | 'pingpong';
 }
 export declare class RealObjectGLTF extends RealObject {
+    private static _topViewCache;
+    private static _gltfCache;
     private static _sharedLoader;
-    private static _getSharedLoader;
+    /**
+     * DRACO/KTX2/Meshopt/SpecGloss가 모두 설정된 공유 GLTFLoader를 반환한다.
+     * renderer를 전달하면 KTX2 detectSupport를 갱신한다.
+     * 2D 스냅샷 등 renderer 없이도 호출 가능하다.
+     */
+    static getSharedLoader(renderer?: THREE.WebGLRenderer): GLTFLoader;
+    /**
+     * URL로 GLTF를 로드한다. 동일 URL은 캐시하여 1회만 파싱한다.
+     * 로드 실패 시 캐시에서 제거하여 재시도 가능.
+     */
+    static loadGLTF(url: string, renderer?: THREE.WebGLRenderer): Promise<GLTF>;
     private pivot?;
-    private objectSize?;
+    private _objectSize?;
+    get objectSize(): THREE.Vector3 | undefined;
     private _nodeIndex;
     private _originals;
-    private _animationActions;
+    _animationActions: Map<string, THREE.AnimationAction>;
     private _fillStyleOriginals;
+    private _clonedMaterials;
+    /**
+     * mesh의 material이 아직 복제되지 않았으면 복제하여 독립 인스턴스로 만든다.
+     * GLTF 캐시로 인해 동일 소스의 오브젝트들이 material을 공유하므로,
+     * material을 변경하기 전에 반드시 호출해야 한다.
+     */
+    private _ensureOwnMaterial;
     private _loadGen;
     build(): void;
     private gltfLoaded;
+    private _renderTopViewSnapshot;
+    /**
+     * 오프스크린 렌더러로 Object3D의 탑뷰(Y축 위→아래) 스냅샷을 생성한다.
+     * GLTFObject에서 2D 모드 독립 로딩 시에도 사용한다.
+     */
+    static renderTopView(object: THREE.Object3D): HTMLCanvasElement;
+    /** 캐시에서 스냅샷을 조회한다 */
+    static getTopViewCache(source: string): HTMLCanvasElement | undefined;
+    /** 캐시에 스냅샷을 저장한다 */
+    static setTopViewCache(source: string, canvas: HTMLCanvasElement): void;
+    /**
+     * GLTF 파싱 캐시와 탑뷰 스냅샷 캐시를 모두 비운다.
+     * Scene(보드) 전환 시 호출하여 메모리를 회수한다.
+     * clone()은 geometry/texture를 공유 참조하므로,
+     * 모든 컴포넌트가 dispose된 후에만 호출해야 한다.
+     */
+    static flushCache(): void;
     private _buildNodeIndex;
     getNode(name: string): THREE.Object3D | undefined;
     get nodeNames(): string[];
@@ -40,9 +78,16 @@ export declare class RealObjectGLTF extends RealObject {
      */
     private _resetAllNodes;
     private _setupAnimations;
+    /**
+     * playTargets에 따라 해당 애니메이션만 재생.
+     * '*' → 전체, undefined/'none'/[] → 없음, [...] → 선택된 것만
+     * (fillStyleTargets와 동일한 규칙)
+     */
+    _playTargetAnimations(): void;
     private _applyAnimationStates;
     get animationNames(): string[];
     private _showErrorPlaceholder;
+    private _showEmptyPlaceholder;
     updateFillStyle(): void;
     private _restoreFillStyleTargets;
     clear(): THREE.Object3D<THREE.Object3DEventMap>;

package/dist-types/threed/real-object-gltf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"real-object-gltf.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-gltf.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAU7C,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;CACtC;AAQD,qBAAa,cAAe,SAAQ,UAAU;IAE5C,OAAO,CAAC,MAAM,CAAC,aAAa,CAA0B;IAEtD,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAyB/B,OAAO,CAAC,KAAK,CAAC,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAqC;IAGxD,OAAO,CAAC,UAAU,CAAoC;IAGtD,OAAO,CAAC,UAAU,CASd;IAGJ,OAAO,CAAC,iBAAiB,CAA2C;IAGpE,OAAO,CAAC,mBAAmB,CAKvB;IAGJ,OAAO,CAAC,QAAQ,CAAI;IAEpB,KAAK;IAiCL,OAAO,CAAC,UAAU;IAsDlB,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,GAAG,SAAS;IAIjD,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;IAID,OAAO,CAAC,gBAAgB;IAuCxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,qBAAqB;IA8B7B,IAAI,cAAc,IAAI,MAAM,EAAE,CAE7B;IAED,OAAO,CAAC,qBAAqB;IAU7B,eAAe;IA2Cf,OAAO,CAAC,wBAAwB;IA2BhC,KAAK;IAiBL,eAAe;IAUf,YAAY;IAIZ,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;CA0C/C"}
+{"version":3,"file":"real-object-gltf.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-gltf.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG7C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAA;AAO3E,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;CACtC;AAQD,qBAAa,cAAe,SAAQ,UAAU;IAE5C,OAAO,CAAC,MAAM,CAAC,aAAa,CAAuC;IAGnE,OAAO,CAAC,MAAM,CAAC,UAAU,CAAmC;IAG5D,OAAO,CAAC,MAAM,CAAC,aAAa,CAA0B;IAEtD;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,UAAU;IA2BlE;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3E,OAAO,CAAC,KAAK,CAAC,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAC,CAAqC;IAEzD,IAAI,UAAU,IAAI,KAAK,CAAC,OAAO,GAAG,SAAS,CAE1C;IAGD,OAAO,CAAC,UAAU,CAAoC;IAGtD,OAAO,CAAC,UAAU,CASd;IAGJ,iBAAiB,qCAA2C;IAG5D,OAAO,CAAC,mBAAmB,CAKvB;IAIJ,OAAO,CAAC,gBAAgB,CAAgC;IAExD;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,QAAQ,CAAI;IAEpB,KAAK;IAkCL,OAAO,CAAC,UAAU;IAmElB,OAAO,CAAC,sBAAsB;IAO9B;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,iBAAiB;IA8E/D,qBAAqB;IACrB,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIrE,oBAAoB;IACpB,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB;IAIhE;;;;;OAKG;IACH,MAAM,CAAC,UAAU;IAOjB,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,GAAG,SAAS;IAIjD,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;IAID,OAAO,CAAC,gBAAgB;IA0CxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,gBAAgB;IAqBxB;;;;OAIG;IACH,qBAAqB;IAarB,OAAO,CAAC,qBAAqB;IA8B7B,IAAI,cAAc,IAAI,MAAM,EAAE,CAE7B;IAED,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,qBAAqB;IA4B7B,eAAe;IA2Df,OAAO,CAAC,wBAAwB;IA2BhC,KAAK;IAiBL,eAAe;IAUf,YAAY;IAIZ,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;CA4C/C"}

package/dist-types/threed/real-object-line.d.ts

@@ -0,0 +1,81 @@
+import * as THREE from 'three';
+import { Line2 } from 'three/examples/jsm/lines/Line2.js';
+import { RealObject } from './real-object.js';
+import type { Properties } from '../interfaces/types.js';
+/**
+ * 선형 컴포넌트(line, polyline, path 등)를 3D에서 Line2(fat line)로 렌더링하는 베이스 클래스.
+ *
+ * RealObjectMesh, RealObjectExtrude와 동급의 추상 클래스.
+ * 서브클래스는 worldPath를 구현하여 컴포넌트별 좌표 변환 로직을 제공한다.
+ */
+export declare abstract class RealObjectLine extends RealObject<THREE.Group> {
+    protected _line2?: Line2;
+    /** 서브클래스가 오버라이드: 컴포넌트 path → 3D 로컬 좌표 배열 반환 */
+    abstract get worldPath(): THREE.Vector3[];
+    protected getObject3dInstance(): THREE.Group<THREE.Object3DEventMap>;
+    /** 선형 컴포넌트도 기즈모 변환 가능 — 결과를 path 좌표에 베이킹 */
+    get gizmoTransformable(): boolean;
+    /** 선형 컴포넌트는 볼륨이 없으므로 바닥면에 위치 */
+    protected get syncZPosOffset(): number;
+    /**
+     * 기즈모 드래그 중에는 컴포넌트 상태를 변경하지 않는다.
+     * object3d가 움직이면서 Line2가 함께 이동하므로 시각적으로는 정상.
+     * 드래그 종료 시 onGizmoDragEnd에서 일괄 베이킹한다.
+     */
+    syncFromObject3D(): void;
+    /**
+     * scale 기즈모 드래그 중에도 dimension 변경을 방지한다.
+     */
+    applyDimensionFromGizmo(_props: Record<string, number>): void;
+    build(): void;
+    /**
+     * round 속성을 적용하여 worldPath를 보간한 최종 positions을 반환한다.
+     */
+    protected get smoothedPath(): THREE.Vector3[];
+    protected _buildLine(): void;
+    /**
+     * 팁 오브젝트를 위치/회전/색상 설정하여 object3d에 추가한다.
+     */
+    private _placeTip;
+    private _getResolution;
+    /**
+     * 기즈모 드래그 종료 시 호출.
+     * object3d의 현재 transform(translate/rotate/scale)을
+     * path vertex 좌표에 베이킹하고, object3d transform을 리셋한다.
+     *
+     * 핵심: line/path 컴포넌트는 position/rotation/scale 속성을 갖지 않는다.
+     * 오직 vertex 좌표만으로 형태를 결정한다.
+     */
+    onGizmoDragEnd(_mode: string): void;
+    /**
+     * object3d의 transform matrix를 path vertex에 적용한 새 parent 좌표를 계산한다.
+     * 순수 함수로 추출하여 단위 테스트 가능.
+     *
+     * @param path - 컴포넌트 path (local coords, rotation=0이므로 parent coords와 동일)
+     * @param center - component.center (parent coords)
+     * @param parentSize - 부모 컨테이너의 bounds { width, height }
+     * @param object3d - 기즈모에 의해 변환된 Object3D
+     * @returns 새 path (parent coords)
+     */
+    static computeBakedPath(path: Array<{
+        x: number;
+        y: number;
+        z?: number;
+    }>, center: {
+        x: number;
+        y: number;
+    }, parentSize: {
+        width: number;
+        height: number;
+    }, object3d: THREE.Object3D): Array<{
+        x: number;
+        y: number;
+        z?: number;
+    }>;
+    updateStrokeStyle(): void;
+    updateAlpha(): void;
+    updateDimension(): void;
+    onchange(after: Properties, before: Properties): void;
+    clear(): THREE.Group<THREE.Object3DEventMap>;
+}
+//# sourceMappingURL=real-object-line.d.ts.map

package/dist-types/threed/real-object-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-object-line.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-line.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAA;AAKzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAyDxD;;;;;GAKG;AACH,8BAAsB,cAAe,SAAQ,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;IAClE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;IAExB,+CAA+C;IAC/C,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,EAAE,CAAA;IAEzC,SAAS,CAAC,mBAAmB;IAI7B,4CAA4C;IAC5C,IAAa,kBAAkB,IAAI,OAAO,CAEzC;IAED,gCAAgC;IAChC,SAAS,KAAK,cAAc,IAAI,MAAM,CAErC;IAED;;;;OAIG;IACM,gBAAgB,IAAI,IAAI;IAIjC;;OAEG;IACM,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAItE,KAAK;IAKL;;OAEG;IACH,SAAS,KAAK,YAAY,IAAI,KAAK,CAAC,OAAO,EAAE,CAqD5C;IAED,SAAS,CAAC,UAAU;IA0FpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAwCjB,OAAO,CAAC,cAAc;IAStB;;;;;;;OAOG;IACM,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAuC5C;;;;;;;;;OASG;IACH,MAAM,CAAC,gBAAgB,CACrB,IAAI,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EACjD,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAChC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAC7C,QAAQ,EAAE,KAAK,CAAC,QAAQ,GACvB,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAiC9C,iBAAiB;IAKjB,WAAW;IAIX,eAAe;IAKf,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;IAgB9C,KAAK;CAYN"}

package/dist-types/threed/real-object-mesh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"real-object-mesh.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-mesh.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG7C,8BAAsB,cAAe,SAAQ,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;IACjE,SAAS,CAAC,mBAAmB;IAI7B,KAAK;IASL,WAAW;IAMX,YAAY;IAIZ,eAAe;IAsBf,iBAAiB;IAuBjB,eAAe,IAAI,IAAI;IAqBvB,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,IAAI;IAExC,aAAa,IAAI,IAAI;IAerB,gBAAgB;IAiBhB,KAAK;CAKN"}
+{"version":3,"file":"real-object-mesh.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-mesh.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG7C,8BAAsB,cAAe,SAAQ,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;IACjE,SAAS,CAAC,mBAAmB;IAI7B,KAAK;IASL,WAAW;IAMX,YAAY;IAIZ,eAAe;IAsBf,iBAAiB;IAuBjB,eAAe,IAAI,IAAI;IAqBvB,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,IAAI;IAExC,aAAa,IAAI,IAAI;IAOrB,gBAAgB;IAShB,KAAK;CAKN"}

package/dist-types/threed/real-object-service.d.ts

@@ -0,0 +1,14 @@
+import * as THREE from 'three';
+import { RealObject } from './real-object.js';
+export declare class RealObjectService extends RealObject<THREE.Mesh> {
+    protected getObject3dInstance(): THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>;
+    build(): void;
+    updateAlpha(): void;
+    updateHidden(): void;
+    updateDimension(): void;
+    updateFillStyle(): void;
+    updateStrokeStyle(): void;
+    updateText(): void;
+    clear(): THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>;
+}
+//# sourceMappingURL=real-object-service.d.ts.map

package/dist-types/threed/real-object-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-object-service.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-service.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAM7C,qBAAa,iBAAkB,SAAQ,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;IAC3D,SAAS,CAAC,mBAAmB;IAI7B,KAAK;IAyBL,WAAW;IAOX,YAAY;IAIZ,eAAe;IAef,eAAe;IACf,iBAAiB;IACjB,UAAU;IAEV,KAAK;CAIN"}

package/dist-types/threed/real-object-text.d.ts

@@ -6,6 +6,8 @@ export declare class RealObjectText extends RealObjectMesh {
     /** 평면 오브젝트: 바닥(Y=0.5) 위로 올려 z-fighting 방지 */
     protected get syncZPosOffset(): number;
     buildGeometry(): void;
+    updateStrokeStyle(): void;
+    updateFillStyle(): void;
     updateDimension(): void;
     updateText(): void;
     updateAlpha(): void;

package/dist-types/threed/real-object-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"real-object-text.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-text.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAGtD;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAChD,6CAA6C;IAC7C,SAAS,KAAK,cAAc,WAE3B;IAED,aAAa;IAEb,eAAe;IAaf,UAAU;IAwCV,WAAW;CAOZ"}
+{"version":3,"file":"real-object-text.d.ts","sourceRoot":"","sources":["../../src/threed/real-object-text.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAGtD;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAChD,6CAA6C;IAC7C,SAAS,KAAK,cAAc,WAE3B;IAED,aAAa;IAKb,iBAAiB;IAEjB,eAAe;IAKf,eAAe;IAiBf,UAAU;IAyDV,WAAW;CASZ"}

package/dist-types/threed/real-object.d.ts

@@ -10,19 +10,22 @@ export declare abstract class RealObject<T extends THREE.Object3D = THREE.Object
     protected _suppressOnchange: boolean;
     object3d: T;
     private _onchangeWrapper;
-    static buildFillStyleTexture(component: Component): THREE.CanvasTexture<HTMLCanvasElement> | THREE.Texture<HTMLImageElement> | undefined;
-    private static buildGradientTexture;
+    static buildFillStyleTexture(component: Component): THREE.Texture<unknown> | undefined;
     constructor(component: Component);
     update(): void;
     protected getObject3dInstance(): T;
     build(): void;
     updateMaterial3d(): void;
+    private _applyShadow;
+    /** 기즈모(translate/rotate/scale)를 통한 변환이 가능한지 여부. 기본 true. */
+    get gizmoTransformable(): boolean;
     get component(): Component;
     get threeContainer(): ThreeDimensionalContainer | undefined;
     get focused(): boolean;
     set focused(focused: boolean);
     dispose(): void;
     clear(): T;
+    suppressTransform: boolean;
     /**
      * Component의 상태값의 변화를 Object3D에 반영 - translate, rotation, scale
      */
@@ -50,6 +53,13 @@ export declare abstract class RealObject<T extends THREE.Object3D = THREE.Object
         y: number;
         z: any;
     };
+    freezeDimension(): void;
+    unfreezeDimension(): void;
+    _frozenDimension?: {
+        width: number;
+        height: number;
+        depth: number;
+    };
     get dimension(): {
         width: number;
         height: number;
@@ -84,11 +94,21 @@ export declare abstract class RealObject<T extends THREE.Object3D = THREE.Object
      * 볼륨체(extrude): depth/2 (기하 중심), 평면(plane/text): depth (윗면 위치).
      */
     protected get syncZPosOffset(): number;
+    /**
+     * object3d 중심에서 텍스트 표면(상단)까지의 로컬 Y 오프셋.
+     * 볼륨체(extrude): depth/2, 평면(plane/text): 0.
+     */
+    get textSurfaceYOffset(): number;
     /**
      * 기즈모 드래그 결과를 컴포넌트 상태에 역변환하여 반영한다 (translate/rotate 모드 전용).
      * Object3D → Component 방향의 동기화. scale은 dimension으로 처리하므로 여기서는 제외.
      */
     syncFromObject3D(): void;
+    /**
+     * 기즈모 드래그 종료 시 호출. 서브클래스가 오버라이드하여
+     * 기즈모 결과를 컴포넌트 데이터에 베이킹할 수 있다.
+     */
+    onGizmoDragEnd(_mode: string): void;
     /**
      * scale 기즈모 드래그 결과를 dimension으로 역산하여 컴포넌트에 적용한다.
      * _suppressOnchange로 피드백 루프를 방지한다.

package/dist-types/threed/real-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"real-object.d.ts","sourceRoot":"","sources":["../../src/threed/real-object.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,wBAAwB,CAAA;AAM/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAA;AAO5E,8BAAsB,UAAU,CAAC,CAAC,SAAS,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAE,YAAW,WAAW;IAChG,SAAS,CAAC,UAAU,EAAE,SAAS,CAAA;IAC/B,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAQ;IACnC,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC7B,SAAS,CAAC,iBAAiB,UAAQ;IAE5B,QAAQ,EAAE,CAAC,CAAA;IAKlB,OAAO,CAAC,gBAAgB,CAGvB;IAED,MAAM,CAAC,qBAAqB,CAAC,SAAS,EAAE,SAAS;IA4BjD,OAAO,CAAC,MAAM,CAAC,oBAAoB;gBA8DvB,SAAS,EAAE,SAAS;IAOhC,MAAM;IAYN,SAAS,CAAC,mBAAmB,IAAI,CAAC;IAIlC,KAAK;IAQL,gBAAgB;IAOhB,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED,IAAI,cAAc,IAAI,yBAAyB,GAAG,SAAS,CAS1D;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,EAK3B;IAED,OAAO;IAMP,KAAK;IASL;;OAEG;IACH,eAAe;IAUf,IAAI,QAAQ;;;;MAOX;IAED,IAAI,QAAQ;;;;MAQX;IAED,IAAI,KAAK;;;;MAUR;IAED,IAAI,EAAE,WAML;IAED,IAAI,EAAE,WAML;IAED,IAAI,EAAE,QAKL;IAED,IAAI,MAAM;;;;MAWT;IAED,IAAI,SAAS;;;;MAOZ;IAED;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;IAGD,cAAc;IAKd,YAAY;IAKZ,WAAW;IAKX;;;;OAIG;IACH,kBAAkB;IAuClB,eAAe;IAKf,WAAW;IAoBX,YAAY;IAIZ,iBAAiB;IACjB,eAAe;IACf,UAAU;IAEV;;;OAGG;IACH;;;OAGG;IACH,SAAS,KAAK,cAAc,IAAI,MAAM,CAErC;IAED;;;OAGG;IACH,gBAAgB;IAuBhB;;;;OAIG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMrD,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;CAyC/C"}
+{"version":3,"file":"real-object.d.ts","sourceRoot":"","sources":["../../src/threed/real-object.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,wBAAwB,CAAA;AAK/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAA;AAQ5E,8BAAsB,UAAU,CAAC,CAAC,SAAS,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAE,YAAW,WAAW;IAChG,SAAS,CAAC,UAAU,EAAE,SAAS,CAAA;IAC/B,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAQ;IACnC,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC7B,SAAS,CAAC,iBAAiB,UAAQ;IAE5B,QAAQ,EAAE,CAAC,CAAA;IAKlB,OAAO,CAAC,gBAAgB,CAGvB;IAED,MAAM,CAAC,qBAAqB,CAAC,SAAS,EAAE,SAAS;gBAIrC,SAAS,EAAE,SAAS;IAOhC,MAAM;IAYN,SAAS,CAAC,mBAAmB,IAAI,CAAC;IAIlC,KAAK;IAOL,gBAAgB;IAMhB,OAAO,CAAC,YAAY;IAWpB,4DAA4D;IAC5D,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED,IAAI,cAAc,IAAI,yBAAyB,GAAG,SAAS,CAS1D;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,EAK3B;IAED,OAAO;IAMP,KAAK;IASL,iBAAiB,UAAQ;IAEzB;;OAEG;IACH,eAAe;IAqBf,IAAI,QAAQ;;;;MAOX;IAED,IAAI,QAAQ;;;;MAQX;IAED,IAAI,KAAK;;;;MAUR;IAED,IAAI,EAAE,WAML;IAED,IAAI,EAAE,WAML;IAED,IAAI,EAAE,QAKL;IAED,IAAI,MAAM;;;;MAWT;IAED,eAAe;IAIf,iBAAiB;IAIjB,gBAAgB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAEnE,IAAI,SAAS;eAFe,MAAM;gBAAU,MAAM;eAAS,MAAM;MAWhE;IAED;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;IAGD,cAAc;IAKd,YAAY;IAKZ,WAAW;IAKX;;;;OAIG;IACH,kBAAkB;IA6ClB,eAAe;IAKf,WAAW;IAoBX,YAAY;IAIZ,iBAAiB;IACjB,eAAe;IACf,UAAU;IAEV;;;OAGG;IACH;;;OAGG;IACH,SAAS,KAAK,cAAc,IAAI,MAAM,CAErC;IAED;;;OAGG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED;;;OAGG;IACH,gBAAgB;IA6BhB;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC;;;;OAIG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMrD,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;CA8C/C"}

package/dist-types/threed/text-editor-3d.d.ts

@@ -0,0 +1,11 @@
+import type Component from '../components/component.js';
+import type { RendererManager } from './managers/renderer-manager.js';
+/**
+ * 3D 텍스트 편집을 시작한다.
+ *
+ * - textarea를 CSS3DObject로 래핑하여 컴포넌트의 3D 위치에 배치
+ * - 편집 중 RealObjectText의 mesh를 숨겨 겹침 방지
+ * - 편집 완료(blur) 시 CSS3DObject 제거, mesh 복원, 텍스트 업데이트
+ */
+export declare function startTextEdit3D(component: Component, rendererManager: RendererManager, renderCallback: () => void): void;
+//# sourceMappingURL=text-editor-3d.d.ts.map

package/dist-types/threed/text-editor-3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-editor-3d.d.ts","sourceRoot":"","sources":["../../src/threed/text-editor-3d.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAErE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,MAAM,IAAI,GACzB,IAAI,CAkMN"}

package/dist-types/threed/texture/fillstyle-texture.d.ts

@@ -0,0 +1,37 @@
+import * as THREE from 'three';
+import type Component from '../../components/component.js';
+/**
+ * gradient fillStyle을 캔버스에 그려 반환한다.
+ * text-texture.ts의 텍스트+gradient 합성과 real-object.ts의 gradient 텍스처 모두 이 함수를 사용한다.
+ */
+export declare function drawGradientCanvas(fillStyle: {
+    gradientType?: string;
+    rotation?: number;
+    center?: string;
+    colorStops: {
+        position: number;
+        color: string;
+    }[];
+}, w: number, h: number): HTMLCanvasElement | null;
+/**
+ * 패턴 fillStyle을 2D 옵션(fitPattern, offset, align, repeat, color)에 맞춰
+ * 캔버스 텍스처로 생성한다. 이미지 로드 완료 후 component.invalidate()로 갱신.
+ */
+export declare function buildPatternTexture(component: Component, fillStyle: any): THREE.Texture;
+/**
+ * gradient fillStyle을 THREE.CanvasTexture로 생성한다.
+ */
+export declare function buildGradientTexture(fillStyle: {
+    gradientType?: string;
+    rotation?: number;
+    center?: string;
+    colorStops: {
+        position: number;
+        color: string;
+    }[];
+}): THREE.CanvasTexture | undefined;
+/**
+ * fillStyle 객체(pattern 또는 gradient)에 따라 적절한 텍스처를 생성한다.
+ */
+export declare function buildFillStyleTexture(component: Component): THREE.Texture | undefined;
+//# sourceMappingURL=fillstyle-texture.d.ts.map

package/dist-types/threed/texture/fillstyle-texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fillstyle-texture.d.ts","sourceRoot":"","sources":["../../../src/threed/texture/fillstyle-texture.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,SAAS,MAAM,+BAA+B,CAAA;AAG1D;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,EAC3H,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,iBAAiB,GAAG,IAAI,CAmC1B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,GAAG,KAAK,CAAC,OAAO,CAqGvF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,GAC1H,KAAK,CAAC,aAAa,GAAG,SAAS,CASjC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,KAAK,CAAC,OAAO,GAAG,SAAS,CAYrF"}

package/dist-types/threed/texture/text-texture.d.ts

@@ -1,7 +1,22 @@
 import * as THREE from 'three';
 export declare function fontStyle(bold: boolean, italic: boolean, fontSize: number, fontFamily: string): string;
+export declare function nextPowerOf2(n: number): number;
 export declare function drawTextTexture(canvas: HTMLCanvasElement, text: string, textStyle: any): void;
 export declare function textTexture(text: string, width: number, height: number, textStyle: any): THREE.CanvasTexture<HTMLCanvasElement>;
+/**
+ * 패턴(이미지) 배경 + 텍스트를 합성한 텍스처를 비동기로 생성한다.
+ * 2D fill.ts와 동일한 패턴 옵션을 지원한다:
+ *   fitPattern, width/height, offsetX/offsetY, align, noRepeat, color
+ *
+ * @param imageUrl  resolved 이미지 URL
+ * @param text      텍스트 (빈 문자열이면 텍스트 생략)
+ * @param compWidth  컴포넌트 너비
+ * @param compHeight 컴포넌트 높이
+ * @param textStyle  텍스트 스타일 (fontColor, fontSize 등)
+ * @param fillStyle  패턴 fillStyle 객체 (fitPattern, offsetX 등)
+ * @param onReady   텍스처 완성 콜백
+ */
+export declare function patternTextTexture(imageUrl: string, text: string, compWidth: number, compHeight: number, textStyle: any, fillStyle: any, onReady: (texture: THREE.CanvasTexture) => void): void;
 export declare function textBounds(text: string, textStyle: any): {
     width: number;
     height: number;

package/dist-types/threed/texture/text-texture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-texture.d.ts","sourceRoot":"","sources":["../../../src/threed/texture/text-texture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAUtG;AAiBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAYtF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,0CAwBtF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA0B1F"}
+{"version":3,"file":"text-texture.d.ts","sourceRoot":"","sources":["../../../src/threed/texture/text-texture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAUtG;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,UAerC;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QA+CtF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,0CAwCtF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,GAAG,EACd,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,GAC9C,IAAI,CAoGN;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA0B1F"}