godot-plateformer/addons/reedscene/prop/StateManager.gd

'''
	輔助功能性脚本，可以用來管理所有的PropState，並添加一些幫助性的方法。
'''
@tool
@icon("res://addons/reedscene/prop/icon/prop_states_manager.svg")
#class_name ReedPropStateManager
extends Node

## FLAG
const IS_PROP_STATES_ROOT := true

##当节点更新时，是否要自动重置
@export var auto_refresh: bool = true

func _enter_tree() -> void:
	if not Engine.is_editor_hint():
		return

	_connect_editor_signals()
	_refresh_states()

func _ready() -> void:
	if not Engine.is_editor_hint():
		return

## 链接所有的功能信号
func _connect_editor_signals() -> void:
	if not child_entered_tree.is_connected(_on_child_entered_tree):
		child_entered_tree.connect(_on_child_entered_tree)

	if not child_exiting_tree.is_connected(_on_child_exiting_tree):
		child_exiting_tree.connect(_on_child_exiting_tree)

	if not child_order_changed.is_connected(_on_child_order_changing):
		child_order_changed.connect(_on_child_order_changing)

## 断开所有的功能型号
func _disconnect_editor_signals() -> void:
	if child_entered_tree.is_connected(_on_child_entered_tree):
		child_entered_tree.disconnect(_on_child_entered_tree)

	if child_exiting_tree.is_connected(_on_child_exiting_tree):
		child_exiting_tree.disconnect(_on_child_exiting_tree)

	if child_order_changed.is_connected(_on_child_order_changing):
		child_order_changed.disconnect(_on_child_order_changing)

## 如果子節點進入管理器
func _on_child_entered_tree(node: Node) -> void:
	if not Engine.is_editor_hint():
		return

	if not node.renamed.is_connected(_on_child_renamed):
		node.renamed.connect(_on_child_renamed)
	
	if node is ReedPropState and auto_refresh:
		call_deferred("_refresh_states")

## 如果子節點離開管理器
func _on_child_exiting_tree(node: Node) -> void:
	if not Engine.is_editor_hint():
		return
	
	if node.renamed.is_connected(_on_child_renamed):
		node.renamed.disconnect(_on_child_renamed)

	if node is ReedPropState and auto_refresh:
		call_deferred("_refresh_states")

## 如果子節點被重命名
func _on_child_renamed() -> void:
	if not Engine.is_editor_hint():
		return
	
	call_deferred("_refresh_states")

## 如果子節點的順序修改
func _on_child_order_changing() -> void:
	if not Engine.is_editor_hint():
		return
	call_deferred("_refresh_states")

func _refresh_states() -> void:
	var index := 0

	for child in get_children():
		if not child is ReedPropState:
			continue

		_assign_state_id(child, index)
		_rename_state_node(child, index)
		index += 1

func _assign_state_id(state: ReedPropState, id: int) -> void:
	if state.state_id == id:
		return

	state.set("state_id", id)

func _rename_state_node(state: ReedPropState, id: int) -> void:
	var base_name := _strip_id_prefix(state.name)
	var expected := "[ID_%d] %s" % [id, base_name]

	if state.name == expected:
		return

	state.name = expected

##连续剥离Name，防止错乱
func _strip_id_prefix(name: String) -> String:
	var result := name

	# 连续剥离所有 [ID_x] 前缀，防止叠加
	while result.begins_with("[ID_"):
		var end := result.find("]")
		if end == -1:
			break

		# 跳过 "] " 或 "]"
		var cut := end + 1
		if cut < result.length() and result[cut] == " ":
			cut += 1

		result = result.substr(cut)

	return result.strip_edges()

## 提取原本的命名
func _extract_raw_name(name: String) -> String:
	if name.begins_with("[ID:"):
		var end := name.find("]")
		if end != -1 and end + 2 < name.length():
			return name.substr(end + 2)
	return name