added code from unity

Samples~/Scripts/CodeOnlyPopupExample.cs

@@ -0,0 +1,91 @@
+using Jovian.PopupSystem;
+using Jovian.PopupSystem.UI;
+using UnityEngine;
+
+/// <summary>
+/// Example: Showing popups from code without PopupTrigger components.
+///
+/// Use this approach for confirmation dialogs, tutorial tips, or any popup
+/// that is triggered by game logic rather than hover events.
+/// Also demonstrates PopupElementType variants and the generic Add() method.
+/// </summary>
+public class CodeOnlyPopupExample : MonoBehaviour {
+    [SerializeField] PopupSettings popupSettings;
+    [SerializeField] PopupReference popupReferencePrefab;
+    [SerializeField] Transform canvasRoot;
+    [SerializeField] RectTransform targetElement;
+
+    // Custom element type defined in game code
+    static readonly PopupElementType BadgeElement = new("badge");
+
+    IPopupSystem popupSystem;
+
+    void Start() {
+        popupSystem = new PopupSystem(popupSettings, popupReferencePrefab, canvasRoot);
+        popupSystem.RegisterCategory(PopupCategory.General, priority: 1);
+    }
+
+    void Update() {
+        popupSystem?.Tick(Time.deltaTime);
+
+        // Show anchored to an element
+        if(Input.GetKeyDown(KeyCode.Alpha1)) {
+            popupSystem.Show(PopupCategory.General, builder => {
+                builder
+                    .AddText("Anchored Popup", PopupElementType.Header)
+                    .AddText("This popup is anchored to a UI element.", PopupElementType.Text);
+            }, targetElement, AnchorSide.Right);
+        }
+
+        // Show at a fixed screen position
+        if(Input.GetKeyDown(KeyCode.Alpha2)) {
+            popupSystem.ShowAtPosition(PopupCategory.General, builder => {
+                builder
+                    .AddText("Fixed Position", PopupElementType.Header)
+                    .AddText("This popup appears at the center of the screen.", PopupElementType.Text);
+            }, new Vector2(Screen.width * 0.5f, Screen.height * 0.5f));
+        }
+
+        // Show following the mouse
+        if(Input.GetKeyDown(KeyCode.Alpha3)) {
+            popupSystem.Show(PopupCategory.General, builder => {
+                builder
+                    .AddText("Follow Mouse", PopupElementType.Header)
+                    .AddText("This popup follows the cursor.", PopupElementType.Text);
+            });
+        }
+
+        // Demonstrate variant elements
+        // Requires "header_gold" and "separator_thick" entries in PopupSettings.elementPrefabs
+        if(Input.GetKeyDown(KeyCode.Alpha4)) {
+            popupSystem.Show(PopupCategory.General, builder => {
+                builder
+                    .AddText("Legendary Item", PopupElementType.Header.Variant("gold"))
+                    .AddSeparator(PopupElementType.Separator.Variant("thick"))
+                    .AddNameValue("Damage", "150", PopupElementType.LabelValueText)
+                    .AddText("A weapon forged in dragon fire.", "FF6600", PopupElementType.Text);
+            }, targetElement, AnchorSide.Below);
+        }
+
+        // Demonstrate generic Add() for fully custom elements
+        // Requires a "badge" entry in PopupSettings.elementPrefabs
+        if(Input.GetKeyDown(KeyCode.Alpha5)) {
+            popupSystem.Show(PopupCategory.General, builder => {
+                builder.AddText("Custom Element", PopupElementType.Header);
+                var badge = builder.Add(BadgeElement);
+                if(badge != null) {
+                    // Access any components on the custom prefab
+                    // badge.GetComponent<MyBadgeComponent>().SetData(...);
+                }
+            }, targetElement);
+        }
+
+        if(Input.GetKeyDown(KeyCode.Escape)) {
+            popupSystem.HideAll();
+        }
+    }
+
+    void OnDestroy() {
+        popupSystem?.Dispose();
+    }
+}

Samples~/Scripts/DynamicTriggersExample.cs

@@ -0,0 +1,48 @@
+using Jovian.PopupSystem;
+using Jovian.PopupSystem.UI;
+using UnityEngine;
+
+/// <summary>
+/// Example: Using PopupSystem with dynamically instantiated UI elements.
+///
+/// When UI elements are created at runtime (e.g. inventory slots, party member portraits),
+/// use InitializeTriggersInChildren to scan, bind, and configure triggers after instantiation.
+/// The callback receives both the trigger (MonoBehaviour, for hierarchy queries) and the
+/// view (behavior handler, for setting content).
+/// </summary>
+public class DynamicTriggersExample : MonoBehaviour {
+    [SerializeField] PopupSettings popupSettings;
+    [SerializeField] PopupReference popupReferencePrefab;
+    [SerializeField] Transform canvasRoot;
+    [SerializeField] Transform slotsContainer;
+    [SerializeField] GameObject slotPrefab;
+
+    IPopupSystem popupSystem;
+
+    void Start() {
+        popupSystem = new PopupSystem(popupSettings, popupReferencePrefab, canvasRoot);
+        popupSystem.RegisterCategory(PopupCategory.Item, priority: 5);
+
+        for(int i = 0; i < 5; i++) {
+            Instantiate(slotPrefab, slotsContainer);
+        }
+
+        popupSystem.InitializeTriggersInChildren(slotsContainer, (trigger, view) => {
+            var slotName = trigger.gameObject.name;
+            view.SetContent(builder => {
+                builder
+                    .AddText(slotName, PopupElementType.Header)
+                    .AddSeparator(PopupElementType.Separator)
+                    .AddText("This is a dynamically created slot.", PopupElementType.Text);
+            });
+        });
+    }
+
+    void Update() {
+        popupSystem?.Tick(Time.deltaTime);
+    }
+
+    void OnDestroy() {
+        popupSystem?.Dispose();
+    }
+}

Samples~/Scripts/PopupSystemExample.cs

@@ -0,0 +1,67 @@
+using Jovian.PopupSystem;
+using Jovian.PopupSystem.UI;
+using UnityEngine;
+
+/// <summary>
+/// Example: Setting up PopupSystem with auto-scanned triggers.
+///
+/// 1. Attach this to a GameObject in your scene.
+/// 2. Assign the PopupSettings asset and PopupReference prefab.
+/// 3. Set canvasRoot to the root Canvas that contains your UI and PopupTrigger components.
+/// 4. Place PopupTrigger components on any UI elements that should show popups on hover.
+/// 5. The system auto-scans triggers on creation. Use GetTriggerHandler() to set content.
+///
+/// Element prefabs are configured in PopupSettings via PopupElementType.
+/// Add entries mapping types (header, text, label_value_text, separator, image) to prefabs.
+/// </summary>
+public class PopupSystemExample : MonoBehaviour {
+    [SerializeField] PopupSettings popupSettings;
+    [SerializeField] PopupReference popupReferencePrefab;
+    [SerializeField] Transform canvasRoot;
+
+    IPopupSystem popupSystem;
+
+    void Start() {
+        popupSystem = new PopupSystem(popupSettings, popupReferencePrefab, canvasRoot);
+
+        popupSystem.RegisterCategory(PopupCategory.Character, priority: 10);
+        popupSystem.RegisterCategory(PopupCategory.Item, priority: 5);
+        popupSystem.RegisterCategory(PopupCategory.General, priority: 1);
+
+        // Set content on an auto-scanned trigger by GameObject name.
+        var characterHandler = popupSystem.GetTriggerHandler("CharacterPortrait");
+        characterHandler?.SetContent(builder => {
+            builder
+                .AddText("Kael", PopupElementType.Header)
+                .AddText("Human Warrior", "CCCCCC", PopupElementType.Text)
+                .AddSeparator(PopupElementType.Separator)
+                .AddNameValue("Health", 55, PopupElementType.LabelValueText)
+                .AddNameValue("Mana", 42, PopupElementType.LabelValueText)
+                .AddNameValue("Level", 1, PopupElementType.LabelValueText)
+                .AddSeparator(PopupElementType.Separator)
+                .AddNameValue("Might", 8, PopupElementType.LabelValueText)
+                .AddNameValue("Reflex", 2, PopupElementType.LabelValueText)
+                .AddNameValue("Knowledge", 5, PopupElementType.LabelValueText)
+                .AddNameValue("Perception", 1, PopupElementType.LabelValueText);
+        });
+
+        // Set content on all triggers of a category.
+        foreach(var handler in popupSystem.GetTriggerHandlers(PopupCategory.Item)) {
+            handler.SetContent(builder => {
+                builder
+                    .AddText("Health Potion", PopupElementType.Header)
+                    .AddSeparator(PopupElementType.Separator)
+                    .AddText("Restores a moderate amount of health.", PopupElementType.Text)
+                    .AddNameValue("Heal Amount", 50, PopupElementType.LabelValueText);
+            });
+        }
+    }
+
+    void Update() {
+        popupSystem?.Tick(Time.deltaTime);
+    }
+
+    void OnDestroy() {
+        popupSystem?.Dispose();
+    }
+}