extends CharacterBody2D

# ============================================================================
# 文件名: NPCController.gd
# 作用: 通用 NPC 控制器，负责角色待机表现与交互对话
#
# 主要功能:
# - 播放 NPC 待机动画
# - 响应玩家射线交互
# - 触发聊天气泡与 NPC 对话事件
#
# 依赖: EventSystem, EventNames, ChatBubble
# 作者: Codex
# 创建时间: 2026-03-10
# ============================================================================

signal interaction_happened(text: String)

const CHAT_BUBBLE_SCENE: PackedScene = preload("res://scenes/ui/ChatBubble.tscn")

@export var npc_name: String = "NPC"
@export_multiline var dialogue: String = "欢迎来到WhaleTown，我是镇长范鲸晶"

@onready var animation_player: AnimationPlayer = $AnimationPlayer

func _ready() -> void:
	# 播放场景里配置好的待机动画，让不同 NPC 可以复用同一个控制器。
	if animation_player.has_animation("idle"):
		animation_player.play("idle")

	# 保持 NPC 可被玩家射线与角色碰撞识别。
	collision_layer = 3
	collision_mask = 3

# 处理玩家交互，展示气泡并向全局事件系统广播。
func interact() -> void:
	show_bubble(dialogue)
	EventSystem.emit_event(EventNames.NPC_TALKED, {
		"npc": self,
		"npc_name": npc_name,
		"dialogue": dialogue
	})
	interaction_happened.emit(dialogue)

# 在 NPC 头顶生成一次性聊天气泡。
#
# 参数:
#   text: String - 要展示的对话内容
func show_bubble(text: String) -> void:
	var bubble: Control = CHAT_BUBBLE_SCENE.instantiate() as Control
	if bubble == null:
		return
	add_child(bubble)
	if bubble.has_method("set_text"):
		bubble.call("set_text", text)