Add Cell<T> utility class

PowerKit.Tests/CellTests.cs

@@ -0,0 +1,52 @@
+using FluentAssertions;
+using PowerKit;
+using Xunit;
+
+namespace PowerKit.Tests;
+
+public class CellTests
+{
+    [Fact]
+    public void TryOpen_ValueNotSet_Test()
+    {
+        // Arrange
+        var cell = new Cell<int?>();
+
+        // Act
+        var result = cell.TryOpen(out var value);
+
+        // Assert
+        result.Should().BeFalse();
+        value.Should().BeNull();
+    }
+
+    [Fact]
+    public void Store_TryOpen_Test()
+    {
+        // Arrange
+        var cell = new Cell<int?>();
+
+        // Act
+        cell.Store(42);
+        var result = cell.TryOpen(out var value);
+
+        // Assert
+        result.Should().BeTrue();
+        value.Should().Be(42);
+    }
+
+    [Fact]
+    public void Store_Null_TryOpen_Test()
+    {
+        // Arrange
+        var cell = new Cell<int?>();
+
+        // Act
+        cell.Store(null);
+        var result = cell.TryOpen(out var value);
+
+        // Assert
+        result.Should().BeTrue();
+        value.Should().BeNull();
+    }
+}

PowerKit/Cell.cs

@@ -0,0 +1,36 @@
+namespace PowerKit;
+
+/// <summary>
+/// Container for a value that may or may not be set.
+/// Essentially <see cref="System.Nullable{T}" />, but for cases where null is also a valid value.
+/// </summary>
+internal class Cell<T>
+{
+    private bool _isValueSet;
+    private T _value = default!;
+
+    /// <summary>
+    /// Stores the specified value in the cell.
+    /// </summary>
+    public void Store(T value)
+    {
+        _value = value;
+        _isValueSet = true;
+    }
+
+    /// <summary>
+    /// Tries to retrieve the value stored in the cell.
+    /// Returns <see langword="true" /> if a value has been stored, <see langword="false" /> otherwise.
+    /// </summary>
+    public bool TryOpen(out T value)
+    {
+        if (_isValueSet)
+        {
+            value = _value;
+            return true;
+        }
+
+        value = default!;
+        return false;
+    }
+}