import type { Style, EasingType } from 'leviar';
import type { AssetKeysOf } from '../types/config';
export type ElementKind = 'rect' | 'ellipse' | 'text' | 'image';
export type ElementPosition = {
    x?: number;
    y?: number;
};
export type ElementPivot = {
    x?: number;
    y?: number;
};
export type ElementScale = number | {
    x?: number;
    y?: number;
    z?: number;
};
export interface ElementChildBase<TConfig = any> {
    /** 요소 고유 식별자 */
    id: string;
    /** 부모 기준 픽셀 오프셋 위치 */
    position?: ElementPosition;
    /** 기본 스타일 (Leviar Style) */
    style?: Partial<Style>;
    /** 호버 시 스타일 (기본 스타일에 merge, mouseout 시 복귀) */
    hoverStyle?: Partial<Style>;
    /** 피벗 (0~1 정규화). 기본 { x: 0.5, y: 0.5 } */
    pivot?: ElementPivot;
    /** 스케일 배율. number면 x/y에 같은 값을 적용 */
    scale?: ElementScale;
    /** 회전 각도 (degree) */
    rotation?: number;
    /**
     * 이 요소에 바인딩할 behavior 이름 목록.
     * `defineScene`의 `actions`에 정의된 콜백을 참조합니다.
     */
    behaviors?: string[];
    /** 자식 요소 배열 */
    children?: ElementChild<TConfig>[];
}
type Expand<T> = T extends infer O ? {
    [K in keyof O]: O[K];
} : never;
export type ElementChild<TConfig = any> = Expand<ElementChildBase<TConfig> & {
    kind: 'rect';
}> | Expand<ElementChildBase<TConfig> & {
    kind: 'ellipse';
}> | Expand<ElementChildBase<TConfig> & {
    kind: 'text'; /** 텍스트 내용 */
    text: string;
}> | Expand<ElementChildBase<TConfig> & {
    kind: 'image'; /** 이미지 에셋 키 */
    image: AssetKeysOf<TConfig>;
}>;
/**
 * 범용 UI 요소를 화면에 배치한다.
 *
 * - `kind: 'rect'` — 사각형 (패널, 버튼 배경 등)
 * - `kind: 'text'` — 텍스트
 * - `kind: 'image'` — 이미지
 *
 * `children`으로 계층 구조를 구성하며, `behaviors`로 씬 액션을 바인딩합니다.
 *
 * @example
 * {
 *   type: 'element',
 *   action: 'show',
 *   id: 'panel',
 *   kind: 'rect',
 *   position: { x: 1748, y: 540 },
 *   style: { width: 120, height: 300, background: 'rgba(0,0,0,0.5)' },
 *   children: [
 *     {
 *       id: 'btn_save',
 *       kind: 'rect',
 *       position: { x: 0, y: 60 },
 *       style: { width: 100, height: 36, background: 'rgba(255,255,255,0.1)' },
 *       behaviors: ['saveButton', 'hoverGlow'],
 *       children: [
 *         { id: 'btn_save_text', kind: 'text', text: '💾 저장', style: { fontSize: 14, color: '#fff' } }
 *       ]
 *     }
 *   ]
 * }
 */
export interface ElementCmdBase<TConfig = any> {
    /** 요소 고유 식별자 */
    id: string;
    /**
     * 화면 내 위치.
     * - parent 없음 (루트): 픽셀 좌표. { x: 0, y: 0 } = 캔버스 좌상단
     * - parent 있음 (자식): 부모 중심 기준 픽셀(Leviar 좌표계) 오프셋
     */
    position?: ElementPosition;
    /** 기본 스타일 (Leviar Style) */
    style?: Partial<Style>;
    /** 호버 시 스타일 (기본 스타일에 merge, mouseout 시 복귀) */
    hoverStyle?: Partial<Style>;
    /** 피벗 (0~1 정규화) */
    pivot?: ElementPivot;
    /** 스케일 배율. number면 x/y에 같은 값을 적용 */
    scale?: ElementScale;
    /** 회전 각도 (degree) */
    rotation?: number;
    /**
     * 이 요소에 바인딩할 behavior 이름 목록.
     * `defineScene`의 `actions`에 정의된 콜백을 참조합니다.
     */
    behaviors?: string[];
    /** 자식 요소 배열 */
    children?: ElementChild<TConfig>[];
    /** show/hide 페이드 시간(ms). 기본 200 */
    duration?: number;
    /** 애니메이션의 이징 함수 이름입니다. */
    ease?: EasingType;
    /** UI 억제 시스템을 위한 태그 목록. 없으면 빈 배열([]) */
    uiTags?: string[];
    /** 해당 UI 활성화 시 억제(숨김)할 대상 태그 목록. 없으면 빈 배열([]) */
    hideTags?: string[];
}
export type ElementCmd<TConfig = any> = Expand<ElementCmdBase<TConfig> & {
    action: 'show'; /** 요소 종류 */
    kind: 'rect';
}> | Expand<ElementCmdBase<TConfig> & {
    action: 'show'; /** 요소 종류 */
    kind: 'ellipse';
}> | Expand<ElementCmdBase<TConfig> & {
    action: 'show'; /** 요소 종류 */
    kind: 'text'; /** 텍스트 내용 */
    text: string;
}> | Expand<ElementCmdBase<TConfig> & {
    action: 'show'; /** 요소 종류 */
    kind: 'image'; /** 이미지 에셋 키 */
    image: AssetKeysOf<TConfig>;
}> | Expand<ElementCmdBase<TConfig> & {
    action: 'hide';
}>;
export interface ElementEntry {
    id: string;
    kind: ElementKind;
    text?: string;
    image?: string;
    position: ElementPosition;
    parent?: string;
    style?: Partial<Style>;
    hoverStyle?: Partial<Style>;
    pivot?: ElementPivot;
    scale?: ElementScale;
    rotation?: number;
    /** 이 요소에 바인딩된 behavior 이름 목록 */
    behaviors?: string[];
    /** 이 요소의 UI 억제 태그 목록 */
    uiTags?: string[];
    /** 이 요소 활성화 시 숨길 UI 태그 목록 */
    hideTags?: string[];
    /** @internal 이 요소를 선언한 씬 이름 (actions 바인딩 추적용) */
    _sceneName?: string;
}
export interface ElementSchema {
    _elements: Record<string, ElementEntry>;
    _lastDuration?: number;
    _lastEase?: string;
}
declare const elementModule: import("..").NovelModule<ElementCmd<any>, ElementSchema, import("..").DefaultHook>;
export default elementModule;