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

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Change Log
 
+## [v10.0.0] — Unreleased
+
+Consolidated release notes for the v9 → v10 major upgrade. This section summarizes the
+significant, consumer-facing changes by theme; the per-beta entries below remain as the
+detailed historical record (beta.11 and earlier).
+
+### Highlights
+
+- **Unified 2D + 3D rendering** — a single component model renders to both HTML5 Canvas
+  (2D) and Three.js/WebGL (3D), with live mode switching. `Scene = 3D space`, per-container
+  render modes.
+- **Material3D + Material Bank** — preset materials (metal, glass, plastic, wood, ceramic,
+  rubber) with seamless 2D ↔ 3D property binding. Shared `MaterialBank` deduplicates 3D
+  materials by name+spec signature to avoid churn and variant explosion.
+- **GLTF/GLB loading** — per-node control (color, opacity, visibility), shared loader
+  instances, and parse caching.
+- **Zero-to-Twin foundation** — flow primitives (`FlowNode`, `Capacity`, `Transferable`,
+  `Transfer`, `FlowGraph`) with a single universal reception contract
+  (`canReceive` → `reserve` → `commit` → `release`; `receive` = reserve + commit).
+- **Navigation** — `NavGraph` + A\* `PathPlanner` + `ReservationTable`.
+
+### New Features (since beta.11)
+
+- **Material Bank + variant registry** — shared 3D materials, per-instance `material3d`
+  support via name+spec keys, `depthWrite` spec, dispose exemption on teardown.
+- **Modeling faint/alpha core unification** — editor "faint" (hidden/dim) applied
+  consistently across all three render channels (canvas, 3D, DOM overlay) from the core;
+  content alpha applied to every 3D component through a single opacity overlay.
+- **Flow — capability generalization** — `StationHost` → `Sorter` capability;
+  `findNearestWithCapability(name)` replaces Sorter-specific lookups; `downstreamRef`
+  vocabulary unified with a `resolveDownstream` selector and host-driven fan-out registration.
+- **3D capability taxonomy** — module-scope `threedEnabled` switch, instance-level gate
+  (`create({ threed })`), `threeDOnly` component marker, and 3D hotkey/help gating. Root
+  model `threed` decoupled from the live 2D/3D view mode.
+- **Headless frameClock** — Node-safe frame clock and transfer re-exposure for headless
+  simulation.
+- **StackingStrategy core promotion** — `StackingStrategy` / `computeStackPositions`
+  promoted to core as a peer of `ArrangementStrategy`; `GridStrategy` aligned to the
+  `placementFor` 2D-board convention.
+- **loading-overlay Data Lag** — pluggable renderer seam and LAG/LEAD/SYNC lag visualization.
+- **`postprocessing` option** — `create({ postprocessing: false })` skips the EffectComposer
+  pipeline for lightweight/headless rendering.
+
+### Foundational / Internal
+
+- **Full TypeScript migration** — 132 JS files → 0; `strict: true` enabled
+  (`noImplicitAny` remains off, tracked for a follow-up).
+- **`component.ts` module split** — 1332 → 629 lines; public `Component` API unchanged.
+- **`ready()` lifecycle** — structurally enforced to run once per component
+  lifetime (`invokeReady`).
+
+### Breaking Changes (v9 → v10)
+
+| Change | Impact | Migration |
+| --- | --- | --- |
+| Hardened evaluator sandbox (`SHADOWED_GLOBALS`) | eval rule scripts | `window` / `document` / `globalThis` blocked; `scene`, `setTimeout`, `Math`, etc. remain |
+| `innerHTML` → `textContent` | templates with HTML markup | safe HTML via DOMPurify |
+| `strict: true` | custom component authors | must satisfy `strictPropertyInitialization`, etc. |
+| ESM `globalThis.scene` auto-set | eval scripts accessing `scene.*` | no need to set `window.scene` manually |
+| `state` getter replaced with Proxy | `this.state` access | behavior-compatible (get / has / ownKeys / spread) |
+| `bounds` `Object.freeze` | code mutating the returned bounds | read-only; copy with a spread before mutating |
+| `component.ts` module split | internal import paths | public API (`Component` class) unchanged |
+
+---
+
 ## [v10.0.0-beta.11] (2026-03-08)
 
 ### New Features

package/README.md

@@ -1,36 +1,36 @@
 # Things-Scene
 
-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 형식 지원
+A high-performance 2D/3D scene graph library for building interactive visual editors. It combines the HTML5 Canvas and Three.js to enable facility visualization, data-driven animations, and real-time monitoring dashboards from a single component model.
+
+## Features
+
+- High-performance Canvas-based 2D rendering
+- Three.js-based 3D rendering (WebGL)
+- Component-based architecture
+- Gizmo editing system (Move / Rotate / Scale)
+- Material3D preset system (metal, glass, plastic, wood, ceramic, rubber)
+- Seamless 2D ↔ 3D property binding
+- GLTF/GLB model loading with per-node control
+- ESM and UMD builds
 - TypeScript strict mode
 
-## 설치
+## Installation
 
 ```bash
 npm install @hatiolab/things-scene
 ```
 
-## 사용 방법
+## Usage
 
-### ESM 방식 (권장)
+### ESM (recommended)
 
 ```javascript
 import { Scene, Component } from '@hatiolab/things-scene'
 
-// 씬 생성 및 렌더링
+// create and render a scene
 ```
 
-### UMD 방식
+### UMD
 
 ```html
 <script src="node_modules/@hatiolab/things-scene/things-scene-min.js"></script>
@@ -39,73 +39,76 @@ import { Scene, Component } from '@hatiolab/things-scene'
 </script>
 ```
 
-## 3D 기능 (v10)
+## 3D Features (v10)
 
-### 3D 모드 활성화
+### Enabling 3D mode
 
-model-layer의 `threed: true` 속성으로 3D 모드를 활성화합니다.
+Set `threed: true` on the model-layer to enable 3D mode. A single component model
+renders to both 2D and 3D, with live mode switching.
 
 ### Material3D API
 
-컴포넌트의 `material3d` 속성으로 3D 재질을 제어합니다:
+Control 3D materials through a component's `material3d` property:
 
 ```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
+  preset: 'glass',      // default, metal, glass, plastic, wood, ceramic, rubber
+  metalness: 0.5,       // 0–1
+  roughness: 0.3,       // 0–1
+  opacity: 0.3,         // 0–1 (preset default or explicit)
+  envMapIntensity: 1.5, // 0–3
+  side: 'double',       // double, front, back
   castShadow: true,
   receiveShadow: false,
 })
 ```
 
-### 3D 컴포넌트 타입
+### 3D component types
 
-Sphere, Cube, Cylinder, Banner, Camera, Wall, GLTFObject, Light, Sprite
+Sphere, Cube, Cylinder, Banner, Camera, Wall, GLTFObject, Light, Sprite.
 
-### GLTF 모델
+### GLTF models
 
 ```javascript
 component.set('src', '/models/building.glb')
 component.set('nodes', {
-  'Wall': { color: '#ff0000', opacity: 0.5 },
-  'Door': { visible: false }
+  Wall: { color: '#ff0000', opacity: 0.5 },
+  Door: { visible: false },
 })
 ```
 
-## 빌드
+## Builds
 
-| 포맷 | 파일명              | 용도          |
-| ---- | ------------------- | ------------- |
-| ESM  | things-scene.mjs    | 최신 브라우저 |
-| UMD  | things-scene-min.js | 모든 환경     |
+| Format | File                  | Target                     |
+| ------ | --------------------- | -------------------------- |
+| ESM    | `things-scene.mjs`    | Modern browsers            |
+| UMD    | `things-scene-min.js` | Any environment            |
+| Node   | `things-scene-transfer.mjs` | Headless / SSR simulation |
 
 ```bash
-npm run build
-npm test        # 1170+ tests
-npm run type-check
+npm run build       # types + rollup (production)
+npm test            # 2460+ tests (mocha)
+npm run type-check  # tsc --noEmit
 ```
 
-## 개발 환경
+## Development
 
-자세한 내용은 [DEVELOPMENT.md](./DEVELOPMENT.md)를 참조하세요.
+See [DEVELOPMENT.md](./DEVELOPMENT.md) for the development setup.
 
-## v9 → v10 마이그레이션
+## Migrating v9 → v10
 
-### Breaking Changes
+### Breaking changes
 
-- `strict: true` — strictPropertyInitialization 등 준수 필요
-- Evaluator 샌드박스 강화 — `window`/`document` 접근 차단
-- `innerHTML` → `textContent` + DOMPurify
-- `state` getter가 Proxy로 변경 (동작 호환)
-- `bounds` 반환값 Object.freeze (수정 시 spread 복사 필요)
+- `strict: true` — custom components must satisfy `strictPropertyInitialization`, etc.
+- Hardened evaluator sandbox — `window` / `document` / `globalThis` access is blocked
+  (`scene`, `setTimeout`, `Math`, and similar remain available).
+- `innerHTML` → `textContent`, with safe HTML rendering via DOMPurify.
+- The `state` getter is now a Proxy (behavior-compatible: get / has / ownKeys / spread all supported).
+- `bounds` return values are `Object.freeze`d — copy with a spread before mutating.
 
-상세: [CHANGELOG.md](./CHANGELOG.md)
+See [CHANGELOG.md](./CHANGELOG.md) for the full list.
 
-## 라이선스
+## License
 
-이 프로젝트는 독점 라이선스로 배포됩니다.
-라이선스 정보: [http://things-scene.hatiolab.com/EULA/](http://things-scene.hatiolab.com/EULA/)
+This project is distributed under a proprietary license.
+License terms: [http://things-scene.hatiolab.com/EULA/](http://things-scene.hatiolab.com/EULA/)

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

@@ -1 +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"}
+{"version":3,"file":"animate.d.ts","sourceRoot":"","sources":["../../src/animation/animate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAQtE;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,mBAAmB,CA8F5E"}

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

@@ -38,11 +38,13 @@ export default class Animation {
      */
     private _started;
     /**
-     * requestAnimationFrame ID
+     * frameClock 'real' subscription unsubscribe 함수.
+     * (이전: requestAnimationFrame ID 직접 사용 — Phase E2 통합으로 frameClock 으로 위임.)
      */
-    private _raf;
+    private _unsub;
     /**
-     * 타임아웃 ID
+     * 타임아웃 ID — interval > 0 인 반복 애니메이션의 재생 간격용.
+     * (frameClock 'real' subscribe 가 다시 시작될 때까지 대기)
      */
     private _timeout;
     /**

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

@@ -1 +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"}
+{"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;AAGlF;;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;;;OAGG;IACH,OAAO,CAAC,MAAM,CAA2B;IAEzC;;;OAGG;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;IAwFb;;;OAGG;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAgBjC;;;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/heartbeat.d.ts

@@ -10,14 +10,7 @@ interface HeartBeatConfig extends AnimationConfig {
  * 하트비트 애니메이션 클래스
  */
 export default class HeartBeat extends Animation {
-    /**
-     * 애니메이션 설정
-     */
     protected config: HeartBeatConfig;
-    /**
-     * 애니메이션 단계 실행
-     * @param delta 델타 값 (0-1)
-     */
     step(delta: number): void;
 }
 export {};

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

@@ -1 +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"}
+{"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,UAAkB,MAAM,EAAE,eAAe,CAAA;IAEzC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAW1B"}

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

@@ -24,11 +24,23 @@ interface WaypointClient extends AnimationClient {
     delta(property?: string | object, value?: any): any;
 }
 /**
- * 웨이포인트 애니메이션 설정 인터페이스
+ * 웨이포인트 애니메이션 설정 인터페이스.
+ *
+ * - `yawOffset`: heading 계산 시 atan2(dy, dx)에 더해지는 라디안 오프셋.
+ *   things-scene 의 default 컨벤션은 vehicle forward = component-local -Z
+ *   (canvas 위쪽이 전방). 이 컨벤션 모델은 명시 안 해도 동작 (default π/2).
+ *   GLB Khronos 표준(+Z forward) 모델은 `yawOffset: 0`, 다른 컨벤션은 그에
+ *   맞는 값을 명시. 이 값은 model forward 와 framework default 의 각도 차.
+ *
+ * - `finalize`: cancel/완료 시점에 위치를 어떻게 정리할지.
+ *   - 'snap' (default): toComponent center 로 강제 텔레포트 (기존 동작).
+ *   - 'hold': 현재 위치 유지 (cancel-and-redirect 시나리오용).
  */
 interface WaypointConfig extends AnimationConfig {
     fromComponent: WaypointComponent;
     toComponent: WaypointComponent;
+    yawOffset?: number;
+    finalize?: 'snap' | 'hold';
 }
 /**
  * 웨이포인트 애니메이션 클래스
@@ -42,16 +54,45 @@ export default class Waypoint extends Animation {
      * 클라이언트 타입 확장
      */
     protected client: WaypointClient;
+    /**
+     * Cached scene-frame endpoints, captured at start().
+     *
+     * Why cache: step() must run an absolute linear lerp from the original
+     * start to the original end, parameterised on `delta` (Animation 's
+     * progress 0→1). Re-reading `fromComponent.center` every step would
+     * conflate "lerp progress" with "where the component currently is",
+     * because the previous frame's lerp already moved the component.
+     * The result is an iterative critically-damped decay (component
+     * approaches target asymptotically) instead of linear motion — visible
+     * as "30s duration completing in ~2s" regardless of the configured
+     * duration. Caching the endpoints once preserves linear semantics:
+     * at progress=t the component is exactly t of the way from the
+     * original `from` to the original `to`, end of story.
+     */
+    private _startX;
+    private _startY;
+    private _endX;
+    private _endY;
     /**
      * 애니메이션 시작
      */
     start(): void;
     /**
-     * 애니메이션 정지
+     * 애니메이션 정지.
+     *
+     * - `finalize: 'snap'` (default): toComponent center 로 텔레포트. 정상 완료
+     *   시점에 끝점 정확히 맞춤 (RAF progress 의 부동소수 잔차 제거).
+     * - `finalize: 'hold'`: 현재 위치 유지. 새 motion 이 가로채는 cancel-and-
+     *   redirect 시나리오에서 시각적 점프 방지.
+     *
+     * `callback` 인자를 받아 `super.stop(callback)` 으로 forward — config 의
+     * `onComplete` 가 정상 호출되도록. (기존엔 인자 누락으로 callback drop.)
      */
-    stop(): void;
+    stop(callback?: () => void): void;
     /**
-     * 애니메이션 단계 실행
+     * 애니메이션 단계 실행 — uses endpoints cached in start(), so progress
+     * is honest linear lerp from the original start to the original end.
+     *
      * @param delta 델타 값 (0-1)
      */
     step(delta: number): void;

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;GAYG;AACH,UAAU,cAAe,SAAQ,eAAe;IAC9C,aAAa,EAAE,iBAAiB,CAAA;IAChC,WAAW,EAAE,iBAAiB,CAAA;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC3B;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;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,KAAK,CAAI;IAEjB;;OAEG;IACH,KAAK,IAAI,IAAI;IA8Bb;;;;;;;;;;OAUG;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAcjC;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAK1B"}

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

@@ -39,7 +39,7 @@ export interface AnimationConfig {
     /**
      * 애니메이션 단계 실행 함수
      */
-    step: Function;
+    step?: Function;
     /**
      * 반복 여부
      */

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

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

package/dist-types/clock/frame-clock.d.ts

@@ -0,0 +1,119 @@
+export type TickHandler = (dt: number, simTime: number) => void;
+export type Unsubscribe = () => void;
+export interface SubscribeOptions {
+    /** 이 subscription 의 유래 (모니터링/디버깅용). 예: 'TransitionEffect' / 'Conveyor3D[c-123]' */
+    description?: string;
+    /**
+     * Subscription 의 lifecycle owner — WeakRef 로 추적되는 컴포넌트.
+     * 모니터링 패널에서 "누가 등록했는가" (subscriber/owner) 로 표시.
+     */
+    component?: any;
+    /**
+     * 이 subscription 이 매 프레임 다루는 "애니메이션 대상 객체" 들.
+     * subscriber 와 다를 수 있음 (예: TransitionEffect 는 root 가 owner 지만,
+     * 실제 reparent 대상들은 따로 있음). 동적 — 매 snapshot 마다 호출됨.
+     * 단일 객체 / 배열 / null 어느 쪽이든 OK.
+     */
+    getTargets?: () => any | any[] | null | undefined;
+    /** 추가 메타데이터 (모니터링 패널에 표시). */
+    metadata?: Record<string, any>;
+}
+/** 컴포넌트 식별 요약 정보 (subscriber 또는 target 표시용). */
+export interface ComponentInfoSummary {
+    type?: string;
+    id?: string;
+    refid?: string | number;
+    className?: string;
+}
+export interface SubscriptionInfo {
+    id: number;
+    description: string;
+    /** Subscription 을 등록한 lifecycle owner (subscriber). */
+    componentInfo?: ComponentInfoSummary;
+    /** 이 subscription 이 매 프레임 다루는 애니메이션 대상들. owner 와 다를 수 있음. */
+    targetInfos?: ComponentInfoSummary[];
+    metadata?: Record<string, any>;
+    registeredAt: number;
+    tickCount: number;
+    totalDurationMs: number;
+    avgDurationMs: number;
+    lastDt: number;
+    lastDurationMs: number;
+}
+/**
+ * frameClock 외부에서 자체 RAF/timer 로 동작하는 애니메이션 등록 정보.
+ *
+ * setInterval polling, 외부 라이브러리 RAF (OrbitControls 등), 자체 타이머 사용
+ * 시스템들이 모니터링 패널에 표시되도록 자기 자신을 register/unregister 한다.
+ *
+ * AGV/Forklift 가 pick 후에 멈추지 않는 등의 stuck animation 추적에 핵심.
+ */
+export interface ExternalAnimationInfo {
+    id: number;
+    description: string;
+    source: string;
+    metadata?: Record<string, any>;
+    registeredAt: number;
+    liveDurationMs: number;
+}
+export interface ExternalAnimationHandle {
+    /** 메타데이터 갱신 (예: 진행률 업데이트). */
+    update(metadata: Record<string, any>): void;
+    /** 등록 해제. 애니메이션 종료 시 반드시 호출. */
+    unregister(): void;
+}
+export interface FrameClockSnapshot {
+    realTime: number;
+    simTime: number;
+    isRunning: boolean;
+    speed: number;
+    paused: boolean;
+    totalTicks: number;
+    /** 최근 ~1초 평균 tick/sec (TPS). 60Hz display = ~60. 부하 시 떨어짐. */
+    ticksPerSecond: number;
+    totalSubs: number;
+    subscriptions: SubscriptionInfo[];
+    /** frameClock 외부에서 동작 중인 애니메이션들 (자체 RAF/timer 사용). */
+    externalAnimations: ExternalAnimationInfo[];
+}
+export interface FrameClock {
+    /** 단조증가 wall-clock (FrameClock 시작 후 ms). 모니터링/측정용. */
+    readonly realTime: number;
+    /**
+     * Simulation time — globalSimClock.now 와 동일.
+     * paused 일 때 정지, speed 적용.
+     */
+    readonly simTime: number;
+    /** 현재 RAF 루프 활성 여부. */
+    readonly isRunning: boolean;
+    /**
+     * 매 frame 호출되는 handler 등록.
+     * handler 는 (simDt, simTime) 받음 — paused 시 simDt=0.
+     *
+     * 첫 subscribe 시 RAF 루프 자동 시작. 마지막 unsubscribe 시 자동 정지.
+     *
+     * options.description 을 전달하면 모니터링 패널에 표시되어 디버깅에 도움.
+     */
+    subscribe(handler: TickHandler, options?: SubscribeOptions): Unsubscribe;
+    /**
+     * 단일 tick 수동 실행 (테스트/replay 용). 프로덕션에서 호출 금지.
+     * @param realDeltaMs 가짜 wall-clock delta (ms)
+     */
+    tick(realDeltaMs: number): void;
+    /** RAF 루프 명시 시작 (일반적으로 subscribe 시 자동 시작). */
+    start(): void;
+    /** RAF 루프 명시 중단. 테스트/dispose 용. */
+    stop(): void;
+    /**
+     * frameClock 외부에서 자체 RAF/timer 로 동작하는 애니메이션 등록.
+     * 모니터링 패널에 표시되어 "지금 무슨 애니메이션이 돌고 있는가" 확인 가능.
+     */
+    registerExternalAnimation(description: string, source: string, metadata?: Record<string, any>): ExternalAnimationHandle;
+    /**
+     * 현재 상태 + 모든 활성 subscription + 외부 애니메이션 스냅샷.
+     * Chrome Extension monitor / DevTools 에서 디버깅용.
+     */
+    snapshot(): FrameClockSnapshot;
+}
+export declare const frameClock: FrameClock;
+//# sourceMappingURL=frame-clock.d.ts.map

package/dist-types/clock/frame-clock.d.ts.map

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

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

@@ -0,0 +1,3 @@
+export { frameClock } from './frame-clock.js';
+export type { FrameClock, TickHandler, Unsubscribe, SubscribeOptions, SubscriptionInfo, FrameClockSnapshot, ExternalAnimationInfo, ExternalAnimationHandle } from './frame-clock.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clock/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,kBAAkB,CAAA"}

package/dist-types/command/command-migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-migrate.d.ts","sourceRoot":"","sources":["../../src/command/command-migrate.ts"],"names":[],"mappings":"AAIA,OAAO,OAAO,MAAM,cAAc,CAAA;AAgElC,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,OAAO;CAkCR"}
+{"version":3,"file":"command-migrate.d.ts","sourceRoot":"","sources":["../../src/command/command-migrate.ts"],"names":[],"mappings":"AAIA,OAAO,OAAO,MAAM,cAAc,CAAA;AA8FlC,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,OAAO;CAwCR"}

package/dist-types/command/snapshot-commander.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-commander.d.ts","sourceRoot":"","sources":["../../src/command/snapshot-commander.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC,SAAS,EAAE,GAAG,CAAA;IACd,WAAW,EAAE,GAAG,CAAA;IAChB,cAAc,EAAE,GAAG,CAAA;IACnB,OAAO,EAAE,GAAG,CAAA;gBAEA,SAAS,EAAE,GAAG;IAkB1B,OAAO;IAUP,QAAQ;IAIR,qBAAqB;IAIrB,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG;IAS/B,IAAI;IAQJ,IAAI;IAQJ,QAAQ;IAIR,QAAQ;IAIR,KAAK;CAIN"}
+{"version":3,"file":"snapshot-commander.d.ts","sourceRoot":"","sources":["../../src/command/snapshot-commander.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC,SAAS,EAAE,GAAG,CAAA;IACd,WAAW,EAAE,GAAG,CAAA;IAChB,cAAc,EAAE,GAAG,CAAA;IACnB,OAAO,EAAE,GAAG,CAAA;gBAEA,SAAS,EAAE,GAAG;IAkB1B,OAAO;IAUP,QAAQ;IAIR,qBAAqB;IAIrB,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG;IAS/B,IAAI;IAQJ,IAAI;IAQJ,QAAQ;IAIR,QAAQ;IAIR,KAAK;CAIN"}

package/dist-types/components/audio.d.ts

@@ -39,12 +39,14 @@ declare const AudioPlayer_base: {
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../types/component.js").Container): void;
+        removed(parent: import("../types/component.js").Container): void;
         ready(): Promise<void>;
+        _readyInvoked: boolean;
+        invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         dispose(): void;
         get nature(): import("../index.js").ComponentNature;
@@ -63,16 +65,17 @@ declare const AudioPlayer_base: {
         isConnectable(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
-        setState(props: any, propval?: any): any;
+        getState(property: string): any;
+        setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
-        get state(): any;
+        get state(): import("../index.js").State;
+        get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("./component.js").ApplyPropsOptions): /*elided*/ any;
         move(offset: {
             x: number;
             y: number;
@@ -160,7 +163,7 @@ declare const AudioPlayer_base: {
         findAll(s: string | ((c: Component) => boolean), ...others: any[]): any[] | undefined;
         capture(x: number, y: number, except?: (c: Component) => boolean): any;
         findAnchor(name: string): any;
-        isDescendible(container: Component): boolean;
+        isDescendible(container: Component | any): boolean;
         getContext(component?: unknown): any;
         get root(): Component;
         get rootModel(): Component;
@@ -204,9 +207,13 @@ declare const AudioPlayer_base: {
         toLocal(x: number, y: number, top?: Component): import("../index.js").POINT;
         toGlobal(x: number, y: number, top?: Component): import("../index.js").POINT;
         toOther(x: number, y: number, target: Component): import("../index.js").POINT;
+        on<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback: (...args: import("../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
         on(name: string | object, callback: Function, context?: any): /*elided*/ any;
+        off<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback?: ((...args: import("../index.js").ComponentEventMap[K]) => void) | undefined, context?: any): /*elided*/ any;
         off(name?: string | object, callback?: Function, context?: any): /*elided*/ any;
+        once<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback: (...args: import("../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
         once(name: string | object, callback: Function, context?: any): /*elided*/ any;
+        trigger<K extends keyof import("../index.js").ComponentEventMap>(name: K, ...args: import("../index.js").ComponentEventMap[K]): /*elided*/ any;
         trigger(name: string, ...args: any[]): /*elided*/ any;
         delegate_on(delegator: any): /*elided*/ any;
         delegate_off(delegator: any): /*elided*/ any;

package/dist-types/components/audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/components/audio.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,KAAK,MAAM,YAAY,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoC9B,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,gBAAe;IACtD,MAAM,CAAC,KAAK,EAAE,GAAG,CAAA;IACjB,MAAM,EAAE,GAAG,CAAA;IAEX,MAAM,KAAK,KAAK,QAOf;IAED,OAAO;IAOD,KAAK;IAgBX,MAAM,CAAC,GAAG,EAAE,wBAAwB;IAQpC,IAAI,MAAM;;;;;;;;;;;;;;;;;;;MAET;IAED,IAAI,eAAe,YAElB;IAED,IAAI,GAAG,QAEN;IAED,IAAI,GAAG,CAAC,GAAG,KAAA,EAEV;IAED,IAAI,OAAO,YAEV;IAED,IAAI,OAAO,CAAC,OAAO,SAAA,EAElB;IAED,KAAK;IAOL,KAAK;IAOL,WAAW,CAAC,GAAG,EAAE,GAAG;IAapB,eAAe,CAAC,OAAO,EAAE,GAAG;IAkB5B,YAAY,CAAC,IAAI,EAAE,GAAG;IAItB,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG;IAMhC,UAAU,CAAC,CAAC,EAAE,GAAG;IAIjB,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE;CAQjD"}
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/components/audio.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,KAAK,MAAM,YAAY,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoC9B,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,gBAAe;IACtD,MAAM,CAAC,KAAK,EAAE,GAAG,CAAA;IACjB,MAAM,EAAE,GAAG,CAAA;IAEX,MAAM,KAAK,KAAK,QAOf;IAED,OAAO;IAOD,KAAK;IA2BX,MAAM,CAAC,GAAG,EAAE,wBAAwB;IAQpC,IAAI,MAAM;;;;;;;;;;;;;;;;;;;MAET;IAED,IAAI,eAAe,YAElB;IAED,IAAI,GAAG,QAEN;IAED,IAAI,GAAG,CAAC,GAAG,KAAA,EAEV;IAED,IAAI,OAAO,YAEV;IAED,IAAI,OAAO,CAAC,OAAO,SAAA,EAElB;IAED,KAAK;IAOL,KAAK;IAOL,WAAW,CAAC,GAAG,EAAE,GAAG;IAapB,eAAe,CAAC,OAAO,EAAE,GAAG;IAkB5B,YAAY,CAAC,IAAI,EAAE,GAAG;IAItB,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG;IAMhC,UAAU,CAAC,CAAC,EAAE,GAAG;IAIjB,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE;CAQjD"}