@hatiolab/things-scene 9.0.2 → 10.0.0-beta.1

package/dist-types/threed/three-capability.d.ts

@@ -0,0 +1,325 @@
+import Component from '../components/component.js';
+import * as THREE from 'three';
+import { type ArrowStyle3D } from './arrow-3d.js';
+import { SceneManager, CameraManager, RendererManager, LightManager, ControlsManager, EventManager3D, GizmoManager, GizmoOperationManager, InteractionManager, PlacementManager, LightingConfig } from './managers/index.js';
+import type { CameraViewName } from './managers/index.js';
+/**
+ * ThreeCapability를 사용하는 호스트가 구현해야 하는 인터페이스.
+ * ThreeContainer와 ModelLayer 모두 이 인터페이스를 만족한다.
+ */
+export interface ThreeCapabilityHost {
+    readonly element: HTMLElement | null;
+    readonly components: Component[];
+    readonly state: Record<string, any>;
+    readonly bounds: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    readonly app: any;
+    readonly root: any;
+    invalidate(): void;
+    transcoordC2S?(x: number, y: number): {
+        x: number;
+        y: number;
+    };
+    getState?(key: string): any;
+    setState?(key: string, value: any): void;
+    set?(key: string | Record<string, any>, value?: any): void;
+    on?(name: string, callback: Function, context?: any): any;
+    off?(name?: string, callback?: Function, context?: any): any;
+}
+export interface CameraSessionState {
+    view: CameraViewName;
+    perspPosition?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    perspZoom?: number;
+    orbitTarget?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+/**
+ * 3D 렌더링 기능을 캡슐화한 컴포지션 클래스.
+ *
+ * ThreeContainer와 ModelLayer 모두에서 재사용 가능.
+ * 6개 매니저(Scene, Camera, Renderer, Light, Controls, Event)를 관리하고
+ * 3D 오브젝트 생성, 렌더링, 이벤트 처리를 담당한다.
+ */
+export declare class ThreeCapability {
+    protected sceneManager: SceneManager;
+    protected cameraManager: CameraManager;
+    protected rendererManager: RendererManager;
+    protected lightManager: LightManager;
+    protected controlsManager: ControlsManager;
+    protected eventManager: EventManager3D;
+    protected gizmoManager: GizmoManager;
+    protected interactionManager: InteractionManager;
+    protected placementManager: PlacementManager;
+    protected gizmoOperationManager: GizmoOperationManager;
+    private _host?;
+    private _clipboard?;
+    private _onFocus?;
+    private _redrawHandler?;
+    private _onComponentAdd?;
+    private _onComponentRemove?;
+    private _onSelectionChanged?;
+    private _onAddStart?;
+    private _onAddStop?;
+    private _initialized;
+    private _decoratorOutlines;
+    private _selectionOutlineObjects;
+    private _arrows;
+    private _resizeDebouncer?;
+    get isInitialized(): boolean;
+    get host(): ThreeCapabilityHost | undefined;
+    get scene3d(): THREE.Scene | undefined;
+    get renderer3d(): THREE.WebGLRenderer | undefined;
+    get mixer(): THREE.AnimationMixer | undefined;
+    get zoom(): number | undefined;
+    get camera(): THREE.PerspectiveCamera | undefined;
+    get activeCamera(): THREE.Camera;
+    get css3DScene(): THREE.Scene;
+    get css3DRenderer(): import("three/examples/jsm/renderers/CSS3DRenderer.js").CSS3DRenderer;
+    get noSupportWebgl(): boolean;
+    get isActive(): boolean;
+    /**
+     * 기즈모 모드를 변경하고 콜백을 호출한다.
+     */
+    onGizmoModeChanged?: (mode: 'translate' | 'rotate' | 'scale') => void;
+    onGizmoAttachChanged?: (isAttached: boolean) => void;
+    onCameraViewChanged?: (view: string) => void;
+    setGizmoMode(mode: 'translate' | 'rotate' | 'scale'): void;
+    get gizmoMode(): 'translate' | 'rotate' | 'scale';
+    /**
+     * 3D 씬을 초기화한다.
+     * host의 redraw 이벤트에 훅하고, 매니저들을 셋업한다.
+     */
+    init(host: ThreeCapabilityHost, options?: {
+        lightingConfig?: LightingConfig;
+        css3DSceneAttribute?: string;
+    }): void;
+    /**
+     * 이벤트 핸들러를 정리한다 (init/dispose에서 공용).
+     */
+    private _cleanupEventHandlers;
+    /**
+     * Scene, Camera, Renderer 등 모든 매니저를 셋업한다.
+     */
+    private _setupScene;
+    /**
+     * 기즈모 콜백을 등록한다.
+     * _setupScene()과 rebuildForHost()에서 공용으로 사용한다.
+     */
+    private _setupGizmoCallbacks;
+    /**
+     * 자식 컴포넌트들을 3D 오브젝트로 변환하여 씬에 추가한다.
+     * 컨테이너의 자식도 재귀적으로 처리한다.
+     */
+    createObjects(components: Component[]): void;
+    /**
+     * 단일 컴포넌트를 3D 오브젝트로 변환하여 씬에 추가한다.
+     * 컨테이너인 경우 자식 컴포넌트도 재귀적으로 처리하고, add/remove 이벤트를 구독한다.
+     */
+    addObject(component: Component): void;
+    /**
+     * 컴포넌트의 3D 오브젝트를 씬에서 제거하고 정리한다.
+     * 컨테이너인 경우 자식도 재귀적으로 제거한다.
+     */
+    removeObject(component: Component): void;
+    /**
+     * 렌더러 크기를 조정한다.
+     * 명시적 크기가 주어지면 그 값을, 아니면 호스트 bounds를 사용한다.
+     *
+     * 런타임 리사이즈(브라우저/패널 크기 변경)에서는 CSS 크기만 즉시 업데이트하여
+     * 기존 컨텐츠가 부드럽게 스케일되게 하고, 실제 버퍼 리사이즈 + 렌더는
+     * 디바운스하여 레이아웃이 안정된 후 1회만 수행한다.
+     *
+     * immediate=true (초기화 등)면 디바운스 없이 즉시 리사이즈 + 렌더한다.
+     */
+    resize(width?: number, height?: number, immediate?: boolean): void;
+    /**
+     * 실제 버퍼 리사이즈 + 렌더를 수행한다.
+     */
+    private _applyResize;
+    /**
+     * 매 프레임 애니메이션 업데이트.
+     */
+    animate(): void;
+    /**
+     * WebGL 씬을 렌더링한다.
+     */
+    renderThreeD(): void;
+    /**
+     * 카메라 뷰 프리셋을 전환한다.
+     * 'perspective': 기본 원근 투영 카메라 복귀
+     * 'top'/'front'/'back'/'right'/'left': 직교 투영 정사영 뷰
+     */
+    setCameraView(view: string, options?: {
+        render?: boolean;
+    }): void;
+    /**
+     * CSS3D 씬을 렌더링한다.
+     */
+    renderCSS3D(): void;
+    /**
+     * CSS3D 렌더러 DOM을 호스트 element에 부착한다.
+     */
+    buildOverlays(): void;
+    /**
+     * 모든 리소스를 정리한다.
+     */
+    destroy(): void;
+    /**
+     * 드래그 상태를 강제 정리한다.
+     * 모드 전환 시 드래그 진행 중이면 document capture 리스너가
+     * 고아가 되는 것을 방지한다.
+     */
+    forceCleanupDragState(): void;
+    /**
+     * 씬에서 모든 사용자 3D 오브젝트를 제거하되 인프라(Renderer, Camera, Scene, Controls)는 유지한다.
+     * Undo/Redo 시 호스트 교체 전에 호출하여 stale 오브젝트를 정리한다.
+     */
+    clearAllObjects(): void;
+    /**
+     * 호스트를 교체하고 새 컴포넌트들의 3D 오브젝트를 재생성한다.
+     * 인프라(Renderer, Camera, Scene, Controls)는 유지된 채 이벤트 리스너만 재등록한다.
+     */
+    rebuildForHost(newHost: ThreeCapabilityHost, options?: {
+        lightingConfig?: LightingConfig;
+        css3DSceneAttribute?: string;
+    }): void;
+    /**
+     * 완전히 해제한다 (redraw 이벤트 해제 포함).
+     * 호스트 컴포넌트들의 _realObject 참조도 정리하여
+     * 재활성화 시 3D 오브젝트가 다시 생성될 수 있도록 한다.
+     */
+    dispose(): void;
+    /**
+     * InteractionManager에 전달할 delegate 객체를 생성한다.
+     * arrow function으로 this(ThreeCapability)를 캡처하여
+     * 호스트 교체 후에도 올바른 인스턴스를 참조한다.
+     */
+    private _buildInteractionDelegate;
+    /**
+     * 클릭 처리: raycast로 오브젝트 선택.
+     * NDC는 InteractionManager가 이미 업데이트한 상태여야 한다.
+     */
+    private _handleClickAt;
+    /**
+     * Raycast로 마우스 아래의 3D 오브젝트를 찾는다.
+     */
+    getObjectByRaycast(): THREE.Object3D | undefined;
+    getObjectsByRaycast(): THREE.Intersection<THREE.Object3D<THREE.Object3DEventMap>>[] | undefined;
+    /**
+     * clientX/clientY → element-relative → NDC 통일 변환.
+     * 3D 렌더러는 DOM element 전체를 채우므로 element의 물리 좌표계만 사용한다.
+     * host.state의 논리 좌표나 transcoordC2S는 사용하지 않는다.
+     *
+     * 레거시 이벤트 핸들러(onMouseUp 등)에서 사용.
+     * DOM 직접 리스닝 경로는 InteractionManager.updateMouseNDCFromClient()를 사용한다.
+     */
+    private _updateMouseNDCFromClient;
+    /**
+     * 마우스 이벤트의 NDC 좌표를 업데이트한다.
+     * offsetX/offsetY는 이벤트 target에 상대적이라 CSS3D 자식 등에서 부정확할 수 있으므로
+     * clientX/clientY를 사용한다.
+     */
+    private _updateMouseNDC;
+    onMouseUp(e: MouseEvent): boolean;
+    onMouseMove(e: MouseEvent): boolean;
+    onMouseDown(e: MouseEvent): boolean;
+    onMouseLeave(_e: MouseEvent): boolean;
+    onWheel(e: WheelEvent): boolean;
+    onDblClick(e: MouseEvent): boolean;
+    onDragStart(e: DragEvent): boolean;
+    onDragMove(e: DragEvent): boolean;
+    onDragEnd(e: DragEvent): boolean;
+    onTouchStart(e: TouchEvent): boolean;
+    onPan(e: TouchEvent): boolean;
+    onTouchEnd(e: TouchEvent): boolean;
+    onKeyDown(e: KeyboardEvent): boolean;
+    onPinch(e: TouchEvent): boolean;
+    onDoubleTap(): void;
+    /**
+     * 현재 카메라 상태를 반환한다 (Inspector의 "Save Current View"용).
+     * cameraX/Y/Z는 setup()의 역변환으로 모델에 저장 가능한 상대값.
+     */
+    getCameraState(): {
+        view: string;
+        zoom: number;
+        cameraX: number;
+        cameraY: number;
+        cameraZ: number;
+    } | null;
+    captureSessionState(): CameraSessionState;
+    restoreSessionState(state: CameraSessionState): void;
+    /**
+     * 상태 변경을 3D 씬에 반영한다.
+     * width/height 처리는 호스트별로 다르므로 여기서는 하지 않는다:
+     *   - ThreeContainer: destroy → postrender에서 reinit
+     *   - ModelLayer: _resizeThreeD()로 표시 크기에 맞춤
+     */
+    onchange(after: Record<string, any>): void;
+    /**
+     * WebGL 렌더러의 DOM element를 가져온다 (ctx.drawImage에 사용).
+     */
+    get domElement(): HTMLCanvasElement | undefined;
+    /**
+     * 렌더러의 현재 크기를 반환한다.
+     */
+    getRendererSize(): {
+        width: number;
+        height: number;
+    };
+    /**
+     * WebGL 미지원 텍스트를 2D context에 그린다.
+     */
+    showWebglNoSupportText(context: CanvasRenderingContext2D, width: number, height: number): void;
+    /**
+     * 디버그 FPS를 2D context에 그린다.
+     */
+    showDebugFPS(context: CanvasRenderingContext2D): void;
+    addOutline(component: Component): void;
+    removeOutline(component: Component): void;
+    clearOutlines(): void;
+    /**
+     * 두 컴포넌트 사이에 3D 화살표를 추가한다.
+     * @param id 화살표 식별자 (제거 시 사용)
+     * @param from 출발 컴포넌트
+     * @param to 도착 컴포넌트
+     * @param style 화살표 스타일 옵션
+     */
+    addArrow(id: string, from: Component, to: Component, style?: ArrowStyle3D): void;
+    /**
+     * ID로 3D 화살표를 제거한다.
+     */
+    removeArrow(id: string): void;
+    /**
+     * 모든 3D 화살표를 제거한다.
+     */
+    clearArrows(): void;
+    /**
+     * 기존 화살표의 위치를 업데이트한다 (컴포넌트 이동 시).
+     */
+    updateArrow(id: string, from: Component, to: Component): void;
+    private _getArrowStyle;
+    /**
+     * 편집모드 선택 아웃라인과 데코레이터 아웃라인을 합집합하여 OutlinePass에 설정한다.
+     */
+    private _syncOutlinePass;
+    /**
+     * root.selected 변경에 따라 기즈모를 부착/해제한다.
+     */
+    private _handleSelectionChanged;
+    /**
+     * 선택된 컴포넌트들의 object3d를 저장하고 _syncOutlinePass로 합산한다.
+     */
+    private _updateSelectionOutline;
+}
+//# sourceMappingURL=three-capability.d.ts.map

package/dist-types/threed/three-capability.d.ts.map

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

package/dist-types/threed/three-container.d.ts

@@ -0,0 +1,58 @@
+import Component from '../components/component.js';
+import Container from '../components/container.js';
+import type { ComponentNature, Properties } from '../interfaces/types.js';
+import * as THREE from 'three';
+import './three-layout.js';
+import { ThreeDimensionalContainer } from './three-dimensional-container.js';
+import { ThreeCapability } from './three-capability.js';
+import type { LightingConfig } from './managers/index.js';
+import type { SceneManager, CameraManager, RendererManager, LightManager, ControlsManager, EventManager3D } from './managers/index.js';
+export declare class ThreeContainer extends Container implements ThreeDimensionalContainer {
+    protected _capability: ThreeCapability;
+    /** @deprecated 하위 호환용 — ThreeCapability 내부 매니저 직접 접근. 새 코드에서는 _capability를 사용하세요. */
+    protected get sceneManager(): SceneManager;
+    protected get cameraManager(): CameraManager;
+    protected get rendererManager(): RendererManager;
+    protected get lightManager(): LightManager;
+    protected get controlsManager(): ControlsManager;
+    protected get eventManager(): EventManager3D;
+    containable(component: Component): boolean;
+    is3dContainer(): boolean;
+    protected getLightingConfig(): LightingConfig;
+    protected getCss3DSceneAttribute(): string | undefined;
+    init_scene3d(): void;
+    destroy_scene3d(): void;
+    stop(): void;
+    resize(): void;
+    get scene3d(): THREE.Scene | undefined;
+    get renderer3d(): THREE.WebGLRenderer | undefined;
+    get mixer(): THREE.AnimationMixer | undefined;
+    get zoom(): number | undefined;
+    get css3DScene(): THREE.Scene;
+    get css3DRenderer(): import("three/examples/jsm/renderers/CSS3DRenderer.js").CSS3DRenderer;
+    render_threed(): void;
+    render(ctx: CanvasRenderingContext2D): void;
+    postrender(ctx: CanvasRenderingContext2D): void;
+    dispose(): void;
+    get layout(): any;
+    get nature(): ComponentNature;
+    getObjectByRaycast(): THREE.Object3D | undefined;
+    getObjectsByRaycast(): THREE.Intersection<THREE.Object3D<THREE.Object3DEventMap>>[] | undefined;
+    onchange(after: Properties, before: Properties): void;
+    onmousedown(e: MouseEvent): void;
+    onmouseup(e: MouseEvent): void;
+    onmousemove(e: MouseEvent): void;
+    onmouseleave(e: MouseEvent): void;
+    onwheel(e: WheelEvent): void;
+    ondblclick(e: MouseEvent): void;
+    ondragstart(e: DragEvent): void;
+    ondragmove(e: DragEvent): void;
+    ondragend(e: DragEvent): void;
+    ontouchstart(e: TouchEvent): void;
+    onpan(e: TouchEvent): void;
+    ontouchend(e: TouchEvent): void;
+    onkeydown(e: KeyboardEvent): void;
+    onpinch(e: TouchEvent): void;
+    ondoubletap(): void;
+}
+//# sourceMappingURL=three-container.d.ts.map

package/dist-types/threed/three-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-container.d.ts","sourceRoot":"","sources":["../../src/threed/three-container.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAClD,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAGlD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,mBAAmB,CAAA;AAC1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAA;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AA2BtI,qBACa,cAAe,SAAQ,SAAU,YAAW,yBAAyB;IAChF,SAAS,CAAC,WAAW,kBAAwB;IAE7C,qFAAqF;IACrF,SAAS,KAAK,YAAY,IAAI,YAAY,CAA4C;IACtF,SAAS,KAAK,aAAa,IAAI,aAAa,CAA6C;IACzF,SAAS,KAAK,eAAe,IAAI,eAAe,CAA+C;IAC/F,SAAS,KAAK,YAAY,IAAI,YAAY,CAA4C;IACtF,SAAS,KAAK,eAAe,IAAI,eAAe,CAA+C;IAC/F,SAAS,KAAK,YAAY,IAAI,cAAc,CAA4C;IAExF,WAAW,CAAC,SAAS,EAAE,SAAS;IAIhC,aAAa;IAIb,SAAS,CAAC,iBAAiB,IAAI,cAAc;IAM7C,SAAS,CAAC,sBAAsB,IAAI,MAAM,GAAG,SAAS;IAItD,YAAY;IAgBZ,eAAe;IAKf,IAAI;IAEJ,MAAM;IAMN,IAAI,OAAO,4BAKV;IAED,IAAI,UAAU,oCAEb;IAED,IAAI,KAAK,qCAER;IAED,IAAI,IAAI,uBAEP;IAED,IAAI,UAAU,gBAEb;IAED,IAAI,aAAa,0EAEhB;IAED,aAAa;IAMb,MAAM,CAAC,GAAG,EAAE,wBAAwB;IAepC,UAAU,CAAC,GAAG,EAAE,wBAAwB;IAiCxC,OAAO;IAKP,IAAI,MAAM,IAAI,GAAG,CAEhB;IAED,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,kBAAkB,IAAI,KAAK,CAAC,QAAQ,GAAG,SAAS;IAIhD,mBAAmB;IAMnB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;IAS9C,WAAW,CAAC,CAAC,EAAE,UAAU;IAIzB,SAAS,CAAC,CAAC,EAAE,UAAU;IAIvB,WAAW,CAAC,CAAC,EAAE,UAAU;IAIzB,YAAY,CAAC,CAAC,EAAE,UAAU;IAI1B,OAAO,CAAC,CAAC,EAAE,UAAU;IAIrB,UAAU,CAAC,CAAC,EAAE,UAAU;IAIxB,WAAW,CAAC,CAAC,EAAE,SAAS;IAIxB,UAAU,CAAC,CAAC,EAAE,SAAS;IAIvB,SAAS,CAAC,CAAC,EAAE,SAAS;IAItB,YAAY,CAAC,CAAC,EAAE,UAAU;IAI1B,KAAK,CAAC,CAAC,EAAE,UAAU;IAInB,UAAU,CAAC,CAAC,EAAE,UAAU;IAIxB,SAAS,CAAC,CAAC,EAAE,aAAa;IAI1B,OAAO,CAAC,CAAC,EAAE,UAAU;IAIrB,WAAW;CAGZ"}

package/dist-types/threed/three-dimensional-container.d.ts

@@ -0,0 +1,9 @@
+import type { Scene, WebGLRenderer, AnimationMixer } from 'three';
+export interface ThreeDimensionalContainer {
+    is3dContainer(): boolean;
+    get scene3d(): Scene | undefined;
+    get renderer3d(): WebGLRenderer | undefined;
+    get mixer(): AnimationMixer | undefined;
+    get zoom(): number | undefined;
+}
+//# sourceMappingURL=three-dimensional-container.d.ts.map

package/dist-types/threed/three-dimensional-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-dimensional-container.d.ts","sourceRoot":"","sources":["../../src/threed/three-dimensional-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAEjE,MAAM,WAAW,yBAAyB;IACxC,aAAa,IAAI,OAAO,CAAA;IACxB,IAAI,OAAO,IAAI,KAAK,GAAG,SAAS,CAAA;IAChC,IAAI,UAAU,IAAI,aAAa,GAAG,SAAS,CAAA;IAC3C,IAAI,KAAK,IAAI,cAAc,GAAG,SAAS,CAAA;IACvC,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAAA;CAC/B"}

package/dist-types/threed/three-layout.d.ts

@@ -0,0 +1,10 @@
+import type Component from '../components/component.js';
+import type Container from '../components/container.js';
+declare const ThreeLayout: {
+    reflow: (container: Container) => void;
+    capturables: (container: Container) => Component[];
+    drawables: (container: Container) => Component[];
+    isStuck: (component: Component) => boolean;
+};
+export default ThreeLayout;
+//# sourceMappingURL=three-layout.d.ts.map

package/dist-types/threed/three-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-layout.d.ts","sourceRoot":"","sources":["../../src/threed/three-layout.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AACvD,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AAIvD,QAAA,MAAM,WAAW;wBACc,SAAS;6BAEJ,SAAS;2BAIX,SAAS;yBAIX,SAAS;CAGxC,CAAA;AAID,eAAe,WAAW,CAAA"}

package/dist-types/threed/utils/bound-uv-generator.d.ts

@@ -0,0 +1,17 @@
+import * as THREE from 'three';
+type ExtrudedOptions = {
+    depth: number;
+};
+export declare class BoundUVGenerator {
+    bb?: THREE.Box2;
+    extrudedShape?: THREE.Shape;
+    extrudedOptions?: ExtrudedOptions;
+    setShape({ extrudedShape, extrudedOptions }: {
+        extrudedShape: THREE.Shape;
+        extrudedOptions: ExtrudedOptions;
+    }): void;
+    generateTopUV(geometry: THREE.BufferGeometry, vertices: number[], indexA: number, indexB: number, indexC: number): THREE.Vector2[];
+    generateSideWallUV(geometry: THREE.BufferGeometry, vertices: number[], indexA: number, indexB: number, indexC: number, indexD: number): THREE.Vector2[];
+}
+export {};
+//# sourceMappingURL=bound-uv-generator.d.ts.map

package/dist-types/threed/utils/bound-uv-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bound-uv-generator.d.ts","sourceRoot":"","sources":["../../../src/threed/utils/bound-uv-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,qBAAa,gBAAgB;IAC3B,EAAE,CAAC,EAAE,KAAK,CAAC,IAAI,CAAA;IACf,aAAa,CAAC,EAAE,KAAK,CAAC,KAAK,CAAA;IAC3B,eAAe,CAAC,EAAE,eAAe,CAAA;IAEjC,QAAQ,CAAC,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE;QAAE,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC;QAAC,eAAe,EAAE,eAAe,CAAA;KAAE;IAQ7G,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAkBhH,kBAAkB,CAChB,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;CAoCjB"}

package/dist-types/threed/utils/dispose.d.ts

@@ -0,0 +1,3 @@
+import * as THREE from 'three';
+export declare function disposeObject3D(obj: THREE.Object3D): void;
+//# sourceMappingURL=dispose.d.ts.map

package/dist-types/threed/utils/dispose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispose.d.ts","sourceRoot":"","sources":["../../../src/threed/utils/dispose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAwB9B,wBAAgB,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,QAQlD"}

package/dist-types/threed/utils/project.d.ts

@@ -0,0 +1,11 @@
+import Component from '../../components/component.js';
+/**
+ * 컴포넌트의 로컬 좌표를 스크린 픽셀 좌표로 변환한다.
+ * 3D 모드: object3d 월드 좌표 → 카메라 투영 → 픽셀
+ * 2D 모드: toGlobal() 사용
+ */
+export declare function projectToScreen(component: Component, localX: number, localY: number): {
+    x: number;
+    y: number;
+} | null;
+//# sourceMappingURL=project.d.ts.map

package/dist-types/threed/utils/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/threed/utils/project.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,+BAA+B,CAAA;AAErD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuBjC"}

package/dist-types/types/bounding.d.ts

@@ -0,0 +1,52 @@
+export type Position = 'static' | 'absolute' | 'relative';
+export interface Bounds {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/**
+ * Defines the alignment anchor point for positioning.
+ * The origin is used to determine how the offset applies.
+ */
+export type Origin = 'left-top' | 'left-middle' | 'left-bottom' | 'center-top' | 'center-middle' | 'center-bottom' | 'right-top' | 'right-middle' | 'right-bottom';
+/**
+ * Represents a 2D point in space.
+ */
+export interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * Describes a path-based geometry composed of multiple points.
+ */
+export type Path = Point[];
+/**
+ * Defines how a component's position and size are calculated and represented.
+ * This interface is the canonical source of bounding geometry, used by rendering, layout, and interaction systems.
+ */
+export interface Bounding {
+    /** Anchor point used to interpret the offset. */
+    origin: Origin;
+    /** X offset from the origin anchor. */
+    offsetX: number;
+    /** Y offset from the origin anchor. */
+    offsetY: number;
+    /** Full rectangular bounds, computed from origin, offset, and size. */
+    bounds: Bounds;
+    /** Center point of the bounds. */
+    center: Point;
+    /** (Optional) Path used for custom-shaped components. */
+    path?: Path;
+    /** Repositions the component to the given absolute position (based on origin). */
+    moveTo(x: number, y: number): void;
+    /** Resizes the component. */
+    resize(width: number, height: number): void;
+    /** Applies a bounding box and internally adjusts offset + size accordingly. */
+    applyBounds(bounds: Bounds): void;
+    /** Calculates current bounds based on offset and origin. */
+    computeBounds(): Bounds;
+    /** Computes bounds from path geometry, if applicable. */
+    computeBoundsFromPath?(): Bounds;
+}
+//# sourceMappingURL=bounding.d.ts.map

package/dist-types/types/bounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounding.d.ts","sourceRoot":"","sources":["../../src/types/bounding.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAA;AAEzD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GACd,UAAU,GACV,aAAa,GACb,aAAa,GACb,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,GACX,cAAc,GACd,cAAc,CAAA;AAElB;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,EAAE,CAAA;AAE1B;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAA;IAEd,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;IAEf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;IAEf,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAA;IAEd,kCAAkC;IAClC,MAAM,EAAE,KAAK,CAAA;IAEb,yDAAyD;IACzD,IAAI,CAAC,EAAE,IAAI,CAAA;IAEX,kFAAkF;IAClF,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAElC,6BAA6B;IAC7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3C,+EAA+E;IAC/E,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAEjC,4DAA4D;IAC5D,aAAa,IAAI,MAAM,CAAA;IAEvB,yDAAyD;IACzD,qBAAqB,CAAC,IAAI,MAAM,CAAA;CACjC"}