feat: TypeWhisper Flow sessions, Phase 4 UX, and GitHub Pages privacy site

Migrate keyboard dictation to continuous Flow sessions with auto-start, tap-to-toggle recording, 60s countdown, five-step onboarding, and App Group IPC. Add docs/ GitHub Pages site with en/zh privacy policy for App Store compliance.
2026-06-19 18:05:50 +08:00
parent 6148d05093
commit 7f059dbd45
48 changed files with 3815 additions and 1065 deletions
@@ -0,0 +1,35 @@
+// FlowSessionKeys.swift
+// OSGKeyboard · Shared
+//
+// App Group keys for TypeWhisper-style Flow sessions between the
+// keyboard extension and the host app (Session Owner).
+
+import Foundation
+
+public enum FlowSessionKeys {
+    public static let flowSessionActive = "flow.flowSessionActive"
+    public static let flowSessionExpires = "flow.flowSessionExpires"
+    public static let flowHeartbeat = "flow.flowHeartbeat"
+    public static let keyboardRecordingState = "flow.keyboardRecordingState"
+    public static let transcriptionLanguage = "flow.transcriptionLanguage"
+    public static let transcriptionResult = "flow.transcriptionResult"
+    public static let transcriptionError = "flow.transcriptionError"
+    public static let audioLevels = "flow.audioLevels"
+
+    /// Heartbeat older than this implies the host app was killed.
+    public static let heartbeatStaleInterval: TimeInterval = 3
+
+    /// Default Flow session length when started from the keyboard.
+    public static let defaultSessionDuration: TimeInterval = 480
+
+    /// Maximum duration for a single keyboard utterance.
+    public static let maxUtteranceDuration: TimeInterval = 60
+
+    public enum RecordingState: String, Sendable, Equatable {
+        case idle
+        case recording
+        case stopped
+        case processing
+        case aborted
+    }
+}