chore(typing): snapshot local pinyin WIP before syncing cloud branch

Preserve the in-progress local typing/pinyin implementation so feat/pinyin can safely reset to origin/feat/pinyin (cloud English + Chinese typing).
2026-08-03 13:14:01 +08:00
parent c037be3654
commit d1e5fed964
58 changed files with 370539 additions and 121 deletions
@@ -0,0 +1,76 @@
+// RimeEngineBridging.swift
+// OSGKeyboard · Shared
+//
+// Engine façade for the typing surface. `LibrimeEngine` is the production
+// implementation; the protocol keeps SwiftUI independent of the C runtime.
+
+import Foundation
+
+/// Input language for the typing surface (not ASR locale).
+public enum TypingInputLanguage: String, CaseIterable, Identifiable, Sendable {
+    case chinese
+    case english
+
+    public var id: String { rawValue }
+
+    public var shortLabel: String {
+        switch self {
+        case .chinese: return "中"
+        case .english: return "英"
+        }
+    }
+}
+
+/// One candidate row item after composing.
+public struct TypingCandidate: Identifiable, Equatable, Sendable {
+    public let id: String
+    public let text: String
+    public let annotation: String?
+
+    public init(id: String = UUID().uuidString, text: String, annotation: String? = nil) {
+        self.id = id
+        self.text = text
+        self.annotation = annotation
+    }
+}
+
+/// Snapshot the UI observes while composing.
+public struct TypingComposition: Equatable, Sendable {
+    public var preedit: String
+    public var candidates: [TypingCandidate]
+
+    public init(preedit: String = "", candidates: [TypingCandidate] = []) {
+        self.preedit = preedit
+        self.candidates = candidates
+    }
+
+    public static let empty = TypingComposition()
+}
+
+/// Bridge between key events and IME state. Keep this small so Phase 2
+/// can swap KeyboardKit-style shells or librime without UI rewrites.
+@MainActor
+public protocol RimeEngineBridging: AnyObject {
+    var composition: TypingComposition { get }
+    var isReady: Bool { get }
+    var schema: TypingInputSchema { get }
+
+    /// Load dictionaries / open session. Safe to call repeatedly.
+    func prepare() async throws
+    /// Drop heavy caches (leave typing mode / memory warning).
+    func teardown()
+
+    func setLanguage(_ language: TypingInputLanguage)
+    @discardableResult
+    func setSchema(_ schema: TypingInputSchema) -> Bool
+    /// Process one key and return newly committed text, if any.
+    func processCharacter(_ character: Character) -> String?
+    func processBackspace() -> String?
+    func processSpace() -> String?
+    func processReturn() -> String?
+    /// Commit candidate at index; returns text to insert (empty if invalid).
+    func selectCandidate(at index: Int) -> String
+    /// Force-commit current preedit as raw latin (or empty).
+    func flushPreedit() -> String
+    func clearComposition()
+}