feat(keyboard): improve typing, voice flow, and polish reliability

Reduce extension memory pressure and delivery races while adding richer candidates, tactile feedback, and safer two-level creative polishing.
2026-08-05 21:39:31 +08:00
parent 38e5ad570d
commit 31f5937a7f
177 changed files with 8343 additions and 3904 deletions
@@ -0,0 +1,98 @@
+// AppGroupOnboardingStoreTests.swift
+// OSGKeyboard · Tests
+//
+// Locks AppGroupStore onboarding flags (host-app OnboardingView),
+// detected app-context accessors, and polish intensity defaults.
+
+import XCTest
+@testable import OSGKeyboard
+@testable import OSGKeyboardShared
+
+final class AppGroupOnboardingStoreTests: XCTestCase {
+
+    private var suiteName: String!
+    private var defaults: UserDefaults!
+    private var store: AppGroupStore!
+
+    override func setUp() {
+        super.setUp()
+        suiteName = "group.com.osgkeyboard.shared.tests.\(UUID().uuidString)"
+        defaults = UserDefaults(suiteName: suiteName)!
+        defaults.removePersistentDomain(forName: suiteName)
+        store = AppGroupStore(defaults: defaults)
+    }
+
+    override func tearDown() {
+        defaults.removePersistentDomain(forName: suiteName)
+        super.tearDown()
+    }
+
+    // MARK: - Onboarding flags (host app)
+
+    func testOnboardingFlagsDefaultFalseAndZero() {
+        XCTAssertFalse(store.hasCompletedOnboarding, "fresh install should not show as onboarded")
+        XCTAssertEqual(store.onboardingPage, 0, "fresh install should start at page 0")
+        XCTAssertEqual(store.polishIntensity, .light)
+    }
+
+    func testPolishIntensityRoundTrip() {
+        store.setPolishIntensity(.heavy)
+
+        XCTAssertEqual(AppGroupStore(defaults: defaults).polishIntensity, .heavy)
+    }
+
+    func testOnboardingFlagsRoundTrip() {
+        store.onboardingPage = 3
+        XCTAssertEqual(store.onboardingPage, 3)
+        store.hasCompletedOnboarding = true
+        XCTAssertTrue(store.hasCompletedOnboarding)
+        // Completing onboarding clears the in-progress page index.
+        XCTAssertEqual(store.onboardingPage, 0)
+    }
+
+    func testOnboardingFlagsSurviveReconstruct() {
+        store.onboardingPage = 4
+
+        var store2 = AppGroupStore(defaults: defaults)
+        XCTAssertEqual(store2.onboardingPage, 4)
+
+        store2.hasCompletedOnboarding = true
+        let store3 = AppGroupStore(defaults: defaults)
+        XCTAssertTrue(store3.hasCompletedOnboarding)
+        XCTAssertEqual(store3.onboardingPage, 0)
+    }
+
+    // MARK: - App context detection round-trip
+
+    func testDetectedAppContextRoundTrip() throws {
+        let now = Date()
+        store.setDetectedAppContext(.code, at: now)
+        let result = store.detectedAppContext
+        XCTAssertEqual(result?.context, .code)
+        let observedAt = try XCTUnwrap(result?.observedAt)
+        XCTAssertEqual(observedAt.timeIntervalSinceReferenceDate,
+                       now.timeIntervalSinceReferenceDate,
+                       accuracy: 0.001)
+    }
+
+    func testDetectedAppContextOverwrite() {
+        store.setDetectedAppContext(.code)
+        store.setDetectedAppContext(.email)
+        XCTAssertEqual(store.detectedAppContext?.context, .email,
+                       "second setDetectedAppContext must overwrite the first")
+    }
+
+    func testDetectedAppContextEmptyBeforeSet() {
+        XCTAssertNil(store.detectedAppContext,
+                     "detectedAppContext must be nil before any explicit set")
+    }
+
+    // MARK: - All cases enum surface
+
+    func testAllAppContextCasesHaveRawValue() {
+        for context in AppContext.allCases {
+            XCTAssertFalse(context.rawValue.isEmpty,
+                           "AppContext.\(context) must have a non-empty rawValue")
+        }
+    }
+}