feat: add extensible item inventory and world system

src/Features/Items/Contracts/Hand.cs

@@ -0,0 +1,7 @@
+namespace Game.Features.Items.Contracts;
+
+public enum Hand
+{
+    Left,
+    Right
+}

src/Features/Items/Contracts/Hand.cs.uid

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

src/Features/Items/Contracts/HandRequirement.cs

@@ -0,0 +1,7 @@
+namespace Game.Features.Items.Contracts;
+
+public enum HandRequirement
+{
+    One,
+    Both
+}

src/Features/Items/Contracts/HandRequirement.cs.uid

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

src/Features/Items/Contracts/IHeldItemPresenter.cs

@@ -0,0 +1,10 @@
+using Godot;
+
+namespace Game.Features.Items.Contracts;
+
+public interface IHeldItemPresenter
+{
+    bool TryShowHeld(IItemInstance item, Hand hand);
+    bool TryShowDropped(IItemInstance item, Vector3 worldPosition);
+    void Refresh(IItemInstance item);
+}

src/Features/Items/Contracts/IHeldItemPresenter.cs.uid

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

src/Features/Items/Contracts/IItemInstance.cs

@@ -0,0 +1,7 @@
+namespace Game.Features.Items.Contracts;
+
+public interface IItemInstance
+{
+    ItemInfo Info { get; }
+    ItemActionResult Use(ItemUseRequest request);
+}

src/Features/Items/Contracts/IItemInstance.cs.uid

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

src/Features/Items/Contracts/IItemInteractionService.cs

@@ -0,0 +1,12 @@
+using Godot;
+
+namespace Game.Features.Items.Contracts;
+
+public interface IItemInteractionService
+{
+    bool IsHandFree(Hand hand);
+    ItemInstanceId? GetHeldItem(Hand hand);
+    ItemActionResult TryPickup(ItemInstanceId itemId, Hand hand);
+    ItemActionResult TryUse(ItemUseRequest request);
+    ItemActionResult TryDrop(Hand hand, Vector3 worldPosition);
+}

src/Features/Items/Contracts/IItemInteractionService.cs.uid

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

src/Features/Items/Contracts/IItemRepository.cs

@@ -0,0 +1,6 @@
+namespace Game.Features.Items.Contracts;
+
+public interface IItemRepository
+{
+    bool TryGet(ItemInstanceId itemId, out IItemInstance item);
+}

src/Features/Items/Contracts/IItemRepository.cs.uid

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

src/Features/Items/Contracts/IItemSpawnPoint.cs

@@ -0,0 +1,8 @@
+using Godot;
+
+namespace Game.Features.Items.Contracts;
+
+public interface IItemSpawnPoint
+{
+    Vector3 GetItemSpawnPosition();
+}

src/Features/Items/Contracts/IItemSpawnPoint.cs.uid

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

src/Features/Items/Contracts/IItemSpawner.cs

@@ -0,0 +1,10 @@
+using System.Collections.Generic;
+using Godot;
+
+namespace Game.Features.Items.Contracts;
+
+public interface IItemSpawner
+{
+    IReadOnlyCollection<ItemDefinitionId> DefinitionIds { get; }
+    ItemActionResult TrySpawn(ItemDefinitionId definitionId, Vector3 worldPosition, out ItemInstanceId itemId);
+}

src/Features/Items/Contracts/IItemSpawner.cs.uid

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

src/Features/Items/Contracts/IPickupTarget.cs

@@ -0,0 +1,6 @@
+namespace Game.Features.Items.Contracts;
+
+public interface IPickupTarget
+{
+    ItemInfo ItemInfo { get; }
+}

src/Features/Items/Contracts/IPickupTarget.cs.uid

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

src/Features/Items/Contracts/ItemActionPhase.cs

@@ -0,0 +1,8 @@
+namespace Game.Features.Items.Contracts;
+
+public enum ItemActionPhase
+{
+    Started,
+    Completed,
+    Cancelled
+}

src/Features/Items/Contracts/ItemActionPhase.cs.uid

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

src/Features/Items/Contracts/ItemActionResult.cs

@@ -0,0 +1,10 @@
+namespace Game.Features.Items.Contracts;
+
+public readonly record struct ItemActionResult(ItemActionStatus Status, string Message = "")
+{
+    public bool Success => Status == ItemActionStatus.Success;
+
+    public static ItemActionResult Ok() => new(ItemActionStatus.Success);
+
+    public static ItemActionResult Fail(ItemActionStatus status, string message) => new(status, message);
+}

src/Features/Items/Contracts/ItemActionResult.cs.uid

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

src/Features/Items/Contracts/ItemActionStatus.cs

@@ -0,0 +1,12 @@
+namespace Game.Features.Items.Contracts;
+
+public enum ItemActionStatus
+{
+    Success,
+    ItemNotFound,
+    HandOccupied,
+    HandEmpty,
+    UnsupportedAction,
+    PresentationFailed,
+    UnknownDefinition
+}

src/Features/Items/Contracts/ItemActionStatus.cs.uid

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

src/Features/Items/Contracts/ItemDefinition.cs

@@ -0,0 +1,7 @@
+namespace Game.Features.Items.Contracts;
+
+public readonly record struct ItemDefinition(
+    ItemDefinitionId Id,
+    string DisplayName,
+    HandRequirement HandRequirement
+);

src/Features/Items/Contracts/ItemDefinition.cs.uid

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

src/Features/Items/Contracts/ItemDefinitionId.cs

@@ -0,0 +1,6 @@
+namespace Game.Features.Items.Contracts;
+
+public readonly record struct ItemDefinitionId(string Value)
+{
+    public override string ToString() => Value;
+}

src/Features/Items/Contracts/ItemDefinitionId.cs.uid

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

src/Features/Items/Contracts/ItemInfo.cs

@@ -0,0 +1,8 @@
+namespace Game.Features.Items.Contracts;
+
+public readonly record struct ItemInfo(
+    ItemInstanceId Id,
+    ItemDefinitionId DefinitionId,
+    string DisplayName,
+    HandRequirement HandRequirement
+);

src/Features/Items/Contracts/ItemInfo.cs.uid

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

src/Features/Items/Contracts/ItemInstanceId.cs

@@ -0,0 +1,8 @@
+using System;
+
+namespace Game.Features.Items.Contracts;
+
+public readonly record struct ItemInstanceId(Guid Value)
+{
+    public override string ToString() => Value.ToString();
+}

src/Features/Items/Contracts/ItemInstanceId.cs.uid

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

src/Features/Items/Contracts/ItemUseRequest.cs

@@ -0,0 +1,11 @@
+using Game.Features.Interactions.Contracts;
+using Game.Features.Players.Contracts;
+
+namespace Game.Features.Items.Contracts;
+
+public readonly record struct ItemUseRequest(
+    PlayerId PlayerId,
+    Hand Hand,
+    ItemActionPhase Phase,
+    InteractionTargetId? TargetId = null
+);

src/Features/Items/Contracts/ItemUseRequest.cs.uid

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