@hatiolab/things-scene 10.0.0-beta.12 → 10.0.0-beta.120

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

@@ -1,5 +1,7 @@
+import type Component from '../components/component.js';
+import type Container from '../components/container.js';
 /**
- * 레이아웃 인터페이스
+ * 레이아웃 인터페이스 (구현체용)
  */
 export interface LAYOUT {
     reflow(container: any, component?: any): void;
@@ -9,6 +11,38 @@ export interface LAYOUT {
     keyNavigate?(container: any, component: any, e: KeyboardEvent): any | undefined;
     joinType?: boolean;
 }
+/**
+ * 레이아웃 인터페이스 (Public API — 외부 타입 어노테이션용)
+ *
+ * A layout strategy defines how a container arranges its child components.
+ * Only components with `position: 'static'` should be affected by layout.
+ */
+export interface Layout {
+    /**
+     * Recalculates the positions and sizes of child components.
+     */
+    reflow(container: Container, component?: Component): void;
+    /**
+     * Returns components that are eligible for interaction.
+     */
+    capturables(container: Container): Component[];
+    /**
+     * Returns components that should be rendered.
+     */
+    drawables(container: Container): Component[];
+    /**
+     * Determines whether the given component is "stuck" in its layout position.
+     */
+    isStuck(component: Component): boolean;
+    /**
+     * (Optional) Key navigation handler for keyboard interaction within the layout.
+     */
+    keyNavigate?(container: Container, component: Component, e: KeyboardEvent): Component | undefined;
+    /**
+     * (Optional) Whether the layout joins component types.
+     */
+    joinType?: boolean;
+}
 /**
  * 레이아웃 레지스트리 인터페이스
  */

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

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/interfaces/layout.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,GAAG,IAAI,CAAA;IAC7C,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;IAClC,SAAS,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;IAChC,OAAO,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAA;IAChC,WAAW,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,aAAa,GAAG,GAAG,GAAG,SAAS,CAAA;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,IAAI,IAAI;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;CACnC"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/interfaces/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AACvD,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AAEvD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,GAAG,IAAI,CAAA;IAC7C,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;IAClC,SAAS,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;IAChC,OAAO,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAA;IAChC,WAAW,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,aAAa,GAAG,GAAG,GAAG,SAAS,CAAA;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IAEzD;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,CAAA;IAE9C;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,CAAA;IAE5C;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAA;IAEtC;;OAEG;IACH,WAAW,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS,CAAA;IAEjG;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,IAAI,IAAI;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;CACnC"}

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

@@ -1,35 +1,47 @@
 import type { SceneMode } from '../const';
 import type { Scene } from '../types/scene';
 /**
- * 참조 제공자 인터페이스
+ * Provides sub-board references for board-to-board linking (goto, link-open).
+ * Implementations should cache loaded scenes and handle lifecycle (release).
  */
 export interface ReferenceProvider {
+    /** All registered board IDs */
     get ids(): string[];
+    /** Register a board scene by ID */
     add(id: string, target?: any): Promise<Scene & {
         release: () => void;
     }>;
+    /** Get a board scene by ID, optionally creating if not found */
     get(id: string, createIf?: boolean): Promise<Scene & {
         release: () => void;
     }>;
+    /** Create a new board scene by ID */
     create(id: string): Promise<Scene & {
         release: () => void;
     }>;
 }
 /**
- * 데이터 구독 제공자 인터페이스
+ * Provides real-time data subscriptions for components with a `tag` property.
+ * Components receive live data via `component.data = ...` when subscribed.
  */
 export interface DataSubscriptionProvider {
+    /** Subscribe a component to a data tag. Returns an unsubscribe handle. */
     subscribe(tag: string, component: any): Promise<{
         unsubscribe: () => void;
     }>;
+    /** Dispose all active subscriptions */
     dispose(): void;
 }
 /**
- * 영속성 데이터 저장소 인터페이스
+ * Per-component persistent data storage for saving/restoring component state
+ * across sessions (e.g. user inputs, slider positions).
  */
 export interface PersistentDataStorage {
+    /** Load persisted data for a component */
     load(key: object): Promise<any>;
+    /** Save data for a component */
     save(key: object, value: any): Promise<void>;
+    /** Clear persisted data for a component */
     clear(key: object): Promise<void>;
 }
 /**
@@ -50,6 +62,11 @@ export interface ApplicationContext {
     PPI?: number;
     /** Command executor for undo/redo operations (edit mode) */
     commander?: any;
+    /** Loading monitor */
+    loadTracker?: import('../diagnostics/load-tracker.js').LoadTracker;
+    adoptLoadTracker?(tracker: import('../diagnostics/load-tracker.js').LoadTracker): void;
+    /** Data lag monitor (optional, created when dataLagMonitor configured) */
+    lagTracker?: import('../diagnostics/data-lag-tracker.js').DataLagTracker;
     url(x: string): string;
     dispose(): void;
     subscribe?(tag: string, component: any): Promise<any>;

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

@@ -1 +1 @@
-{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/interfaces/providers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAE3C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,GAAG,IAAI,MAAM,EAAE,CAAA;IACnB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAA;IACvE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAA;IAC7E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAA;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAA;IAC5E,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAA;IAC3C,QAAQ,CAAC,wBAAwB,EAAE,wBAAwB,CAAA;IAC3D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAE5B,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,SAAS,CAAC,EAAE,GAAG,CAAA;IAEf,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,OAAO,IAAI,IAAI,CAAA;IACf,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;CACtD"}
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/interfaces/providers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAE3C;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,IAAI,GAAG,IAAI,MAAM,EAAE,CAAA;IACnB,mCAAmC;IACnC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAA;IACvE,gEAAgE;IAChE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAA;IAC7E,qCAAqC;IACrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAA;CAC7D;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAA;IAC5E,uCAAuC;IACvC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/B,gCAAgC;IAChC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,2CAA2C;IAC3C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAA;IAC3C,QAAQ,CAAC,wBAAwB,EAAE,wBAAwB,CAAA;IAC3D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAE5B,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,SAAS,CAAC,EAAE,GAAG,CAAA;IAEf,sBAAsB;IACtB,WAAW,CAAC,EAAE,OAAO,gCAAgC,EAAE,WAAW,CAAA;IAClE,gBAAgB,CAAC,CAAC,OAAO,EAAE,OAAO,gCAAgC,EAAE,WAAW,GAAG,IAAI,CAAA;IACtF,0EAA0E;IAC1E,UAAU,CAAC,EAAE,OAAO,oCAAoC,EAAE,cAAc,CAAA;IAExE,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,OAAO,IAAI,IAAI,CAAA;IACf,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;CACtD"}

package/dist-types/interfaces/real-object.d.ts

@@ -4,9 +4,16 @@ import type { Properties } from './types.js';
  * Component의 3D 표현을 담당하는 객체가 구현해야 하는 계약.
  * 실제 구현은 src/threed/real-object.ts에서 제공.
  *
- * Three.js 의존성 없음 — THREE 관련 멤버는 IThreeRealObject(src/threed/interfaces.ts)에서 확장.
+ * Three.js 직접 import 의존성은 없지만, 모든 실 구현(RealObject<T extends THREE.Object3D>)이
+ * object3d 를 갖기 때문에 인터페이스에도 노출. 타입은 any — 명시 타입이 필요한
+ * 곳은 IThreeRealObject(src/threed/interfaces.ts) 또는 구체 구현 클래스로 좁혀 사용.
  */
 export interface IRealObject {
+    /**
+     * THREE.Object3D 인스턴스. THREE 의존성 회피를 위해 any 로 노출.
+     * 명시 THREE.Object3D 타입이 필요하면 IThreeRealObject 로 narrow.
+     */
+    object3d?: any;
     /** 3D 오브젝트 업데이트 (build + dimension + transform + 외관) */
     update(): void;
     /** 리소스 해제 */

package/dist-types/interfaces/real-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"real-object.d.ts","sourceRoot":"","sources":["../../src/interfaces/real-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAE1B,wDAAwD;IACxD,MAAM,IAAI,IAAI,CAAA;IACd,aAAa;IACb,OAAO,IAAI,IAAI,CAAA;IAGf,0CAA0C;IAC1C,eAAe,IAAI,IAAI,CAAA;IACvB,oDAAoD;IACpD,eAAe,IAAI,IAAI,CAAA;IACvB,eAAe;IACf,cAAc,IAAI,IAAI,CAAA;IAGtB,gBAAgB;IAChB,WAAW,IAAI,IAAI,CAAA;IACnB,eAAe;IACf,YAAY,IAAI,IAAI,CAAA;IACpB,iBAAiB;IACjB,eAAe,IAAI,IAAI,CAAA;IACvB,eAAe;IACf,iBAAiB,IAAI,IAAI,CAAA;IACzB,gBAAgB;IAChB,UAAU,IAAI,IAAI,CAAA;IAGlB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IAGrD,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAA;CACjB"}
+{"version":3,"file":"real-object.d.ts","sourceRoot":"","sources":["../../src/interfaces/real-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAA;IAGd,wDAAwD;IACxD,MAAM,IAAI,IAAI,CAAA;IACd,aAAa;IACb,OAAO,IAAI,IAAI,CAAA;IAGf,0CAA0C;IAC1C,eAAe,IAAI,IAAI,CAAA;IACvB,oDAAoD;IACpD,eAAe,IAAI,IAAI,CAAA;IACvB,eAAe;IACf,cAAc,IAAI,IAAI,CAAA;IAGtB,gBAAgB;IAChB,WAAW,IAAI,IAAI,CAAA;IACnB,eAAe;IACf,YAAY,IAAI,IAAI,CAAA;IACpB,iBAAiB;IACjB,eAAe,IAAI,IAAI,CAAA;IACvB,eAAe;IACf,iBAAiB,IAAI,IAAI,CAAA;IACzB,gBAAgB;IAChB,UAAU,IAAI,IAAI,CAAA;IAGlB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IAGrD,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAA;CACjB"}

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

@@ -12,59 +12,131 @@ export interface DrawOptions {
     override?: Record<string, any>;
 }
 /**
- * 스타일 옵션을 정의하는 인터페이스
+ * 스타일 옵션 — gradient / pattern 타입 fillStyle 의 공통 베이스.
+ *
+ * 주의: 'solid' 채우기는 객체가 아니라 단순 색상 문자열이다 (`state.fillStyle = '#ff0000'`).
+ * 이 인터페이스는 객체 형태일 때만 (gradient / pattern) 적용된다.
  */
 export interface StyleOptions {
     type?: string;
-    gradientType?: string;
+    gradientType?: 'linear' | 'radial';
     rotation?: number;
     color?: string;
-    colors?: string[];
-    stops?: number[];
+    /** 인덱스 시그니처 — pattern 의 fitPattern / align / offsetX / offsetY 등 자유 필드 허용. */
     [key: string]: any;
 }
 /**
- * 채우기 스타일을 정의하는 인터페이스
+ * 채우기 스타일 — `state.fillStyle` 타입.
+ *
+ * 실제 형식 (drawer/fill.ts 검증):
+ *   - **solid**: 그냥 색상 문자열 — 객체 아님. e.g., `state.fillStyle = '#ff0000'` 또는 `'rgba(...)'`.
+ *   - **gradient**: 객체 — `{ type: 'gradient', gradientType, colorStops: [{position, color}], rotation, ... }`
+ *   - **pattern**: 객체 — `{ type: 'pattern', image, fitPattern?, noRepeat?, align?, offsetX?, offsetY?, width?, height?, color? }`
+ *   - **none**: `undefined` 또는 `null`.
+ *
+ * 따라서 `state.fillStyle` 의 실제 타입은 `string | FillStyle | undefined`.
  */
+export type FillStyleValue = string | FillStyle | undefined;
 export interface FillStyle extends StyleOptions {
-    type: 'solid' | 'gradient' | 'pattern' | 'image';
-    color?: string;
+    type: 'gradient' | 'pattern';
+    /** gradient: 색상-위치 stops. drawer/fill.ts:79 가 사용. */
+    colorStops?: Array<{
+        position: number;
+        color: string;
+    }>;
+    /** pattern: 이미지 URL 또는 asset 참조. */
+    image?: string;
+    /** pattern: 영역에 맞춰 비율 조정. */
+    fitPattern?: boolean;
+    /** pattern: 반복 안 함 (1회만). */
+    noRepeat?: boolean;
+    /** pattern: 영역 내 정렬. */
+    align?: 'center' | 'left-top' | 'left-bottom' | 'right-top' | 'right-bottom' | 'left' | 'right' | 'top' | 'bottom';
+    /** pattern: fitPattern=false 일 때 영역 내 위치. */
+    offsetX?: number;
+    offsetY?: number;
+    /** pattern: 패턴 크기 (기본은 이미지 원본 크기). */
+    width?: number;
+    height?: number;
+    /** 컴포넌트 alpha 와 별개 — gradient/pattern 의 자체 투명도. */
     opacity?: number;
 }
 /**
- * 선 스타일을 정의하는 인터페이스
+ * 선 / 테두리 스타일 — **state 에 top-level flat 으로 저장되는 필드들**.
+ *
+ * 실제 형식 (drawer/stroke.ts:6 destructure 검증):
+ *   `{ strokeStyle, lineDash, lineWidth, lineCap, lineJoin, alpha } = component.state`
+ *
+ * - `state.strokeStyle`: 색상 문자열 (Canvas API 의 strokeStyle 직접 대입)
+ * - `state.lineWidth`: number
+ * - `state.lineDash`: STRING preset 이름 — 'solid' / 'round-dot' / 'square-dot' /
+ *   'dash' / 'dash-dot' / 'long-dash' / 'long-dash-dot' / 'long-dash-dot-dot'
+ * - `state.lineCap`: 'butt' | 'round' | 'square'
+ * - `state.lineJoin`: 'miter' | 'round' | 'bevel'
+ *
+ * 이 인터페이스는 historic 한 객체 구조 — 실제로는 사용 안 됨. 참고용.
+ * 새 코드는 state 의 top-level 필드를 직접 사용할 것.
  */
 export interface StrokeStyle {
+    /** @deprecated 실제로는 `state.lineWidth` (top-level). */
     width?: number;
+    /** @deprecated 실제로는 `state.strokeStyle` (string color). */
     color?: string;
+    /** @deprecated 실제로는 컴포넌트 `state.alpha` 가 stroke 에도 적용. */
     opacity?: number;
+    /** @deprecated 실제로는 `state.lineCap`. */
     lineCap?: CanvasLineCap;
+    /** @deprecated 실제로는 `state.lineJoin`. */
     lineJoin?: CanvasLineJoin;
-    lineDash?: number[];
+    /** @deprecated 실제로는 `state.lineDash` — number[] 가 아닌 STRING preset 이름. */
+    lineDash?: string;
+    /** @deprecated 미사용. */
     lineDashOffset?: number;
 }
 /**
- * 텍스트 스타일을 정의하는 인터페이스
+ * 텍스트 / 폰트 스타일 — **state 에 top-level flat 으로 저장**.
+ *
+ *   `state.fontFamily / fontSize / fontStyle / fontWeight / fontColor /
+ *    textAlign / textBaseline / lineHeight`
+ *
+ * 이 인터페이스는 필드 이름 reference 용 — 객체로 묶어 저장하지 않는다.
  */
 export interface TextStyle {
-    font?: string;
-    fontSize?: number;
-    fontColor?: string;
     fontFamily?: string;
+    fontSize?: number;
     fontStyle?: string;
     fontWeight?: string;
+    fontColor?: string;
     textAlign?: CanvasTextAlign;
     textBaseline?: CanvasTextBaseline;
     lineHeight?: number;
+    /** @deprecated 사용처 없음. */
+    font?: string;
 }
 /**
- * 그림자 효과를 정의하는 인터페이스
+ * 그림자 효과 — `state.shadow` 객체 형식.
+ *
+ * Canonical 이름 (CSS box-shadow / Canvas API 와 일치):
+ *   `{ offsetX, offsetY, blur, color } = state.shadow`
+ *
+ * Backwards compatibility — 옛 이름 (`left`, `top`, `blurSize`) 도 drawer 가
+ * fallback 으로 읽음. 영속된 옛 데이터는 마이그레이션 없이 그대로 렌더링.
+ * 새 코드는 canonical 이름 사용.
  */
 export interface Shadow {
     color?: string;
+    /** Horizontal offset (CSS box-shadow 의 offset-x, Canvas 의 shadowOffsetX). */
     offsetX?: number;
+    /** Vertical offset (CSS box-shadow 의 offset-y, Canvas 의 shadowOffsetY). */
     offsetY?: number;
+    /** Blur radius (CSS box-shadow 의 blur-radius, Canvas 의 shadowBlur). */
     blur?: number;
+    /** @deprecated `offsetX` 사용. drawer 가 fallback 으로 읽음 — 옛 데이터 호환용. */
+    left?: number;
+    /** @deprecated `offsetY` 사용. drawer 가 fallback 으로 읽음 — 옛 데이터 호환용. */
+    top?: number;
+    /** @deprecated `blur` 사용. drawer 가 fallback 으로 읽음 — 옛 데이터 호환용. */
+    blurSize?: number;
 }
 /** Fill drawer — 그라디언트, 패턴, 이미지 채우기 */
 export interface IFillDrawer {

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

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

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

@@ -8,8 +8,27 @@ export type Class = {
 export type Properties = {
     [key: string]: any;
 };
-export type State = Properties;
 export type Style = Properties;
+/**
+ * Component state — 임의 필드를 갖는 동적 객체.
+ *
+ * 컴포넌트별로 자기 state 형태를 선언하고 싶으면 이 인터페이스를 extends 하여
+ * 필드를 추가하고, 컴포넌트 클래스에서 `declare state: MyState` 로 좁히면 된다:
+ *
+ *   interface MyState extends State {
+ *     mySpecificField: number
+ *     myStatus: 'idle' | 'busy'
+ *   }
+ *   class MyComponent extends RectPath(Shape) {
+ *     declare state: MyState  // 타입 narrowing — 런타임 영향 없음
+ *   }
+ *
+ * 기존 `state.foo` 접근 코드는 인덱스 시그니처로 호환된다.
+ * 추후 단계적으로 공통 필드(left/top/width/height/...)를 명시적으로 추가할 수 있다.
+ */
+export interface State {
+    [key: string]: any;
+}
 /**
  * 좌표, 위치, 크기 관련 타입
  */

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

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

package/dist-types/layer/action/popup.d.ts

@@ -1,6 +1,7 @@
 import { Position } from '../../types/bounding.js';
 import { Component } from '../../types/component.js';
 import { PopupOrigin } from '../../components/position/popup-position.js';
+import { type AnchorPin } from '../../threed/utils/anchor.js';
 export default class ScenePopup {
     static hideAll(root: any): void;
     static hide(component: Component): void;
@@ -14,6 +15,18 @@ export default class ScenePopup {
         popupPosition?: Position;
         origin?: PopupOrigin;
         title?: string;
+        threed?: boolean;
+        containerRef?: string;
+        htmlTemplate?: string;
+        anchor?: Component;
+        anchorPin?: AnchorPin;
+        anchorOffsetX?: number;
+        anchorOffsetY?: number;
+        anchorOffsetZ?: number;
+        constantSize?: boolean;
+        billboard?: boolean;
+        tether?: boolean;
+        offScreen?: 'hide' | 'edge-pin' | 'keep-last';
     }): void;
 }
 //# sourceMappingURL=popup.d.ts.map

package/dist-types/layer/action/popup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../../../src/layer/action/popup.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEpD,OAAO,EAIL,WAAW,EACZ,MAAM,6CAA6C,CAAA;AA4RpD,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;IAKxB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS;IAoBhC,MAAM,CAAC,IAAI,CACT,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,GAAG,CAAA;QACV,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,aAAa,CAAC,EAAE,QAAQ,CAAA;QACxB,MAAM,CAAC,EAAE,WAAW,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;KACV;CAgOT"}
+{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../../../src/layer/action/popup.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEpD,OAAO,EAIL,WAAW,EACZ,MAAM,6CAA6C,CAAA;AAGpD,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAA;AA0sBzF,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;IAKxB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS;IAqChC,MAAM,CAAC,IAAI,CACT,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,GAAG,CAAA;QACV,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,aAAa,CAAC,EAAE,QAAQ,CAAA;QACxB,MAAM,CAAC,EAAE,WAAW,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,OAAO,CAAA;QAEhB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,YAAY,CAAC,EAAE,MAAM,CAAA;QAGrB,MAAM,CAAC,EAAE,SAAS,CAAA;QAClB,SAAS,CAAC,EAAE,SAAS,CAAA;QACrB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAA;KACzC;CAiTT"}

package/dist-types/layer/add-layer.d.ts

@@ -4,6 +4,14 @@ export default class AddLayer extends Layer {
     before_mode: any;
     models: any;
     downpoint: any;
+    /** bulk-create mode flag — ondragend 에서 add 대신 'bulkareaselected' event 발행. */
+    bulkMode?: boolean;
+    /** bulk-create 시 사용자가 전달한 템플릿 model — bulkareaselected event payload 로 그대로 전달. */
+    template?: any;
+    /** bulk-create 시 addbox stroke 색. 기본은 검정 (= 일반 add 와 동일). */
+    boxStrokeStyle?: string;
+    /** ondragstart 가 실제 호출되었는지 — drag 미발생 시 ondragend (잔류 이벤트) 가 들어와도 무시. */
+    dragStarted?: boolean;
     ready(): Promise<void>;
     get pointerEvents(): string;
     render(ctx: any): void;

package/dist-types/layer/add-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-layer.d.ts","sourceRoot":"","sources":["../../src/layer/add-layer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,MAAM,YAAY,CAAA;AAE9B,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,GAAG,CAAA;IACX,WAAW,EAAE,GAAG,CAAA;IAChB,MAAM,EAAE,GAAG,CAAA;IACX,SAAS,EAAE,GAAG,CAAA;IAGhB,KAAK;IAWX,IAAI,aAAa,WAEhB;IAED,MAAM,CAAC,GAAG,KAAA;IAmBV,QAAQ,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA;IAIb,IAAI,QAAQ;;;;;;;;;;;;;;;;;;MAoBX;IAED,mBAAmB,CAAC,KAAK,KAAA,EAAE,MAAM,KAAA,EAAE,IAAI,KAAA;IAYvC,UAAU,CAAC,MAAM,KAAA,EAAE,IAAI,KAAA;IAWvB,SAAS;IAUT,SAAS,CAAC,CAAC,KAAA;IAQX,WAAW,CAAC,CAAC,KAAA;IASb,UAAU,CAAC,CAAC,KAAA;IAeZ,SAAS,CAAC,CAAC,KAAA,EAAE,IAAI,KAAA;IAiBjB,WAAW,CAAC,CAAC,KAAA,EAAE,IAAI,KAAA;IAWnB,SAAS,CAAC,CAAC,KAAA,EAAE,IAAI,KAAA;CAiBlB"}
+{"version":3,"file":"add-layer.d.ts","sourceRoot":"","sources":["../../src/layer/add-layer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,MAAM,YAAY,CAAA;AAE9B,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,GAAG,CAAA;IACX,WAAW,EAAE,GAAG,CAAA;IAChB,MAAM,EAAE,GAAG,CAAA;IACX,SAAS,EAAE,GAAG,CAAA;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAA;IAGf,KAAK;IAWX,IAAI,aAAa,WAEhB;IAED,MAAM,CAAC,GAAG,KAAA;IAmBV,QAAQ,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA;IAIb,IAAI,QAAQ;;;;;;;;;;;;;;;;;;MAoBX;IAED,mBAAmB,CAAC,KAAK,KAAA,EAAE,MAAM,KAAA,EAAE,IAAI,KAAA;IAYvC,UAAU,CAAC,MAAM,KAAA,EAAE,IAAI,KAAA;IAmBvB,SAAS;IAcT,SAAS,CAAC,CAAC,KAAA;IAQX,WAAW,CAAC,CAAC,KAAA;IAUb,UAAU,CAAC,CAAC,KAAA;IAeZ,SAAS,CAAC,CAAC,KAAA,EAAE,IAAI,KAAA;IA8CjB,WAAW,CAAC,CAAC,KAAA,EAAE,IAAI,KAAA;IAWnB,SAAS,CAAC,CAAC,KAAA,EAAE,IAAI,KAAA;CAuBlB"}

package/dist-types/layer/dual-canvas-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dual-canvas-layer.d.ts","sourceRoot":"","sources":["../../src/layer/dual-canvas-layer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,YAAY,CAAA;AAE9B,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,KAAK;IAChD,OAAO,EAAE,GAAG,CAAA;IACZ,UAAU,EAAE,GAAG,CAAA;IACf,aAAa,EAAE,GAAG,CAAA;IAElB,OAAO;IAOP,aAAa,IAAI,GAAG;IA6BpB,MAAM;IAaN,IAAI,MAAM,QAET;IAED,IAAI,SAAS,QAEZ;IAED,IAAI,SAAS,QAcZ;IAED,IAAI,YAAY,QAcf;IAED,UAAU,CAAC,SAAS,EAAE,GAAG;IAQzB,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG;CAiBnB"}
+{"version":3,"file":"dual-canvas-layer.d.ts","sourceRoot":"","sources":["../../src/layer/dual-canvas-layer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,YAAY,CAAA;AAE9B,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,KAAK;IAChD,OAAO,EAAE,GAAG,CAAA;IACZ,UAAU,EAAE,GAAG,CAAA;IACf,aAAa,EAAE,GAAG,CAAA;IAElB,OAAO;IAOP,aAAa,IAAI,GAAG;IA6BpB,MAAM;IAaN,IAAI,MAAM,QAET;IAED,IAAI,SAAS,QAEZ;IAED,IAAI,SAAS,QAcZ;IAED,IAAI,YAAY,QAcf;IAED,UAAU,CAAC,SAAS,EAAE,GAAG;IAYzB,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG;CAiBnB"}

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

@@ -5,4 +5,5 @@ export { default as AddLayer } from './add-layer.js';
 export { default as SelectionLayer } from './selection-layer.js';
 export { default as ModelingLayer } from './modeling-layer.js';
 export { default as ScrollLayer } from './scroll-layer.js';
+export { default as SnapGuideLayer } from './snap-guide-layer.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layer/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layer/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAA"}

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

@@ -7,6 +7,7 @@ export default class Layer extends ContainerAbstract {
     throttle_render: any;
     _target: any;
     _context2D: any;
+    private _firstDrawReported;
     constructor(model: any, context: any);
     get element(): HTMLElement | null;
     set element(v: HTMLElement | null);

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

@@ -1 +1 @@
-{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../../src/layer/layer.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAClD,OAAO,iBAAiB,MAAM,qCAAqC,CAAA;AAInE,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,iBAAiB;IAClD,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAO;IACnC,cAAc,EAAE,GAAG,CAAA;IACnB,QAAQ,EAAE,GAAG,CAAA;IACb,eAAe,EAAE,GAAG,CAAA;IACpB,OAAO,EAAE,GAAG,CAAA;IACZ,UAAU,EAAE,GAAG,CAAA;gBAEH,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;IAiCpC,IAAI,OAAO,IAAI,WAAW,GAAG,IAAI,CAAyB;IAC1D,IAAI,OAAO,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,EAAuB;IAExD,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG;IAsBzD,MAAM;IAIN,OAAO;IAIP,IAAI,YAAY,YAEf;IAED,IAAI,OAAO,IAAI,GAAG,CAAqB;IAEvC,aAAa;IASb,IAAI,aAAa,WAEhB;IAED,IAAI,MAAM,QAET;IAED,IAAI,MAAM,CAAC,MAAM,KAAA,EAuBhB;IAED,IAAI,MAAM,IAAI,iBAAiB,GAAG,IAAI,CAErC;IAED,OAAO;IAQP,IAAI,QAAQ,IAAI,SAAS,EAAE,CAE1B;IAED,IAAI,QAAQ,CAAC,IAAI,EAJD,SAAS,EAIR,EAEhB;IAED,IAAI,2BAA2B,YAE9B;IAED,IAAI,OAAO,qBAEV;IAED,IAAI,OAAO,CAAC,SAAS,kBAAA,EAEpB;IAED,IAAI,SAAS,QAgBZ;IAED,UAAU,CAAC,SAAS,EAAE,GAAG;IASzB,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG;IAalB,SAAS,CAAC,OAAO,EAAE,wBAAwB;IAkB3C,IAAI,WAAW;;;MAMd;IAGD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAI7B,UAAU;IASV,IAAI,CAAC,MAAM,EAAE,GAAG;IAWhB,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG;CAqCvC"}
+{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../../src/layer/layer.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAClD,OAAO,iBAAiB,MAAM,qCAAqC,CAAA;AAInE,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,iBAAiB;IAClD,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAO;IACnC,cAAc,EAAE,GAAG,CAAA;IACnB,QAAQ,EAAE,GAAG,CAAA;IACb,eAAe,EAAE,GAAG,CAAA;IACpB,OAAO,EAAE,GAAG,CAAA;IACZ,UAAU,EAAE,GAAG,CAAA;IACf,OAAO,CAAC,kBAAkB,CAAQ;gBAEtB,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;IA8CpC,IAAI,OAAO,IAAI,WAAW,GAAG,IAAI,CAAyB;IAC1D,IAAI,OAAO,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,EAAuB;IAExD,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG;IAsBzD,MAAM;IAIN,OAAO;IAIP,IAAI,YAAY,YAEf;IAED,IAAI,OAAO,IAAI,GAAG,CAAqB;IAEvC,aAAa;IASb,IAAI,aAAa,WAEhB;IAED,IAAI,MAAM,QAET;IAED,IAAI,MAAM,CAAC,MAAM,KAAA,EAuBhB;IAED,IAAI,MAAM,IAAI,iBAAiB,GAAG,IAAI,CAErC;IAED,OAAO;IAQP,IAAI,QAAQ,IAAI,SAAS,EAAE,CAE1B;IAED,IAAI,QAAQ,CAAC,IAAI,EAJD,SAAS,EAIR,EAEhB;IAED,IAAI,2BAA2B,YAE9B;IAED,IAAI,OAAO,qBAEV;IAED,IAAI,OAAO,CAAC,SAAS,kBAAA,EAEpB;IAED,IAAI,SAAS,QAgBZ;IAED,UAAU,CAAC,SAAS,EAAE,GAAG;IASzB,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG;IAalB,SAAS,CAAC,OAAO,EAAE,wBAAwB;IAkB3C,IAAI,WAAW;;;MAMd;IAGD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAI7B,UAAU;IASV,IAAI,CAAC,MAAM,EAAE,GAAG;IAWhB,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG;CAqCvC"}

package/dist-types/layer/model-layer.d.ts

@@ -1,6 +1,7 @@
-import type * as THREE from 'three';
+import * as THREE from 'three';
 import type { ArrowStyle3D } from '../threed/arrow-3d.js';
 import Component from '../components/component.js';
+import { type EventHandler, type EventTrigger } from '../interfaces/event-handler.js';
 import ScenePopup from './action/popup.js';
 import DualCanvasLayer from './dual-canvas-layer.js';
 import { ThreeCapability } from '../threed/three-capability.js';
@@ -23,21 +24,40 @@ export default class ModelLayer extends DualCanvasLayer implements ThreeDimensio
     _decoratorAuxOverlay: any;
     private _threeCapability?;
     private _lastCameraState?;
+    private _saved2DViewport?;
     private _toolbar?;
-    private _cameraSection?;
-    private _gizmoSection?;
     private _cameraButtons?;
-    private _gizmoButtons?;
+    private _floatingPopup?;
+    private _floatingPopupCloseHandler?;
+    /** Scene이 주입하는 토글 콜백 */
+    onSearchToggle?: () => void;
+    onDataBindingToggle?: () => void;
+    onMonitorToggle?: () => void;
     get nature(): ComponentNature;
     get is3dMode(): boolean;
     is3dContainer(): boolean;
+    get gizmoMode(): 'translate' | 'rotate' | 'scale' | undefined;
+    setGizmoMode(mode: 'translate' | 'rotate' | 'scale'): void;
     get scene3d(): THREE.Scene | undefined;
     get renderer3d(): THREE.WebGLRenderer | undefined;
     get activeCamera3d(): THREE.Camera | undefined;
     get mixer(): THREE.AnimationMixer | undefined;
-    get zoom(): number | undefined;
     addArrow3D(id: string, from: Component, to: Component, style?: ArrowStyle3D): void;
     removeArrow3D(id: string): void;
+    /**
+     * 3D selection/decorator outline 의 색을 설정. Tracker 등 외부 모듈이 자기
+     * 정책 색으로 동기화할 때. 3D 미초기화 상태에서도 색상은 보존되어:
+     *  - 3D 모드 활성화 (_activateThreeD) 시점에 새로 만들어지는 OutlinePass 에 적용
+     *  - 3D→2D 전환 시 border-highlighting 복원에 사용
+     */
+    setOutlineColor(color: number): void;
+    /** outline 색의 number 형. setOutlineColor 가 갱신. 기본 things-scene 표준. */
+    private _outlineColor;
+    /**
+     * 3D→2D 전환 시 outline 컴포넌트를 border-highlighting 으로 복원할 때 사용할 색.
+     * setOutlineColor 호출로 갱신. 기본은 things-scene 표준 (#f26522 의 alpha 형).
+     */
+    private _outlineDecoColor;
     clearArrows3D(): void;
     private _buildLightingConfig;
     /**
@@ -45,6 +65,20 @@ export default class ModelLayer extends DualCanvasLayer implements ThreeDimensio
      * _activateThreeD()와 adoptThreeCapability()에서 공용으로 사용한다.
      */
     private _hide2DLayers;
+    /**
+     * zoom-handler가 등록되어 있는지 확인한다.
+     * zoom-handler가 있으면 사용자가 자유 줌/팬이 가능하므로 뷰포트 연동이 필요하다.
+     */
+    private get _hasZoomHandler();
+    /**
+     * 2D↔3D 전환 시 뷰포트 연동이 필요한지 판단한다.
+     * - 모델러: 항상 연동 (3D↔2D 카메라 매핑)
+     * - 뷰어 + zoom-handler: 연동 (2D 상태 저장/복원)
+     * - 뷰어 + zoom-handler 없음: 독립 (각자 뷰, 연동 불필요)
+     */
+    private get _needsViewportSync();
+    private _2dScaleBeforeThreeD?;
+    private _initialVisibleHeight?;
     private _activateThreeD;
     /**
      * 플로팅 툴바를 생성한다.
@@ -54,9 +88,15 @@ export default class ModelLayer extends DualCanvasLayer implements ThreeDimensio
     private _createToolbar;
     private _applyToggleStyle;
     private _applyButtonStyle;
-    private _toggleToolbarSection;
     private _updateCameraButtons;
-    private _updateGizmoButtons;
+    private _registerPopupCallbacks;
+    private _closeFloatingPopup;
+    private _showFloatingPopup;
+    private _makePopupDraggable;
+    private _toggleHelpPanel;
+    private _toggleBookmarkNav;
+    private _toggleBookmarkEdit;
+    private _buildBookmarkPopup;
     private _removeToolbar;
     /**
      * 3D 렌더러를 실제 표시 영역 크기에 맞춰 리사이즈한다.
@@ -81,7 +121,26 @@ export default class ModelLayer extends DualCanvasLayer implements ThreeDimensio
      */
     adoptThreeCapability(cap: ThreeCapability): void;
     private _deactivateThreeD;
+    /**
+     * 실제 뷰포트 크기를 반환한다.
+     * canvas가 hidden일 수 있으므로 target(외부 컨테이너)에서 읽는다.
+     */
+    private _getViewportSize;
+    /**
+     * 2D 뷰포트 상태를 기반으로 3D 카메라 위치/타겟을 설정한다.
+     */
+    private _initCameraFrom2DViewport;
+    /**
+     * 3D 카메라 상태를 기반으로 2D 뷰포트(translate, scale)를 설정한다.
+     */
+    private _init2DViewportFrom3DCamera;
+    centerTo(component: any, animated?: boolean): void;
     ready(): Promise<void>;
+    /**
+     * 3D 모드 전환 (모델에 저장하지 않음 — 런타임 전환만)
+     */
+    private _threeDUserDeactivated;
+    toggleThreeD(force3d?: boolean): void;
     dispose(): void;
     contains(x: any, y: any): boolean;
     isRootModel(): boolean;
@@ -98,6 +157,7 @@ export default class ModelLayer extends DualCanvasLayer implements ThreeDimensio
     capturePath(path: any, excepts: any): any;
     getOverlay(component: any): any;
     getDecoratorOverlay(component: any): any;
+    _onkeydown_root(e: KeyboardEvent): void;
     get eventMap(): {
         '(self)': {
             '(all)': {
@@ -145,6 +205,7 @@ export default class ModelLayer extends DualCanvasLayer implements ThreeDimensio
         '(root)': {
             '(self)': {
                 selected: (selected: any[]) => void;
+                keydown: (e: KeyboardEvent) => void;
             };
         };
     };
@@ -161,6 +222,21 @@ export default class ModelLayer extends DualCanvasLayer implements ThreeDimensio
     _onmouseenter_all(event: any, hint: any): void;
     _onmouseleave_all(event: any, hint: any): void;
     _onclick(event: any, hint: any): void;
+    /**
+     * 컴포넌트의 eventHandlers (legacy 정규화 포함) 중 매칭되는 trigger 의 핸들러
+     * 모두 실행. enter=true (mouseenter/click), enter=false (mouseleave).
+     *
+     * 실행 순서:
+     *   1) 컴포넌트 class 의 *built-in method* (예: onTap, onMouseEnter) — 도메인
+     *      기본 동작 (예: SlidingDoor.onTap → toggle). 컴포넌트가 override 시 호출.
+     *   2) state.eventHandlers (사용자 커스텀) — UI 에서 등록한 script/action.
+     *
+     * 둘 다 실행 — *override 가 아니라 augment*. 사용자 커스텀이 도메인 동작 보완.
+     */
+    _dispatchEventHandlers(component: any, triggers: EventTrigger[], event: any, enter: boolean): void;
+    /** EventTrigger → 컴포넌트 method 이름. 컴포넌트가 해당 method override 시 자동 호출. */
+    _triggerToMethodName(trigger: EventTrigger, enter: boolean): string | undefined;
+    _executeHandler(handler: EventHandler, component: any, event: any, enter: boolean): void;
     _onmousedownup(event: any, hint: any): void;
     _doMouseDownUpEventAction(event: any, component: any, enter: any, org_event: any): void;
     _doEventAction(event: any, component: any, enter: any, org_event: any): void;