Tekkon // (v1.4.2) Integrate phonabetKeyForQuery().

Packages/vChewing_Tekkon/Sources/Tekkon/Tekkon_SyllableComposer.swift

@@ -46,6 +46,9 @@ public extension Tekkon {
       consonant.value + semivowel.value + vowel.value + intonation.value
     }
 
+    /// 當前注拼槽是否處於拼音模式。
+    public var isPinyinMode: Bool { parser.rawValue >= 100 }
+
     /// 與 value 類似，這個函式就是用來決定輸入法組字區內顯示的注音/拼音內容，
     /// 但可以指定是否輸出教科書格式（拼音的調號在字母上方、注音的輕聲寫在左側）。
     /// - Parameters:
@@ -66,8 +69,7 @@ public extension Tekkon {
     /// - Parameters:
     ///   - isHanyuPinyin: 是否將輸出結果轉成漢語拼音。
     public func getInlineCompositionForDisplay(isHanyuPinyin: Bool = false) -> String {
-      switch parser {
+      guard isPinyinMode else { return getComposition(isHanyuPinyin: isHanyuPinyin) }
-      case .ofHanyuPinyin, .ofSecondaryPinyin, .ofYalePinyin, .ofHualuoPinyin, .ofUniversalPinyin, .ofWadeGilesPinyin:
       var toneReturned = ""
       switch intonation.value {
       case " ": toneReturned = "1"
@@ -78,17 +80,12 @@ public extension Tekkon {
       default: break
       }
       return romajiBuffer.replacingOccurrences(of: "v", with: "ü") + toneReturned
-      default: return getComposition(isHanyuPinyin: isHanyuPinyin)
-      }
     }
 
     /// 注拼槽內容是否為空。
     public var isEmpty: Bool {
-      switch parser {
+      guard !isPinyinMode else { return intonation.isEmpty && romajiBuffer.isEmpty }
-      case .ofHanyuPinyin, .ofSecondaryPinyin, .ofYalePinyin, .ofHualuoPinyin, .ofUniversalPinyin, .ofWadeGilesPinyin:
+      return intonation.isEmpty && vowel.isEmpty && semivowel.isEmpty && consonant.isEmpty
-        return intonation.isEmpty && romajiBuffer.isEmpty
-      default: return intonation.isEmpty && vowel.isEmpty && semivowel.isEmpty && consonant.isEmpty
-      }
     }
 
     /// 注拼槽內容是否可唸。
@@ -197,8 +194,10 @@ public extension Tekkon {
     /// - Parameters:
     ///   - fromString: 傳入的 String 內容。
     public mutating func receiveKey(fromString input: String = "") {
-      switch parser {
+      guard isPinyinMode else {
-      case .ofHanyuPinyin, .ofSecondaryPinyin, .ofYalePinyin, .ofHualuoPinyin, .ofUniversalPinyin, .ofWadeGilesPinyin:
+        receiveKey(fromPhonabet: translate(key: input))
+        return
+      }
       if mapArayuruPinyinIntonation.keys.contains(input) {
         if let theTone = mapArayuruPinyinIntonation[input] {
           intonation = Phonabet(theTone)
@@ -213,8 +212,6 @@ public extension Tekkon {
         receiveSequence(romajiBufferBackup, isRomaji: true)
         romajiBuffer = romajiBufferBackup
       }
-      default: receiveKey(fromPhonabet: translate(key: input))
-      }
     }
 
     /// 接受傳入的按鍵訊號時的處理，處理對象為 UniChar。
@@ -325,9 +322,7 @@ public extension Tekkon {
     ///
     /// 基本上就是按順序從游標前方開始往後刪。
     public mutating func doBackSpace() {
-      if [.ofHanyuPinyin, .ofSecondaryPinyin, .ofYalePinyin, .ofHualuoPinyin, .ofUniversalPinyin, .ofWadeGilesPinyin].contains(parser),
+      if isPinyinMode, !romajiBuffer.isEmpty {
-         !romajiBuffer.isEmpty
-      {
         if !intonation.isEmpty {
           intonation.clear()
         } else {
@@ -361,7 +356,29 @@ public extension Tekkon {
       parser = arrange
     }
 
-    // MARK: - Parser Processings
+    /// 拿取用來進行索引檢索用的注音字串。
+    ///
+    /// 如果輸入法的辭典索引是漢語拼音的話，你可能用不上這個函式。
+    /// - Remark: 該字串結果不能為空，否則組字引擎會炸。
+    /// - Parameter pronouncable: 是否可以唸出。
+    /// - Returns: 可用的查詢用注音字串，或者 nil。
+    public func phonabetKeyForQuery(pronouncable: Bool) -> String? {
+      let readingKey = getComposition()
+      var validKeyGeneratable = false
+      switch isPinyinMode {
+      case false:
+        switch pronouncable {
+        case false:
+          validKeyGeneratable = !readingKey.isEmpty
+        case true:
+          validKeyGeneratable = isPronouncable
+        }
+      case true: validKeyGeneratable = isPronouncable
+      }
+      return validKeyGeneratable ? readingKey : nil
+    }
+
+    // MARK: - Parser Processing
 
     // 注拼槽對內處理用函式都在這一小節。
 
@@ -371,6 +388,7 @@ public extension Tekkon {
     /// - Parameters:
     ///   - key: 傳入的 String 訊號。
     public mutating func translate(key: String = "") -> String {
+      guard !isPinyinMode else { return "" }
       switch parser {
       case .ofDachen:
         return Tekkon.mapQwertyDachen[key] ?? ""
@@ -392,11 +410,10 @@ public extension Tekkon {
         return Tekkon.mapFakeSeigyou[key] ?? ""
       case .ofStarlight:
         return handleStarlight(key: key)
-      case .ofHanyuPinyin, .ofSecondaryPinyin, .ofYalePinyin, .ofHualuoPinyin, .ofUniversalPinyin, .ofWadeGilesPinyin:
+      default:
-        break // 漢語拼音單獨用另外的函式處理
-      }
         return ""
       }
+    }
 
     /// 所有動態注音鍵盤佈局都會用到的共用糾錯處理步驟。
     /// - Parameter incomingPhonabet: 傳入的注音 Phonabet。

Source/Modules/InputHandler_HandleComposition.swift

@@ -94,7 +94,7 @@ extension InputHandler {
         return handleEnter(input: input, readingOnly: true)
       }
       // 拿取用來進行索引檢索用的注音。這裡先不急著處理「僅有注音符號輸入」的情況。
-      guard let readingKey = composer.keyForQuery(pronouncable: true) else { break ifComposeReading }
+      guard let readingKey = composer.phonabetKeyForQuery(pronouncable: true) else { break ifComposeReading }
       // 向語言模型詢問是否有對應的記錄。
       if !currentLM.hasUnigramsFor(keyArray: [readingKey]) {
         delegate.callError("B49C0979：語彙庫內無「\(readingKey)」的匹配記錄。")
@@ -167,7 +167,7 @@ extension InputHandler {
     /// 但這裡不處理陰平聲調。
     if keyConsumedByReading {
       // 此處將 strict 設為 false，以應對「僅有注音符號輸入」的情況。
-      if composer.keyForQuery(pronouncable: false) == nil {
+      if composer.phonabetKeyForQuery(pronouncable: false) == nil {
         // 將被空格鍵覆蓋掉的既有聲調塞入組字器。
         if !composer.isPinyinMode, input.isSpace,
            compositor.insertKey(existedIntonation.value)
@@ -379,33 +379,3 @@ extension InputHandler {
     }
   }
 }
-
-// MARK: - Private Extensions for Tekkon Composer
-
-// 此處的功能擴充大概只會在威注音輸入法當中用到。
-
-extension Tekkon.Composer {
-  /// 闡明當前注拼槽是否處於拼音模式。
-  var isPinyinMode: Bool { parser.rawValue >= 100 }
-
-  /// 拿取用來進行索引檢索用的注音。
-  /// 如果輸入法的辭典索引是漢語拼音的話，要注意改這裡、使其拿到的內容是漢語拼音。
-  /// - Remark: 該字串不能為空，否則組字引擎會炸。
-  /// - Parameter pronouncable: 是否可以唸出。
-  /// - Returns: 可用的查詢用注音字串，或者 nil。
-  func keyForQuery(pronouncable: Bool) -> String? {
-    let readingKey = getComposition()
-    var validKeyGeneratable = false
-    switch isPinyinMode {
-    case false:
-      switch pronouncable {
-      case false:
-        validKeyGeneratable = !readingKey.isEmpty
-      case true:
-        validKeyGeneratable = isPronouncable
-      }
-    case true: validKeyGeneratable = isPronouncable
-    }
-    return validKeyGeneratable ? readingKey : nil
-  }
-}