import type { Style } from 'leviar';
import type { CharacterKeysOf } from '../types/config';
import type { SceneContext } from '../core/SceneContext';
export interface DialogueHook {
    /** view builder에서 방출. 직전 command ctx를 캐싱하여 전달. */
    'dialogue:text-render': (s: {
        speaker: string | undefined;
        text: string;
    }, ctx: SceneContext) => {
        speaker: string | undefined;
        text: string;
    };
    /** command handler에서 방출. ctx는 항상 존재. */
    'dialogue:text-run': (s: {
        speaker: string | undefined;
        text: string;
    }, ctx: SceneContext) => {
        speaker: string | undefined;
        text: string;
    };
}
/**
 * 대화창 내부 간격 레이아웃 설정.
 * `defineInitial` 또는 커맨드의 `layout` 필드로 씬/커맨드별 지정 가능.
 */
export interface DialogueLayout {
    /**
     * 패널 내부 좌측 여백(px).
     * @default 48
     */
    panelPaddingLeft?: number;
    /**
     * 패널 내부 우측 여백(px).
     * @default 48
     */
    panelPaddingRight?: number;
    /**
     * 대화창 상단(패널 안쪽 위)에서 화자명 상단까지의 거리(px).
     * @default 24
     */
    panelPaddingTop?: number;
    /**
     * 대화창 하단 패딩(px).
     * @default 24
     */
    panelPaddingBottom?: number;
    /**
     * 화자명과 대사 텍스트 사이 간격(px).
     * @default 8
     */
    speakerTextGap?: number;
}
/** dialogueModule이 공유하는 데이터 스키마 */
export interface DialogueSchema {
    /** 대화창 전체 패널 스타일 (권장) */
    style?: Partial<Style>;
    /** 대화창 배경 패널 스타일 */
    bg?: Partial<Style>;
    /** 화자(캐릭터 이름) 텍스트 스타일 */
    speaker?: Partial<Style>;
    /** 대사 텍스트 스타일 */
    text?: Partial<Style>;
    /** 내부 간격 레이아웃. `defineInitial`로 씬 전체에 적용 가능 */
    layout?: DialogueLayout;
    /** @internal 현재 텍스트 서브 인덱스 */
    _subIndex: number;
    /** @internal 현재 대사 줄 목록 */
    _lines: string[];
    /** @internal 현재 화자 키 */
    _speakerKey: string | undefined;
    /** @internal 현재 타이핑 속도(ms) */
    _speed: number | undefined;
}
export declare const DEFAULT_DIALOGUE_BG: Partial<Style>;
export declare const DEFAULT_DIALOGUE_SPEAKER: Partial<Style>;
export declare const DEFAULT_DIALOGUE_TEXT: Partial<Style>;
export declare const DEFAULT_DIALOGUE_LAYOUT: Required<DialogueLayout>;
/**
 * 대사 또는 나레이션 출력
 *
 * @example
 * { type: 'dialogue', speaker: 'hero', text: 'Hello world!', speed: 50 }
 * // 또는 나레이션
 * { type: 'dialogue', text: ['첫 번째 줄', '두 번째 줄'] }
 */
export interface DialogueCmd<TConfig = any> {
    /**
     * 화자의 이름 (config.characters의 키).
     * 생략할 경우 화자 이름 없이 나레이션으로 처리됩니다.
     */
    speaker?: CharacterKeysOf<TConfig> | (string & {});
    /** 화면에 출력할 텍스트입니다. 배열일 경우 여러 줄로 출력될 수 있습니다. */
    text: string | string[];
    /**
     * 텍스트가 한 글자씩 출력되는 속도(ms 단위)입니다.
     * 미지정 시 시스템 설정 속도 또는 기본값(예: 30ms)이 사용됩니다.
     */
    speed?: number;
}
declare const dialogueModule: import("..").NovelModule<DialogueCmd<any>, DialogueSchema, DialogueHook>;
export default dialogueModule;