test: add unit tests for DialogLayoutHelper, VibrationPatterns, InputBoxLayoutManager

perditavojo · Copilot · perditavojo · commit 3787f37abd34 · 2026-04-10T14:12:19.000+08:00
- DialogLayoutHelperTests: 9 tests for TryBeginDpiLayout DPI debounce and GetMaxFitSize boundary math
- VibrationPatternsTests: 12 tests verifying static vibration profile values and GlobalIntensityMultiplier
- InputBoxLayoutManagerTests: 4 tests for UpdateMinimumSize DPI debounce callback logic

Increases test count from 124 to 150 (+21%)

Co-authored-by: Copilot &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/tests/InputBox.Tests/DialogLayoutHelperTests.cs b/tests/InputBox.Tests/DialogLayoutHelperTests.cs
@@ -0,0 +1,130 @@
+using InputBox.Core.Utilities;
+using Xunit;
+
+namespace InputBox.Tests;
+
+/// <summary>
+/// DialogLayoutHelper 的 DPI 防抖與工作區計算邏輯測試
+/// </summary>
+public class DialogLayoutHelperTests
+{
+    // ── TryBeginDpiLayout ──────────────────────────────────────────────────
+
+    /// <summary>
+    /// DPI 沒有變化時（差值 &lt; 0.01），不應觸發重新計算，回傳 false 且快取不變。
+    /// </summary>
+    [Fact]
+    public void TryBeginDpiLayout_SameDpi_ReturnsFalse()
+    {
+        float lastDpi = 96f;
+        bool result = DialogLayoutHelper.TryBeginDpiLayout(96f, ref lastDpi);
+
+        Assert.False(result);
+        Assert.Equal(96f, lastDpi);
+    }
+
+    /// <summary>
+    /// DPI 在 0.01 以內的微小差值不應視為變化，回傳 false。
+    /// </summary>
+    [Fact]
+    public void TryBeginDpiLayout_TinyDiff_ReturnsFalse()
+    {
+        float lastDpi = 96f;
+        bool result = DialogLayoutHelper.TryBeginDpiLayout(96.005f, ref lastDpi);
+
+        Assert.False(result);
+    }
+
+    /// <summary>
+    /// DPI 變化超過 0.01 時，應觸發重新計算，回傳 true 並更新快取值。
+    /// </summary>
+    [Fact]
+    public void TryBeginDpiLayout_ChangedDpi_ReturnsTrueAndUpdatesCache()
+    {
+        float lastDpi = 96f;
+        bool result = DialogLayoutHelper.TryBeginDpiLayout(120f, ref lastDpi);
+
+        Assert.True(result);
+        Assert.Equal(120f, lastDpi);
+    }
+
+    /// <summary>
+    /// forceRecalculate = true 時，即使 DPI 相同也應強制重新計算並更新快取。
+    /// </summary>
+    [Fact]
+    public void TryBeginDpiLayout_ForceRecalculate_ReturnsTrueEvenIfSameDpi()
+    {
+        float lastDpi = 96f;
+        bool result = DialogLayoutHelper.TryBeginDpiLayout(96f, ref lastDpi, forceRecalculate: true);
+
+        Assert.True(result);
+        Assert.Equal(96f, lastDpi);
+    }
+
+    /// <summary>
+    /// DPI 從高降至低也應觸發重新計算（確保縮小場景同樣被偵測）。
+    /// </summary>
+    [Fact]
+    public void TryBeginDpiLayout_DpiDecreased_ReturnsTrueAndUpdatesCache()
+    {
+        float lastDpi = 144f;
+        bool result = DialogLayoutHelper.TryBeginDpiLayout(96f, ref lastDpi);
+
+        Assert.True(result);
+        Assert.Equal(96f, lastDpi);
+    }
+
+    // ── GetMaxFitSize ──────────────────────────────────────────────────────
+
+    /// <summary>
+    /// 一般工作區應回傳 workArea 扣除 margin 的寬高。
+    /// </summary>
+    [Fact]
+    public void GetMaxFitSize_NormalWorkArea_ReturnsWidthAndHeightMinusMargin()
+    {
+        Rectangle workArea = new(0, 0, 1920, 1080);
+        var (w, h) = DialogLayoutHelper.GetMaxFitSize(workArea, margin: 40);
+
+        Assert.Equal(1880, w);
+        Assert.Equal(1040, h);
+    }
+
+    /// <summary>
+    /// 不傳 margin 時應使用預設值 40，結果相同。
+    /// </summary>
+    [Fact]
+    public void GetMaxFitSize_DefaultMargin_Is40()
+    {
+        Rectangle workArea = new(0, 0, 800, 600);
+        var (w, h) = DialogLayoutHelper.GetMaxFitSize(workArea);
+
+        Assert.Equal(760, w);
+        Assert.Equal(560, h);
+    }
+
+    /// <summary>
+    /// 工作區寬度小於或等於 margin 時，MaxFitWidth 應回傳最小值 1，不允許 &lt;= 0。
+    /// </summary>
+    [Fact]
+    public void GetMaxFitSize_WorkAreaSmallerThanMargin_ReturnsAtLeastOne()
+    {
+        Rectangle workArea = new(0, 0, 30, 30);
+        var (w, h) = DialogLayoutHelper.GetMaxFitSize(workArea, margin: 40);
+
+        Assert.Equal(1, w);
+        Assert.Equal(1, h);
+    }
+
+    /// <summary>
+    /// margin = 0 時回傳值應等於工作區的實際寬高。
+    /// </summary>
+    [Fact]
+    public void GetMaxFitSize_ZeroMargin_ReturnsExactWorkAreaSize()
+    {
+        Rectangle workArea = new(0, 0, 1280, 720);
+        var (w, h) = DialogLayoutHelper.GetMaxFitSize(workArea, margin: 0);
+
+        Assert.Equal(1280, w);
+        Assert.Equal(720, h);
+    }
+}
diff --git a/tests/InputBox.Tests/InputBoxLayoutManagerTests.cs b/tests/InputBox.Tests/InputBoxLayoutManagerTests.cs
@@ -0,0 +1,87 @@
+using InputBox.Core.Utilities;
+using Xunit;
+
+namespace InputBox.Tests;
+
+/// <summary>
+/// InputBoxLayoutManager.UpdateMinimumSize DPI 防抖邏輯測試
+/// </summary>
+public class InputBoxLayoutManagerTests
+{
+    // ── UpdateMinimumSize ──────────────────────────────────────────────────
+
+    /// <summary>
+    /// DPI 沒有變化（差值 &lt; 0.01）時，不應呼叫任何回呼，並回傳原始快取值。
+    /// </summary>
+    [Fact]
+    public void UpdateMinimumSize_SameDpi_DoesNotInvokeCallbacks()
+    {
+        bool layoutCalled = false;
+        bool opacityCalled = false;
+
+        float result = InputBoxLayoutManager.UpdateMinimumSize(
+            currentDpi: 96f,
+            lastAppliedDpi: 96f,
+            updateLayoutConstraints: () => layoutCalled = true,
+            updateOpacityWhenHighContrast: () => opacityCalled = true);
+
+        Assert.False(layoutCalled);
+        Assert.False(opacityCalled);
+        Assert.Equal(96f, result);
+    }
+
+    /// <summary>
+    /// DPI 在 0.01 閾值以內的微小差距不應觸發更新。
+    /// </summary>
+    [Fact]
+    public void UpdateMinimumSize_TinyDiffBelowThreshold_DoesNotInvokeCallbacks()
+    {
+        bool layoutCalled = false;
+
+        float result = InputBoxLayoutManager.UpdateMinimumSize(
+            currentDpi: 96.005f,
+            lastAppliedDpi: 96f,
+            updateLayoutConstraints: () => layoutCalled = true,
+            updateOpacityWhenHighContrast: () => { });
+
+        Assert.False(layoutCalled);
+        // 快取不應被更新（小於閾值回傳 lastAppliedDpi）
+        Assert.Equal(96f, result);
+    }
+
+    /// <summary>
+    /// DPI 有明確變化時，應呼叫 updateLayoutConstraints 回呼並回傳新的 DPI 值。
+    /// </summary>
+    [Fact]
+    public void UpdateMinimumSize_ChangedDpi_InvokesLayoutCallback()
+    {
+        bool layoutCalled = false;
+
+        float result = InputBoxLayoutManager.UpdateMinimumSize(
+            currentDpi: 120f,
+            lastAppliedDpi: 96f,
+            updateLayoutConstraints: () => layoutCalled = true,
+            updateOpacityWhenHighContrast: () => { });
+
+        Assert.True(layoutCalled);
+        Assert.Equal(120f, result);
+    }
+
+    /// <summary>
+    /// DPI 從高降至低也應觸發 updateLayoutConstraints（縮小場景同樣被偵測）。
+    /// </summary>
+    [Fact]
+    public void UpdateMinimumSize_DpiDecreased_InvokesLayoutCallback()
+    {
+        bool layoutCalled = false;
+
+        float result = InputBoxLayoutManager.UpdateMinimumSize(
+            currentDpi: 96f,
+            lastAppliedDpi: 144f,
+            updateLayoutConstraints: () => layoutCalled = true,
+            updateOpacityWhenHighContrast: () => { });
+
+        Assert.True(layoutCalled);
+        Assert.Equal(96f, result);
+    }
+}
diff --git a/tests/InputBox.Tests/VibrationPatternsTests.cs b/tests/InputBox.Tests/VibrationPatternsTests.cs
@@ -0,0 +1,152 @@
+using InputBox.Core.Feedback;
+using Xunit;
+
+namespace InputBox.Tests;
+
+/// <summary>
+/// VibrationPatterns 的靜態欄位值與 GlobalIntensityMultiplier 行為測試
+/// <para>確保各震動設定的強度與持續時間符合設計規格，且全域倍率能正確設定與讀取。</para>
+/// </summary>
+public class VibrationPatternsTests
+{
+    // ── GlobalIntensityMultiplier ──────────────────────────────────────────
+
+    /// <summary>
+    /// GlobalIntensityMultiplier 預設值應為 0.7f。
+    /// </summary>
+    [Fact]
+    public void GlobalIntensityMultiplier_DefaultValue_Is0Point7()
+    {
+        // 重置為已知狀態
+        VibrationPatterns.GlobalIntensityMultiplier = 0.7f;
+        Assert.Equal(0.7f, VibrationPatterns.GlobalIntensityMultiplier);
+    }
+
+    /// <summary>
+    /// 設定 GlobalIntensityMultiplier 後，讀取值應與設定值一致。
+    /// </summary>
+    [Fact]
+    public void GlobalIntensityMultiplier_SetAndGet_ReturnsNewValue()
+    {
+        float original = VibrationPatterns.GlobalIntensityMultiplier;
+
+        try
+        {
+            VibrationPatterns.GlobalIntensityMultiplier = 0.5f;
+            Assert.Equal(0.5f, VibrationPatterns.GlobalIntensityMultiplier);
+        }
+        finally
+        {
+            VibrationPatterns.GlobalIntensityMultiplier = original;
+        }
+    }
+
+    // ── 靜態欄位設計值 ─────────────────────────────────────────────────────
+
+    /// <summary>
+    /// CursorMove 強度應為 18000（足以克服馬達啟動閾值的輕微點擊感）。
+    /// </summary>
+    [Fact]
+    public void CursorMove_Strength_Is18000()
+    {
+        Assert.Equal(18000, VibrationPatterns.CursorMove.Strength);
+    }
+
+    /// <summary>
+    /// CursorMove 持續時間應為 50ms（短暫點擊感，避免連按時糊在一起）。
+    /// </summary>
+    [Fact]
+    public void CursorMove_Duration_Is50()
+    {
+        Assert.Equal(50, VibrationPatterns.CursorMove.Duration);
+    }
+
+    /// <summary>
+    /// CopySuccess 強度應為 40000（約 60% 強度的確認感）。
+    /// </summary>
+    [Fact]
+    public void CopySuccess_Strength_Is40000()
+    {
+        Assert.Equal(40000, VibrationPatterns.CopySuccess.Strength);
+    }
+
+    /// <summary>
+    /// CopySuccess 持續時間應為 150ms。
+    /// </summary>
+    [Fact]
+    public void CopySuccess_Duration_Is150()
+    {
+        Assert.Equal(150, VibrationPatterns.CopySuccess.Duration);
+    }
+
+    /// <summary>
+    /// ActionFail 強度應為 45000（最強，確保錯誤不被忽視）。
+    /// </summary>
+    [Fact]
+    public void ActionFail_Strength_Is45000()
+    {
+        Assert.Equal(45000, VibrationPatterns.ActionFail.Strength);
+    }
+
+    /// <summary>
+    /// ActionFail 持續時間應為 200ms（最長，打破節奏）。
+    /// </summary>
+    [Fact]
+    public void ActionFail_Duration_Is200()
+    {
+        Assert.Equal(200, VibrationPatterns.ActionFail.Duration);
+    }
+
+    /// <summary>
+    /// ControllerConnected 強度應為 30000（觸覺握手的中等強度）。
+    /// </summary>
+    [Fact]
+    public void ControllerConnected_Strength_Is30000()
+    {
+        Assert.Equal(30000, VibrationPatterns.ControllerConnected.Strength);
+    }
+
+    /// <summary>
+    /// ControllerConnected 持續時間應為 200ms（確保視聽雙障使用者也能感知）。
+    /// </summary>
+    [Fact]
+    public void ControllerConnected_Duration_Is200()
+    {
+        Assert.Equal(200, VibrationPatterns.ControllerConnected.Duration);
+    }
+
+    // ── VibrationProfile 值語義 ────────────────────────────────────────────
+
+    /// <summary>
+    /// VibrationProfile 的 Strength 與 Duration 應正確封裝初始值。
+    /// </summary>
+    [Fact]
+    public void VibrationProfile_ConstructorValues_AreAccessible()
+    {
+        var profile = new VibrationProfile(12345, 99);
+        Assert.Equal(12345, profile.Strength);
+        Assert.Equal(99, profile.Duration);
+    }
+
+    /// <summary>
+    /// VibrationProfile 是 record struct，相同值的兩個實例應相等。
+    /// </summary>
+    [Fact]
+    public void VibrationProfile_SameValues_AreEqual()
+    {
+        var a = new VibrationProfile(30000, 120);
+        var b = new VibrationProfile(30000, 120);
+        Assert.Equal(a, b);
+    }
+
+    /// <summary>
+    /// VibrationProfile 不同值的兩個實例應不相等。
+    /// </summary>
+    [Fact]
+    public void VibrationProfile_DifferentValues_AreNotEqual()
+    {
+        var a = new VibrationProfile(30000, 120);
+        var b = new VibrationProfile(30000, 121);
+        Assert.NotEqual(a, b);
+    }
+}
