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,52 @@
+// TypingLayoutProviding.swift
+// OSGKeyboard · Shared
+//
+// Phase 2 escape hatch: replace the in-repo SwiftUI key shell with a
+// KeyboardKit-based (or other) layout without changing the engine bridge.
+
+import Foundation
+
+/// Page shown by the typing key shell.
+public enum TypingKeyPage: String, CaseIterable, Sendable {
+    case letters
+    case numbers
+    case symbols
+}
+
+/// Abstraction over “which characters the current page shows”.
+/// The Phase 1 SwiftUI keyboard reads this; a future Kit-backed shell
+/// can feed the same consumer.
+public protocol TypingLayoutProviding: Sendable {
+    func rows(for page: TypingKeyPage, shiftActive: Bool) -> [[String]]
+}
+
+/// Standard phone QWERTY + 123 + light symbols (NanoMouse / system-like).
+public struct StandardTypingLayout: TypingLayoutProviding {
+    public init() {}
+
+    public func rows(for page: TypingKeyPage, shiftActive: Bool) -> [[String]] {
+        switch page {
+        case .letters:
+            let upper = shiftActive
+            let map: (String) -> String = { upper ? $0.uppercased() : $0 }
+            return [
+                ["q", "w", "e", "r", "t", "y", "u", "i", "o", "p"].map(map),
+                ["a", "s", "d", "f", "g", "h", "j", "k", "l"].map(map),
+                ["⇧", "z", "x", "c", "v", "b", "n", "m", "⌫"].map { $0.count == 1 ? map($0) : $0 }
+            ]
+        case .numbers:
+            return [
+                ["1", "2", "3", "4", "5", "6", "7", "8", "9", "0"],
+                ["-", "/", ":", ";", "(", ")", "$", "&", "@", "\""],
+                ["#+=", ".", ",", "?", "!", "'", "⌫"]
+            ]
+        case .symbols:
+            return [
+                ["[", "]", "{", "}", "#", "%", "^", "*", "+", "="],
+                ["_", "\\", "|", "~", "<", ">", "€", "£", "¥", "·"],
+                ["123", ".", ",", "?", "!", "'", "⌫"],
+                ["，", "。", "、", "？", "！", "：", "；"]
+            ]
+        }
+    }
+}