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

package/dist-types/things-scene/scene.d.ts

@@ -1,11 +1,57 @@
 import animate from '../animation/animate.js';
+import * as API from './api/index.js';
+import type { LoadTracker } from '../diagnostics/load-tracker.js';
+import { LoadingOverlay } from '../diagnostics/loading-overlay.js';
+import { SearchOverlay } from '../search/search-overlay.js';
+import { Tracker, type TrackerOptions } from '../tracker/tracker.js';
 /**
- * 화면(scene) 객체
+ * The top-level API object for things-scene, managing the full lifecycle of a visual board:
+ * creation, rendering (2D Canvas + 3D Three.js), interaction, and disposal.
+ *
+ * Created via the `create()` factory function.
+ *
+ * @example
+ * ```ts
+ * import { create, SCENE_MODE } from '@hatiolab/things-scene'
+ *
+ * const scene = create({
+ *   target: document.getElementById('board'),
+ *   model: JSON.parse(boardJson),
+ *   mode: SCENE_MODE.VIEW,
+ *   handlers: ['zoom-handler', 'shift-handler']
+ * })
+ *
+ * scene.data = { sensor1: { value: 42 } }  // data binding
+ * scene.dispose()                            // cleanup
+ * ```
  */
 declare class Scene {
     _container: any;
     _commander: any;
     app: any;
+    private _searchOverlay;
+    private _tracker?;
+    /**
+     * SearchOverlay 의 VIEW 모드 동작에 영향. Tracker 옵션 (color, fallback,
+     * fallbackColor, intervalMs) 을 application 이 제공. SearchOverlay 가 자동
+     * tracker.start 호출 시 이 옵션 사용.
+     */
+    trackerOptions?: TrackerOptions;
+    /**
+     * SearchOverlay 의 query-submit 시 호출되는 application override hook.
+     * - 반환 true: SearchOverlay 의 디폴트 동작 (자동 tracker.start) skip — application 이 모든 처리.
+     * - 반환 false/void: 디폴트 진행 (tracker.start 자동 호출).
+     * 미지정 시 디폴트 진행. application 은 폴백만 제공할 수도, 완전 override 할 수도.
+     */
+    onSearchSubmit?: (detail: any, scene: any) => boolean | void;
+    /**
+     * SearchOverlay close 시 호출되는 application override hook.
+     * 반환 true 시 디폴트 (tracker.stop) skip.
+     */
+    onSearchClose?: (scene: any) => boolean | void;
+    private _loadingOverlay;
+    onDataBindingToggle?: () => void;
+    onMonitorToggle?: () => void;
     static get residents(): number;
     static get residentsCount(): number;
     /**
@@ -13,11 +59,19 @@ declare class Scene {
      * @param {RootContainer} container - Root container
      */
     constructor(container: any);
+    /**
+     * Add one or more component models to the scene (undoable).
+     * @param models - A model or array of models to add.
+     * @param boundsOrOffset - Optional target bounds, or an `{x, y}` offset.
+     * @param onto - Optional target container to add into.
+     */
     add(models: any, boundsOrOffset?: any, onto?: any): void;
+    /** Duplicate the current selection (undoable). */
     duplicate(): void;
+    /** Remove the current selection (undoable). */
     remove(): void;
     animate(config: Parameters<typeof animate>[0]): import("./index.js").AnimationController;
-    fullscreen(fit?: any): void;
+    fullscreen(fit?: string): void;
     get target(): any;
     set target(target: any);
     get scale(): any;
@@ -33,11 +87,23 @@ declare class Scene {
     get screen(): any;
     set screen(size: any);
     resize(): void;
+    /** Alias for {@link dispose}. */
     release(): void;
+    /**
+     * Tear down the scene and release all resources — container, commander, overlays,
+     * tracker, 3D GLTF caches, and the global transfer log. Call this on board switch or
+     * unmount to avoid leaks. The scene must not be used after disposal.
+     */
     dispose(): void;
+    /** The currently selected components, as a snapshot array (safe to iterate/mutate). */
     get selected(): any;
     set selected(selected: any);
-    select(selector: any, ...others: any[]): any;
+    /**
+     * Select all components matching a selector, replacing the current selection.
+     * @param selector - A CSS-like selector (by type, id, class, etc.).
+     * @returns The resulting selection.
+     */
+    select(selector: string, ...others: any[]): any;
     get commander(): any;
     undo(): void;
     undoable(): any;
@@ -47,52 +113,161 @@ declare class Scene {
     hasUnpreservedChanges(): any;
     cut(): string | undefined;
     copy(): string | undefined;
-    paste(copied?: any): void;
+    paste(copied?: string): void;
     undoableChange(changeFunc?: any): void;
-    change(selector: any, value?: any, self?: any): any;
+    change(selector: string, value?: any, self?: any): any;
+    /**
+     * The scene's model as a plain, serializable component tree (volatile props stripped,
+     * numbers rounded). Assigning a new model rebuilds the entire scene content.
+     */
     get model(): any;
     set model(model: any);
     get rootContainer(): any;
     get root(): any;
-    findAll(selector: any, ...others: any[]): any;
-    findFirst(selector: any, ...others: any[]): any;
-    findById(id: any): any;
-    findAllById(id: any): any;
+    /** Find all components matching a CSS-like selector. */
+    findAll(selector: string, ...others: any[]): any;
+    /** Find the first component matching a CSS-like selector, or `undefined`. */
+    findFirst(selector: string, ...others: any[]): any;
+    /** Find the first component with the given `id`. */
+    findById(id: string): any;
+    /** Find all components sharing the given `id`. */
+    findAllById(id: string): any;
     serialize(): any;
-    align(type: any): void;
-    place(type: any): void;
-    distribute(type: any): void;
-    move(component?: any, to_container?: any, to_index?: any): void;
-    zorder(type: any): void;
+    align(type: string): void;
+    place(type: string): void;
+    distribute(type: string): void;
+    move(component?: any, to_container?: any, to_index?: number): void;
+    zorder(type: string): void;
     symmetryX(): void;
     symmetryY(): void;
-    on(event: any, listener: any, context?: any): void;
-    once(event: any, listener: any, context?: any): void;
-    off(event?: any, listener?: any, context?: any): any;
-    centerTo(component: any, animated?: any): any;
+    on(event: string, listener: any, context?: any): void;
+    once(event: string, listener: any, context?: any): void;
+    off(event?: string, listener?: any, context?: any): any;
+    centerTo(component: any, animated?: boolean): any;
+    /**
+     * 영구 추적 모듈. 단일 추적 — 한 번에 하나의 id 만 추적. 트리에서 매칭 컴포넌트가
+     * dispose/재등장 사이클을 타도 자동 재부착. 2D 는 deco-border, 3D 는 outline 으로
+     * 같은 색깔 시각화. 자세한 사용법은 Tracker 클래스 참고.
+     */
+    get tracker(): Tracker;
+    /**
+     * Scene mode: `MODE_VIEW` (0) for monitoring / runtime, `MODE_EDIT` (1) for the modeller.
+     * Switching mode changes interaction (selection, gizmos) and rendering behavior.
+     */
     get mode(): any;
     set mode(mode: any);
-    toDataURL(type?: any, encoderOptions?: any, width?: any, height?: any): Promise<unknown>;
+    /**
+     * 3D 기능을 쓸 수 있는지 — 프로세스 전역 스위치(setThreedEnabled)를 반영한다.
+     * false 이면 3D 는 전혀 켜지지 않는다. 인스턴스별로 다르지 않다.
+     */
+    get threedEnabled(): boolean;
+    /** 마퀴(영역) 선택 드래그 진행 중 여부 — 드래그 중 외부 UI 갱신 억제용. */
+    get isSelecting(): boolean;
+    get focusFilter(): ((component: any) => boolean) | undefined;
+    /**
+     * 포커스 필터 설정 — 반환 false 컴포넌트는 편집 모드에서 dim + pick 제외.
+     * 모델·저장물·undo 와 무관(transient). 설정 시 즉시 리드로우(2D). 3D 는 별도 갱신.
+     */
+    set focusFilter(filter: ((component: any) => boolean) | undefined);
+    /**
+     * 포커스 필터 변경 시 모델링 흐림(faint)을 canvas 외 채널(3D material, HTML DOM)에 즉시 재적용.
+     * canvas 는 invalidate 리드로우로 draw() 가 처리하지만, 3D material·DOM opacity 는 렌더 루프
+     * 밖이라 별도로 훑어 재적용한다. 재빌드 없이 opacity 스케일만 — 해당 채널을 가진 컴포넌트에만.
+     */
+    private _reapplyModelingFaint;
+    toDataURL(type?: string, encoderOptions?: any, width?: number, height?: number): Promise<unknown>;
     group(): void;
     ungroup(): void;
-    fit(type?: any): void;
+    fit(type?: string): void;
     get fitMode(): any;
-    get ids(): any[];
+    /** All component `id`s in the scene, as a snapshot array. */
+    get ids(): {
+        key: any;
+        value: any;
+    }[];
+    /**
+     * Live data binding — the core mechanism for driving a scene from real-time data.
+     *
+     * Assigning a map propagates values into components by their `id`; each component's
+     * data mappings then update its visual state (color, text, animation, etc.). This is
+     * the primary way a monitoring dashboard reflects sensor / device data.
+     *
+     * @example
+     * ```ts
+     * scene.data = { conveyor1: { running: true }, gauge2: { value: 73 } }
+     * ```
+     */
     get data(): any;
     set data(data: any);
+    /** Like {@link data}, but keyed by component `refid` instead of `id`. */
     get dataByRefid(): any;
     set dataByRefid(data: any);
+    /**
+     * Per-component scalar values keyed by `id` — the simple form of data binding
+     * (a single value per component, vs. the structured map used by {@link data}).
+     */
     get values(): any;
     set values(values: any);
+    /** Like {@link values}, but keyed by component `refid` instead of `id`. */
     get valuesByRefid(): any;
     set valuesByRefid(values: any);
     get baseUrl(): any;
     set baseUrl(baseUrl: any);
+    /**
+     * 애니메이션 억제 활성 여부.
+     * 영구 플래그(set suppressAnimations) 또는 활성 스코프(withSuppressedAnimations/
+     * beginSuppressAnimations) 중 하나라도 해당되면 true.
+     */
+    get suppressAnimations(): boolean;
+    /** 런타임 모드 토글: 지정된 상태로 고정. 스코프드 API 와는 독립적으로 동작. */
+    set suppressAnimations(value: boolean);
+    /**
+     * 콜백 실행 동안만 애니메이션 억제.
+     * 중첩 호출 / sync·async / 예외 모두 안전.
+     *
+     * @example
+     * scene.withSuppressedAnimations(() => {
+     *   for (const record of snapshot) component.data = record
+     * })
+     */
+    withSuppressedAnimations<T>(fn: () => T | Promise<T>): T | Promise<T>;
+    /**
+     * 수동 제어용 disposable. end() 호출 전까지 억제 유지.
+     * 스코프가 콜백 경계를 넘어가는 케이스 (이벤트 기반 드래그 등) 에 사용.
+     *
+     * @example
+     * const d = scene.beginSuppressAnimations()
+     * // ... some async flow ...
+     * d.end()
+     */
+    beginSuppressAnimations(): {
+        end(): void;
+    };
     startAddMode(models?: any): void;
+    /**
+     * Bulk-create 모드 진입. 사용자가 캔버스에 영역을 드래그 완료하면 area 와 함께
+     * resolve, ESC/취소 시 null 로 resolve.
+     *
+     *   const result = await scene.startBulkCreateMode(template, { boxStrokeStyle: '#2964c2' })
+     *   if (result) { ... result.area, result.template ... }
+     *
+     * 일반 startAddMode 와 달리 AddLayer 가 add 를 호출하지 않고 영역 선택만 처리.
+     * 외부 consumer 가 dialog/옵션 협의 후 직접 add 결정.
+     */
+    startBulkCreateMode(template: any, options?: {
+        boxStrokeStyle?: string;
+    }): Promise<API.BulkCreateResult | null>;
     startStylePasteMode(): void;
     stopStylePasteMode(): void;
     startDatabindPasteMode(): void;
     stopDatabindPasteMode(): void;
+    get loading(): LoadTracker | undefined;
+    get loadingOverlay(): LoadingOverlay;
+    showLoadingOverlay(): void;
+    hideLoadingOverlay(): void;
+    toggleLoadingOverlay(): void;
+    get searchOverlay(): SearchOverlay;
+    private _setupSearchOverlay;
 }
 export default Scene;
 //# sourceMappingURL=scene.d.ts.map

package/dist-types/things-scene/scene.d.ts.map

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

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

@@ -1,6 +1,6 @@
 import * as THREE from 'three';
 import { Line2 } from 'three/examples/jsm/lines/Line2.js';
-export type TipType = 'none' | 'arrow' | 'open-arrow' | 'sharp-arrow' | 'diamond' | 'oval';
+export type TipType = 'none' | 'arrow' | 'open-arrow' | 'sharp-arrow' | 'diamond' | 'oval' | 'cross';
 export type TipSize = 'size1' | 'size2' | 'size3' | 'size4' | 'size5' | 'size6' | 'size7' | 'size8' | 'size9';
 export type LineDash = 'solid' | 'round-dot' | 'square-dot' | 'dash' | 'dash-dot' | 'long-dash' | 'long-dash-dot' | 'long-dash-dot-dot';
 export interface ArrowStyle3D {
@@ -22,16 +22,25 @@ export declare function tipSize(size: TipSize | undefined, lineWidth: number): {
     Y: number;
 };
 /**
- * 팁 타입별 BufferGeometry(또는 Line2) 생성.
- * XY 평면, +X 방향이 화살표가 가리키는 방향(외부에서 쿼터니언 회전).
+ * 팁 타입별 3D Geometry 생성.
+ * +X 방향이 화살표가 가리키는 방향(외부에서 쿼터니언 회전).
  * 반환이 null이면 'none' 팁.
+ *
+ * 3D 형상 매핑:
+ * - arrow      → ConeGeometry (넓은 원뿔)
+ * - sharp-arrow → ConeGeometry (좁고 긴 원뿔)
+ * - open-arrow  → ConeGeometry (wireframe)
+ * - diamond     → OctahedronGeometry
+ * - oval        → SphereGeometry
+ * - cross       → TetrahedronGeometry
  */
 export declare function createTipGeometry(type: TipType, size: {
     X: number;
     Y: number;
-}, lineWidth: number): {
+}, _lineWidth: number): {
     mesh?: THREE.Mesh;
     line2?: Line2;
+    group?: THREE.Group;
 } | null;
 /**
  * Line2 + LineMaterial 기반 화살표 줄기 생성.

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

@@ -1 +1 @@
-{"version":3,"file":"arrow-3d.d.ts","sourceRoot":"","sources":["../../src/threed/arrow-3d.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAA;AAQzD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,CAAA;AAC1F,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;AAC7G,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,WAAW,GACX,YAAY,GACZ,MAAM,GACN,UAAU,GACV,WAAW,GACX,eAAe,GACf,mBAAmB,CAAA;AAEvB,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAMD;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAwB9F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9B,SAAS,EAAE,MAAM,GAChB;IAAE,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG,IAAI,CA+D7C;AAqCD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,KAAK,CAAC,OAAO,EACnB,IAAI,EAAE,KAAK,CAAC,OAAO,EACnB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,KAAK,CAAC,OAAO,GACxB,KAAK,CA4CP;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,KAAK,CAAC,OAAO,GACtB,KAAK,CAAC,MAAM,CAqCd;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,KAAK,CAAC,OAAO,EACnB,IAAI,EAAE,KAAK,CAAC,OAAO,EACnB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,KAAK,CAAC,OAAO,GACxB,KAAK,CAAC,KAAK,CAqGb"}
+{"version":3,"file":"arrow-3d.d.ts","sourceRoot":"","sources":["../../src/threed/arrow-3d.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAA;AAQzD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAA;AACpG,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;AAC7G,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,WAAW,GACX,YAAY,GACZ,MAAM,GACN,UAAU,GACV,WAAW,GACX,eAAe,GACf,mBAAmB,CAAA;AAEvB,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAMD;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAwB9F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9B,UAAU,EAAE,MAAM,GACjB;IAAE,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAA;CAAE,GAAG,IAAI,CA4ElE;AAqCD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,KAAK,CAAC,OAAO,EACnB,IAAI,EAAE,KAAK,CAAC,OAAO,EACnB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,KAAK,CAAC,OAAO,GACxB,KAAK,CA4CP;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,KAAK,CAAC,OAAO,GACtB,KAAK,CAAC,MAAM,CAqCd;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,KAAK,CAAC,OAAO,EACnB,IAAI,EAAE,KAAK,CAAC,OAAO,EACnB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,KAAK,CAAC,OAAO,GACxB,KAAK,CAAC,KAAK,CAuGb"}

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

@@ -1,5 +1,10 @@
 export declare const SCALE_MIN = 0.001;
-export declare function applyAlpha(material: any, alpha: number, fillStyle: any): void;
+/**
+ * material 의 **설계(canonical) opacity** 를 fillStyle 로 정한다 — fillStyle 의 alpha 채널(rgba 등),
+ * 'none'/'transparent' 는 0. **content alpha(state.alpha)는 여기서 곱하지 않는다** — 코어의 opacity
+ * 오버레이(RealObject.applyMaterialOpacity)가 faint 와 함께 일괄로 곱한다(이중적용 방지).
+ */
+export declare function applyAlpha(material: any, _alpha: number, fillStyle: any): void;
 /**
  * rgba/hsla 등 alpha 포함 색상 문자열에서 alpha 없는 hex 색상을 반환한다.
  * THREE.Color는 alpha를 지원하지 않으므로 color.set() 전에 사용한다.

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

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/threed/common.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,QAAQ,CAAA;AAE9B,wBAAgB,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAWtE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,eAAO,MAAM,cAAc;;;;CAAoC,CAAA;AAC/D,eAAO,MAAM,UAAU;;;;CAAuB,CAAA;AAC9C,eAAO,MAAM,cAAc;;;;CAAuB,CAAA;AAClD,eAAO,MAAM,WAAW;;;;CAAuB,CAAA"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/threed/common.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,QAAQ,CAAA;AAE9B;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAUvE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,eAAO,MAAM,cAAc;;;;CAAoC,CAAA;AAC/D,eAAO,MAAM,UAAU;;;;CAAuB,CAAA;AAC9C,eAAO,MAAM,cAAc;;;;CAAuB,CAAA;AAClD,eAAO,MAAM,WAAW;;;;CAAuB,CAAA"}

package/dist-types/threed/environments/base-environment.d.ts

@@ -0,0 +1,17 @@
+import { Scene } from 'three';
+/**
+ * 환경 씬 공통 베이스 클래스.
+ * PMREMGenerator.fromScene()으로 cubemap을 생성하는 환경 씬들의 공통 dispose() 로직을 제공한다.
+ *
+ * 정적 속성:
+ *   recommendsLogarithmicDepth — 이 환경에서 z-fight 가 시각적으로 두드러져 로그 depth
+ *   buffer 권장 여부. 실내 (warehouse / factory / office / home) 는 가까운 거리에 큰
+ *   배경 + 많은 겹친 면이 많아 true. 실외 (sunny / cloudy / rainy / studio) 는 일반적
+ *   사용에서 z-fight 가 덜 보여 false. 사용자의 SceneCreateOptions.logarithmicDepth 가
+ *   명시되지 않은 경우만 이 추천이 적용됨.
+ */
+export declare abstract class BaseEnvironment extends Scene {
+    static recommendsLogarithmicDepth: boolean;
+    dispose(): void;
+}
+//# sourceMappingURL=base-environment.d.ts.map

package/dist-types/threed/environments/base-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/base-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,EAAE,MAAM,OAAO,CAAA;AAEnC;;;;;;;;;;GAUG;AACH,8BAAsB,eAAgB,SAAQ,KAAK;IACjD,MAAM,CAAC,0BAA0B,EAAE,OAAO,CAAQ;IAElD,OAAO;CAYR"}

package/dist-types/threed/environments/cloudy-environment.d.ts

@@ -0,0 +1,10 @@
+import { BaseEnvironment } from './base-environment.js';
+/**
+ * Cloudy 환경 — 흐린 날씨.
+ * 높은 turbidity + 낮은 rayleigh로 하늘 전체가 회백색 느낌.
+ * 태양은 구름 뒤에 있는 듯 약한 halo만 보임.
+ */
+export declare class CloudyEnvironment extends BaseEnvironment {
+    constructor();
+}
+//# sourceMappingURL=cloudy-environment.d.ts.map

package/dist-types/threed/environments/cloudy-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudy-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/cloudy-environment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;;CAsBrD"}

package/dist-types/threed/environments/factory-environment.d.ts

@@ -1,11 +1,11 @@
-import { Scene } from 'three';
+import { BaseEnvironment } from './base-environment.js';
 /**
  * 공장 환경 — 높은 천장, 강한 상단 조명, 금속적 톤, 높은 대비.
  * PMREMGenerator.fromScene()으로 cubemap을 생성하여
  * scene.environment / GroundedSkybox에 사용한다.
  */
-export declare class FactoryEnvironment extends Scene {
+export declare class FactoryEnvironment extends BaseEnvironment {
+    static recommendsLogarithmicDepth: boolean;
     constructor();
-    dispose(): void;
 }
 //# sourceMappingURL=factory-environment.d.ts.map

package/dist-types/threed/environments/factory-environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/factory-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,EACN,MAAM,OAAO,CAAA;AAEd;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;;IA+D3C,OAAO;CAYR"}
+{"version":3,"file":"factory-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/factory-environment.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,MAAM,CAAC,0BAA0B,UAAO;;CAgEzC"}

package/dist-types/threed/environments/home-environment.d.ts

@@ -1,11 +1,11 @@
-import { Scene } from 'three';
+import { BaseEnvironment } from './base-environment.js';
 /**
  * 가정 환경 — 아늑한 분위기, 따뜻한 조명, 낮은 천장, 넓은 창문.
  * PMREMGenerator.fromScene()으로 cubemap을 생성하여
  * scene.environment / scene.background에 사용한다.
  */
-export declare class HomeEnvironment extends Scene {
+export declare class HomeEnvironment extends BaseEnvironment {
+    static recommendsLogarithmicDepth: boolean;
     constructor();
-    dispose(): void;
 }
 //# sourceMappingURL=home-environment.d.ts.map

package/dist-types/threed/environments/home-environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"home-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/home-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,EACN,MAAM,OAAO,CAAA;AAEd;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;;IA0DxC,OAAO;CAYR"}
+{"version":3,"file":"home-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/home-environment.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,eAAe;IAClD,MAAM,CAAC,0BAA0B,UAAO;;CA2DzC"}

package/dist-types/threed/environments/office-environment.d.ts

@@ -1,11 +1,11 @@
-import { Scene } from 'three';
+import { BaseEnvironment } from './base-environment.js';
 /**
  * 사무실 환경 — 낮은 천장, 균일한 면광원, 따뜻한 색온도.
  * PMREMGenerator.fromScene()으로 cubemap을 생성하여
  * scene.environment / GroundedSkybox에 사용한다.
  */
-export declare class OfficeEnvironment extends Scene {
+export declare class OfficeEnvironment extends BaseEnvironment {
+    static recommendsLogarithmicDepth: boolean;
     constructor();
-    dispose(): void;
 }
 //# sourceMappingURL=office-environment.d.ts.map

package/dist-types/threed/environments/office-environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"office-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/office-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,EACN,MAAM,OAAO,CAAA;AAEd;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;;IAuD1C,OAAO;CAYR"}
+{"version":3,"file":"office-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/office-environment.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,MAAM,CAAC,0BAA0B,UAAO;;CAwDzC"}

package/dist-types/threed/environments/rainy-environment.d.ts

@@ -0,0 +1,10 @@
+import { BaseEnvironment } from './base-environment.js';
+/**
+ * Rainy 환경 — 비 오는 날씨.
+ * 매우 높은 turbidity + 억제된 rayleigh로 어두운 회청색 하늘.
+ * 태양은 거의 안 보이고 전반적으로 어둑한 분위기.
+ */
+export declare class RainyEnvironment extends BaseEnvironment {
+    constructor();
+}
+//# sourceMappingURL=rainy-environment.d.ts.map

package/dist-types/threed/environments/rainy-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rainy-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/rainy-environment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;;CAsBpD"}

package/dist-types/threed/environments/studio-environment.d.ts

@@ -1,12 +1,11 @@
-import { Scene } from 'three';
+import { BaseEnvironment } from './base-environment.js';
 /**
  * 스튜디오 환경 — 밝고 균일한 조명, 중성 배경.
  * RoomEnvironment 대체용. 바닥 오브젝트 없이 벽/천장/조명만 구성.
  * PMREMGenerator.fromScene()으로 cubemap을 생성하여
  * scene.environment / scene.background에 사용한다.
  */
-export declare class StudioEnvironment extends Scene {
+export declare class StudioEnvironment extends BaseEnvironment {
     constructor();
-    dispose(): void;
 }
 //# sourceMappingURL=studio-environment.d.ts.map

package/dist-types/threed/environments/studio-environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"studio-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/studio-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,EACN,MAAM,OAAO,CAAA;AAEd;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;;IAoD1C,OAAO;CAYR"}
+{"version":3,"file":"studio-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/studio-environment.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;;CAoDrD"}

package/dist-types/threed/environments/sunny-environment.d.ts

@@ -0,0 +1,10 @@
+import { BaseEnvironment } from './base-environment.js';
+/**
+ * Sunny 환경 — 맑은 날씨.
+ * Three.js 내장 Sky shader(Hosek-Wilkie 대기 산란)로 실제 같은 하늘 생성.
+ * 지평선 옅은 흰빛 → 천정 짙은 파랑의 자연스러운 그라데이션 + 강한 태양.
+ */
+export declare class SunnyEnvironment extends BaseEnvironment {
+    constructor();
+}
+//# sourceMappingURL=sunny-environment.d.ts.map

package/dist-types/threed/environments/sunny-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sunny-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/sunny-environment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;;CAuBpD"}

package/dist-types/threed/environments/warehouse-environment.d.ts

@@ -1,11 +1,11 @@
-import { Scene } from 'three';
+import { BaseEnvironment } from './base-environment.js';
 /**
  * 창고 환경 — 높은 천장, 상단 집중 형광등, 차가운 색온도.
  * PMREMGenerator.fromScene()으로 cubemap을 생성하여
  * scene.environment / GroundedSkybox에 사용한다.
  */
-export declare class WarehouseEnvironment extends Scene {
+export declare class WarehouseEnvironment extends BaseEnvironment {
+    static recommendsLogarithmicDepth: boolean;
     constructor();
-    dispose(): void;
 }
 //# sourceMappingURL=warehouse-environment.d.ts.map

package/dist-types/threed/environments/warehouse-environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"warehouse-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/warehouse-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,EACN,MAAM,OAAO,CAAA;AAEd;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;;IAqD7C,OAAO;CAYR"}
+{"version":3,"file":"warehouse-environment.d.ts","sourceRoot":"","sources":["../../../src/threed/environments/warehouse-environment.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,MAAM,CAAC,0BAA0B,UAAO;;CAsDzC"}