using UnityEngine;

using Cysharp.Threading.Tasks;

using xpTURN.AssetLink;

public class ExampleSimple : MonoBehaviour
{
    [Header("AssetLink (name-based)")]
    public AssetLinkGameObject prefabLink;
    public AssetLinkSprite spriteLink;

    [Header("AssetRef (GUID-based)")]
    public AssetRefGameObject prefabRef;
    public AssetRefSprite spriteRef;

    private GameObject goCat;
    private GameObject goDog;
    private Sprite spriteCat;
    private Sprite spriteDog;

    async void LoadSprite()
    {
        // Call when dynamic mapping is needed (asset name, sprite name)
        spriteLink.SetAssetName("sprites/cats_maine_coon", "cats_maine_coon");
        spriteCat = await spriteLink.LoadAssetAsync().ToUniTask();

        // Dynamic mapping not supported
        spriteDog = await spriteRef.LoadAssetAsync().ToUniTask();
    }

    async void InstantiatePrefab()
    {
        goCat = await prefabLink.InstantiateAsync().ToUniTask();
        goDog = await prefabRef.InstantiateAsync().ToUniTask();
    }

    void OnDestroy()
    {
        // Release loaded assets
        if (spriteLink.IsValid())
            spriteLink.ReleaseAsset();

        // Release loaded assets (omission causes memory leak)
        // if (spriteRef.IsValid())
        //     spriteRef.ReleaseAsset();

        // ReleaseInstance is called automatically (by DoAutoRelease component when OnDestroy fires)
        GameObject.Destroy(goCat);
        GameObject.Destroy(goDog);

        // For instances created with AssetReference.InstantiateAsync,
        // AssetReference.ReleaseInstance() must be called (omission causes memory leak)
    }
}

using System.Collections.Generic;

using UnityEngine;

using Cysharp.Threading.Tasks;

using xpTURN.AssetLink;

public class ExampleSpawner : MonoBehaviour
{
    public AssetLinkSpawner prefabSpawner;

    private List<GameObject> goCats = new();

    async void Start()
    {
        for (int i = 0; i < 100; ++i)
        {
            var goCat = await prefabSpawner.SpawnAsync();
            goCat.name = $"Cat{i:d3}";

            goCats.Add(goCat);
        }
    }

    void OnDestroy()
    {
        // Instances created with SpawnAsync(InstantiateAsync) are released automatically when destroyed; no need to manage the prefab handle or call ReleaseInstance manually
        foreach (var goCat in goCats)
        {
            // ReleaseInstance is called internally
            // Handled by DoAutoRelease component when OnDestroy fires
            GameObject.Destroy(goCat);
        }
    }
}

using UnityEngine;
using UnityEngine.SceneManagement;

using Cysharp.Threading.Tasks;

using xpTURN.AssetLink;

public class ExampleScene : MonoBehaviour
{
    [Header("AssetLinkScene (name-based)")]
    public AssetLinkScene sceneLink;

    async void Start()
    {
        // Load scene additively (optional: await handle.ToUniTask() for completion)
        sceneLink.LoadSceneAsync(LoadSceneMode.Additive, activateOnLoad: true, priority: 100);
    }

    void OnDestroy()
    {
        // Unload scene (omission causes memory leak)
        if (sceneLink.IsValid())
            sceneLink.UnLoadScene();
    }
}

using System;
using UnityEngine;

using Cysharp.Threading.Tasks;
using xpTURN.AssetLink;

// Intentionally load without release (creates leak scenario).
// In real game code, always call Release (ReleaseAsset) for loaded assets.
public class LeakScenario : MonoBehaviour
{
    AssetLink ObjectLink_001 = new AssetLink();
    AssetLink ObjectLink_002 = new AssetLink();
    AssetLink ObjectLink_003 = new AssetLink();
    AssetLink ObjectLink_004 = new AssetLink();
    AssetLink ObjectLink_005 = new AssetLink();

    async void Start()
    {
        ObjectLink_001.SetAssetName("Prefabs/Cat1.prefab");
        await ObjectLink_001.LoadAssetAsync<GameObject>().ToUniTask();

        ObjectLink_002.SetAssetName("Prefabs/Cat2.prefab");
        await ObjectLink_002.LoadAssetAsync<GameObject>().ToUniTask();

        ObjectLink_003.SetAssetName("Prefabs/Cat3.prefab");
        await ObjectLink_003.LoadAssetAsync<GameObject>().ToUniTask();

        ObjectLink_004.SetAssetName("Prefabs/Cat4.prefab");
        await ObjectLink_004.LoadAssetAsync<GameObject>().ToUniTask();

        ObjectLink_005.SetAssetName("Prefabs/Cat5.prefab");
        await ObjectLink_005.LoadAssetAsync<GameObject>().ToUniTask();
    }

    void OnDestroy()
    {
        // Release loaded assets; ReleaseAsset intentionally omitted for testing
        // if (ObjectLink_001.IsValid())
        //     ObjectLink_001.ReleaseAsset();
        // if (ObjectLink_002.IsValid())
        //     ObjectLink_002.ReleaseAsset();
        // if (ObjectLink_003.IsValid())
        //     ObjectLink_003.ReleaseAsset();
        // if (ObjectLink_004.IsValid())
        //     ObjectLink_004.ReleaseAsset();
        // if (ObjectLink_005.IsValid())
        //     ObjectLink_005.ReleaseAsset();

        // Link objects removed without Release
        ObjectLink_001 = null;
        ObjectLink_002 = null;
        ObjectLink_003 = null;
        ObjectLink_004 = null;
        ObjectLink_005 = null;
    }
}

using System;
using UnityEngine;

using Cysharp.Threading.Tasks;
using xpTURN.AssetLink;

public class DoTrack : MonoBehaviour
{
    async void DetectAndReportLeaks()
    {
        // Run GC
        GC.Collect();
        GC.WaitForPendingFinalizers();

        // Unload unused assets
        await Resources.UnloadUnusedAssets().ToUniTask();
        await UniTask.DelayFrame(2);

        // Run GC
        GC.Collect(GC.MaxGeneration, GCCollectionMode.Forced);
        GC.WaitForPendingFinalizers();

        await UniTask.WaitForSeconds(0.1f);

        // Log Link/Ref that leaked due to missing Release
        // Use error log to fix code (add ReleaseAsset() calls)
        AddressablesTracker.ReportUnreferencedHandles();

        // Log Link/Ref that leaked & force ReleaseAsset (fallback)
        // But not release the handles that are assets of scene links. (Too dangerous…)
        AddressablesTracker.ReleaseUnreferencedHandles(true);
    }
}