@hatiolab/things-scene 10.0.0-beta.11 → 10.0.0-beta.110

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/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"}