feat(ui-service): add UiInstance struct to encapsulate presenter metadata

refactor(ui-service): replace LoadedPresenters property with GetLoadedPresenters method
refactor(editor): auto-set instance address from addressable address

Author: Miguel Cartier

Editor/UiConfigsEditor.cs

@@ -64,7 +64,7 @@ public abstract class UiConfigsEditor<TSet> : Editor
 			"UI Sets group multiple presenter instances that should be displayed together. " +
 			"When a set is activated via UiService, all its presenters are loaded and shown simultaneously. " +
 			"Presenters are loaded in the order listed (top to bottom).\n\n" +
-			"You can add the same UI type multiple times with different instance addresses for multi-instance support.";
+			"Each UI's instance address is automatically set to its Addressable address from the config.";
 
 		private Dictionary<string, string> _assetPathLookup;
 		private List<string> _uiConfigsAddress;
@@ -258,14 +258,6 @@ private VisualElement CreateSetPresenterElement()
 			dropdown.name = "ui-type-dropdown";
 			container.Add(dropdown);
 
-			// Instance address field (optional)
-			var instanceField = new TextField();
-			instanceField.style.width = 120;
-			instanceField.style.marginLeft = 5;
-			instanceField.tooltip = "Optional instance address (leave empty for default instance)";
-			instanceField.name = "instance-address-field";
-			container.Add(instanceField);
-			
 			// Delete button
 			var deleteButton = new Button { text = "×" };
 			deleteButton.style.width = 25;
@@ -335,8 +327,7 @@ private void BindSetPresenterElement(VisualElement element, int index, Serialize
 				return;
 
 			var dropdown = element.Q<DropdownField>("ui-type-dropdown");
-			var instanceField = element.Q<TextField>("instance-address-field");
-			if (dropdown == null || instanceField == null)
+			if (dropdown == null)
 				return;
 
 			var entryProperty = uiEntriesProperty.GetArrayElementAtIndex(index);
@@ -371,14 +362,12 @@ private void BindSetPresenterElement(VisualElement element, int index, Serialize
 			{
 				// Unbind to prevent stale property references
 				dropdown.Unbind();
-				instanceField.Unbind();
 
 				// Set the current values
 				dropdown.index = selectedIndex;
-				instanceField.value = instanceAddressProperty.stringValue ?? string.Empty;
 
-				// Register callback to store type when changed
-				dropdown.RegisterValueChangedCallback(evt =>
+				// Register callback to store type and addressable address when changed
+				dropdown.RegisterValueChangedCallback(_ =>
 				{
 					var newIndex = dropdown.index;
 					if (newIndex >= 0 && newIndex < _uiConfigsAddress.Count)
@@ -387,25 +376,21 @@ private void BindSetPresenterElement(VisualElement element, int index, Serialize
 						if (_uiTypesByAddress.TryGetValue(selectedAddress, out var selectedType))
 						{
 							typeNameProperty.stringValue = selectedType.AssemblyQualifiedName;
+							// Use the addressable address as the instance address
+							instanceAddressProperty.stringValue = selectedAddress;
 							SaveSetChanges();
 						}
 					}
 				});
 
-				// Register callback for instance address field
-				instanceField.RegisterValueChangedCallback(evt =>
-				{
-					instanceAddressProperty.stringValue = evt.newValue ?? string.Empty;
-					SaveSetChanges();
-				});
-				
 				// Set initial value if property is empty
 				if (string.IsNullOrEmpty(typeNameProperty.stringValue) && selectedIndex < _uiConfigsAddress.Count)
 				{
 					var address = _uiConfigsAddress[selectedIndex];
 					if (_uiTypesByAddress.TryGetValue(address, out var type))
 					{
 						typeNameProperty.stringValue = type.AssemblyQualifiedName;
+						instanceAddressProperty.stringValue = address;
 						serializedObject.ApplyModifiedProperties();
 					}
 				}
@@ -429,8 +414,8 @@ private void BindSetPresenterElement(VisualElement element, int index, Serialize
 
 				deleteButton.userData = clickHandler;
 				deleteButton.RegisterCallback(clickHandler);
-			}
 		}
+	}
 
 		private void OnPresenterItemsAdded(IEnumerable<int> indices, SerializedProperty uiEntriesProperty)
 		{
@@ -451,7 +436,8 @@ private void OnPresenterItemsAdded(IEnumerable<int> indices, SerializedProperty
 					var instanceAddressProperty = entryProperty.FindPropertyRelative(nameof(UiSetEntry.InstanceAddress));
 
 					typeNameProperty.stringValue = defaultType?.AssemblyQualifiedName ?? string.Empty;
-					instanceAddressProperty.stringValue = string.Empty;
+					// Use the addressable address as the instance address
+					instanceAddressProperty.stringValue = defaultAddress;
 				}
 			}
 

Runtime/IUiService.cs

@@ -8,18 +8,41 @@
 
 namespace GameLovers.UiService
 {
+	/// <summary>
+	/// Represents a UI presenter instance with its type, address and presenter reference
+	/// </summary>
+	public readonly struct UiInstance
+	{
+		/// <summary>
+		/// The type of the UI presenter
+		/// </summary>
+		public readonly Type Type;
+		
+		/// <summary>
+		/// The instance address (empty string for default/singleton instances)
+		/// </summary>
+		public readonly string Address;
+		
+		/// <summary>
+		/// The UI presenter reference
+		/// </summary>
+		public readonly UiPresenter Presenter;
+
+		public UiInstance(Type type, string address, UiPresenter presenter)
+		{
+			Type = type;
+			Address = address;
+			Presenter = presenter;
+		}
+	}
+
 	/// <summary>
 	/// This service provides an abstraction layer to interact with the game's UI <seealso cref="UiPresenter"/>
 	/// The Ui Service is organized by layers. The higher the layer the more close is to the camera viewport.
 	/// Supports multiple instances of the same UI type through the UiInstanceId system.
 	/// </summary>
 	public interface IUiService
 	{
-		/// <summary>
-		/// Gets a read-only dictionary of all Presenters currently loaded in memory by the UI service.
-		/// Keys are UiInstanceId which contain both the Type and optional instance name.
-		/// </summary>
-		IReadOnlyDictionary<UiInstanceId, UiPresenter> LoadedPresenters { get; }
 
 		/// <summary>
 		/// Gets a read-only list of all Presenter instances currently visible.
@@ -32,6 +55,12 @@ public interface IUiService
 		/// </summary>
 		IReadOnlyDictionary<int, UiSetConfig> UiSets { get; }
 
+		/// <summary>
+		/// Gets all UI presenters currently loaded in memory by the UI service.
+		/// </summary>
+		/// <returns>A list of all loaded UI instances</returns>
+		List<UiInstance> GetLoadedPresenters();
+
 		/// <summary>
 		/// Requests the UI of given type <typeparamref name="T"/>
 		/// </summary>