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

package/README.md

@@ -1,22 +1,23 @@
 # Things-Scene
 
-Things-Scene은 웹 애플리케이션을 위한 2D 그래픽 라이브러리입니다.
+Things-Scene은 웹 애플리케이션을 위한 2D/3D 씬 렌더링 및 편집 라이브러리입니다.
 
 ## 주요 특징
 
 - 캔버스 기반 고성능 2D 렌더링
+- Three.js 기반 3D 렌더링 (WebGL)
 - 컴포넌트 기반 아키텍처
+- 기즈모 편집 시스템 (Move/Rotate/Scale)
+- Material3D 프리셋 시스템 (metal, glass, plastic, wood, ceramic, rubber)
+- 2D↔3D 속성 자연스러운 연동
+- GLTF/GLB 모델 로딩 및 노드별 제어
 - ESM 및 UMD 형식 지원
-- TypeScript 타입 정의 제공
+- TypeScript strict mode
 
 ## 설치
 
 ```bash
-# npm 사용
 npm install @hatiolab/things-scene
-
-# yarn 사용
-yarn add @hatiolab/things-scene
 ```
 
 ## 사용 방법
@@ -35,47 +36,76 @@ import { Scene, Component } from '@hatiolab/things-scene'
 <script src="node_modules/@hatiolab/things-scene/things-scene-min.js"></script>
 <script>
   const { Scene, Component } = window['things-scene']
-  // 씬 생성 및 렌더링
 </script>
 ```
 
-## 빌드 시스템
-
-이 프로젝트는 Rollup을 통해 다음 포맷으로 빌드됩니다:
+## 3D 기능 (v10)
 
-| 포맷 | 파일명              | 용도          | 비고                    |
-| ---- | ------------------- | ------------- | ----------------------- |
-| ESM  | things-scene.mjs    | 최신 브라우저 | 권장 사용 포맷          |
-| UMD  | things-scene-min.js | 모든 환경     | 레거시 지원 및 번들링용 |
+### 3D 모드 활성화
 
-```bash
-# 빌드 실행
-npm run build
-```
+model-layer의 `threed: true` 속성으로 3D 모드를 활성화합니다.
 
-## 개발 환경
+### Material3D API
 
-개발을 위한 자세한 내용은 [DEVELOPMENT.md](./DEVELOPMENT.md)를 참조하세요.
+컴포넌트의 `material3d` 속성으로 3D 재질을 제어합니다:
 
-```bash
-# 개발 서버 실행
-npm run serve:dev
+```javascript
+component.set('material3d', {
+  preset: 'glass',     // 프리셋: default, metal, glass, plastic, wood, ceramic, rubber
+  metalness: 0.5,      // 0~1
+  roughness: 0.3,      // 0~1
+  opacity: 0.3,        // 0~1 (프리셋 기본값 또는 명시적)
+  envMapIntensity: 1.5, // 0~3
+  side: 'double',      // double, front, back
+  castShadow: true,
+  receiveShadow: false,
+})
 ```
 
-## 배포
+### 3D 컴포넌트 타입
+
+Sphere, Cube, Cylinder, Banner, Camera, Wall, GLTFObject, Light, Sprite
+
+### GLTF 모델
 
-배포 절차는 [DEPLOYMENT.md](./DEPLOYMENT.md)를 참조하세요.
+```javascript
+component.set('src', '/models/building.glb')
+component.set('nodes', {
+  'Wall': { color: '#ff0000', opacity: 0.5 },
+  'Door': { visible: false }
+})
+```
 
-## TypeScript 지원
+## 빌드
 
-이 프로젝트는 TypeScript 타입 정의를 제공합니다. 기존 JavaScript 코드는 유지하면서 TypeScript 타입 시스템을 활용할 수 있습니다.
+| 포맷 | 파일명              | 용도          |
+| ---- | ------------------- | ------------- |
+| ESM  | things-scene.mjs    | 최신 브라우저 |
+| UMD  | things-scene-min.js | 모든 환경     |
 
 ```bash
-# 타입 검사 실행
+npm run build
+npm test        # 1170+ tests
 npm run type-check
 ```
 
+## 개발 환경
+
+자세한 내용은 [DEVELOPMENT.md](./DEVELOPMENT.md)를 참조하세요.
+
+## v9 → v10 마이그레이션
+
+### Breaking Changes
+
+- `strict: true` — strictPropertyInitialization 등 준수 필요
+- Evaluator 샌드박스 강화 — `window`/`document` 접근 차단
+- `innerHTML` → `textContent` + DOMPurify
+- `state` getter가 Proxy로 변경 (동작 호환)
+- `bounds` 반환값 Object.freeze (수정 시 spread 복사 필요)
+
+상세: [CHANGELOG.md](./CHANGELOG.md)
+
 ## 라이선스
 
-이 프로젝트는 독점 라이선스로 배포됩니다.  
+이 프로젝트는 독점 라이선스로 배포됩니다.
 라이선스 정보: [http://things-scene.hatiolab.com/EULA/](http://things-scene.hatiolab.com/EULA/)

package/dist-types/animation/animate.d.ts

@@ -0,0 +1,8 @@
+import { AnimationConfig, AnimationController } from './interfaces.js';
+/**
+ * 애니메이션 생성 함수
+ * @param config 애니메이션 설정
+ * @returns 애니메이션 컨트롤러
+ */
+export default function animate(config: AnimationConfig): AnimationController;
+//# sourceMappingURL=animate.d.ts.map

package/dist-types/animation/animate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.d.ts","sourceRoot":"","sources":["../../src/animation/animate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAOtE;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,mBAAmB,CA+E5E"}

package/dist-types/animation/animations/animation.d.ts

@@ -0,0 +1,90 @@
+import { AnimationTarget, DeltaCallback, AnimationConfig } from '../interfaces.js';
+/**
+ * 기본 콜백 함수 타입 정의
+ */
+type onComplete = () => void;
+/**
+ * 애니메이션 설정 인터페이스
+ */
+export interface AnimationClient extends AnimationTarget {
+    root?: any;
+    center?: {
+        x: number;
+        y: number;
+    };
+    toScene?: (x: number, y: number) => {
+        x: number;
+        y: number;
+    };
+    location?: any;
+    setState?: (property: string, value: any) => void;
+}
+/**
+ * 여러가지 Animation 동작의 추상클래스임.
+ * Animation 생성자의 client 는
+ * - delta, invalidate 메쏘드를 구현하여야 한다.
+ */
+export default class Animation {
+    /**
+     * 애니메이션 클라이언트
+     */
+    protected client: AnimationClient;
+    /**
+     * 애니메이션 설정
+     */
+    protected config: AnimationConfig;
+    /**
+     * 시작 여부
+     */
+    private _started;
+    /**
+     * requestAnimationFrame ID
+     */
+    private _raf;
+    /**
+     * 타임아웃 ID
+     */
+    private _timeout;
+    /**
+     * Delta 함수
+     */
+    protected delta: DeltaCallback;
+    /**
+     * 생성자
+     * @param client 애니메이션 클라이언트
+     * @param config 애니메이션 설정
+     */
+    constructor(client: AnimationClient, config: AnimationConfig);
+    /**
+     * 리소스 해제
+     */
+    dispose(): void;
+    /**
+     * 초기화 메서드
+     */
+    init(): void;
+    /**
+     * 애니메이션 시작
+     */
+    start(): void;
+    /**
+     * 애니메이션 정지
+     * @param callback 정지 후 콜백
+     */
+    stop(callback?: onComplete): void;
+    /**
+     * 애니메이션 단계 실행
+     * @param delta 델타 값 (0-1)
+     */
+    step(delta: number): void;
+    /**
+     * 시작 여부 반환
+     */
+    get started(): boolean;
+    /**
+     * 시작 여부 설정
+     */
+    set started(started: boolean);
+}
+export {};
+//# sourceMappingURL=animation.d.ts.map

package/dist-types/animation/animations/animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../../src/animation/animations/animation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElF;;GAEG;AACH,KAAK,UAAU,GAAG,MAAM,IAAI,CAAA;AAE5B;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IAEtD,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACjC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5D,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAA;CAClD;AAqBD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAC5B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,CAAA;IAEjC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,CAAA;IAEjC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAiB;IAEjC;;OAEG;IACH,OAAO,CAAC,IAAI,CAAsB;IAElC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAA6C;IAE7D;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,aAAa,CAAA;IAE9B;;;;OAIG;gBACS,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe;IAuB5D;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf;;OAEG;IACH,IAAI,IAAI,IAAI;IAEZ;;OAEG;IACH,KAAK,IAAI,IAAI;IA4Db;;;OAGG;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAiBjC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,EAO3B;CACF"}

package/dist-types/animation/animations/fade.d.ts

@@ -0,0 +1,25 @@
+import Animation from './animation.js';
+import { AnimationConfig } from '../interfaces.js';
+/**
+ * 페이드 애니메이션 설정 인터페이스
+ */
+interface FadeConfig extends AnimationConfig {
+    startAlpha?: number;
+    endAlpha?: number;
+}
+/**
+ * 페이드 애니메이션 클래스
+ */
+export default class Fade extends Animation {
+    /**
+     * 애니메이션 설정
+     */
+    protected config: FadeConfig;
+    /**
+     * 애니메이션 단계 실행
+     * @param delta 델타 값 (0-1)
+     */
+    step(delta: number): void;
+}
+export {};
+//# sourceMappingURL=fade.d.ts.map

package/dist-types/animation/animations/fade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fade.d.ts","sourceRoot":"","sources":["../../../src/animation/animations/fade.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD;;GAEG;AACH,UAAU,UAAW,SAAQ,eAAe;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,SAAS;IACzC;;OAEG;IACH,UAAkB,MAAM,EAAE,UAAU,CAAA;IAEpC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAa1B"}

package/dist-types/animation/animations/heartbeat.d.ts

@@ -0,0 +1,24 @@
+import Animation from './animation.js';
+import { AnimationConfig } from '../interfaces.js';
+/**
+ * 하트비트 애니메이션 설정 인터페이스
+ */
+interface HeartBeatConfig extends AnimationConfig {
+    scale?: number;
+}
+/**
+ * 하트비트 애니메이션 클래스
+ */
+export default class HeartBeat extends Animation {
+    /**
+     * 애니메이션 설정
+     */
+    protected config: HeartBeatConfig;
+    /**
+     * 애니메이션 단계 실행
+     * @param delta 델타 값 (0-1)
+     */
+    step(delta: number): void;
+}
+export {};
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist-types/animation/animations/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../../src/animation/animations/heartbeat.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD;;GAEG;AACH,UAAU,eAAgB,SAAQ,eAAe;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,SAAS;IAC9C;;OAEG;IACH,UAAkB,MAAM,EAAE,eAAe,CAAA;IAEzC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAY1B"}

package/dist-types/animation/animations/moving.d.ts

@@ -0,0 +1,25 @@
+import Animation from './animation.js';
+import { AnimationConfig } from '../interfaces.js';
+/**
+ * 이동 애니메이션 설정 인터페이스
+ */
+interface MovingConfig extends AnimationConfig {
+    x?: number;
+    y?: number;
+}
+/**
+ * 이동 애니메이션 클래스
+ */
+export default class Moving extends Animation {
+    /**
+     * 애니메이션 설정
+     */
+    protected config: MovingConfig;
+    /**
+     * 애니메이션 단계 실행
+     * @param delta 델타 값 (0-1)
+     */
+    step(delta: number): void;
+}
+export {};
+//# sourceMappingURL=moving.d.ts.map

package/dist-types/animation/animations/moving.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moving.d.ts","sourceRoot":"","sources":["../../../src/animation/animations/moving.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD;;GAEG;AACH,UAAU,YAAa,SAAQ,eAAe;IAC5C,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,CAAC,CAAC,EAAE,MAAM,CAAA;CACX;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,SAAS;IAC3C;;OAEG;IACH,UAAkB,MAAM,EAAE,YAAY,CAAA;IAEtC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAK1B"}

package/dist-types/animation/animations/outline.d.ts

@@ -0,0 +1,58 @@
+import Animation from './animation.js';
+import { AnimationConfig } from '../interfaces.js';
+import { AnimationClient } from './animation.js';
+/**
+ * 아웃라인 애니메이션을 위한 컴포넌트 인터페이스
+ */
+interface OutlineComponentClient {
+    outline(delta: number): {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * 아웃라인 애니메이션을 위한 클라이언트 인터페이스
+ */
+interface OutlineClient extends AnimationClient {
+    root: {
+        findById(id: string): OutlineComponentClient | null;
+    };
+    center: {
+        x: number;
+        y: number;
+    };
+    toScene(x: number, y: number): {
+        x: number;
+        y: number;
+    };
+    delta(property?: string | object, value?: any): any;
+}
+/**
+ * 아웃라인 애니메이션 설정 인터페이스
+ */
+interface OutlineConfig extends AnimationConfig {
+    rideOn?: string;
+}
+/**
+ * outline 애니메이션은 정지해있는 컴포넌트의 outline을 따라 움직이는 효과를 만들어낸다.
+ * 만일 아웃라인을 제공하는 컴포넌트가 애니메이션 동작중이면, 애니메이션 동작에 의한 아웃라인의 변화는 반영되지 않는다.
+ * 애니메이션이 아닌 실제 위치가 변경되는 경우에는 반영된다.
+ * 아웃라인 컴포넌트와 애니메이션 컴포넌트가 동일 부모 아래서 적용된다면, 부모의 움직임이 반영되는 효과를 만들어 낼 수 있다.
+ */
+export default class Outline extends Animation {
+    /**
+     * 애니메이션 설정
+     */
+    protected config: OutlineConfig;
+    /**
+     * 클라이언트 타입 확장
+     */
+    protected client: OutlineClient;
+    /**
+     * 애니메이션 단계 실행
+     * @param delta 델타 값 (0-1)
+     */
+    step(delta: number): void;
+}
+export {};
+//# sourceMappingURL=outline.d.ts.map

package/dist-types/animation/animations/outline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline.d.ts","sourceRoot":"","sources":["../../../src/animation/animations/outline.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;GAEG;AACH,UAAU,sBAAsB;IAC9B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACjD;AAED;;GAEG;AACH,UAAU,aAAc,SAAQ,eAAe;IAC7C,IAAI,EAAE;QACJ,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAAA;KACpD,CAAA;IACD,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,CAAA;CACpD;AAED;;GAEG;AACH,UAAU,aAAc,SAAQ,eAAe;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,SAAS;IAC5C;;OAEG;IACH,UAAkB,MAAM,EAAE,aAAa,CAAA;IAEvC;;OAEG;IACH,UAAkB,MAAM,EAAE,aAAa,CAAA;IAEvC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAiC1B"}

package/dist-types/animation/animations/rotation.d.ts

@@ -0,0 +1,24 @@
+import Animation from './animation.js';
+import { AnimationConfig } from '../interfaces.js';
+/**
+ * 회전 애니메이션 설정 인터페이스
+ */
+interface RotationConfig extends AnimationConfig {
+    theta?: number;
+}
+/**
+ * 회전 애니메이션 클래스
+ */
+export default class Rotation extends Animation {
+    /**
+     * 애니메이션 설정
+     */
+    protected config: RotationConfig;
+    /**
+     * 애니메이션 단계 실행
+     * @param delta 델타 값 (0-1)
+     */
+    step(delta: number): void;
+}
+export {};
+//# sourceMappingURL=rotation.d.ts.map

package/dist-types/animation/animations/rotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotation.d.ts","sourceRoot":"","sources":["../../../src/animation/animations/rotation.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD;;GAEG;AACH,UAAU,cAAe,SAAQ,eAAe;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,SAAS;IAC7C;;OAEG;IACH,UAAkB,MAAM,EAAE,cAAc,CAAA;IAExC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAK1B"}

package/dist-types/animation/animations/vibration.d.ts

@@ -0,0 +1,24 @@
+import Animation from './animation.js';
+import { AnimationConfig } from '../interfaces.js';
+/**
+ * 진동 애니메이션 설정 인터페이스
+ */
+interface VibrationConfig extends AnimationConfig {
+    theta?: number;
+}
+/**
+ * 진동 애니메이션 클래스
+ */
+export default class Vibration extends Animation {
+    /**
+     * 애니메이션 설정
+     */
+    protected config: VibrationConfig;
+    /**
+     * 애니메이션 단계 실행
+     * @param delta 델타 값 (0-1)
+     */
+    step(delta: number): void;
+}
+export {};
+//# sourceMappingURL=vibration.d.ts.map

package/dist-types/animation/animations/vibration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibration.d.ts","sourceRoot":"","sources":["../../../src/animation/animations/vibration.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD;;GAEG;AACH,UAAU,eAAgB,SAAQ,eAAe;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,SAAS;IAC9C;;OAEG;IACH,UAAkB,MAAM,EAAE,eAAe,CAAA;IAEzC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAkB1B"}

package/dist-types/animation/animations/waypoint.d.ts

@@ -0,0 +1,60 @@
+import Animation from './animation.js';
+import { AnimationConfig } from '../interfaces.js';
+import { AnimationClient } from './animation.js';
+/**
+ * 웨이포인트 애니메이션을 위한 컴포넌트 인터페이스
+ */
+interface WaypointComponent {
+    center: {
+        x: number;
+        y: number;
+    };
+    location: any;
+    toScene(x: number, y: number): {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * 웨이포인트 애니메이션을 위한 클라이언트 인터페이스
+ */
+interface WaypointClient extends AnimationClient {
+    location: any;
+    setState(property: string, value: any): void;
+    delta(property?: string | object, value?: any): any;
+}
+/**
+ * 웨이포인트 애니메이션 설정 인터페이스
+ */
+interface WaypointConfig extends AnimationConfig {
+    fromComponent: WaypointComponent;
+    toComponent: WaypointComponent;
+}
+/**
+ * 웨이포인트 애니메이션 클래스
+ */
+export default class Waypoint extends Animation {
+    /**
+     * 애니메이션 설정
+     */
+    protected config: WaypointConfig;
+    /**
+     * 클라이언트 타입 확장
+     */
+    protected client: WaypointClient;
+    /**
+     * 애니메이션 시작
+     */
+    start(): void;
+    /**
+     * 애니메이션 정지
+     */
+    stop(): void;
+    /**
+     * 애니메이션 단계 실행
+     * @param delta 델타 값 (0-1)
+     */
+    step(delta: number): void;
+}
+export {};
+//# sourceMappingURL=waypoint.d.ts.map

package/dist-types/animation/animations/waypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waypoint.d.ts","sourceRoot":"","sources":["../../../src/animation/animations/waypoint.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;GAEG;AACH,UAAU,iBAAiB;IACzB,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,QAAQ,EAAE,GAAG,CAAA;IACb,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACxD;AAED;;GAEG;AACH,UAAU,cAAe,SAAQ,eAAe;IAC9C,QAAQ,EAAE,GAAG,CAAA;IACb,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAA;IAC5C,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,CAAA;CACpD;AAED;;GAEG;AACH,UAAU,cAAe,SAAQ,eAAe;IAC9C,aAAa,EAAE,iBAAiB,CAAA;IAChC,WAAW,EAAE,iBAAiB,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,SAAS;IAC7C;;OAEG;IACH,UAAkB,MAAM,EAAE,cAAc,CAAA;IAExC;;OAEG;IACH,UAAkB,MAAM,EAAE,cAAc,CAAA;IAExC;;OAEG;IACH,KAAK,IAAI,IAAI;IAsBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAaZ;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAkB1B"}

package/dist-types/animation/compile.d.ts

@@ -0,0 +1,16 @@
+import { AnimationTarget, AnimationConfig } from './interfaces.js';
+import Animation from './animations/animation.js';
+/**
+ * 애니메이션 클래스 인터페이스
+ */
+export interface AnimationClass {
+    new (client: AnimationTarget, config: AnimationConfig): Animation;
+}
+/**
+ * 애니메이션 컴파일 함수 - 설정에 따라 적절한 애니메이션 인스턴스 생성
+ * @param client 애니메이션을 적용할 클라이언트 객체
+ * @param animationConfig 애니메이션 설정
+ * @returns 애니메이션 인스턴스 또는 null
+ */
+export default function compile(client: AnimationTarget, animationConfig: AnimationConfig): Animation | null;
+//# sourceMappingURL=compile.d.ts.map

package/dist-types/animation/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/animation/compile.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,SAAS,MAAM,2BAA2B,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,GAAG,SAAS,CAAA;CAClE;AAeD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAM3G"}

package/dist-types/animation/delta.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 옵션 인터페이스 정의
+ */
+interface DeltaOptions {
+    x: number;
+}
+/**
+ * 선형 진행
+ * @param progress 진행도 (0-1 사이의 값)
+ * @returns 변환된 진행도
+ */
+export declare function linear(progress: number): number;
+/**
+ * 2차 곡선 진행
+ * @param progress 진행도 (0-1 사이의 값)
+ * @returns 변환된 진행도
+ */
+export declare function quad(progress: number): number;
+/**
+ * 원형 진행
+ * @param progress 진행도 (0-1 사이의 값)
+ * @returns 변환된 진행도
+ */
+export declare function circ(progress: number): number;
+/**
+ * 뒤로 튕기는 진행
+ * @param progress 진행도 (0-1 사이의 값)
+ * @param options 옵션 객체 (x: 튕김 강도)
+ * @returns 변환된 진행도
+ */
+export declare function back(progress: number, options?: DeltaOptions): number;
+/**
+ * 통통 튕기는 진행
+ * @param progress 진행도 (0-1 사이의 값)
+ * @returns 변환된 진행도
+ */
+export declare function bounce(progress: number): number;
+/**
+ * 탄성 진행
+ * @param progress 진행도 (0-1 사이의 값)
+ * @param options 옵션 객체 (x: 탄성 강도)
+ * @returns 변환된 진행도
+ */
+export declare function elastic(progress: number, options?: DeltaOptions): number;
+/**
+ * Delta 함수 객체 - 모든 이징 함수 제공
+ */
+declare const _default: {
+    linear: typeof linear;
+    quad: typeof quad;
+    circ: typeof circ;
+    back: typeof back;
+    bounce: typeof bounce;
+    elastic: typeof elastic;
+};
+export default _default;
+//# sourceMappingURL=delta.d.ts.map

package/dist-types/animation/delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../../src/animation/delta.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,UAAU,YAAY;IACpB,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,YAAyB,GAAG,MAAM,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,YAAyB,GAAG,MAAM,CAEpF;AAED;;GAEG;;;;;;;;;AACH,wBAOC"}

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

@@ -0,0 +1,7 @@
+export { default as animate } from './animate.js';
+export { default as delta } from './delta.js';
+export { default as compile } from './compile.js';
+export { AnimationTarget, AnimationConfig, AnimationOptions, AnimationController, AnimationEvent, TransitionConfig, EffectConfig } from './interfaces.js';
+export { AnimationClass } from './compile.js';
+export { default as Animation } from './animations/animation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/animation/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EACL,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACb,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,2BAA2B,CAAA"}