@hatiolab/things-scene 9.0.0-beta.9 → 9.0.1

package/things-scene.d.ts

@@ -6,11 +6,11 @@ declare module '@hatiolab/things-scene' {
   type Style = Properties
   type Decorator = (component: Component, context: CanvasRenderingContext2D, delta?: number) => boolean
   type PopupOptions = {
-    data: any
-    location: 'center' | 'left-top' | 'right-top' | 'left-bottom' | 'right-bottom'
-    modal: boolean
-    closable: boolean
-    output: boolean
+    data?: any
+    location?: 'center' | 'left-top' | 'right-top' | 'left-bottom' | 'right-bottom'
+    modal?: boolean
+    closable?: boolean
+    output?: boolean
   }
 
   type ChangeFunction = (selector: string, value: any, self: any) => Component[]
@@ -140,8 +140,33 @@ declare module '@hatiolab/things-scene' {
 
   interface Control extends POINT {
     handler: ControlHandler
+    [key: string]: any
   }
 
+  /**
+   * Things-Scene 컴포넌트를 등록하기 위한 데코레이터
+   *
+   * @param componentType 컴포넌트 타입 이름 또는 이름 배열
+   * @returns 클래스 데코레이터
+   *
+   * @example
+   * ```ts
+   * @sceneComponent('rect')
+   * export default class Rect extends RectPath(Shape) {
+   *   // 컴포넌트 구현
+   * }
+   * ```
+   *
+   * 여러 컴포넌트 타입을 한 번에 등록할 수도 있습니다:
+   * ```ts
+   * @sceneComponent(['input-text', 'input-password'])
+   * export default class Input extends HTMLOverlayElement {
+   *   // 컴포넌트 구현
+   * }
+   * ```
+   */
+  function sceneComponent(componentType: string | string[]): <T extends typeof Component>(target: T) => T
+
   function create({
     target,
     model,
@@ -347,7 +372,7 @@ declare module '@hatiolab/things-scene' {
     state: Properties
     root: RootContainer
     rootModel: ModelLayer
-    parent: Container
+    parent: ContainerAbstract
     app: ApplicationContext
 
     get nature(): ComponentNature
@@ -405,6 +430,19 @@ declare module '@hatiolab/things-scene' {
     get decorators(): Array<string | Decorator>
     get reactionDecorators(): Array<string | Decorator>
 
+    get started(): boolean
+    set started(started: boolean)
+
+    get tag(): string
+    set tag(tag: string)
+
+    get appendum(): any
+    set appendum(appendum: any)
+
+    get position(): string
+
+    resetAnimation(): void
+
     isRootModel(): boolean
     isContainer(): boolean
     isLine(): boolean
@@ -415,6 +453,7 @@ declare module '@hatiolab/things-scene' {
     isIdentifiable(): boolean
     isTemplate(): boolean
     isIn3DSpace(): boolean
+    isPositionable(): boolean
 
     ready(): void
     dispose(): void
@@ -515,7 +554,9 @@ declare module '@hatiolab/things-scene' {
     target: HTMLElement | null
     canvas: HTMLCanvasElement | null
 
-    getContext(): CanvasRenderingContext2D
+    getContext(component?: Component): CanvasRenderingContext2D
+    getOverlay(component?: Component): HTMLElement
+
     centerTo(component: Component, animated?: boolean): void
   }
 
@@ -528,6 +569,7 @@ declare module '@hatiolab/things-scene' {
   class Shape extends Component {}
   class Ellipse extends Shape {}
   class Polygon extends Shape {}
+  class Popup extends RectPath(Shape) {}
   class Line extends Component {
     get fromEnd(): LinkEnd | undefined
     get toEnd(): LinkEnd | undefined