feature/match3/move-gems (#7)

Reviewed-on: #7
Co-authored-by: Vladimir nett00n Budylnikov <git@nett00n.org>
Co-committed-by: Vladimir nett00n Budylnikov <git@nett00n.org>

examples/ValueStepperExample.gd

@@ -0,0 +1,77 @@
+# Example of how to use the ValueStepper component in any scene
+extends Control
+
+@onready var language_stepper: ValueStepper = $VBoxContainer/Examples/LanguageContainer/LanguageStepper
+@onready var difficulty_stepper: ValueStepper = $VBoxContainer/Examples/DifficultyContainer/DifficultyStepper
+@onready var resolution_stepper: ValueStepper = $VBoxContainer/Examples/ResolutionContainer/ResolutionStepper
+@onready var custom_stepper: ValueStepper = $VBoxContainer/Examples/CustomContainer/CustomStepper
+
+# Example of setting up custom navigation
+var navigable_steppers: Array[ValueStepper] = []
+var current_stepper_index: int = 0
+
+func _ready():
+	DebugManager.log_info("ValueStepper example ready", "Example")
+
+	# Setup navigation array
+	navigable_steppers = [language_stepper, difficulty_stepper, resolution_stepper, custom_stepper]
+
+	# Connect to value change events
+	for stepper in navigable_steppers:
+		if not stepper.value_changed.is_connected(_on_stepper_value_changed):
+			stepper.value_changed.connect(_on_stepper_value_changed)
+
+	# Setup custom stepper with custom values
+	var themes = ["Light", "Dark", "Blue", "Green", "Purple"]
+	var theme_values = ["light", "dark", "blue", "green", "purple"]
+	custom_stepper.setup_custom_values(theme_values, themes)
+	custom_stepper.data_source = "theme"  # For better logging
+
+	# Highlight first stepper
+	_update_stepper_highlighting()
+
+func _input(event: InputEvent):
+	# Example navigation handling
+	if event.is_action_pressed("move_up"):
+		_navigate_steppers(-1)
+		get_viewport().set_input_as_handled()
+	elif event.is_action_pressed("move_down"):
+		_navigate_steppers(1)
+		get_viewport().set_input_as_handled()
+	elif event.is_action_pressed("move_left"):
+		_handle_stepper_input("move_left")
+		get_viewport().set_input_as_handled()
+	elif event.is_action_pressed("move_right"):
+		_handle_stepper_input("move_right")
+		get_viewport().set_input_as_handled()
+
+func _navigate_steppers(direction: int):
+	current_stepper_index = (current_stepper_index + direction) % navigable_steppers.size()
+	if current_stepper_index < 0:
+		current_stepper_index = navigable_steppers.size() - 1
+	_update_stepper_highlighting()
+	DebugManager.log_info("Stepper navigation: index " + str(current_stepper_index), "Example")
+
+func _handle_stepper_input(action: String):
+	if current_stepper_index >= 0 and current_stepper_index < navigable_steppers.size():
+		var stepper = navigable_steppers[current_stepper_index]
+		if stepper.handle_input_action(action):
+			AudioManager.play_ui_click()
+
+func _update_stepper_highlighting():
+	for i in range(navigable_steppers.size()):
+		navigable_steppers[i].set_highlighted(i == current_stepper_index)
+
+func _on_stepper_value_changed(new_value: String, new_index: int):
+	DebugManager.log_info("Stepper value changed to: " + new_value + " (index: " + str(new_index) + ")", "Example")
+	# Handle value change in your scene
+	# For example: apply settings, save preferences, update UI, etc.
+
+# Example of programmatically setting values
+func _on_reset_to_defaults_pressed():
+	AudioManager.play_ui_click()
+	language_stepper.set_current_value("en")
+	difficulty_stepper.set_current_value("normal")
+	resolution_stepper.set_current_value("1920x1080")
+	custom_stepper.set_current_value("dark")
+	DebugManager.log_info("Reset all steppers to defaults", "Example")

examples/ValueStepperExample.gd.uid

@@ -0,0 +1 @@
+uid://bu6f2vbdku4gg

examples/ValueStepperExample.tscn

@@ -0,0 +1,113 @@
+[gd_scene load_steps=3 format=3 uid="uid://cw03putw85q1o"]
+
+[ext_resource type="Script" path="res://examples/ValueStepperExample.gd" id="1_example"]
+[ext_resource type="PackedScene" path="res://scenes/ui/components/ValueStepper.tscn" id="2_value_stepper"]
+
+[node name="ValueStepperExample" type="Control"]
+layout_mode = 3
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+script = ExtResource("1_example")
+
+[node name="VBoxContainer" type="VBoxContainer" parent="."]
+layout_mode = 1
+anchors_preset = 8
+anchor_left = 0.5
+anchor_top = 0.5
+anchor_right = 0.5
+anchor_bottom = 0.5
+offset_left = -200.0
+offset_top = -150.0
+offset_right = 200.0
+offset_bottom = 150.0
+grow_horizontal = 2
+grow_vertical = 2
+
+[node name="Title" type="Label" parent="VBoxContainer"]
+layout_mode = 2
+text = "ValueStepper Component Examples"
+horizontal_alignment = 1
+
+[node name="HSeparator" type="HSeparator" parent="VBoxContainer"]
+layout_mode = 2
+
+[node name="Examples" type="VBoxContainer" parent="VBoxContainer"]
+layout_mode = 2
+
+[node name="LanguageContainer" type="HBoxContainer" parent="VBoxContainer/Examples"]
+layout_mode = 2
+
+[node name="LanguageLabel" type="Label" parent="VBoxContainer/Examples/LanguageContainer"]
+custom_minimum_size = Vector2(120, 0)
+layout_mode = 2
+text = "Language:"
+
+[node name="LanguageStepper" parent="VBoxContainer/Examples/LanguageContainer" instance=ExtResource("2_value_stepper")]
+layout_mode = 2
+data_source = "language"
+
+[node name="DifficultyContainer" type="HBoxContainer" parent="VBoxContainer/Examples"]
+layout_mode = 2
+
+[node name="DifficultyLabel" type="Label" parent="VBoxContainer/Examples/DifficultyContainer"]
+custom_minimum_size = Vector2(120, 0)
+layout_mode = 2
+text = "Difficulty:"
+
+[node name="DifficultyStepper" parent="VBoxContainer/Examples/DifficultyContainer" instance=ExtResource("2_value_stepper")]
+layout_mode = 2
+data_source = "difficulty"
+
+[node name="ResolutionContainer" type="HBoxContainer" parent="VBoxContainer/Examples"]
+layout_mode = 2
+
+[node name="ResolutionLabel" type="Label" parent="VBoxContainer/Examples/ResolutionContainer"]
+custom_minimum_size = Vector2(120, 0)
+layout_mode = 2
+text = "Resolution:"
+
+[node name="ResolutionStepper" parent="VBoxContainer/Examples/ResolutionContainer" instance=ExtResource("2_value_stepper")]
+layout_mode = 2
+data_source = "resolution"
+
+[node name="CustomContainer" type="HBoxContainer" parent="VBoxContainer/Examples"]
+layout_mode = 2
+
+[node name="CustomLabel" type="Label" parent="VBoxContainer/Examples/CustomContainer"]
+custom_minimum_size = Vector2(120, 0)
+layout_mode = 2
+text = "Theme:"
+
+[node name="CustomStepper" parent="VBoxContainer/Examples/CustomContainer" instance=ExtResource("2_value_stepper")]
+layout_mode = 2
+data_source = "custom"
+
+[node name="HSeparator2" type="HSeparator" parent="VBoxContainer"]
+layout_mode = 2
+
+[node name="Instructions" type="Label" parent="VBoxContainer"]
+layout_mode = 2
+text = "Navigation:
+• Up/Down arrows - Navigate between steppers
+• Left/Right arrows - Change values
+• Mouse clicks work on arrow buttons
+
+Features:
+• Multiple data sources (language, difficulty, resolution)
+• Custom values support (theme example)
+• Gamepad/keyboard navigation
+• Visual highlighting
+• Signal-based value changes"
+horizontal_alignment = 1
+
+[node name="HSeparator3" type="HSeparator" parent="VBoxContainer"]
+layout_mode = 2
+
+[node name="ResetButton" type="Button" parent="VBoxContainer"]
+layout_mode = 2
+text = "Reset to Defaults"
+
+[connection signal="pressed" from="VBoxContainer/ResetButton" to="." method="_on_reset_to_defaults_pressed"]