From 5a62eea6fb68d9f911175cc22189221f5f8ac88f Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Fri, 8 Jul 2022 22:14:05 +0800
Subject: [PATCH 01/20] KeyHandler // Simplify findHighestScore().

---
 .../Modules/ControllerModules/KeyHandler_Core.swift  | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/Source/Modules/ControllerModules/KeyHandler_Core.swift b/Source/Modules/ControllerModules/KeyHandler_Core.swift
index 5b3786e2..2331b7ae 100644
--- a/Source/Modules/ControllerModules/KeyHandler_Core.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_Core.swift
@@ -294,7 +294,7 @@ class KeyHandler {
       compositor.grid.overrideNodeScoreForSelectedCandidate(
         location: min(actualCandidateCursorIndex + (mgrPrefs.useRearCursorMode ? 1 : 0), compositorLength),
         value: overrideValue,
-        overridingScore: findHighestScore(nodes: rawAnchorsOfNodes, epsilon: kEpsilon)
+        overridingScore: findHighestScore(nodeAnchors: rawAnchorsOfNodes, epsilon: kEpsilon)
       )
     } else {
       IME.prtDebugIntel("UOM: Blank suggestion retrieved, dismissing.")
@@ -306,14 +306,8 @@ class KeyHandler {
   ///   - nodes: 給定的節錨陣列。
   ///   - epsilon: 半衰模組的衰減指數。
   /// - Returns: 尋獲的最高權重數值。
-  func findHighestScore(nodes: [Megrez.NodeAnchor], epsilon: Double) -> Double {
-    var highestScore: Double = 0
-    for currentAnchor in nodes {
-      if let theNode = currentAnchor.node {
-        highestScore = max(theNode.highestUnigramScore, highestScore)
-      }
-    }
-    return highestScore + epsilon
+  func findHighestScore(nodeAnchors: [Megrez.NodeAnchor], epsilon: Double) -> Double {
+    return nodeAnchors.compactMap(\.node?.highestUnigramScore).max() ?? 0 + epsilon
   }
 
   // MARK: - Extracted methods and functions (Tekkon).

From 1eae81986fd3f2ba9f2a5deb0ff1b64023db1241 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Sat, 9 Jul 2022 18:57:34 +0800
Subject: [PATCH 02/20] Tekkon // v1.2.4 update.

---
 .../ControllerModules/SyllableComposer.swift  | 50 +++++++++++++++----
 1 file changed, 39 insertions(+), 11 deletions(-)

diff --git a/Source/Modules/ControllerModules/SyllableComposer.swift b/Source/Modules/ControllerModules/SyllableComposer.swift
index 5807d6d3..d76d4636 100644
--- a/Source/Modules/ControllerModules/SyllableComposer.swift
+++ b/Source/Modules/ControllerModules/SyllableComposer.swift
@@ -236,18 +236,11 @@ public struct Tekkon {
     public func getComposition(isHanyuPinyin: Bool = false, isTextBookStyle: Bool = false) -> String {
       switch isHanyuPinyin {
         case false:  // 注音輸出的場合
-          var valReturnZhuyin = value.replacingOccurrences(of: " ", with: "")
-          if isTextBookStyle, valReturnZhuyin.contains("˙") {
-            valReturnZhuyin = String(valReturnZhuyin.dropLast())
-            valReturnZhuyin.insert("˙", at: valReturnZhuyin.startIndex)
-          }
-          return valReturnZhuyin
+          let valReturnZhuyin = value.replacingOccurrences(of: " ", with: "")
+          return isTextBookStyle ? cnvZhuyinChainToTextbookReading(target: valReturnZhuyin) : valReturnZhuyin
         case true:  // 拼音輸出的場合
-          var valReturnPinyin = Tekkon.cnvPhonaToHanyuPinyin(target: value)
-          if isTextBookStyle {
-            valReturnPinyin = Tekkon.cnvHanyuPinyinToTextbookStyle(target: valReturnPinyin)
-          }
-          return valReturnPinyin
+          let valReturnPinyin = Tekkon.cnvPhonaToHanyuPinyin(target: value)
+          return isTextBookStyle ? Tekkon.cnvHanyuPinyinToTextbookStyle(target: valReturnPinyin) : valReturnPinyin
       }
     }
 
@@ -852,6 +845,41 @@ public struct Tekkon {
     return targetConverted
   }
 
+  /// 該函式負責將注音轉為教科書印刷的方式（先寫輕聲）。
+  /// - Parameters:
+  ///   - target: 要拿來做轉換處理的讀音鏈，以英文減號來分隔每個讀音。
+  ///   - newSeparator: 新的讀音分隔符。
+  /// - Returns: 經過轉換處理的讀音鏈。
+  static func cnvZhuyinChainToTextbookReading(target: String, newSeparator: String = "-") -> String {
+    var arrReturn: [String] = []
+    for neta in target.split(separator: "-") {
+      var newString = String(neta)
+      if String(neta.reversed()[0]) == "˙" {
+        newString = String(neta.dropLast())
+        newString.insert("˙", at: newString.startIndex)
+      }
+      arrReturn.append(newString)
+    }
+    return arrReturn.joined(separator: newSeparator)
+  }
+
+  /// 該函式用來恢復注音當中的陰平聲調，恢復之後會以「1」表示陰平。
+  /// - Parameters:
+  ///   - target: 要拿來做轉換處理的讀音鏈，以英文減號來分隔每個讀音。
+  ///   - newSeparator: 新的讀音分隔符。
+  /// - Returns: 經過轉換處理的讀音鏈。
+  static func restoreToneOneInZhuyinKey(target: String, newSeparator: String = "-") -> String {
+    var arrReturn: [String] = []
+    for neta in target.split(separator: "-") {
+      var newNeta = String(neta)
+      if !"ˊˇˋ˙".contains(String(neta.reversed()[0])), !neta.contains("_") {
+        newNeta += "1"
+      }
+      arrReturn.append(newNeta)
+    }
+    return arrReturn.joined(separator: newSeparator)
+  }
+
   /// 原始轉換對照表資料貯存專用佇列（數字標調格式）
   static let arrPhonaToHanyuPinyin = [  // 排序很重要。先處理最長的，再處理短的。不然會出亂子。
     [" ", "1"], ["ˊ", "2"], ["ˇ", "3"], ["ˋ", "4"], ["˙", "5"],

From e681c2e31ba37c042d5647d51cfebcee79a11ae6 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Sat, 9 Jul 2022 10:15:21 +0800
Subject: [PATCH 03/20] KeyHandler // Comment fix.

---
 Source/Modules/ControllerModules/KeyHandler_Core.swift | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Source/Modules/ControllerModules/KeyHandler_Core.swift b/Source/Modules/ControllerModules/KeyHandler_Core.swift
index 2331b7ae..751e4005 100644
--- a/Source/Modules/ControllerModules/KeyHandler_Core.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_Core.swift
@@ -190,8 +190,8 @@ class KeyHandler {
       }
       if addToUserOverrideModel {
         IME.prtDebugIntel("UOM: Start Observation.")
-        // 令半衰記憶模組觀測給定的 trigram。
-        // 這個過程會讓半衰引擎根據當前上下文生成 trigram 索引鍵。
+        // 令半衰記憶模組觀測給定的三元圖。
+        // 這個過程會讓半衰引擎根據當前上下文生成三元圖索引鍵。
         currentUOM.observe(
           walkedAnchors: walkedAnchors, cursorIndex: cursorIndex, candidate: value,
           timestamp: NSDate().timeIntervalSince1970
@@ -284,7 +284,7 @@ class KeyHandler {
     if mgrPrefs.useSCPCTypingMode { return }
     /// 如果這個開關沒打開的話，直接放棄執行這個函式。
     if !mgrPrefs.fetchSuggestionsFromUserOverrideModel { return }
-    /// 先就當前上下文讓半衰引擎重新生成 trigram 索引鍵。
+    /// 先就當前上下文讓半衰引擎重新生成三元圖索引鍵。
     let overrideValue = fetchSuggestedCandidates().first?.keyValue.value ?? ""
 
     /// 再拿著索引鍵去問半衰模組有沒有選字建議。有的話就遵循之、讓天權星引擎對指定節錨下的節點複寫權重。

From f8086500a0737c49267cb460686a4ff8ab938da5 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Sat, 9 Jul 2022 10:24:15 +0800
Subject: [PATCH 04/20] KeyHandler // Implement Alt+Fwd/Bwd support.

---
 .../ControllerModules/KeyHandler_Core.swift   | 24 +++++++++++++++----
 .../ControllerModules/KeyHandler_States.swift | 21 ++++++++++++++++
 2 files changed, 41 insertions(+), 4 deletions(-)

diff --git a/Source/Modules/ControllerModules/KeyHandler_Core.swift b/Source/Modules/ControllerModules/KeyHandler_Core.swift
index 751e4005..0cdf9c6a 100644
--- a/Source/Modules/ControllerModules/KeyHandler_Core.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_Core.swift
@@ -166,10 +166,10 @@ class KeyHandler {
   ///   - value: 給定之候選字字串。
   ///   - respectCursorPushing: 若該選項為 true，則會在選字之後始終將游標推送至選字厚的節錨的前方。
   func fixNode(value: String, respectCursorPushing: Bool = true) {
-    let cursorIndex = min(actualCandidateCursorIndex + (mgrPrefs.useRearCursorMode ? 1 : 0), compositorLength)
+    let adjustedIndex = max(0, min(actualCandidateCursorIndex + (mgrPrefs.useRearCursorMode ? 1 : 0), compositorLength))
     // 開始讓半衰模組觀察目前的狀況。
     let selectedNode: Megrez.NodeAnchor = compositor.grid.fixNodeSelectedCandidate(
-      location: cursorIndex, value: value
+      location: adjustedIndex, value: value
     )
     // 不要針對逐字選字模式啟用臨時半衰記憶模型。
     if !mgrPrefs.useSCPCTypingMode {
@@ -193,7 +193,7 @@ class KeyHandler {
         // 令半衰記憶模組觀測給定的三元圖。
         // 這個過程會讓半衰引擎根據當前上下文生成三元圖索引鍵。
         currentUOM.observe(
-          walkedAnchors: walkedAnchors, cursorIndex: cursorIndex, candidate: value,
+          walkedAnchors: walkedAnchors, cursorIndex: adjustedIndex, candidate: value,
           timestamp: NSDate().timeIntervalSince1970
         )
       }
@@ -206,7 +206,7 @@ class KeyHandler {
     if mgrPrefs.moveCursorAfterSelectingCandidate, respectCursorPushing {
       var nextPosition = 0
       for theAnchor in walkedAnchors {
-        if nextPosition >= cursorIndex { break }
+        if nextPosition >= adjustedIndex { break }
         nextPosition += theAnchor.spanningLength
       }
       if nextPosition <= compositorLength {
@@ -452,4 +452,20 @@ class KeyHandler {
   func deleteCompositorReadingToTheFrontOfCursor() {
     compositor.deleteReadingToTheFrontOfCursor()
   }
+
+  /// 獲取指定游標位置的鍵值長度。
+  /// - Returns: 指定游標位置的鍵值長度。
+  var keyLengthAtCurrentIndex: Int {
+    guard let node = walkedAnchors[compositorCursorIndex].node else { return 0 }
+    return node.key.split(separator: "-").count
+  }
+
+  var nextPhrasePosition: Int {
+    var nextPosition = 0
+    for theAnchor in walkedAnchors {
+      if nextPosition > actualCandidateCursorIndex { break }
+      nextPosition += theAnchor.spanningLength
+    }
+    return min(nextPosition, compositorLength)
+  }
 }
diff --git a/Source/Modules/ControllerModules/KeyHandler_States.swift b/Source/Modules/ControllerModules/KeyHandler_States.swift
index b84fad5a..c8334146 100644
--- a/Source/Modules/ControllerModules/KeyHandler_States.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_States.swift
@@ -651,6 +651,15 @@ extension KeyHandler {
         errorCallback()
         stateCallback(state)
       }
+    } else if input.isOptionHold {
+      if compositorCursorIndex < compositorLength {
+        compositorCursorIndex = nextPhrasePosition
+        stateCallback(buildInputtingState)
+      } else {
+        IME.prtDebugIntel("33C3B580")
+        errorCallback()
+        stateCallback(state)
+      }
     } else {
       if compositorCursorIndex < compositorLength {
         compositorCursorIndex += 1
@@ -707,6 +716,18 @@ extension KeyHandler {
         errorCallback()
         stateCallback(state)
       }
+    } else if input.isOptionHold {
+      if compositorCursorIndex > 1 {
+        compositorCursorIndex -= 2
+        stateCallback(buildInputtingState)
+      } else if compositorCursorIndex == 1 {
+        compositorCursorIndex = 0
+        stateCallback(buildInputtingState)
+      } else {
+        IME.prtDebugIntel("8D50DD9E")
+        errorCallback()
+        stateCallback(state)
+      }
     } else {
       if compositorCursorIndex > 0 {
         compositorCursorIndex -= 1

From 9a369a71cc5888f0e4845e87f555857c70547f43 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Sat, 9 Jul 2022 12:41:41 +0800
Subject: [PATCH 05/20] KeyHandler // Ensure textbook reading display in
 tooltip.

---
 .../ControllerModules/KeyHandler_Core.swift   | 35 -------------------
 .../ControllerModules/KeyHandler_States.swift | 18 ++++++++--
 2 files changed, 15 insertions(+), 38 deletions(-)

diff --git a/Source/Modules/ControllerModules/KeyHandler_Core.swift b/Source/Modules/ControllerModules/KeyHandler_Core.swift
index 0cdf9c6a..28c1d288 100644
--- a/Source/Modules/ControllerModules/KeyHandler_Core.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_Core.swift
@@ -353,41 +353,6 @@ class KeyHandler {
     composer.clear()
   }
 
-  /// 用於網頁 Ruby 的注音需要按照教科書印刷的方式來顯示輕聲。該函式負責這種轉換。
-  /// - Parameters:
-  ///   - target: 要拿來做轉換處理的讀音鏈。
-  ///   - newSeparator: 新的讀音分隔符。
-  /// - Returns: 經過轉換處理的讀音鏈。
-  func cnvZhuyinKeyToTextbookReading(target: String, newSeparator: String = "-") -> String {
-    var arrReturn: [String] = []
-    for neta in target.split(separator: "-") {
-      var newString = String(neta)
-      if String(neta.reversed()[0]) == "˙" {
-        newString = String(neta.dropLast())
-        newString.insert("˙", at: newString.startIndex)
-      }
-      arrReturn.append(newString)
-    }
-    return arrReturn.joined(separator: newSeparator)
-  }
-
-  /// 用於網頁 Ruby 的拼音的陰平必須顯示，這裡處理一下。
-  /// - Parameters:
-  ///   - target: 要拿來做轉換處理的讀音鏈。
-  ///   - newSeparator: 新的讀音分隔符。
-  /// - Returns: 經過轉換處理的讀音鏈。
-  func restoreToneOneInZhuyinKey(target: String, newSeparator: String = "-") -> String {
-    var arrReturn: [String] = []
-    for neta in target.split(separator: "-") {
-      var newNeta = String(neta)
-      if !"ˊˇˋ˙".contains(String(neta.reversed()[0])), !neta.contains("_") {
-        newNeta += "1"
-      }
-      arrReturn.append(newNeta)
-    }
-    return arrReturn.joined(separator: newSeparator)
-  }
-
   // MARK: - Extracted methods and functions (Megrez).
 
   /// 組字器是否為空。
diff --git a/Source/Modules/ControllerModules/KeyHandler_States.swift b/Source/Modules/ControllerModules/KeyHandler_States.swift
index c8334146..affc3bc3 100644
--- a/Source/Modules/ControllerModules/KeyHandler_States.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_States.swift
@@ -86,6 +86,18 @@ extension KeyHandler {
                   tooltipParameterRef[1] = compositor.readings[compositorCursorIndex]
                 }
             }
+            /// 注音轉拼音
+            for (i, _) in tooltipParameterRef.enumerated() {
+              if tooltipParameterRef[i].isEmpty { continue }
+              if tooltipParameterRef[i].contains("_") { continue }
+              if mgrPrefs.showHanyuPinyinInCompositionBuffer {  // 恢復陰平標記->注音轉拼音->轉教科書式標調
+                tooltipParameterRef[i] = Tekkon.restoreToneOneInZhuyinKey(target: tooltipParameterRef[i])
+                tooltipParameterRef[i] = Tekkon.cnvPhonaToHanyuPinyin(target: tooltipParameterRef[i])
+                tooltipParameterRef[i] = Tekkon.cnvHanyuPinyinToTextbookStyle(target: tooltipParameterRef[i])
+              } else {
+                tooltipParameterRef[i] = Tekkon.cnvZhuyinChainToTextbookReading(target: tooltipParameterRef[i])
+              }
+            }
           }
         }
       }
@@ -364,7 +376,7 @@ extension KeyHandler {
 
     var composingBuffer = currentReadings.joined(separator: "-")
     if mgrPrefs.inlineDumpPinyinInLieuOfZhuyin {
-      composingBuffer = restoreToneOneInZhuyinKey(target: composingBuffer)  // 恢復陰平標記
+      composingBuffer = Tekkon.restoreToneOneInZhuyinKey(target: composingBuffer)  // 恢復陰平標記
       composingBuffer = Tekkon.cnvPhonaToHanyuPinyin(target: composingBuffer)  // 注音轉拼音
     }
 
@@ -398,12 +410,12 @@ extension KeyHandler {
       if let node = theAnchor.node {
         var key = node.key
         if mgrPrefs.inlineDumpPinyinInLieuOfZhuyin {
-          key = restoreToneOneInZhuyinKey(target: key)  // 恢復陰平標記
+          key = Tekkon.restoreToneOneInZhuyinKey(target: key)  // 恢復陰平標記
           key = Tekkon.cnvPhonaToHanyuPinyin(target: key)  // 注音轉拼音
           key = Tekkon.cnvHanyuPinyinToTextbookStyle(target: key)  // 轉教科書式標調
           key = key.replacingOccurrences(of: "-", with: " ")
         } else {
-          key = cnvZhuyinKeyToTextbookReading(target: key, newSeparator: " ")
+          key = Tekkon.cnvZhuyinChainToTextbookReading(target: key, newSeparator: " ")
         }
 
         let value = node.currentKeyValue.value

From 331942c0b45a05661d6cde76c720f317b74c4e82 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Sun, 10 Jul 2022 09:17:08 +0800
Subject: [PATCH 06/20] InputState // Show readings when in-place marking
 phrases.

---
 .../ControllerModules/InputState.swift        | 31 ++++++++++++++++---
 .../Resources/Base.lproj/Localizable.strings  |  2 +-
 Source/Resources/en.lproj/Localizable.strings |  2 +-
 Source/Resources/ja.lproj/Localizable.strings |  2 +-
 .../zh-Hans.lproj/Localizable.strings         |  2 +-
 .../zh-Hant.lproj/Localizable.strings         |  2 +-
 Source/UI/PrefUI/suiPrefPaneGeneral.swift     |  2 +-
 .../WindowNIBs/Base.lproj/frmPrefWindow.xib   |  2 +-
 .../WindowNIBs/en.lproj/frmPrefWindow.strings |  2 +-
 .../WindowNIBs/ja.lproj/frmPrefWindow.strings |  2 +-
 .../zh-Hans.lproj/frmPrefWindow.strings       |  2 +-
 .../zh-Hant.lproj/frmPrefWindow.strings       |  2 +-
 12 files changed, 37 insertions(+), 16 deletions(-)

diff --git a/Source/Modules/ControllerModules/InputState.swift b/Source/Modules/ControllerModules/InputState.swift
index 4587c486..bfe0cab9 100644
--- a/Source/Modules/ControllerModules/InputState.swift
+++ b/Source/Modules/ControllerModules/InputState.swift
@@ -228,6 +228,27 @@ enum InputState {
       return lowerBoundLiteral..<upperBoundLiteral
     }
 
+    var literalReadingThread: String {
+      var arrOutput = [String]()
+      for neta in readings[literalMarkedRange] {
+        var neta = neta
+        if neta.isEmpty { continue }
+        if neta.contains("_") {
+          arrOutput.append("??")
+          continue
+        }
+        if mgrPrefs.showHanyuPinyinInCompositionBuffer {  // 恢復陰平標記->注音轉拼音->轉教科書式標調
+          neta = Tekkon.restoreToneOneInZhuyinKey(target: neta)
+          neta = Tekkon.cnvPhonaToHanyuPinyin(target: neta)
+          neta = Tekkon.cnvHanyuPinyinToTextbookStyle(target: neta)
+        } else {
+          neta = Tekkon.cnvZhuyinChainToTextbookReading(target: neta)
+        }
+        arrOutput.append(neta)
+      }
+      return arrOutput.joined(separator: " ")
+    }
+
     private var deleteTargetExists = false
     var tooltip: String {
       if composingBuffer.count != readings.count {
@@ -252,15 +273,14 @@ enum InputState {
         return String(
           format: NSLocalizedString(
             "\"%@\" length must ≥ 2 for a user phrase.", comment: ""
-          ), text
+          ) + "\n//  " + literalReadingThread, text
         )
       } else if literalMarkedRange.count > allowedMarkRange.upperBound {
         ctlInputMethod.tooltipController.setColor(state: .denialOverflow)
         return String(
           format: NSLocalizedString(
             "\"%@\" length should ≤ %d for a user phrase.", comment: ""
-          ),
-          text, allowedMarkRange.upperBound
+          ) + "\n//  " + literalReadingThread, text, allowedMarkRange.upperBound
         )
       }
 
@@ -275,12 +295,13 @@ enum InputState {
         return String(
           format: NSLocalizedString(
             "\"%@\" already exists: ENTER to boost, \n SHIFT+CMD+ENTER to exclude.", comment: ""
-          ), text
+          ) + "\n//  " + literalReadingThread, text
         )
       }
       ctlInputMethod.tooltipController.resetColor()
       return String(
-        format: NSLocalizedString("\"%@\" selected. ENTER to add user phrase.", comment: ""),
+        format: NSLocalizedString("\"%@\" selected. ENTER to add user phrase.", comment: "") + "\n//  "
+          + literalReadingThread,
         text
       )
     }
diff --git a/Source/Resources/Base.lproj/Localizable.strings b/Source/Resources/Base.lproj/Localizable.strings
index 261aa368..c4faf713 100644
--- a/Source/Resources/Base.lproj/Localizable.strings
+++ b/Source/Resources/Base.lproj/Localizable.strings
@@ -146,7 +146,7 @@
 "Push the cursor in front of the phrase after selection" = "Push the cursor in front of the phrase after selection";
 "Secondary Pinyin with Numeral Intonation" = "Secondary Pinyin with Numeral Intonation";
 "Selection Keys:" = "Selection Keys:";
-"Show Hanyu-Pinyin in the inline composition buffer" = "Show Hanyu-Pinyin in the inline composition buffer";
+"Show Hanyu-Pinyin in the inline composition buffer & tooltip" = "Show Hanyu-Pinyin in the inline composition buffer & tooltip";
 "Show page buttons in candidate window" = "Show page buttons in candidate window";
 "Simplified Chinese" = "Simplified Chinese";
 "Space & ESC Key:" = "Space & ESC Key:";
diff --git a/Source/Resources/en.lproj/Localizable.strings b/Source/Resources/en.lproj/Localizable.strings
index 261aa368..c4faf713 100644
--- a/Source/Resources/en.lproj/Localizable.strings
+++ b/Source/Resources/en.lproj/Localizable.strings
@@ -146,7 +146,7 @@
 "Push the cursor in front of the phrase after selection" = "Push the cursor in front of the phrase after selection";
 "Secondary Pinyin with Numeral Intonation" = "Secondary Pinyin with Numeral Intonation";
 "Selection Keys:" = "Selection Keys:";
-"Show Hanyu-Pinyin in the inline composition buffer" = "Show Hanyu-Pinyin in the inline composition buffer";
+"Show Hanyu-Pinyin in the inline composition buffer & tooltip" = "Show Hanyu-Pinyin in the inline composition buffer & tooltip";
 "Show page buttons in candidate window" = "Show page buttons in candidate window";
 "Simplified Chinese" = "Simplified Chinese";
 "Space & ESC Key:" = "Space & ESC Key:";
diff --git a/Source/Resources/ja.lproj/Localizable.strings b/Source/Resources/ja.lproj/Localizable.strings
index 057cc480..79a8751b 100644
--- a/Source/Resources/ja.lproj/Localizable.strings
+++ b/Source/Resources/ja.lproj/Localizable.strings
@@ -146,7 +146,7 @@
 "Push the cursor in front of the phrase after selection" = "候補選択の直後、すぐカーソルを単語の向こうに推し進める";
 "Secondary Pinyin with Numeral Intonation" = "国音二式 (ローマ字+数字音調)";
 "Selection Keys:" = "言選り用キー:";
-"Show Hanyu-Pinyin in the inline composition buffer" = "弁音合併入力（入力緩衝列で代わりに漢語弁音の音読み）";
+"Show Hanyu-Pinyin in the inline composition buffer & tooltip" = "弁音合併入力（入力緩衝列とヒントで音読みを漢語弁音に）";
 "Show page buttons in candidate window" = "入力候補陳列の側にページボタンを表示";
 "Simplified Chinese" = "簡体中国語";
 "Space & ESC Key:" = "ESC と Space:";
diff --git a/Source/Resources/zh-Hans.lproj/Localizable.strings b/Source/Resources/zh-Hans.lproj/Localizable.strings
index 81e9a423..8cb3ee1f 100644
--- a/Source/Resources/zh-Hans.lproj/Localizable.strings
+++ b/Source/Resources/zh-Hans.lproj/Localizable.strings
@@ -147,7 +147,7 @@
 "Push the cursor in front of the phrase after selection" = "在选字后将游标置于该字词的前方";
 "Secondary Pinyin with Numeral Intonation" = "国音二式+数字标调";
 "Selection Keys:" = "选字键:";
-"Show Hanyu-Pinyin in the inline composition buffer" = "拼音并击模式（组字区内看到的是汉语拼音）";
+"Show Hanyu-Pinyin in the inline composition buffer & tooltip" = "拼音并击（组字区与工具提示内显示汉语拼音）";
 "Show page buttons in candidate window" = "在选字窗内显示翻页按钮";
 "Simplified Chinese" = "简体中文";
 "Space & ESC Key:" = "ESC 与空格键:";
diff --git a/Source/Resources/zh-Hant.lproj/Localizable.strings b/Source/Resources/zh-Hant.lproj/Localizable.strings
index b4c27069..2f13703c 100644
--- a/Source/Resources/zh-Hant.lproj/Localizable.strings
+++ b/Source/Resources/zh-Hant.lproj/Localizable.strings
@@ -146,7 +146,7 @@
 "Push the cursor in front of the phrase after selection" = "在選字後將游標置於該字詞的前方";
 "Secondary Pinyin with Numeral Intonation" = "國音二式+數字標調";
 "Selection Keys:" = "選字鍵:";
-"Show Hanyu-Pinyin in the inline composition buffer" = "拼音並擊模式（組字區內看到的是漢語拼音）";
+"Show Hanyu-Pinyin in the inline composition buffer & tooltip" = "拼音並擊（組字區與工具提示內顯示漢語拼音）";
 "Show page buttons in candidate window" = "在選字窗內顯示翻頁按鈕";
 "Simplified Chinese" = "簡體中文";
 "Space & ESC Key:" = "ESC 與空格鍵:";
diff --git a/Source/UI/PrefUI/suiPrefPaneGeneral.swift b/Source/UI/PrefUI/suiPrefPaneGeneral.swift
index 1551f0e9..093b9ba9 100644
--- a/Source/UI/PrefUI/suiPrefPaneGeneral.swift
+++ b/Source/UI/PrefUI/suiPrefPaneGeneral.swift
@@ -158,7 +158,7 @@ struct suiPrefPaneGeneral: View {
           }
         }
         Toggle(
-          LocalizedStringKey("Show Hanyu-Pinyin in the inline composition buffer"),
+          LocalizedStringKey("Show Hanyu-Pinyin in the inline composition buffer & tooltip"),
           isOn: $selShowHanyuPinyinInCompositionBuffer
         ).onChange(of: selShowHanyuPinyinInCompositionBuffer) { value in
           mgrPrefs.showHanyuPinyinInCompositionBuffer = value
diff --git a/Source/WindowNIBs/Base.lproj/frmPrefWindow.xib b/Source/WindowNIBs/Base.lproj/frmPrefWindow.xib
index 7dc12991..ae6afabc 100644
--- a/Source/WindowNIBs/Base.lproj/frmPrefWindow.xib
+++ b/Source/WindowNIBs/Base.lproj/frmPrefWindow.xib
@@ -269,7 +269,7 @@
                                                     </button>
                                                     <button verticalHuggingPriority="750" translatesAutoresizingMaskIntoConstraints="NO" id="vwf-Kq-s8M" userLabel="chkShowHanyuPinyinInCompositionBuffer">
                                                         <rect key="frame" x="19" y="42.5" width="406" height="16"/>
-                                                        <buttonCell key="cell" type="check" title="Show Hanyu-Pinyin in the inline composition buffer" bezelStyle="regularSquare" imagePosition="left" controlSize="small" inset="2" id="wFR-zX-M8H">
+                                                        <buttonCell key="cell" type="check" title="Show Hanyu-Pinyin in the inline composition buffer &amp; tooltip" bezelStyle="regularSquare" imagePosition="left" controlSize="small" inset="2" id="wFR-zX-M8H">
                                                             <behavior key="behavior" changeContents="YES" doesNotDimImage="YES" lightByContents="YES"/>
                                                             <font key="font" metaFont="cellTitle"/>
                                                         </buttonCell>
diff --git a/Source/WindowNIBs/en.lproj/frmPrefWindow.strings b/Source/WindowNIBs/en.lproj/frmPrefWindow.strings
index f586aeec..ef10205d 100644
--- a/Source/WindowNIBs/en.lproj/frmPrefWindow.strings
+++ b/Source/WindowNIBs/en.lproj/frmPrefWindow.strings
@@ -74,7 +74,7 @@
 "ueU-Rz-a1C.title" = "Choose the behavior of (Shift+)Tab key in the candidate window.";
 "Uyz-xL-TVN.title" = "Output Settings";
 "W24-T4-cg0.title" = "Enable CNS11643 Support (2022-06-15)";
-"wFR-zX-M8H.title" = "Show Hanyu-Pinyin in the inline composition buffer";
+"wFR-zX-M8H.title" = "Show Hanyu-Pinyin in the inline composition buffer & tooltip";
 "wN3-k3-b2a.title" = "Choose your desired user data folder path. Will be omitted if invalid.";
 "wQ9-px-b07.title" = "Apple Dynamic Bopomofo Basic Keyboard Layouts (Dachen & Eten Traditional) must match the Dachen parser in order to be functional.";
 "Wvt-HE-LOv.title" = "Keyboard Layout";
diff --git a/Source/WindowNIBs/ja.lproj/frmPrefWindow.strings b/Source/WindowNIBs/ja.lproj/frmPrefWindow.strings
index af59bae2..0c36a8da 100644
--- a/Source/WindowNIBs/ja.lproj/frmPrefWindow.strings
+++ b/Source/WindowNIBs/ja.lproj/frmPrefWindow.strings
@@ -74,7 +74,7 @@
 "ueU-Rz-a1C.title" = "入力候補陳列での (Shift+)Tab キーの輪番切替対象をご指定ください。";
 "Uyz-xL-TVN.title" = "出力設定";
 "W24-T4-cg0.title" = "全字庫モード // 入力可能の漢字数倍増 (2022-06-15)";
-"wFR-zX-M8H.title" = "弁音合併入力（入力緩衝列で代わりに漢語弁音の音読み）";
+"wFR-zX-M8H.title" = "弁音合併入力（入力緩衝列とヒントで音読みを漢語弁音に）";
 "wN3-k3-b2a.title" = "欲しがるユーザー辞書保存先をご指定ください。無効の保存先設定は効かぬ。";
 "wQ9-px-b07.title" = "Apple 動態注音キーボード (大千と倚天伝統) を使うには、共通語分析器の注音配列を大千と設定すべきである。";
 "Wvt-HE-LOv.title" = "キーボード";
diff --git a/Source/WindowNIBs/zh-Hans.lproj/frmPrefWindow.strings b/Source/WindowNIBs/zh-Hans.lproj/frmPrefWindow.strings
index 06bb9035..18d49824 100644
--- a/Source/WindowNIBs/zh-Hans.lproj/frmPrefWindow.strings
+++ b/Source/WindowNIBs/zh-Hans.lproj/frmPrefWindow.strings
@@ -74,7 +74,7 @@
 "ueU-Rz-a1C.title" = "指定 (Shift+)Tab 热键在选字窗内的轮替操作对象。";
 "Uyz-xL-TVN.title" = "输出设定";
 "W24-T4-cg0.title" = "启用 CNS11643 全字库支援 (2022-06-15)";
-"wFR-zX-M8H.title" = "拼音并击模式（组字区内看到的是汉语拼音）";
+"wFR-zX-M8H.title" = "拼音并击（组字区与工具提示内显示汉语拼音）";
 "wN3-k3-b2a.title" = "请在此指定您想指定的使用者语汇档案目录。无效值会被忽略。";
 "wQ9-px-b07.title" = "Apple 动态注音键盘布局（大千与倚天）要求普通话/国音分析器的注音排列得配置为大千排列。";
 "Wvt-HE-LOv.title" = "键盘布局";
diff --git a/Source/WindowNIBs/zh-Hant.lproj/frmPrefWindow.strings b/Source/WindowNIBs/zh-Hant.lproj/frmPrefWindow.strings
index acdb1ccc..0bedda26 100644
--- a/Source/WindowNIBs/zh-Hant.lproj/frmPrefWindow.strings
+++ b/Source/WindowNIBs/zh-Hant.lproj/frmPrefWindow.strings
@@ -74,7 +74,7 @@
 "ueU-Rz-a1C.title" = "指定 (Shift+)Tab 熱鍵在選字窗內的輪替操作對象。";
 "Uyz-xL-TVN.title" = "輸出設定";
 "W24-T4-cg0.title" = "啟用 CNS11643 全字庫支援 (2022-06-15)";
-"wFR-zX-M8H.title" = "拼音並擊模式（組字區內看到的是漢語拼音）";
+"wFR-zX-M8H.title" = "拼音並擊（組字區與工具提示內顯示漢語拼音）";
 "wN3-k3-b2a.title" = "請在此指定您想指定的使用者語彙檔案目錄。無效值會被忽略。";
 "wQ9-px-b07.title" = "Apple 動態注音鍵盤佈局（大千與倚天）要求普通話/國音分析器的注音排列得配置為大千排列。";
 "Wvt-HE-LOv.title" = "鍵盤佈局";

From 3db04310a2efb011cde15a5c1f2348790d88f794 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Mon, 11 Jul 2022 18:53:54 +0800
Subject: [PATCH 07/20] FAQ // Typo fix.

---
 FAQ.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/FAQ.md b/FAQ.md
index 5844813b..8bf84952 100644
--- a/FAQ.md
+++ b/FAQ.md
@@ -55,7 +55,7 @@ xattr -dr com.apple.quarantine ~/Downloads/vChewingInstaller.app
 
 ### 5. 選字窗位置不對欸。
 
-這往往是您在打字時使用的應用程式，並沒有正確地將正確的游標位置告知 IMK、導致輸入法無法得知相關的資訊使然。您在某個應用程式中打字，輸入游標的位置到底在哪裡，一開始只有那個應用程式知道，然後，那個應用程式必須把正確的位置告知輸入法，輸入法才知道應該在什麼位置，顯示像是選字窗這樣的使用者介面元件。某些應用完全沒有認真處理與 macOS 的 IMK 框架有關的內容，所以就通知了輸入法一個奇怪的位置資訊，有時候座標根本就在螢幕大小之外。威注音在使用的 Voltaire MK3 與上游使用的 Voltaire MK2 的判斷方法相同：如果某個應用程式將奇怪的位置（不在任何一個螢幕的範圍內）告知給 IMK，那麼輸入法就會想辦法把選字窗擺在螢幕範圍內最接近的位置。比方說：如果是 y 軸超過了螢幕尺寸，就會改在螢幕的最上方顯示。
+這往往是您在敲字時使用的應用程式，並沒有正確地將正確的游標位置告知 IMK、導致輸入法無法得知相關的資訊使然。您在某個應用程式中敲字，輸入游標的位置到底在哪裡，一開始只有那個應用程式知道，然後，那個應用程式必須把正確的位置告知輸入法，輸入法才知道應該在什麼位置，顯示像是選字窗這樣的使用者介面元件。某些應用完全沒有認真處理與 macOS 的 IMK 框架有關的內容，所以就通知了輸入法一個奇怪的位置資訊，有時候座標根本就在螢幕大小之外。威注音在使用的 Voltaire MK3 與上游使用的 Voltaire MK2 的判斷方法相同：如果某個應用程式將奇怪的位置（不在任何一個螢幕的範圍內）告知給 IMK，那麼輸入法就會想辦法把選字窗擺在螢幕範圍內最接近的位置。比方說：如果是 y 軸超過了螢幕尺寸，就會改在螢幕的最上方顯示。
 
 ### 6. 自訂使用者語彙資料該怎麼管理？
 

From 4ff9051c17c6b011da44e0f90ebe70c12046e438 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Sat, 9 Jul 2022 10:15:12 +0800
Subject: [PATCH 08/20] Megrez // v1.2.8 update + UOM punctuation conditioning
 fix.

---
 .../ControllerModules/KeyHandler_Core.swift   |  88 +++---
 .../ControllerModules/KeyHandler_States.swift |  49 ++--
 .../LangModelRelated/LMInstantiator.swift     |   6 +-
 .../SubLMs/lmUserOverride.swift               |  18 +-
 .../LanguageParsers/Megrez/1_Compositor.swift | 253 +++++++++---------
 .../LanguageParsers/Megrez/2_Grid.swift       | 215 ++++++++-------
 .../LanguageParsers/Megrez/3_NodeAnchor.swift |  39 ++-
 .../LanguageParsers/Megrez/3_Span.swift       |  37 ++-
 .../LanguageParsers/Megrez/4_Node.swift       | 150 ++++++-----
 .../Megrez/5_LanguageModel.swift              |   4 +-
 .../LanguageParsers/Megrez/6_Bigram.swift     |   4 +-
 .../LanguageParsers/Megrez/6_Unigram.swift    |   4 +-
 .../Megrez/7_KeyValuePaired.swift             |   2 +-
 13 files changed, 450 insertions(+), 419 deletions(-)

diff --git a/Source/Modules/ControllerModules/KeyHandler_Core.swift b/Source/Modules/ControllerModules/KeyHandler_Core.swift
index 28c1d288..79123ef2 100644
--- a/Source/Modules/ControllerModules/KeyHandler_Core.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_Core.swift
@@ -56,7 +56,7 @@ class KeyHandler {
   var compositor: Megrez.Compositor  // 組字器
   var currentLM: vChewing.LMInstantiator = .init()  // 當前主語言模組
   var currentUOM: vChewing.LMUserOverride = .init()  // 當前半衰記憶模組
-  var walkedAnchors: [Megrez.NodeAnchor] = []  // 用以記錄爬過的節錨的陣列
+  var walkedAnchors: [Megrez.NodeAnchor] { compositor.walkedAnchors }  // 用以記錄爬過的節錨的陣列
   /// 委任物件 (ctlInputMethod)，以便呼叫其中的函式。
   var delegate: KeyHandlerDelegate?
 
@@ -95,7 +95,6 @@ class KeyHandler {
   func clear() {
     composer.clear()
     compositor.clear()
-    walkedAnchors.removeAll()
   }
 
   // MARK: - Functions dealing with Megrez.
@@ -103,7 +102,7 @@ class KeyHandler {
   /// 實際上要拿給 Megrez 使用的的滑鼠游標位址，以方便在組字器最開頭或者最末尾的時候始終能抓取候選字節點陣列。
   ///
   /// 威注音對游標前置與游標後置模式採取的候選字節點陣列抓取方法是分離的，且不使用 Node Crossing。
-  var actualCandidateCursorIndex: Int {
+  var actualCandidateCursor: Int {
     mgrPrefs.useRearCursorMode ? min(compositorCursorIndex, compositorLength - 1) : max(compositorCursorIndex, 1)
   }
 
@@ -113,11 +112,11 @@ class KeyHandler {
   ///
   /// 該函式的爬取順序是從頭到尾。
   func walk() {
-    walkedAnchors = compositor.walk()
+    compositor.walk()
 
     // 在偵錯模式開啟時，將 GraphViz 資料寫入至指定位置。
     if mgrPrefs.isDebugModeEnabled {
-      let result = compositor.grid.dumpDOT
+      let result = compositor.dumpDOT
       do {
         try result.write(
           toFile: "/private/var/tmp/vChewing-visualization.dot",
@@ -137,12 +136,10 @@ class KeyHandler {
   /// 估算對象範圍。用比較形象且生動卻有點噁心的解釋的話，蒼蠅一邊吃一邊屙。
   var commitOverflownCompositionAndWalk: String {
     var textToCommit = ""
-    if compositor.grid.width > mgrPrefs.composingBufferSize, !walkedAnchors.isEmpty {
+    if compositor.width > mgrPrefs.composingBufferSize, !walkedAnchors.isEmpty {
       let anchor: Megrez.NodeAnchor = walkedAnchors[0]
-      if let theNode = anchor.node {
-        textToCommit = theNode.currentKeyValue.value
-      }
-      compositor.removeHeadReadings(count: anchor.spanningLength)
+      textToCommit = anchor.node.currentPair.value
+      compositor.removeHeadReadings(count: anchor.spanLength)
     }
     walk()
     return textToCommit
@@ -166,26 +163,22 @@ class KeyHandler {
   ///   - value: 給定之候選字字串。
   ///   - respectCursorPushing: 若該選項為 true，則會在選字之後始終將游標推送至選字厚的節錨的前方。
   func fixNode(value: String, respectCursorPushing: Bool = true) {
-    let adjustedIndex = max(0, min(actualCandidateCursorIndex + (mgrPrefs.useRearCursorMode ? 1 : 0), compositorLength))
+    let adjustedCursor = max(0, min(actualCandidateCursor + (mgrPrefs.useRearCursorMode ? 1 : 0), compositorLength))
     // 開始讓半衰模組觀察目前的狀況。
-    let selectedNode: Megrez.NodeAnchor = compositor.grid.fixNodeSelectedCandidate(
-      location: adjustedIndex, value: value
-    )
+    let selectedNode: Megrez.NodeAnchor = compositor.fixNodeSelectedCandidate(value, at: adjustedCursor)
     // 不要針對逐字選字模式啟用臨時半衰記憶模型。
     if !mgrPrefs.useSCPCTypingMode {
       var addToUserOverrideModel = true
       // 所有讀音數與字符數不匹配的情況均不得塞入半衰記憶模組。
-      if selectedNode.spanningLength != value.count {
+      if selectedNode.spanLength != value.count {
         IME.prtDebugIntel("UOM: SpanningLength != value.count, dismissing.")
         addToUserOverrideModel = false
       }
       if addToUserOverrideModel {
-        if let theNode = selectedNode.node {
-          // 威注音的 SymbolLM 的 Score 是 -12，符合該條件的內容不得塞入半衰記憶模組。
-          if theNode.scoreFor(candidate: value) <= -12 {
-            IME.prtDebugIntel("UOM: Score <= -12, dismissing.")
-            addToUserOverrideModel = false
-          }
+        // 威注音的 SymbolLM 的 Score 是 -12，符合該條件的內容不得塞入半衰記憶模組。
+        if selectedNode.node.scoreFor(candidate: value) <= -12 {
+          IME.prtDebugIntel("UOM: Score <= -12, dismissing.")
+          addToUserOverrideModel = false
         }
       }
       if addToUserOverrideModel {
@@ -193,7 +186,7 @@ class KeyHandler {
         // 令半衰記憶模組觀測給定的三元圖。
         // 這個過程會讓半衰引擎根據當前上下文生成三元圖索引鍵。
         currentUOM.observe(
-          walkedAnchors: walkedAnchors, cursorIndex: adjustedIndex, candidate: value,
+          walkedAnchors: walkedAnchors, cursorIndex: adjustedCursor, candidate: value,
           timestamp: NSDate().timeIntervalSince1970
         )
       }
@@ -206,8 +199,8 @@ class KeyHandler {
     if mgrPrefs.moveCursorAfterSelectingCandidate, respectCursorPushing {
       var nextPosition = 0
       for theAnchor in walkedAnchors {
-        if nextPosition >= adjustedIndex { break }
-        nextPosition += theAnchor.spanningLength
+        if nextPosition >= adjustedCursor { break }
+        nextPosition += theAnchor.spanLength
       }
       if nextPosition <= compositorLength {
         compositorCursorIndex = nextPosition
@@ -217,20 +210,17 @@ class KeyHandler {
 
   /// 組字器內超出最大動態爬軌範圍的節錨都會被自動標記為「已經手動選字過」，減少爬軌運算負擔。
   func markNodesFixedIfNecessary() {
-    let width = compositor.grid.width
+    let width = compositor.width
     if width <= kMaxComposingBufferNeedsToWalkSize {
       return
     }
     var index = 0
     for anchor in walkedAnchors {
-      guard let node = anchor.node else { break }
       if index >= width - kMaxComposingBufferNeedsToWalkSize { break }
-      if node.score < node.kSelectedCandidateScore {
-        compositor.grid.fixNodeSelectedCandidate(
-          location: index + anchor.spanningLength, value: node.currentKeyValue.value
-        )
+      if anchor.node.score < Megrez.Node.kSelectedCandidateScore {
+        compositor.fixNodeSelectedCandidate(anchor.node.currentPair.value, at: index + anchor.spanLength)
       }
-      index += anchor.spanningLength
+      index += anchor.spanLength
     }
   }
 
@@ -248,14 +238,11 @@ class KeyHandler {
     arrAnchors = arrAnchors.stableSort { $0.keyLength > $1.keyLength }
 
     // 將節錨內的候選字詞資料拓印到輸出陣列內。
-    for currentNodeAnchor in arrAnchors {
-      guard let currentNode = currentNodeAnchor.node else { continue }
-      for currentCandidate in currentNode.candidates {
-        // 選字窗的內容的康熙轉換 / JIS 轉換不能放在這裡處理，會影響選字有效性。
-        // 選字的原理是拿著具體的候選字詞的字串去當前的節錨下找出對應的候選字詞（Ｘ元圖）。
-        // 一旦在這裡轉換了，節錨內的某些元圖就無法被選中。
-        arrCandidates.append(currentCandidate.value)
-      }
+    for currentCandidate in arrAnchors.map(\.node.candidates).joined() {
+      // 選字窗的內容的康熙轉換 / JIS 轉換不能放在這裡處理，會影響選字有效性。
+      // 選字的原理是拿著具體的候選字詞的字串去當前的節錨下找出對應的候選字詞（Ｘ元圖）。
+      // 一旦在這裡轉換了，節錨內的某些元圖就無法被選中。
+      arrCandidates.append(currentCandidate.value)
     }
     // 決定是否根據半衰記憶模組的建議來調整候選字詞的順序。
     if !mgrPrefs.fetchSuggestionsFromUserOverrideModel || mgrPrefs.useSCPCTypingMode || fixOrder {
@@ -291,8 +278,8 @@ class KeyHandler {
     if !overrideValue.isEmpty {
       IME.prtDebugIntel(
         "UOM: Suggestion retrieved, overriding the node score of the selected candidate.")
-      compositor.grid.overrideNodeScoreForSelectedCandidate(
-        location: min(actualCandidateCursorIndex + (mgrPrefs.useRearCursorMode ? 1 : 0), compositorLength),
+      compositor.overrideNodeScoreForSelectedCandidate(
+        location: min(actualCandidateCursor + (mgrPrefs.useRearCursorMode ? 1 : 0), compositorLength),
         value: overrideValue,
         overridingScore: findHighestScore(nodeAnchors: rawAnchorsOfNodes, epsilon: kEpsilon)
       )
@@ -307,7 +294,7 @@ class KeyHandler {
   ///   - epsilon: 半衰模組的衰減指數。
   /// - Returns: 尋獲的最高權重數值。
   func findHighestScore(nodeAnchors: [Megrez.NodeAnchor], epsilon: Double) -> Double {
-    return nodeAnchors.compactMap(\.node?.highestUnigramScore).max() ?? 0 + epsilon
+    return nodeAnchors.map(\.node.highestUnigramScore).max() ?? 0 + epsilon
   }
 
   // MARK: - Extracted methods and functions (Tekkon).
@@ -363,8 +350,8 @@ class KeyHandler {
     /// 警告：不要對游標前置風格使用 nodesCrossing，否則會導致游標行為與 macOS 內建注音輸入法不一致。
     /// 微軟新注音輸入法的游標後置風格也是不允許 nodeCrossing 的。
     mgrPrefs.useRearCursorMode
-      ? compositor.grid.nodesBeginningAt(location: actualCandidateCursorIndex)
-      : compositor.grid.nodesEndingAt(location: actualCandidateCursorIndex)
+      ? compositor.nodesBeginningAt(location: actualCandidateCursor)
+      : compositor.nodesEndingAt(location: actualCandidateCursor)
   }
 
   /// 將輸入法偏好設定同步至語言模組內。
@@ -390,7 +377,7 @@ class KeyHandler {
 
   /// 在組字器的給定游標位置內插入讀音。
   func insertToCompositorAtCursor(reading: String) {
-    compositor.insertReadingAtCursor(reading: reading)
+    compositor.insertReading(reading)
   }
 
   /// 組字器的游標位置。
@@ -408,28 +395,27 @@ class KeyHandler {
   ///
   /// 在威注音的術語體系當中，「與文字輸入方向相反的方向」為向後（Rear）。
   func deleteCompositorReadingAtTheRearOfCursor() {
-    compositor.deleteReadingAtTheRearOfCursor()
+    compositor.dropReading(direction: .rear)
   }
 
   /// 在組字器內，朝著往文字輸入方向、砍掉一個與游標相鄰的讀音。
   ///
   /// 在威注音的術語體系當中，「文字輸入方向」為向前（Front）。
   func deleteCompositorReadingToTheFrontOfCursor() {
-    compositor.deleteReadingToTheFrontOfCursor()
+    compositor.dropReading(direction: .front)
   }
 
   /// 獲取指定游標位置的鍵值長度。
   /// - Returns: 指定游標位置的鍵值長度。
   var keyLengthAtCurrentIndex: Int {
-    guard let node = walkedAnchors[compositorCursorIndex].node else { return 0 }
-    return node.key.split(separator: "-").count
+    walkedAnchors[compositorCursorIndex].node.key.split(separator: "-").count
   }
 
   var nextPhrasePosition: Int {
     var nextPosition = 0
     for theAnchor in walkedAnchors {
-      if nextPosition > actualCandidateCursorIndex { break }
-      nextPosition += theAnchor.spanningLength
+      if nextPosition > actualCandidateCursor { break }
+      nextPosition += theAnchor.spanLength
     }
     return min(nextPosition, compositorLength)
   }
diff --git a/Source/Modules/ControllerModules/KeyHandler_States.swift b/Source/Modules/ControllerModules/KeyHandler_States.swift
index affc3bc3..ae662528 100644
--- a/Source/Modules/ControllerModules/KeyHandler_States.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_States.swift
@@ -45,15 +45,15 @@ extension KeyHandler {
     /// 所以在這裡必須做糾偏處理。因為在用 Swift，所以可以用「.utf16」取代「NSString.length()」。
     /// 這樣就可以免除不必要的類型轉換。
     for theAnchor in walkedAnchors {
-      guard let theNode = theAnchor.node else { continue }
-      let strNodeValue = theNode.currentKeyValue.value
+      let theNode = theAnchor.node
+      let strNodeValue = theNode.currentPair.value
       composingBuffer += strNodeValue
       let arrSplit: [String] = Array(strNodeValue).map { String($0) }
       let codepointCount = arrSplit.count
       /// 藉下述步驟重新將「可見游標位置」對齊至「組字器內的游標所在的讀音位置」。
       /// 每個節錨（NodeAnchor）都有自身的幅位長度（spanningLength），可以用來
       /// 累加、以此為依據，來校正「可見游標位置」。
-      let spanningLength: Int = theAnchor.spanningLength
+      let spanningLength: Int = theAnchor.spanLength
       if readingCursorIndex + spanningLength <= compositorCursorIndex {
         composedStringCursorIndex += strNodeValue.utf16.count
         readingCursorIndex += spanningLength
@@ -406,22 +406,20 @@ extension KeyHandler {
 
     var composed = ""
 
-    for theAnchor in walkedAnchors {
-      if let node = theAnchor.node {
-        var key = node.key
-        if mgrPrefs.inlineDumpPinyinInLieuOfZhuyin {
-          key = Tekkon.restoreToneOneInZhuyinKey(target: key)  // 恢復陰平標記
-          key = Tekkon.cnvPhonaToHanyuPinyin(target: key)  // 注音轉拼音
-          key = Tekkon.cnvHanyuPinyinToTextbookStyle(target: key)  // 轉教科書式標調
-          key = key.replacingOccurrences(of: "-", with: " ")
-        } else {
-          key = Tekkon.cnvZhuyinChainToTextbookReading(target: key, newSeparator: " ")
-        }
-
-        let value = node.currentKeyValue.value
-        // 不要給標點符號等特殊元素加注音
-        composed += key.contains("_") ? value : "<ruby>\(value)<rp>(</rp><rt>\(key)</rt><rp>)</rp></ruby>"
+    for node in walkedAnchors.map(\.node) {
+      var key = node.key
+      if mgrPrefs.inlineDumpPinyinInLieuOfZhuyin {
+        key = Tekkon.restoreToneOneInZhuyinKey(target: key)  // 恢復陰平標記
+        key = Tekkon.cnvPhonaToHanyuPinyin(target: key)  // 注音轉拼音
+        key = Tekkon.cnvHanyuPinyinToTextbookStyle(target: key)  // 轉教科書式標調
+        key = key.replacingOccurrences(of: "-", with: " ")
+      } else {
+        key = Tekkon.cnvZhuyinChainToTextbookReading(target: key, newSeparator: " ")
       }
+
+      let value = node.currentPair.value
+      // 不要給標點符號等特殊元素加注音
+      composed += key.contains("_") ? value : "<ruby>\(value)<rp>(</rp><rt>\(key)</rt><rp>)</rp></ruby>"
     }
 
     clear()
@@ -796,26 +794,21 @@ extension KeyHandler {
     var length = 0
     var currentAnchor = Megrez.NodeAnchor()
     let cursorIndex = min(
-      actualCandidateCursorIndex + (mgrPrefs.useRearCursorMode ? 1 : 0), compositorLength
+      actualCandidateCursor + (mgrPrefs.useRearCursorMode ? 1 : 0), compositorLength
     )
     for anchor in walkedAnchors {
-      length += anchor.spanningLength
+      length += anchor.spanLength
       if length >= cursorIndex {
         currentAnchor = anchor
         break
       }
     }
 
-    guard let currentNode = currentAnchor.node else {
-      IME.prtDebugIntel("4F2DEC2F")
-      errorCallback()
-      return true
-    }
-
-    let currentValue = currentNode.currentKeyValue.value
+    let currentNode = currentAnchor.node
+    let currentValue = currentNode.currentPair.value
 
     var currentIndex = 0
-    if currentNode.score < currentNode.kSelectedCandidateScore {
+    if currentNode.score < Megrez.Node.kSelectedCandidateScore {
       /// 只要是沒有被使用者手動選字過的（節錨下的）節點，
       /// 就從第一個候選字詞開始，這樣使用者在敲字時就會優先匹配
       /// 那些字詞長度不小於 2 的單元圖。換言之，如果使用者敲了兩個
diff --git a/Source/Modules/LangModelRelated/LMInstantiator.swift b/Source/Modules/LangModelRelated/LMInstantiator.swift
index a8f81404..d13705f4 100644
--- a/Source/Modules/LangModelRelated/LMInstantiator.swift
+++ b/Source/Modules/LangModelRelated/LMInstantiator.swift
@@ -28,7 +28,7 @@ import Foundation
 
 extension vChewing {
   /// 語言模組副本化模組（LMInstantiator，下稱「LMI」）自身為符合天權星組字引擎內
-  /// 的 LanguageModelProtocol 協定的模組、統籌且整理來自其它子模組的資料（包括使
+  /// 的 LangModelProtocol 協定的模組、統籌且整理來自其它子模組的資料（包括使
   /// 用者語彙、繪文字模組、語彙濾除表、原廠語言模組等）。
   ///
   /// LMI 型別為與輸入法按鍵調度模組直接溝通之唯一語言模組。當組字器開始根據給定的
@@ -44,7 +44,7 @@ extension vChewing {
   ///
   /// LMI 會根據需要分別載入原廠語言模組和其他個別的子語言模組。LMI 本身不會記錄這些
   /// 語言模組的相關資料的存放位置，僅藉由參數來讀取相關訊息。
-  public class LMInstantiator: LanguageModelProtocol {
+  public class LMInstantiator: LangModelProtocol {
     // 在函式內部用以記錄狀態的開關。
     public var isPhraseReplacementEnabled = false
     public var isCNSEnabled = false
@@ -256,7 +256,7 @@ extension vChewing {
       lmAssociates.hasValuesFor(key: key)
     }
 
-    /// 該函式不起作用，僅用來滿足 LanguageModelProtocol 協定的要求。
+    /// 該函式不起作用，僅用來滿足 LangModelProtocol 協定的要求。
     public func bigramsForKeys(precedingKey _: String, key _: String) -> [Megrez.Bigram] { .init() }
 
     // MARK: - 核心函式（對內）
diff --git a/Source/Modules/LangModelRelated/SubLMs/lmUserOverride.swift b/Source/Modules/LangModelRelated/SubLMs/lmUserOverride.swift
index 8d50fb04..c5f3b96a 100644
--- a/Source/Modules/LangModelRelated/SubLMs/lmUserOverride.swift
+++ b/Source/Modules/LangModelRelated/SubLMs/lmUserOverride.swift
@@ -130,13 +130,12 @@ extension vChewing {
     func convertKeyFrom(
       walkedAnchors: [Megrez.NodeAnchor], cursorIndex: Int, readingOnly: Bool = false
     ) -> String {
-      let arrEndingPunctuation = ["，", "。", "！", "？", "」", "』", "”", "’"]
       let whiteList = "你他妳她祢衪它牠再在"
       var arrNodes: [Megrez.NodeAnchor] = []
       var intLength = 0
       for theNodeAnchor in walkedAnchors {
         arrNodes.append(theNodeAnchor)
-        intLength += theNodeAnchor.spanningLength
+        intLength += theNodeAnchor.spanLength
         if intLength >= cursorIndex {
           break
         }
@@ -146,9 +145,8 @@ extension vChewing {
 
       arrNodes = Array(arrNodes.reversed())
 
-      guard let kvCurrent = arrNodes[0].node?.currentKeyValue,
-        !arrEndingPunctuation.contains(kvCurrent.value)
-      else {
+      let kvCurrent = arrNodes[0].node.currentPair
+      guard !kvCurrent.key.contains("_") else {
         return ""
       }
 
@@ -173,20 +171,18 @@ extension vChewing {
       }
 
       if arrNodes.count >= 2,
-        let kvPreviousThisOne = arrNodes[1].node?.currentKeyValue,
-        !arrEndingPunctuation.contains(kvPrevious.value),
+        !kvPrevious.key.contains("_"),
         kvPrevious.key.split(separator: "-").count == kvPrevious.value.count
       {
-        kvPrevious = kvPreviousThisOne
+        kvPrevious = arrNodes[1].node.currentPair
         readingStack = kvPrevious.key + readingStack
       }
 
       if arrNodes.count >= 3,
-        let kvAnteriorThisOne = arrNodes[2].node?.currentKeyValue,
-        !arrEndingPunctuation.contains(kvAnterior.value),
+        !kvAnterior.key.contains("_"),
         kvAnterior.key.split(separator: "-").count == kvAnterior.value.count
       {
-        kvAnterior = kvAnteriorThisOne
+        kvAnterior = arrNodes[2].node.currentPair
         readingStack = kvAnterior.key + readingStack
       }
 
diff --git a/Source/Modules/LanguageParsers/Megrez/1_Compositor.swift b/Source/Modules/LanguageParsers/Megrez/1_Compositor.swift
index 72a3284b..76a8f6f1 100644
--- a/Source/Modules/LanguageParsers/Megrez/1_Compositor.swift
+++ b/Source/Modules/LanguageParsers/Megrez/1_Compositor.swift
@@ -25,89 +25,106 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 extension Megrez {
   /// 組字器。
-  public class Compositor {
+  public class Compositor: Grid {
+    /// 文字輸入方向
+    public enum TypingDirection { case front, rear }
     /// 給被丟掉的節點路徑施加的負權重。
     private let kDroppedPathScore: Double = -999
     /// 該組字器的游標位置。
-    private var mutCursorIndex: Int = 0
+    public var cursor: Int = 0 { didSet { cursor = max(0, min(cursor, readings.count)) } }
     /// 該組字器的讀音陣列。
-    private var mutReadings: [String] = []
-    /// 該組字器的軌格。
-    private var mutGrid: Grid = .init()
+    private(set) var readings: [String] = []
     /// 該組字器所使用的語言模型。
-    private var mutLM: LanguageModelProtocol
+    private var langModel: LangModelProtocol
+    /// 允許查詢當前游標位置屬於第幾個幅位座標（從 0 開始算）。
+    private(set) var cursorRegionMap: [Int: Int] = .init()
+    private(set) var walkedAnchors: [Megrez.NodeAnchor] = []  // 用以記錄爬過的節錨的陣列
 
-    /// 公開：該組字器內可以允許的最大詞長。
-    public var maxBuildSpanLength: Int { mutGrid.maxBuildSpanLength }
     /// 公開：多字讀音鍵當中用以分割漢字讀音的記號，預設為空。
-    public var joinSeparator: String = ""
-    /// 公開：該組字器的游標位置。
-    public var cursorIndex: Int {
-      get { mutCursorIndex }
-      set { mutCursorIndex = (newValue < 0) ? 0 : min(newValue, mutReadings.count) }
-    }
+    public var joinSeparator: String = "-"
 
-    /// 公開：該組字器是否為空。
-    public var isEmpty: Bool { mutGrid.isEmpty }
-
-    /// 公開：該組字器的軌格（唯讀）。
-    public var grid: Grid { mutGrid }
     /// 公開：該組字器的長度，也就是內建漢字讀音的數量（唯讀）。
-    public var length: Int { mutReadings.count }
-    /// 公開：該組字器的讀音陣列（唯讀）。
-    public var readings: [String] { mutReadings }
+    public var length: Int { readings.count }
+
+    /// 按幅位來前後移動游標。
+    /// - Parameter direction: 移動方向
+    /// - Returns: 該操作是否順利完成。
+    @discardableResult public func jumpCursorBySpan(to direction: TypingDirection) -> Bool {
+      switch direction {
+        case .front:
+          if cursor == width { return false }
+        case .rear:
+          if cursor == 0 { return false }
+      }
+      guard let currentRegion = cursorRegionMap[cursor] else { return false }
+
+      let aRegionForward = max(currentRegion - 1, 0)
+      let currentRegionBorderRear: Int = walkedAnchors[0..<currentRegion].map(\.spanLength).reduce(0, +)
+      switch cursor {
+        case currentRegionBorderRear:
+          switch direction {
+            case .front:
+              cursor =
+                (currentRegion > walkedAnchors.count)
+                ? readings.count : walkedAnchors[0...currentRegion].map(\.spanLength).reduce(0, +)
+            case .rear:
+              cursor = walkedAnchors[0..<aRegionForward].map(\.spanLength).reduce(0, +)
+          }
+        default:
+          switch direction {
+            case .front:
+              cursor = currentRegionBorderRear + walkedAnchors[currentRegion].spanLength
+            case .rear:
+              cursor = currentRegionBorderRear
+          }
+      }
+      return true
+    }
 
     /// 組字器。
     /// - Parameters:
-    ///   - lm: 語言模型。可以是任何基於 Megrez.LanguageModel 的衍生型別。
+    ///   - lm: 語言模型。可以是任何基於 Megrez.LangModel 的衍生型別。
     ///   - length: 指定該組字器內可以允許的最大詞長，預設為 10 字。
     ///   - separator: 多字讀音鍵當中用以分割漢字讀音的記號，預設為空。
-    public init(lm: LanguageModelProtocol, length: Int = 10, separator: String = "") {
-      mutLM = lm
-      mutGrid = .init(spanLength: abs(length))  // 防呆
+    public init(lm: LangModelProtocol, length: Int = 10, separator: String = "-") {
+      langModel = lm
+      super.init(spanLength: abs(length))  // 防呆
       joinSeparator = separator
     }
 
     /// 組字器自我清空專用函式。
-    public func clear() {
-      mutCursorIndex = 0
-      mutReadings.removeAll()
-      mutGrid.clear()
+    override public func clear() {
+      super.clear()
+      cursor = 0
+      readings.removeAll()
+      walkedAnchors.removeAll()
     }
 
     /// 在游標位置插入給定的讀音。
     /// - Parameters:
     ///   - reading: 要插入的讀音。
-    public func insertReadingAtCursor(reading: String) {
-      mutReadings.insert(reading, at: mutCursorIndex)
-      mutGrid.expandGridByOneAt(location: mutCursorIndex)
-      build()
-      mutCursorIndex += 1
-    }
-
-    /// 朝著與文字輸入方向相反的方向、砍掉一個與游標相鄰的讀音。
-    /// 在威注音的術語體系當中，「與文字輸入方向相反的方向」為向後（Rear）。
-    @discardableResult public func deleteReadingAtTheRearOfCursor() -> Bool {
-      if mutCursorIndex == 0 {
-        return false
-      }
-
-      mutReadings.remove(at: mutCursorIndex - 1)
-      mutCursorIndex -= 1
-      mutGrid.shrinkGridByOneAt(location: mutCursorIndex)
+    @discardableResult public func insertReading(_ reading: String) -> Bool {
+      guard !reading.isEmpty, langModel.hasUnigramsFor(key: reading) else { return false }
+      readings.insert(reading, at: cursor)
+      resizeGridByOneAt(location: cursor, to: .expand)
       build()
+      cursor += 1
       return true
     }
 
-    /// 朝著往文字輸入方向、砍掉一個與游標相鄰的讀音。
-    /// 在威注音的術語體系當中，「文字輸入方向」為向前（Front）。
-    @discardableResult public func deleteReadingToTheFrontOfCursor() -> Bool {
-      if mutCursorIndex == mutReadings.count {
+    /// 朝著指定方向砍掉一個與游標相鄰的讀音。
+    ///
+    /// 在威注音的術語體系當中，「與文字輸入方向相反的方向」為向後（Rear），反之則為向前（Front）。
+    /// - Parameter direction: 指定方向。
+    /// - Returns: 該操作是否順利完成。
+    @discardableResult public func dropReading(direction: TypingDirection) -> Bool {
+      let isBackSpace = direction == .rear
+      if cursor == (isBackSpace ? 0 : readings.count) {
         return false
       }
-
-      mutReadings.remove(at: mutCursorIndex)
-      mutGrid.shrinkGridByOneAt(location: mutCursorIndex)
+      readings.remove(at: cursor - (isBackSpace ? 1 : 0))
+      cursor -= (isBackSpace ? 1 : 0)
+      resizeGridByOneAt(location: cursor, to: .shrink)
       build()
       return true
     }
@@ -118,98 +135,84 @@ extension Megrez {
     /// 將該位置要溢出的敲字內容遞交之後、再執行這個函式。
     @discardableResult public func removeHeadReadings(count: Int) -> Bool {
       let count = abs(count)  // 防呆
-      if count > length {
-        return false
-      }
-
+      if count > length { return false }
       for _ in 0..<count {
-        if mutCursorIndex > 0 {
-          mutCursorIndex -= 1
-        }
-        if !mutReadings.isEmpty {
-          mutReadings.removeFirst()
-          mutGrid.shrinkGridByOneAt(location: 0)
+        cursor = max(cursor - 1, 0)
+        if !readings.isEmpty {
+          readings.removeFirst()
+          resizeGridByOneAt(location: 0, to: .shrink)
         }
         build()
       }
-
       return true
     }
 
-    // MARK: - Walker
-
     /// 對已給定的軌格按照給定的位置與條件進行正向爬軌。
-    /// - Parameters:
-    ///   - location: 開始爬軌的位置。
-    ///   - accumulatedScore: 給定累計權重，非必填參數。預設值為 0。
-    ///   - joinedPhrase: 用以統計累計長詞的內部參數，請勿主動使用。
-    ///   - longPhrases: 用以統計累計長詞的內部參數，請勿主動使用。
-    public func walk(
-      at location: Int = 0,
-      score accumulatedScore: Double = 0.0,
-      joinedPhrase: String = "",
-      longPhrases: [String] = .init()
-    ) -> [NodeAnchor] {
-      let newLocation = (mutGrid.width) - abs(location)  // 防呆
-      return Array(
-        reverseWalk(
-          at: newLocation, score: accumulatedScore,
-          joinedPhrase: joinedPhrase, longPhrases: longPhrases
-        ).reversed())
+    /// - Returns: 一個包含有效結果的節錨陣列。
+    @discardableResult public func walk() -> [NodeAnchor] {
+      let newLocation = width
+      // 這裡把所有空節點都過濾掉。
+      walkedAnchors = Array(
+        reverseWalk(at: newLocation).reversed()
+      ).lazy.filter { !$0.isEmpty }
+      updateCursorJumpingTables(walkedAnchors)
+      return walkedAnchors
     }
 
-    /// 對已給定的軌格按照給定的位置與條件進行反向爬軌。
+    // MARK: - Private functions
+
+    /// 內部專用反芻函式，對已給定的軌格按照給定的位置與條件進行反向爬軌。
     /// - Parameters:
     ///   - location: 開始爬軌的位置。
-    ///   - accumulatedScore: 給定累計權重，非必填參數。預設值為 0。
+    ///   - mass: 給定累計權重，非必填參數。預設值為 0。
     ///   - joinedPhrase: 用以統計累計長詞的內部參數，請勿主動使用。
     ///   - longPhrases: 用以統計累計長詞的內部參數，請勿主動使用。
-    public func reverseWalk(
+    /// - Returns: 一個包含結果的節錨陣列。
+    private func reverseWalk(
       at location: Int,
-      score accumulatedScore: Double = 0.0,
+      mass: Double = 0.0,
       joinedPhrase: String = "",
       longPhrases: [String] = .init()
     ) -> [NodeAnchor] {
       let location = abs(location)  // 防呆
-      if location == 0 || location > mutGrid.width {
+      if location == 0 || location > width {
         return .init()
       }
 
       var paths = [[NodeAnchor]]()
-      var nodes = mutGrid.nodesEndingAt(location: location)
-
-      nodes = nodes.stableSorted {
+      let nodes = nodesEndingAt(location: location).stableSorted {
         $0.scoreForSort > $1.scoreForSort
       }
 
-      if let nodeZero = nodes[0].node, nodeZero.score >= nodeZero.kSelectedCandidateScore {
+      guard !nodes.isEmpty else { return .init() }  // 防止下文出現範圍外索引的錯誤
+
+      if nodes[0].node.score >= Node.kSelectedCandidateScore {
         // 在使用者有選過候選字詞的情況下，摒棄非依此據而成的節點路徑。
-        var anchorZero = nodes[0]
-        anchorZero.accumulatedScore = accumulatedScore + nodeZero.score
+        var theAnchor = nodes[0]
+        theAnchor.mass = mass + nodes[0].node.score
         var path: [NodeAnchor] = reverseWalk(
-          at: location - anchorZero.spanningLength, score: anchorZero.accumulatedScore
+          at: location - theAnchor.spanLength, mass: theAnchor.mass
         )
-        path.insert(anchorZero, at: 0)
+        path.insert(theAnchor, at: 0)
         paths.append(path)
       } else if !longPhrases.isEmpty {
         var path = [NodeAnchor]()
         for theAnchor in nodes {
-          guard let theNode = theAnchor.node else { continue }
           var theAnchor = theAnchor
-          let joinedValue = theNode.currentKeyValue.value + joinedPhrase
+          let joinedValue = theAnchor.node.currentPair.value + joinedPhrase
           // 如果只是一堆單漢字的節點組成了同樣的長詞的話，直接棄用這個節點路徑。
           // 打比方說「八/月/中/秋/山/林/涼」與「八月/中秋/山林/涼」在使用者來看
           // 是「結果等價」的，那就扔掉前者。
           if longPhrases.contains(joinedValue) {
-            theAnchor.accumulatedScore = kDroppedPathScore
+            theAnchor.mass = kDroppedPathScore
             path.insert(theAnchor, at: 0)
             paths.append(path)
             continue
           }
-          theAnchor.accumulatedScore = accumulatedScore + theNode.score
+          theAnchor.mass = mass + theAnchor.node.score
           path = reverseWalk(
-            at: location - theAnchor.spanningLength,
-            score: theAnchor.accumulatedScore,
+            at: location - theAnchor.spanLength,
+            mass: theAnchor.mass,
             joinedPhrase: (joinedValue.count >= longPhrases[0].count) ? "" : joinedValue,
             longPhrases: .init()
           )
@@ -219,9 +222,8 @@ extension Megrez {
       } else {
         // 看看當前格位有沒有更長的候選字詞。
         var longPhrases = [String]()
-        for theAnchor in nodes.lazy.filter({ $0.spanningLength > 1 }) {
-          guard let theNode = theAnchor.node else { continue }
-          longPhrases.append(theNode.currentKeyValue.value)
+        for theAnchor in nodes.lazy.filter({ $0.spanLength > 1 }) {
+          longPhrases.append(theAnchor.node.currentPair.value)
         }
 
         longPhrases = longPhrases.stableSorted {
@@ -229,12 +231,11 @@ extension Megrez {
         }
         for theAnchor in nodes {
           var theAnchor = theAnchor
-          guard let theNode = theAnchor.node else { continue }
-          theAnchor.accumulatedScore = accumulatedScore + theNode.score
+          theAnchor.mass = mass + theAnchor.node.score
           var path = [NodeAnchor]()
           path = reverseWalk(
-            at: location - theAnchor.spanningLength, score: theAnchor.accumulatedScore,
-            joinedPhrase: (theAnchor.spanningLength > 1) ? "" : theNode.currentKeyValue.value,
+            at: location - theAnchor.spanLength, mass: theAnchor.mass,
+            joinedPhrase: (theAnchor.spanLength > 1) ? "" : theAnchor.node.currentPair.value,
             longPhrases: .init()
           )
           path.insert(theAnchor, at: 0)
@@ -248,31 +249,29 @@ extension Megrez {
 
       var result: [NodeAnchor] = paths[0]
       for neta in paths.lazy.filter({
-        $0.last!.accumulatedScore > result.last!.accumulatedScore
+        $0.last!.mass > result.last!.mass
       }) {
         result = neta
       }
 
-      return result
+      return result  // 空節點過濾的步驟交給 walk() 這個對外函式，以避免重複執行清理步驟。
     }
 
-    // MARK: - Private functions
-
     private func build() {
       let itrBegin: Int =
-        (mutCursorIndex < maxBuildSpanLength) ? 0 : mutCursorIndex - maxBuildSpanLength
-      let itrEnd: Int = min(mutCursorIndex + maxBuildSpanLength, mutReadings.count)
+        (cursor < maxBuildSpanLength) ? 0 : cursor - maxBuildSpanLength
+      let itrEnd: Int = min(cursor + maxBuildSpanLength, readings.count)
 
       for p in itrBegin..<itrEnd {
         for q in 1..<maxBuildSpanLength {
           if p + q > itrEnd { break }
-          let arrSlice = mutReadings[p..<(p + q)]
+          let arrSlice = readings[p..<(p + q)]
           let combinedReading: String = join(slice: arrSlice, separator: joinSeparator)
-          if mutGrid.hasMatchedNode(location: p, spanningLength: q, key: combinedReading) { continue }
-          let unigrams: [Unigram] = mutLM.unigramsFor(key: combinedReading)
+          if hasMatchedNode(location: p, spanLength: q, key: combinedReading) { continue }
+          let unigrams: [Unigram] = langModel.unigramsFor(key: combinedReading)
           if unigrams.isEmpty { continue }
           let n = Node(key: combinedReading, unigrams: unigrams)
-          mutGrid.insertNode(node: n, location: p, spanningLength: q)
+          insertNode(node: n, location: p, spanLength: q)
         }
       }
     }
@@ -280,6 +279,20 @@ extension Megrez {
     private func join(slice arrSlice: ArraySlice<String>, separator: String) -> String {
       arrSlice.joined(separator: separator)
     }
+
+    internal func updateCursorJumpingTables(_ anchors: [NodeAnchor]) {
+      var cursorRegionMapDict = [Int: Int]()
+      var counter = 0
+      for (i, anchor) in anchors.enumerated() {
+        for _ in 0..<anchor.spanLength {
+          cursorRegionMapDict[counter] = i
+          counter += 1
+        }
+      }
+      cursorRegionMapDict[counter] = anchors.count
+      cursorRegionMapDict[-1] = 0  // 防呆
+      cursorRegionMap = cursorRegionMapDict
+    }
   }
 }
 
diff --git a/Source/Modules/LanguageParsers/Megrez/2_Grid.swift b/Source/Modules/LanguageParsers/Megrez/2_Grid.swift
index fcb7697a..664ec169 100644
--- a/Source/Modules/LanguageParsers/Megrez/2_Grid.swift
+++ b/Source/Modules/LanguageParsers/Megrez/2_Grid.swift
@@ -24,93 +24,82 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */
 
 extension Megrez {
-  /// 軌格。
+  /// 軌格，會被組字器作為原始型別來繼承。
   public class Grid {
+    /// 軌格增減行為。
+    public enum ResizeBehavior { case expand, shrink }
     /// 幅位陣列。
-    private var mutSpans: [Megrez.Span]
+    private(set) var spans: [Megrez.SpanUnit]
 
-    /// 該幅位內可以允許的最大詞長。
-    private var mutMaxBuildSpanLength = 10
-
-    /// 公開：該軌格內可以允許的最大幅位長度。
-    public var maxBuildSpanLength: Int { mutMaxBuildSpanLength }
+    /// 該軌格內可以允許的最大幅位長度。
+    private(set) var maxBuildSpanLength = 10
 
     /// 公開：軌格的寬度，也就是其內的幅位陣列當中的幅位數量。
-    public var width: Int { mutSpans.count }
+    public var width: Int { spans.count }
 
     /// 公開：軌格是否為空。
-    public var isEmpty: Bool { mutSpans.isEmpty }
+    public var isEmpty: Bool { spans.isEmpty }
 
     /// 初期化轨格。
     public init(spanLength: Int = 10) {
-      mutMaxBuildSpanLength = spanLength
-      mutSpans = [Megrez.Span]()
+      maxBuildSpanLength = spanLength
+      spans = [Megrez.SpanUnit]()
     }
 
     /// 自我清空該軌格的內容。
     public func clear() {
-      mutSpans.removeAll()
+      spans.removeAll()
     }
 
     /// 往該軌格的指定位置插入指定幅位長度的指定節點。
     /// - Parameters:
     ///   - node: 節點。
     ///   - location: 位置。
-    ///   - spanningLength: 給定的幅位長度。
-    public func insertNode(node: Node, location: Int, spanningLength: Int) {
+    ///   - spanLength: 給定的幅位長度。
+    public func insertNode(node: Node, location: Int, spanLength: Int) {
       let location = abs(location)  // 防呆
-      let spanningLength = abs(spanningLength)  // 防呆
-      if location >= mutSpans.count {
-        let diff = location - mutSpans.count + 1
+      let spanLength = abs(spanLength)  // 防呆
+      if location >= spans.count {
+        let diff = location - spans.count + 1
         for _ in 0..<diff {
-          mutSpans.append(Span())
+          spans.append(SpanUnit())
         }
       }
-      mutSpans[location].insert(node: node, length: spanningLength)
+      spans[location].insert(node: node, length: spanLength)
     }
 
     /// 給定索引鍵、位置、幅位長度，在該軌格內確認是否有對應的節點存在。
     /// - Parameters:
     ///   - location: 位置。
-    ///   - spanningLength: 給定的幅位長度。
+    ///   - spanLength: 給定的幅位長度。
     ///   - key: 索引鍵。
-    public func hasMatchedNode(location: Int, spanningLength: Int, key: String) -> Bool {
+    public func hasMatchedNode(location: Int, spanLength: Int, key: String) -> Bool {
       let location = abs(location)  // 防呆
-      let spanningLength = abs(spanningLength)  // 防呆
-      if location > mutSpans.count {
+      let spanLength = abs(spanLength)  // 防呆
+      if location > spans.count {
         return false
       }
 
-      let n = mutSpans[location].node(length: spanningLength)
+      let n = spans[location].nodeOf(length: spanLength)
       return n != nil && key == n?.key
     }
 
-    /// 在該軌格的指定位置擴增一個幅位。
+    /// 在該軌格的指定位置擴增或減少一個幅位。
     /// - Parameters:
     ///   - location: 位置。
-    public func expandGridByOneAt(location: Int) {
-      let location = abs(location)  // 防呆
-      mutSpans.insert(Span(), at: location)
-      if location == 0 || location == mutSpans.count { return }
+    public func resizeGridByOneAt(location: Int, to behavior: ResizeBehavior) {
+      let location = max(0, min(width, location))  // 防呆
+      switch behavior {
+        case .expand:
+          spans.insert(SpanUnit(), at: location)
+          if [spans.count, 0].contains(location) { return }
+        case .shrink:
+          if location >= spans.count { return }
+          spans.remove(at: location)
+      }
       for i in 0..<location {
         // zaps overlapping spans
-        mutSpans[i].removeNodeOfLengthGreaterThan(location - i)
-      }
-    }
-
-    /// 在該軌格的指定位置減少一個幅位。
-    /// - Parameters:
-    ///   - location: 位置。
-    public func shrinkGridByOneAt(location: Int) {
-      let location = abs(location)  // 防呆
-      if location >= mutSpans.count {
-        return
-      }
-
-      mutSpans.remove(at: location)
-      for i in 0..<location {
-        // zaps overlapping spans
-        mutSpans[i].removeNodeOfLengthGreaterThan(location - i)
+        spans[i].dropNodesBeyond(length: location - i)
       }
     }
 
@@ -120,21 +109,21 @@ extension Megrez {
     public func nodesBeginningAt(location: Int) -> [NodeAnchor] {
       let location = abs(location)  // 防呆
       var results = [NodeAnchor]()
-      if location >= mutSpans.count { return results }
-      // 此時 mutSpans 必然不為空，因為 location 不可能小於 0。
-      let span = mutSpans[location]
+      if location >= spans.count { return results }
+      // 此時 spans 必然不為空，因為 location 不可能小於 0。
+      let span = spans[location]
       for i in 1...maxBuildSpanLength {
-        if let np = span.node(length: i) {
+        if let np = span.nodeOf(length: i) {
           results.append(
             .init(
               node: np,
               location: location,
-              spanningLength: i
+              spanLength: i
             )
           )
         }
       }
-      return results
+      return results  // 已證實不會有空節點產生。
     }
 
     /// 給定位置，枚舉出所有在這個位置結尾的節點。
@@ -143,21 +132,21 @@ extension Megrez {
     public func nodesEndingAt(location: Int) -> [NodeAnchor] {
       let location = abs(location)  // 防呆
       var results = [NodeAnchor]()
-      if mutSpans.isEmpty || location > mutSpans.count { return results }
+      if spans.isEmpty || location > spans.count { return results }
       for i in 0..<location {
-        let span = mutSpans[i]
-        if i + span.maximumLength < location { continue }
-        if let np = span.node(length: location - i) {
+        let span = spans[i]
+        if i + span.maxLength < location { continue }
+        if let np = span.nodeOf(length: location - i) {
           results.append(
             .init(
               node: np,
               location: i,
-              spanningLength: location - i
+              spanLength: location - i
             )
           )
         }
       }
-      return results
+      return results  // 已證實不會有空節點產生。
     }
 
     /// 給定位置，枚舉出所有在這個位置結尾、或者橫跨該位置的節點。
@@ -166,46 +155,76 @@ extension Megrez {
     public func nodesCrossingOrEndingAt(location: Int) -> [NodeAnchor] {
       let location = abs(location)  // 防呆
       var results = [NodeAnchor]()
-      if mutSpans.isEmpty || location > mutSpans.count { return results }
+      if spans.isEmpty || location > spans.count { return results }
       for i in 0..<location {
-        let span = mutSpans[i]
-        if i + span.maximumLength < location { continue }
-        for j in 1...span.maximumLength {
+        let span = spans[i]
+        if i + span.maxLength < location { continue }
+        for j in 1...span.maxLength {
           if i + j < location { continue }
-          if let np = span.node(length: j) {
+          if let np = span.nodeOf(length: j) {
             results.append(
               .init(
                 node: np,
                 location: i,
-                spanningLength: location - i
+                spanLength: location - i
               )
             )
           }
         }
       }
-      return results
+      return results  // 已證實不會有空節點產生。
     }
 
-    /// 將給定位置的節點的候選字詞改為與給定的字串一致的候選字詞。
+    /// 給定位置，枚舉出所有在這個位置結尾或開頭或者橫跨該位置的節點。
+    ///
+    /// ⚠︎ 注意：排序可能失真。
+    /// - Parameters:
+    ///   - location: 位置。
+    public func nodesOverlappedAt(location: Int) -> [NodeAnchor] {
+      Array(Set(nodesBeginningAt(location: location) + nodesCrossingOrEndingAt(location: location)))
+    }
+
+    /// 使用給定的候選字字串，將給定位置的節點的候選字詞改為與給定的字串一致的候選字詞。
+    ///
+    /// 該函式可以僅用作過程函式，但準確度不如用於處理候選字鍵值配對的 fixNodeWithCandidate()。
+    /// - Parameters:
+    ///   - location: 位置。
+    ///   - value: 給定字串。
+    @discardableResult public func fixNodeWithCandidateLiteral(_ value: String, at location: Int) -> NodeAnchor {
+      let location = abs(location)  // 防呆
+      var node = NodeAnchor()
+      for theAnchor in nodesOverlappedAt(location: location) {
+        let candidates = theAnchor.node.candidates
+        // 將該位置的所有節點的候選字詞鎖定狀態全部重設。
+        theAnchor.node.resetCandidate()
+        for (i, candidate) in candidates.enumerated() {
+          if candidate.value == value {
+            theAnchor.node.selectCandidateAt(index: i)
+            node = theAnchor
+            break
+          }
+        }
+      }
+      return node
+    }
+
+    /// 使用給定的候選字鍵值配對，將給定位置的節點的候選字詞改為與給定的字串一致的候選字詞。
     ///
     /// 該函式可以僅用作過程函式。
     /// - Parameters:
     ///   - location: 位置。
-    ///   - value: 給定字串。
-    @discardableResult public func fixNodeSelectedCandidate(location: Int, value: String) -> NodeAnchor {
+    ///   - value: 給定候選字鍵值配對。
+    @discardableResult public func fixNodeWithCandidate(_ pair: KeyValuePaired, at location: Int) -> NodeAnchor {
       let location = abs(location)  // 防呆
       var node = NodeAnchor()
-      for nodeAnchor in nodesCrossingOrEndingAt(location: location) {
-        guard let theNode = nodeAnchor.node else {
-          continue
-        }
-        let candidates = theNode.candidates
+      for theAnchor in nodesOverlappedAt(location: location) {
+        let candidates = theAnchor.node.candidates
         // 將該位置的所有節點的候選字詞鎖定狀態全部重設。
-        theNode.resetCandidate()
+        theAnchor.node.resetCandidate()
         for (i, candidate) in candidates.enumerated() {
-          if candidate.value == value {
-            theNode.selectCandidateAt(index: i)
-            node = nodeAnchor
+          if candidate == pair {
+            theAnchor.node.selectCandidateAt(index: i)
+            node = theAnchor
             break
           }
         }
@@ -220,16 +239,13 @@ extension Megrez {
     ///   - overridingScore: 給定權重數值。
     public func overrideNodeScoreForSelectedCandidate(location: Int, value: String, overridingScore: Double) {
       let location = abs(location)  // 防呆
-      for nodeAnchor in nodesCrossingOrEndingAt(location: location) {
-        guard let theNode = nodeAnchor.node else {
-          continue
-        }
-        let candidates = theNode.candidates
+      for theAnchor in nodesOverlappedAt(location: location) {
+        let candidates = theAnchor.node.candidates
         // 將該位置的所有節點的候選字詞鎖定狀態全部重設。
-        theNode.resetCandidate()
+        theAnchor.node.resetCandidate()
         for (i, candidate) in candidates.enumerated() {
           if candidate.value == value {
-            theNode.selectFloatingCandidateAt(index: i, score: overridingScore)
+            theAnchor.node.selectFloatingCandidateAt(index: i, score: overridingScore)
             break
           }
         }
@@ -244,29 +260,22 @@ extension Megrez.Grid {
   /// 生成用以交給 GraphViz 診斷的資料檔案內容，純文字。
   public var dumpDOT: String {
     var strOutput = "digraph {\ngraph [ rankdir=LR ];\nBOS;\n"
-    for (p, span) in mutSpans.enumerated() {
-      for ni in 0...(span.maximumLength) {
-        guard let np: Megrez.Node = span.node(length: ni) else {
-          continue
-        }
+    for (p, span) in spans.enumerated() {
+      for ni in 0...(span.maxLength) {
+        guard let np = span.nodeOf(length: ni) else { continue }
         if p == 0 {
-          strOutput += "BOS -> \(np.currentKeyValue.value);\n"
+          strOutput += "BOS -> \(np.currentPair.value);\n"
         }
-
-        strOutput += "\(np.currentKeyValue.value);\n"
-
-        if (p + ni) < mutSpans.count {
-          let destinationSpan = mutSpans[p + ni]
-          for q in 0...(destinationSpan.maximumLength) {
-            if let dn = destinationSpan.node(length: q) {
-              strOutput += np.currentKeyValue.value + " -> " + dn.currentKeyValue.value + ";\n"
-            }
+        strOutput += "\(np.currentPair.value);\n"
+        if (p + ni) < spans.count {
+          let destinationSpan = spans[p + ni]
+          for q in 0...(destinationSpan.maxLength) {
+            guard let dn = destinationSpan.nodeOf(length: q) else { continue }
+            strOutput += np.currentPair.value + " -> " + dn.currentPair.value + ";\n"
           }
         }
-
-        if (p + ni) == mutSpans.count {
-          strOutput += np.currentKeyValue.value + " -> EOS;\n"
-        }
+        guard (p + ni) == spans.count else { continue }
+        strOutput += np.currentPair.value + " -> EOS;\n"
       }
     }
     strOutput += "EOS;\n}\n"
diff --git a/Source/Modules/LanguageParsers/Megrez/3_NodeAnchor.swift b/Source/Modules/LanguageParsers/Megrez/3_NodeAnchor.swift
index 4cdaa64b..40c9c89d 100644
--- a/Source/Modules/LanguageParsers/Megrez/3_NodeAnchor.swift
+++ b/Source/Modules/LanguageParsers/Megrez/3_NodeAnchor.swift
@@ -25,25 +25,34 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 extension Megrez {
   /// 節锚。
-  @frozen public struct NodeAnchor: CustomStringConvertible {
+  @frozen public struct NodeAnchor: Hashable {
+    /// 用來判斷該節錨是否為空。
+    public var isEmpty: Bool { node.key.isEmpty }
     /// 節點。一個節锚內不一定有節點。
-    public var node: Node?
+    public var node: Node = .init()
     /// 節锚所在的位置。
     public var location: Int = 0
-    /// 幅位長度。
-    public var spanningLength: Int = 0
+    /// 指定的幅位長度。
+    public var spanLength: Int = 0
     /// 累計權重。
-    public var accumulatedScore: Double = 0.0
+    public var mass: Double = 0.0
     /// 索引鍵的長度。
     public var keyLength: Int {
-      node?.key.count ?? 0
+      isEmpty ? node.key.count : 0
+    }
+
+    public func hash(into hasher: inout Hasher) {
+      hasher.combine(node)
+      hasher.combine(location)
+      hasher.combine(spanLength)
+      hasher.combine(mass)
     }
 
     /// 將當前節锚列印成一個字串。
     public var description: String {
       var stream = ""
-      stream += "{@(" + String(location) + "," + String(spanningLength) + "),"
-      if let node = node {
+      stream += "{@(" + String(location) + "," + String(spanLength) + "),"
+      if node.key.isEmpty {
         stream += node.description
       } else {
         stream += "null"
@@ -54,12 +63,12 @@ extension Megrez {
 
     /// 獲取用來比較的權重。
     public var scoreForSort: Double {
-      node?.score ?? 0
+      isEmpty ? node.score : 0
     }
   }
 }
 
-// MARK: - DumpDOT-related functions.
+// MARK: - Array Extensions.
 
 extension Array where Element == Megrez.NodeAnchor {
   /// 將節锚陣列列印成一個字串。
@@ -70,4 +79,14 @@ extension Array where Element == Megrez.NodeAnchor {
     }
     return arrOutputContent.joined(separator: "<-")
   }
+
+  /// 從一個節錨陣列當中取出目前的自動選字字串陣列。
+  public var values: [String] {
+    map(\.node.currentPair.value)
+  }
+
+  /// 從一個節錨陣列當中取出目前的索引鍵陣列。
+  public var keys: [String] {
+    map(\.node.currentPair.key)
+  }
 }
diff --git a/Source/Modules/LanguageParsers/Megrez/3_Span.swift b/Source/Modules/LanguageParsers/Megrez/3_Span.swift
index c59c3eaf..a6c71e81 100644
--- a/Source/Modules/LanguageParsers/Megrez/3_Span.swift
+++ b/Source/Modules/LanguageParsers/Megrez/3_Span.swift
@@ -25,21 +25,16 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 extension Megrez {
   /// 幅位。
-  @frozen public struct Span {
+  @frozen public struct SpanUnit {
     /// 辭典：以節點長度為索引，以節點為資料值。
-    private var mutLengthNodeMap: [Int: Megrez.Node] = [:]
-    /// 最大節點長度。
-    private var mutMaximumLength: Int = 0
-
-    /// 公開：最長幅距（唯讀）。
-    public var maximumLength: Int {
-      mutMaximumLength
-    }
+    private var lengthNodeMap: [Int: Megrez.Node] = [:]
+    /// 最長幅距。
+    private(set) var maxLength: Int = 0
 
     /// 自我清空，各項參數歸零。
     mutating func clear() {
-      mutLengthNodeMap.removeAll()
-      mutMaximumLength = 0
+      lengthNodeMap.removeAll()
+      maxLength = 0
     }
 
     /// 往自身插入一個節點、及給定的節點長度。
@@ -48,37 +43,37 @@ extension Megrez {
     ///   - length: 給定的節點長度。
     mutating func insert(node: Node, length: Int) {
       let length = abs(length)  // 防呆
-      mutLengthNodeMap[length] = node
-      mutMaximumLength = max(mutMaximumLength, length)
+      lengthNodeMap[length] = node
+      maxLength = max(maxLength, length)
     }
 
     /// 移除任何比給定的長度更長的節點。
     /// - Parameters:
     ///   - length: 給定的節點長度。
-    mutating func removeNodeOfLengthGreaterThan(_ length: Int) {
+    mutating func dropNodesBeyond(length: Int) {
       let length = abs(length)  // 防呆
-      if length > mutMaximumLength { return }
+      if length > maxLength { return }
       var lenMax = 0
       var removalList: [Int: Megrez.Node] = [:]
-      for key in mutLengthNodeMap.keys {
+      for key in lengthNodeMap.keys {
         if key > length {
-          removalList[key] = mutLengthNodeMap[key]
+          removalList[key] = lengthNodeMap[key]
         } else {
           lenMax = max(lenMax, key)
         }
       }
       for key in removalList.keys {
-        mutLengthNodeMap.removeValue(forKey: key)
+        lengthNodeMap.removeValue(forKey: key)
       }
-      mutMaximumLength = lenMax
+      maxLength = lenMax
     }
 
     /// 給定節點長度，獲取節點。
     /// - Parameters:
     ///   - length: 給定的節點長度。
-    public func node(length: Int) -> Node? {
+    public func nodeOf(length: Int) -> Node? {
       // 防呆 Abs()
-      mutLengthNodeMap.keys.contains(abs(length)) ? mutLengthNodeMap[abs(length)] : nil
+      lengthNodeMap.keys.contains(abs(length)) ? lengthNodeMap[abs(length)] : nil
     }
   }
 }
diff --git a/Source/Modules/LanguageParsers/Megrez/4_Node.swift b/Source/Modules/LanguageParsers/Megrez/4_Node.swift
index 1672b2b9..f5fc0d63 100644
--- a/Source/Modules/LanguageParsers/Megrez/4_Node.swift
+++ b/Source/Modules/LanguageParsers/Megrez/4_Node.swift
@@ -25,76 +25,86 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 extension Megrez {
   /// 節點。
-  public class Node {
-    /// 鍵。
-    private var mutKey: String = ""
-    /// 當前節點的當前被選中的候選字詞「在該節點內的」目前的權重。
-    private var mutScore: Double = 0
-    /// 單元圖陣列。
-    private var mutUnigrams: [Unigram]
-    /// 雙元圖陣列。
-    private var mutBigrams: [Bigram]
-    /// 候選字詞陣列，以鍵值陣列的形式存在。
-    private var mutCandidates: [KeyValuePaired] = []
-    /// 專門「用單元圖資料值來調查索引值」的辭典。
-    private var mutValueUnigramIndexMap: [String: Int] = [:]
-    /// 專門「用給定鍵值來取對應的雙元圖陣列」的辭典。
-    private var mutPrecedingBigramMap: [KeyValuePaired: [Megrez.Bigram]] = [:]
-    /// 狀態標記變數，用來記載當前節點是否處於候選字詞鎖定狀態。
-    private var mutCandidateFixed: Bool = false
-    /// 用來登記「當前選中的單元圖」的索引值的變數。
-    private var mutSelectedUnigramIndex: Int = 0
-    /// 用來登記要施加給「『被標記為選中狀態』的候選字詞」的複寫權重的數值。
-    public let kSelectedCandidateScore: Double = 99
-    /// 將當前節點列印成一個字串。
-    public var description: String {
-      "(node,key:\(mutKey),fixed:\(mutCandidateFixed ? "true" : "false"),selected:\(mutSelectedUnigramIndex),\(mutUnigrams))"
+  public class Node: Equatable, Hashable {
+    public static func == (lhs: Megrez.Node, rhs: Megrez.Node) -> Bool {
+      lhs.key == rhs.key && lhs.score == rhs.score && lhs.unigrams == rhs.unigrams && lhs.bigrams == rhs.bigrams
+        && lhs.candidates == rhs.candidates && lhs.valueUnigramIndexMap == rhs.valueUnigramIndexMap
+        && lhs.precedingBigramMap == rhs.precedingBigramMap && lhs.isCandidateFixed == rhs.isCandidateFixed
+        && lhs.selectedUnigramIndex == rhs.selectedUnigramIndex
     }
 
-    /// 公開：候選字詞陣列（唯讀），以鍵值陣列的形式存在。
-    public var candidates: [KeyValuePaired] { mutCandidates }
-    /// 公開：用來登記「當前選中的單元圖」的索引值的變數（唯讀）。
-    public var isCandidateFixed: Bool { mutCandidateFixed }
+    public func hash(into hasher: inout Hasher) {
+      hasher.combine(key)
+      hasher.combine(score)
+      hasher.combine(unigrams)
+      hasher.combine(bigrams)
+      hasher.combine(candidates)
+      hasher.combine(valueUnigramIndexMap)
+      hasher.combine(precedingBigramMap)
+      hasher.combine(isCandidateFixed)
+      hasher.combine(selectedUnigramIndex)
+    }
+
+    /// 鍵。
+    private(set) var key: String = ""
+    /// 當前節點的當前被選中的候選字詞「在該節點內的」目前的權重。
+    private(set) var score: Double = 0
+    /// 單元圖陣列。
+    private var unigrams: [Unigram]
+    /// 雙元圖陣列。
+    private var bigrams: [Bigram]
+    /// 候選字詞陣列，以鍵值陣列的形式存在。
+    private(set) var candidates: [KeyValuePaired] = []
+    /// 專門「用單元圖資料值來調查索引值」的辭典。
+    private var valueUnigramIndexMap: [String: Int] = [:]
+    /// 專門「用給定鍵值來取對應的雙元圖陣列」的辭典。
+    private var precedingBigramMap: [KeyValuePaired: [Megrez.Bigram]] = [:]
+    /// 狀態標記變數，用來記載當前節點是否處於候選字詞鎖定狀態。
+    private(set) var isCandidateFixed: Bool = false
+    /// 用來登記「當前選中的單元圖」的索引值的變數。
+    private var selectedUnigramIndex: Int = 0
+    /// 用來登記要施加給「『被標記為選中狀態』的候選字詞」的複寫權重的數值。
+    public static let kSelectedCandidateScore: Double = 99
+    /// 將當前節點列印成一個字串。
+    public var description: String {
+      "(node,key:\(key),fixed:\(isCandidateFixed ? "true" : "false"),selected:\(selectedUnigramIndex),\(unigrams))"
+    }
 
-    /// 公開：鍵（唯讀）。
-    public var key: String { mutKey }
-    /// 公開：當前節點的當前被選中的候選字詞「在該節點內的」目前的權重（唯讀）。
-    public var score: Double { mutScore }
     /// 公開：當前被選中的候選字詞的鍵值配對。
-    public var currentKeyValue: KeyValuePaired {
-      mutSelectedUnigramIndex >= mutUnigrams.count ? KeyValuePaired() : mutCandidates[mutSelectedUnigramIndex]
+    public var currentPair: KeyValuePaired {
+      selectedUnigramIndex >= unigrams.count ? KeyValuePaired() : candidates[selectedUnigramIndex]
     }
 
     /// 公開：給出當前單元圖陣列內最高的權重數值。
-    public var highestUnigramScore: Double { mutUnigrams.isEmpty ? 0.0 : mutUnigrams[0].score }
+    public var highestUnigramScore: Double { unigrams.isEmpty ? 0.0 : unigrams[0].score }
 
     /// 初期化一個節點。
     /// - Parameters:
     ///   - key: 索引鍵。
     ///   - unigrams: 單元圖陣列。
     ///   - bigrams: 雙元圖陣列（非必填）。
-    public init(key: String, unigrams: [Megrez.Unigram], bigrams: [Megrez.Bigram] = []) {
-      mutKey = key
-      mutUnigrams = unigrams
-      mutBigrams = bigrams
+    public init(key: String = "", unigrams: [Megrez.Unigram] = [], bigrams: [Megrez.Bigram] = []) {
+      self.key = key
+      self.unigrams = unigrams
+      self.bigrams = bigrams
 
-      mutUnigrams.sort {
+      self.unigrams.sort {
         $0.score > $1.score
       }
 
-      if !mutUnigrams.isEmpty {
-        mutScore = mutUnigrams[0].score
+      if !self.unigrams.isEmpty {
+        score = unigrams[0].score
       }
 
-      for (i, gram) in mutUnigrams.enumerated() {
-        mutValueUnigramIndexMap[gram.keyValue.value] = i
-        mutCandidates.append(gram.keyValue)
+      for (i, gram) in self.unigrams.enumerated() {
+        valueUnigramIndexMap[gram.keyValue.value] = i
+        candidates.append(gram.keyValue)
       }
 
       for gram in bigrams.lazy.filter({ [self] in
-        mutPrecedingBigramMap.keys.contains($0.precedingKeyValue)
+        precedingBigramMap.keys.contains($0.precedingKeyValue)
       }) {
-        mutPrecedingBigramMap[gram.precedingKeyValue]?.append(gram)
+        precedingBigramMap[gram.precedingKeyValue]?.append(gram)
       }
     }
 
@@ -102,22 +112,22 @@ extension Megrez {
     /// - Parameters:
     ///   - precedingKeyValues: 前述鍵值陣列。
     public func primeNodeWith(precedingKeyValues: [KeyValuePaired]) {
-      var newIndex = mutSelectedUnigramIndex
-      var max = mutScore
+      var newIndex = selectedUnigramIndex
+      var max = score
 
       if !isCandidateFixed {
         for neta in precedingKeyValues {
-          let bigrams = mutPrecedingBigramMap[neta] ?? []
+          let bigrams = precedingBigramMap[neta] ?? []
           for bigram in bigrams.lazy.filter({ [self] in
-            $0.score > max && mutValueUnigramIndexMap.keys.contains($0.keyValue.value)
+            $0.score > max && valueUnigramIndexMap.keys.contains($0.keyValue.value)
           }) {
-            newIndex = mutValueUnigramIndexMap[bigram.keyValue.value] ?? newIndex
+            newIndex = valueUnigramIndexMap[bigram.keyValue.value] ?? newIndex
             max = bigram.score
           }
         }
       }
-      mutScore = max
-      mutSelectedUnigramIndex = newIndex
+      score = max
+      selectedUnigramIndex = newIndex
     }
 
     /// 選中位於給定索引位置的候選字詞。
@@ -126,17 +136,17 @@ extension Megrez {
     ///   - fix: 是否將當前解點標記為「候選詞已鎖定」的狀態。
     public func selectCandidateAt(index: Int = 0, fix: Bool = false) {
       let index = abs(index)
-      mutSelectedUnigramIndex = index >= mutUnigrams.count ? 0 : index
-      mutCandidateFixed = fix
-      mutScore = kSelectedCandidateScore
+      selectedUnigramIndex = index >= unigrams.count ? 0 : index
+      isCandidateFixed = fix
+      score = Megrez.Node.kSelectedCandidateScore
     }
 
     /// 重設該節點的候選字詞狀態。
     public func resetCandidate() {
-      mutSelectedUnigramIndex = 0
-      mutCandidateFixed = false
-      if !mutUnigrams.isEmpty {
-        mutScore = mutUnigrams[0].score
+      selectedUnigramIndex = 0
+      isCandidateFixed = false
+      if !unigrams.isEmpty {
+        score = unigrams[0].score
       }
     }
 
@@ -146,16 +156,26 @@ extension Megrez {
     ///   - score: 給定權重條件。
     public func selectFloatingCandidateAt(index: Int, score: Double) {
       let index = abs(index)  // 防呆
-      mutSelectedUnigramIndex = index >= mutUnigrams.count ? 0 : index
-      mutCandidateFixed = false
-      mutScore = score
+      selectedUnigramIndex = index >= unigrams.count ? 0 : index
+      isCandidateFixed = false
+      self.score = score
     }
 
     /// 藉由給定的候選字詞字串，找出在庫的單元圖權重數值。沒有的話就找零。
     /// - Parameters:
     ///   - candidate: 給定的候選字詞字串。
     public func scoreFor(candidate: String) -> Double {
-      for unigram in mutUnigrams.lazy.filter({ $0.keyValue.value == candidate }) {
+      for unigram in unigrams.lazy.filter({ $0.keyValue.value == candidate }) {
+        return unigram.score
+      }
+      return 0.0
+    }
+
+    /// 藉由給定的候選字詞鍵值配對，找出在庫的單元圖權重數值。沒有的話就找零。
+    /// - Parameters:
+    ///   - candidate: 給定的候選字詞字串。
+    public func scoreForPaired(candidate: KeyValuePaired) -> Double {
+      for unigram in unigrams.lazy.filter({ $0.keyValue == candidate }) {
         return unigram.score
       }
       return 0.0
diff --git a/Source/Modules/LanguageParsers/Megrez/5_LanguageModel.swift b/Source/Modules/LanguageParsers/Megrez/5_LanguageModel.swift
index abe8c822..75ee404e 100644
--- a/Source/Modules/LanguageParsers/Megrez/5_LanguageModel.swift
+++ b/Source/Modules/LanguageParsers/Megrez/5_LanguageModel.swift
@@ -23,7 +23,7 @@ IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */
 
-public protocol LanguageModelProtocol {
+public protocol LangModelProtocol {
   /// 給定鍵，讓語言模型找給一組單元圖陣列。
   func unigramsFor(key: String) -> [Megrez.Unigram]
 
@@ -36,7 +36,7 @@ public protocol LanguageModelProtocol {
 
 extension Megrez {
   /// 語言模型框架，回頭實際使用時需要派生一個型別、且重寫相關函式。
-  open class LanguageModel: LanguageModelProtocol {
+  open class LangModel: LangModelProtocol {
     public init() {}
 
     // 這裡寫了一點假內容，不然有些 Swift 格式化工具會破壞掉函式的參數設計。
diff --git a/Source/Modules/LanguageParsers/Megrez/6_Bigram.swift b/Source/Modules/LanguageParsers/Megrez/6_Bigram.swift
index b64e2658..fdf15d51 100644
--- a/Source/Modules/LanguageParsers/Megrez/6_Bigram.swift
+++ b/Source/Modules/LanguageParsers/Megrez/6_Bigram.swift
@@ -25,7 +25,7 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 extension Megrez {
   /// 雙元圖。
-  @frozen public struct Bigram: Equatable, CustomStringConvertible {
+  @frozen public struct Bigram: Equatable, CustomStringConvertible, Hashable {
     /// 當前鍵值。
     public var keyValue: KeyValuePaired
     /// 前述鍵值。
@@ -61,7 +61,7 @@ extension Megrez {
 
     public static func < (lhs: Bigram, rhs: Bigram) -> Bool {
       lhs.precedingKeyValue < rhs.precedingKeyValue
-        || (lhs.keyValue < rhs.keyValue || (lhs.keyValue == rhs.keyValue && lhs.keyValue < rhs.keyValue))
+        || (lhs.keyValue < rhs.keyValue || (lhs.keyValue == rhs.keyValue && lhs.score < rhs.score))
     }
   }
 }
diff --git a/Source/Modules/LanguageParsers/Megrez/6_Unigram.swift b/Source/Modules/LanguageParsers/Megrez/6_Unigram.swift
index 4bcd894e..c716fe18 100644
--- a/Source/Modules/LanguageParsers/Megrez/6_Unigram.swift
+++ b/Source/Modules/LanguageParsers/Megrez/6_Unigram.swift
@@ -25,7 +25,7 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 extension Megrez {
   /// 單元圖。
-  @frozen public struct Unigram: Equatable, CustomStringConvertible {
+  @frozen public struct Unigram: Equatable, CustomStringConvertible, Hashable {
     /// 鍵值。
     public var keyValue: KeyValuePaired
     /// 權重。
@@ -54,7 +54,7 @@ extension Megrez {
     }
 
     public static func < (lhs: Unigram, rhs: Unigram) -> Bool {
-      lhs.keyValue < rhs.keyValue || (lhs.keyValue == rhs.keyValue && lhs.keyValue < rhs.keyValue)
+      lhs.keyValue < rhs.keyValue || (lhs.keyValue == rhs.keyValue && lhs.score < rhs.score)
     }
   }
 }
diff --git a/Source/Modules/LanguageParsers/Megrez/7_KeyValuePaired.swift b/Source/Modules/LanguageParsers/Megrez/7_KeyValuePaired.swift
index 3e9dee80..ac07ad4d 100644
--- a/Source/Modules/LanguageParsers/Megrez/7_KeyValuePaired.swift
+++ b/Source/Modules/LanguageParsers/Megrez/7_KeyValuePaired.swift
@@ -52,7 +52,7 @@ extension Megrez {
     }
 
     public static func == (lhs: KeyValuePaired, rhs: KeyValuePaired) -> Bool {
-      lhs.key.count == rhs.key.count && lhs.value == rhs.value
+      lhs.key == rhs.key && lhs.value == rhs.value
     }
 
     public static func < (lhs: KeyValuePaired, rhs: KeyValuePaired) -> Bool {

From c89636e12a890b66e93d1737a77d6a3f6df81f81 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Tue, 12 Jul 2022 20:59:31 +0800
Subject: [PATCH 09/20] KeyHandler // Tweak fixNode() with new cursor pushing
 behavior.

---
 Source/Modules/ControllerModules/KeyHandler_Core.swift | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/Source/Modules/ControllerModules/KeyHandler_Core.swift b/Source/Modules/ControllerModules/KeyHandler_Core.swift
index 79123ef2..63f24dfa 100644
--- a/Source/Modules/ControllerModules/KeyHandler_Core.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_Core.swift
@@ -197,14 +197,7 @@ class KeyHandler {
 
     /// 若偏好設定內啟用了相關選項，則會在選字之後始終將游標推送至選字厚的節錨的前方。
     if mgrPrefs.moveCursorAfterSelectingCandidate, respectCursorPushing {
-      var nextPosition = 0
-      for theAnchor in walkedAnchors {
-        if nextPosition >= adjustedCursor { break }
-        nextPosition += theAnchor.spanLength
-      }
-      if nextPosition <= compositorLength {
-        compositorCursorIndex = nextPosition
-      }
+      compositor.jumpCursorBySpan(to: .front)
     }
   }
 

From 5f654c842ec91a55ef5533aa737108dc23b79179 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Tue, 12 Jul 2022 15:55:18 +0800
Subject: [PATCH 10/20] KeyHandler // Improve Alt+Fwd/Bwd support.

---
 .../ControllerModules/KeyHandler_Core.swift   |  4 ++--
 .../ControllerModules/KeyHandler_States.swift | 19 ++++++++-----------
 2 files changed, 10 insertions(+), 13 deletions(-)

diff --git a/Source/Modules/ControllerModules/KeyHandler_Core.swift b/Source/Modules/ControllerModules/KeyHandler_Core.swift
index 63f24dfa..998f381e 100644
--- a/Source/Modules/ControllerModules/KeyHandler_Core.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_Core.swift
@@ -375,8 +375,8 @@ class KeyHandler {
 
   /// 組字器的游標位置。
   var compositorCursorIndex: Int {
-    get { compositor.cursorIndex }
-    set { compositor.cursorIndex = newValue }
+    get { compositor.cursor }
+    set { compositor.cursor = newValue }
   }
 
   /// 組字器的目前的長度。
diff --git a/Source/Modules/ControllerModules/KeyHandler_States.swift b/Source/Modules/ControllerModules/KeyHandler_States.swift
index ae662528..401bcaf1 100644
--- a/Source/Modules/ControllerModules/KeyHandler_States.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_States.swift
@@ -662,14 +662,14 @@ extension KeyHandler {
         stateCallback(state)
       }
     } else if input.isOptionHold {
-      if compositorCursorIndex < compositorLength {
-        compositorCursorIndex = nextPhrasePosition
-        stateCallback(buildInputtingState)
-      } else {
+      // 游標跳轉動作無論怎樣都會執行，但如果出了執行失敗的結果的話則觸發報錯流程。
+      if !compositor.jumpCursorBySpan(to: .front) {
         IME.prtDebugIntel("33C3B580")
         errorCallback()
         stateCallback(state)
+        return true
       }
+      stateCallback(buildInputtingState)
     } else {
       if compositorCursorIndex < compositorLength {
         compositorCursorIndex += 1
@@ -727,17 +727,14 @@ extension KeyHandler {
         stateCallback(state)
       }
     } else if input.isOptionHold {
-      if compositorCursorIndex > 1 {
-        compositorCursorIndex -= 2
-        stateCallback(buildInputtingState)
-      } else if compositorCursorIndex == 1 {
-        compositorCursorIndex = 0
-        stateCallback(buildInputtingState)
-      } else {
+      // 游標跳轉動作無論怎樣都會執行，但如果出了執行失敗的結果的話則觸發報錯流程。
+      if !compositor.jumpCursorBySpan(to: .rear) {
         IME.prtDebugIntel("8D50DD9E")
         errorCallback()
         stateCallback(state)
+        return true
       }
+      stateCallback(buildInputtingState)
     } else {
       if compositorCursorIndex > 0 {
         compositorCursorIndex -= 1

From 828575a08a65dd57a27094f7cd3d0dfd799e01d4 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Mon, 11 Jul 2022 23:03:41 +0800
Subject: [PATCH 11/20] Repo // Use KeyValuePaired as candidate unit.

---
 .../ControllerModules/InputState.swift        | 10 ++---
 .../ControllerModules/KeyHandler_Core.swift   | 37 ++++++++++---------
 .../KeyHandler_HandleCandidate.swift          |  2 +-
 .../KeyHandler_HandleInput.swift              |  2 +-
 .../ControllerModules/KeyHandler_States.swift | 12 +++---
 .../ctlInputMethod_Delegates.swift            | 10 ++---
 .../ctlInputMethod_HandleDisplay.swift        |  8 ++--
 Source/UI/CandidateUI/ctlCandidate.swift      |  2 +-
 .../CandidateUI/ctlCandidateUniversal.swift   |  4 +-
 vChewingTests/KeyHandlerTestsNormalCHS.swift  |  6 +--
 vChewingTests/KeyHandlerTestsSCPCCHT.swift    |  6 +--
 11 files changed, 49 insertions(+), 50 deletions(-)

diff --git a/Source/Modules/ControllerModules/InputState.swift b/Source/Modules/ControllerModules/InputState.swift
index bfe0cab9..07915b45 100644
--- a/Source/Modules/ControllerModules/InputState.swift
+++ b/Source/Modules/ControllerModules/InputState.swift
@@ -139,9 +139,9 @@ enum InputState {
   /// 因為逐字選字模式不需要在組字區內存入任何東西，所以該狀態不受 .NotEmpty 的管轄。
   class AssociatedPhrases: InputStateProtocol {
     public var type: StateType { .ofAssociatedPhrases }
-    private(set) var candidates: [String] = []
+    private(set) var candidates: [(String, String)] = []
     private(set) var isTypingVertical: Bool = false
-    init(candidates: [String], isTypingVertical: Bool) {
+    init(candidates: [(String, String)], isTypingVertical: Bool) {
       self.candidates = candidates
       self.isTypingVertical = isTypingVertical
     }
@@ -407,10 +407,10 @@ enum InputState {
   /// .ChoosingCandidate: 叫出選字窗、允許使用者選字。
   class ChoosingCandidate: NotEmpty {
     override public var type: StateType { .ofChooseCandidate }
-    private(set) var candidates: [String]
+    private(set) var candidates: [(String, String)]
     private(set) var isTypingVertical: Bool
 
-    init(composingBuffer: String, cursorIndex: Int, candidates: [String], isTypingVertical: Bool) {
+    init(composingBuffer: String, cursorIndex: Int, candidates: [(String, String)], isTypingVertical: Bool) {
       self.candidates = candidates
       self.isTypingVertical = isTypingVertical
       super.init(composingBuffer: composingBuffer, cursorIndex: cursorIndex)
@@ -432,7 +432,7 @@ enum InputState {
       self.node = node
       let candidates = node.children?.map(\.title) ?? [String]()
       super.init(
-        composingBuffer: "", cursorIndex: 0, candidates: candidates,
+        composingBuffer: "", cursorIndex: 0, candidates: candidates.map { ("", $0) },
         isTypingVertical: isTypingVertical
       )
     }
diff --git a/Source/Modules/ControllerModules/KeyHandler_Core.swift b/Source/Modules/ControllerModules/KeyHandler_Core.swift
index 998f381e..51cd3e51 100644
--- a/Source/Modules/ControllerModules/KeyHandler_Core.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_Core.swift
@@ -149,10 +149,10 @@ class KeyHandler {
   /// - Parameter key: 給定的聯想詞的開頭字。
   /// - Returns: 抓取到的聯想詞陣列。
   /// 不會是 nil，但那些負責接收結果的函式會對空白陣列結果做出正確的處理。
-  func buildAssociatePhraseArray(withKey key: String) -> [String] {
-    var arrResult: [String] = []
+  func buildAssociatePhraseArray(withKey key: String) -> [(String, String)] {
+    var arrResult: [(String, String)] = []
     if currentLM.hasAssociatedPhrasesFor(key: key) {
-      arrResult.append(contentsOf: currentLM.associatedPhrasesFor(key: key))
+      arrResult = currentLM.associatedPhrasesFor(key: key).map { ("", $0) }
     }
     return arrResult
   }
@@ -162,21 +162,22 @@ class KeyHandler {
   /// - Parameters:
   ///   - value: 給定之候選字字串。
   ///   - respectCursorPushing: 若該選項為 true，則會在選字之後始終將游標推送至選字厚的節錨的前方。
-  func fixNode(value: String, respectCursorPushing: Bool = true) {
+  func fixNode(candidate: (String, String), respectCursorPushing: Bool = true) {
+    let theCandidate: Megrez.KeyValuePaired = .init(key: candidate.0, value: candidate.1)
     let adjustedCursor = max(0, min(actualCandidateCursor + (mgrPrefs.useRearCursorMode ? 1 : 0), compositorLength))
     // 開始讓半衰模組觀察目前的狀況。
-    let selectedNode: Megrez.NodeAnchor = compositor.fixNodeSelectedCandidate(value, at: adjustedCursor)
+    let selectedNode: Megrez.NodeAnchor = compositor.fixNodeWithCandidate(theCandidate, at: adjustedCursor)
     // 不要針對逐字選字模式啟用臨時半衰記憶模型。
     if !mgrPrefs.useSCPCTypingMode {
       var addToUserOverrideModel = true
       // 所有讀音數與字符數不匹配的情況均不得塞入半衰記憶模組。
-      if selectedNode.spanLength != value.count {
+      if selectedNode.spanLength != theCandidate.value.count {
         IME.prtDebugIntel("UOM: SpanningLength != value.count, dismissing.")
         addToUserOverrideModel = false
       }
       if addToUserOverrideModel {
         // 威注音的 SymbolLM 的 Score 是 -12，符合該條件的內容不得塞入半衰記憶模組。
-        if selectedNode.node.scoreFor(candidate: value) <= -12 {
+        if selectedNode.node.scoreForPaired(candidate: theCandidate) <= -12 {
           IME.prtDebugIntel("UOM: Score <= -12, dismissing.")
           addToUserOverrideModel = false
         }
@@ -186,7 +187,7 @@ class KeyHandler {
         // 令半衰記憶模組觀測給定的三元圖。
         // 這個過程會讓半衰引擎根據當前上下文生成三元圖索引鍵。
         currentUOM.observe(
-          walkedAnchors: walkedAnchors, cursorIndex: adjustedCursor, candidate: value,
+          walkedAnchors: walkedAnchors, cursorIndex: adjustedCursor, candidate: theCandidate.value,
           timestamp: NSDate().timeIntervalSince1970
         )
       }
@@ -211,21 +212,21 @@ class KeyHandler {
     for anchor in walkedAnchors {
       if index >= width - kMaxComposingBufferNeedsToWalkSize { break }
       if anchor.node.score < Megrez.Node.kSelectedCandidateScore {
-        compositor.fixNodeSelectedCandidate(anchor.node.currentPair.value, at: index + anchor.spanLength)
+        compositor.fixNodeWithCandidate(anchor.node.currentPair, at: index + anchor.spanLength)
       }
       index += anchor.spanLength
     }
   }
 
-  /// 獲取候選字詞陣列資料內容。
-  func getCandidatesArray(fixOrder: Bool = true) -> [String] {
+  /// 獲取候選字詞（包含讀音）陣列資料內容。
+  func getCandidatesArray(fixOrder: Bool = true) -> [(String, String)] {
     var arrAnchors: [Megrez.NodeAnchor] = rawAnchorsOfNodes
-    var arrCandidates: [String] = []
+    var arrCandidates: [Megrez.KeyValuePaired] = .init()
 
     /// 原理：nodes 這個回饋結果包含一堆子陣列，分別對應不同詞長的候選字。
     /// 這裡先對陣列排序、讓最長候選字的子陣列的優先權最高。
     /// 這個過程不會傷到子陣列內部的排序。
-    if arrAnchors.isEmpty { return arrCandidates }
+    if arrAnchors.isEmpty { return .init() }
 
     // 讓更長的節錨排序靠前。
     arrAnchors = arrAnchors.stableSort { $0.keyLength > $1.keyLength }
@@ -235,19 +236,19 @@ class KeyHandler {
       // 選字窗的內容的康熙轉換 / JIS 轉換不能放在這裡處理，會影響選字有效性。
       // 選字的原理是拿著具體的候選字詞的字串去當前的節錨下找出對應的候選字詞（Ｘ元圖）。
       // 一旦在這裡轉換了，節錨內的某些元圖就無法被選中。
-      arrCandidates.append(currentCandidate.value)
+      arrCandidates.append(.init(key: currentCandidate.key, value: currentCandidate.value))
     }
     // 決定是否根據半衰記憶模組的建議來調整候選字詞的順序。
     if !mgrPrefs.fetchSuggestionsFromUserOverrideModel || mgrPrefs.useSCPCTypingMode || fixOrder {
-      return arrCandidates
+      return arrCandidates.map { ($0.key, $0.value) }
     }
 
     let arrSuggestedUnigrams: [Megrez.Unigram] = fetchSuggestedCandidates().stableSort { $0.score > $1.score }
-    let arrSuggestedCandidates: [String] = arrSuggestedUnigrams.map(\.keyValue.value)
+    let arrSuggestedCandidates: [Megrez.KeyValuePaired] = arrSuggestedUnigrams.map(\.keyValue)
     arrCandidates = arrSuggestedCandidates.filter { arrCandidates.contains($0) } + arrCandidates
     arrCandidates = arrCandidates.deduplicate
-    arrCandidates = arrCandidates.stableSort { $0.count > $1.count }
-    return arrCandidates
+    arrCandidates = arrCandidates.stableSort { $0.key.split(separator: "-").count > $1.key.split(separator: "-").count }
+    return arrCandidates.map { ($0.key, $0.value) }
   }
 
   /// 向半衰引擎詢問可能的選字建議。拿到的結果會是一個單元圖陣列。
diff --git a/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift b/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift
index 0e78df2a..5a91344f 100644
--- a/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift
@@ -274,7 +274,7 @@ extension KeyHandler {
 
     // MARK: End Key
 
-    var candidates: [String]!
+    var candidates: [(String, String)]!
 
     if let state = state as? InputState.ChoosingCandidate {
       candidates = state.candidates
diff --git a/Source/Modules/ControllerModules/KeyHandler_HandleInput.swift b/Source/Modules/ControllerModules/KeyHandler_HandleInput.swift
index 8f54848f..f07cac76 100644
--- a/Source/Modules/ControllerModules/KeyHandler_HandleInput.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_HandleInput.swift
@@ -225,7 +225,7 @@ extension KeyHandler {
         )
         if choosingCandidates.candidates.count == 1 {
           clear()
-          let text: String = choosingCandidates.candidates.first ?? ""
+          let text: String = choosingCandidates.candidates.first?.1 ?? ""
           stateCallback(InputState.Committing(textToCommit: text))
 
           if !mgrPrefs.associatedPhrasesEnabled {
diff --git a/Source/Modules/ControllerModules/KeyHandler_States.swift b/Source/Modules/ControllerModules/KeyHandler_States.swift
index 401bcaf1..73132538 100644
--- a/Source/Modules/ControllerModules/KeyHandler_States.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_States.swift
@@ -330,8 +330,8 @@ extension KeyHandler {
     )
     if candidateState.candidates.count == 1 {
       clear()
-      if let strtextToCommit: String = candidateState.candidates.first {
-        stateCallback(InputState.Committing(textToCommit: strtextToCommit))
+      if let candidateToCommit: (String, String) = candidateState.candidates.first {
+        stateCallback(InputState.Committing(textToCommit: candidateToCommit.1))
         stateCallback(InputState.Empty())
       } else {
         stateCallback(candidateState)
@@ -802,7 +802,7 @@ extension KeyHandler {
     }
 
     let currentNode = currentAnchor.node
-    let currentValue = currentNode.currentPair.value
+    let currentPaired: Megrez.KeyValuePaired = currentNode.currentPair
 
     var currentIndex = 0
     if currentNode.score < Megrez.Node.kSelectedCandidateScore {
@@ -814,14 +814,14 @@ extension KeyHandler {
       /// 選中的話，則使用者可以直接摁下本函式對應的按鍵來輪替候選字即可。
       /// （預設情況下是 (Shift+)Tab 來做正 (反) 向切換，但也可以用
       /// Shift(+CMD)+Space 來切換、以應對臉書綁架 Tab 鍵的情況。
-      if candidates[0] == currentValue {
+      if candidates[0].0 == currentPaired.key, candidates[0].1 == currentPaired.value {
         /// 如果第一個候選字詞是當前節點的候選字詞的值的話，
         /// 那就切到下一個（或上一個，也就是最後一個）候選字詞。
         currentIndex = reverseModifier ? candidates.count - 1 : 1
       }
     } else {
       for candidate in candidates {
-        if candidate == currentValue {
+        if candidate.0 == currentPaired.key, candidate.1 == currentPaired.value {
           if reverseModifier {
             if currentIndex == 0 {
               currentIndex = candidates.count - 1
@@ -841,7 +841,7 @@ extension KeyHandler {
       currentIndex = 0
     }
 
-    fixNode(value: candidates[currentIndex], respectCursorPushing: false)
+    fixNode(candidate: candidates[currentIndex], respectCursorPushing: false)
 
     stateCallback(buildInputtingState)
     return true
diff --git a/Source/Modules/ControllerModules/ctlInputMethod_Delegates.swift b/Source/Modules/ControllerModules/ctlInputMethod_Delegates.swift
index d55f76f6..7b0f6f92 100644
--- a/Source/Modules/ControllerModules/ctlInputMethod_Delegates.swift
+++ b/Source/Modules/ControllerModules/ctlInputMethod_Delegates.swift
@@ -81,7 +81,7 @@ extension ctlInputMethod: ctlCandidateDelegate {
   }
 
   func ctlCandidate(_ controller: ctlCandidate, candidateAtIndex index: Int)
-    -> String
+    -> (String, String)
   {
     _ = controller  // 防止格式整理工具毀掉與此對應的參數。
     if let state = state as? InputState.ChoosingCandidate {
@@ -89,7 +89,7 @@ extension ctlInputMethod: ctlCandidateDelegate {
     } else if let state = state as? InputState.AssociatedPhrases {
       return state.candidates[index]
     }
-    return ""
+    return ("", "")
   }
 
   func ctlCandidate(_ controller: ctlCandidate, didSelectCandidateAtIndex index: Int) {
@@ -112,7 +112,7 @@ extension ctlInputMethod: ctlCandidateDelegate {
 
     if let state = state as? InputState.ChoosingCandidate {
       let selectedValue = state.candidates[index]
-      keyHandler.fixNode(value: selectedValue, respectCursorPushing: true)
+      keyHandler.fixNode(candidate: selectedValue, respectCursorPushing: true)
 
       let inputting = keyHandler.buildInputtingState
 
@@ -137,10 +137,10 @@ extension ctlInputMethod: ctlCandidateDelegate {
 
     if let state = state as? InputState.AssociatedPhrases {
       let selectedValue = state.candidates[index]
-      handle(state: InputState.Committing(textToCommit: selectedValue))
+      handle(state: InputState.Committing(textToCommit: selectedValue.1))
       if mgrPrefs.associatedPhrasesEnabled,
         let associatePhrases = keyHandler.buildAssociatePhraseState(
-          withKey: selectedValue, isTypingVertical: state.isTypingVertical
+          withKey: selectedValue.1, isTypingVertical: state.isTypingVertical
         ), !associatePhrases.candidates.isEmpty
       {
         handle(state: associatePhrases)
diff --git a/Source/Modules/ControllerModules/ctlInputMethod_HandleDisplay.swift b/Source/Modules/ControllerModules/ctlInputMethod_HandleDisplay.swift
index fb1819a5..0f180a79 100644
--- a/Source/Modules/ControllerModules/ctlInputMethod_HandleDisplay.swift
+++ b/Source/Modules/ControllerModules/ctlInputMethod_HandleDisplay.swift
@@ -55,7 +55,7 @@ extension ctlInputMethod {
       return false
     }
     var isCandidateWindowVertical: Bool {
-      var candidates: [String] = []
+      var candidates: [(String, String)] = .init()
       if let state = state as? InputState.ChoosingCandidate {
         candidates = state.candidates
       } else if let state = state as? InputState.AssociatedPhrases {
@@ -63,13 +63,11 @@ extension ctlInputMethod {
       }
       if isTypingVertical { return true }
       // 以上是通用情形。接下來決定橫排輸入時是否使用縱排選字窗。
-      candidates.sort {
-        $0.count > $1.count
-      }
+      // 因為在拿候選字陣列時已經排序過了，所以這裡不用再多排序。
       // 測量每頁顯示候選字的累計總長度。如果太長的話就強制使用縱排候選字窗。
       // 範例：「屬實牛逼」（會有一大串各種各樣的「鼠食牛Beer」的 emoji）。
       let maxCandidatesPerPage = mgrPrefs.candidateKeys.count
-      let firstPageCandidates = candidates[0..<min(maxCandidatesPerPage, candidates.count)]
+      let firstPageCandidates = candidates[0..<min(maxCandidatesPerPage, candidates.count)].map(\.1)
       return firstPageCandidates.joined().count > Int(round(Double(maxCandidatesPerPage) * 1.8))
       // 上面這句如果是 true 的話，就會是縱排；反之則為橫排。
     }
diff --git a/Source/UI/CandidateUI/ctlCandidate.swift b/Source/UI/CandidateUI/ctlCandidate.swift
index 29e06964..4142aff0 100644
--- a/Source/UI/CandidateUI/ctlCandidate.swift
+++ b/Source/UI/CandidateUI/ctlCandidate.swift
@@ -40,7 +40,7 @@ public class CandidateKeyLabel: NSObject {
 public protocol ctlCandidateDelegate: AnyObject {
   func candidateCountForController(_ controller: ctlCandidate) -> Int
   func ctlCandidate(_ controller: ctlCandidate, candidateAtIndex index: Int)
-    -> String
+    -> (String, String)
   func ctlCandidate(
     _ controller: ctlCandidate, didSelectCandidateAtIndex index: Int
   )
diff --git a/Source/UI/CandidateUI/ctlCandidateUniversal.swift b/Source/UI/CandidateUI/ctlCandidateUniversal.swift
index 967bf988..2fc4dd31 100644
--- a/Source/UI/CandidateUI/ctlCandidateUniversal.swift
+++ b/Source/UI/CandidateUI/ctlCandidateUniversal.swift
@@ -559,7 +559,7 @@ extension ctlCandidateUniversal {
     }
 
     candidateView.set(keyLabelFont: keyLabelFont, candidateFont: candidateFont)
-    var candidates = [String]()
+    var candidates = [(String, String)]()
     let count = delegate.candidateCountForController(self)
     let keyLabelCount = keyLabels.count
 
@@ -569,7 +569,7 @@ extension ctlCandidateUniversal {
       candidates.append(candidate)
     }
     candidateView.set(
-      keyLabels: keyLabels.map(\.displayedText), displayedCandidates: candidates
+      keyLabels: keyLabels.map(\.displayedText), displayedCandidates: candidates.map(\.1)
     )
     var newSize = candidateView.sizeForView
     var frameRect = candidateView.frame
diff --git a/vChewingTests/KeyHandlerTestsNormalCHS.swift b/vChewingTests/KeyHandlerTestsNormalCHS.swift
index dd334d45..15e48e11 100644
--- a/vChewingTests/KeyHandlerTestsNormalCHS.swift
+++ b/vChewingTests/KeyHandlerTestsNormalCHS.swift
@@ -365,7 +365,7 @@ class KeyHandlerTestsNormalCHS: XCTestCase {
 
     XCTAssertTrue(state is InputState.ChoosingCandidate, "\(state)")
     if let state = state as? InputState.ChoosingCandidate {
-      XCTAssertTrue(state.candidates.contains("！"))
+      XCTAssertTrue(state.candidates.map(\.1).contains("！"))
     }
     mgrPrefs.halfWidthPunctuationEnabled = enabled
   }
@@ -993,7 +993,7 @@ class KeyHandlerTestsNormalCHS: XCTestCase {
       XCTAssertEqual(state.composingBuffer, "你")
       XCTAssertEqual(state.cursorIndex, 1)
       let candidates = state.candidates
-      XCTAssertTrue(candidates.contains("你"))
+      XCTAssertTrue(candidates.map(\.1).contains("你"))
     }
   }
 
@@ -1030,7 +1030,7 @@ class KeyHandlerTestsNormalCHS: XCTestCase {
       XCTAssertEqual(state.composingBuffer, "你")
       XCTAssertEqual(state.cursorIndex, 1)
       let candidates = state.candidates
-      XCTAssertTrue(candidates.contains("你"))
+      XCTAssertTrue(candidates.map(\.1).contains("你"))
     }
     mgrPrefs.chooseCandidateUsingSpace = enabled
   }
diff --git a/vChewingTests/KeyHandlerTestsSCPCCHT.swift b/vChewingTests/KeyHandlerTestsSCPCCHT.swift
index c8036823..25cb3747 100644
--- a/vChewingTests/KeyHandlerTestsSCPCCHT.swift
+++ b/vChewingTests/KeyHandlerTestsSCPCCHT.swift
@@ -85,7 +85,7 @@ class KeyHandlerTestsSCPCCHT: XCTestCase {
 
     XCTAssertTrue(state is InputState.ChoosingCandidate, "\(state)")
     if let state = state as? InputState.ChoosingCandidate {
-      XCTAssertTrue(state.candidates.contains("，"))
+      XCTAssertTrue(state.candidates.map(\.1).contains("，"))
     }
   }
 
@@ -238,7 +238,7 @@ class KeyHandlerTestsSCPCCHT: XCTestCase {
 
     XCTAssertTrue(state is InputState.ChoosingCandidate, "\(state)")
     if let state = state as? InputState.ChoosingCandidate {
-      XCTAssertTrue(state.candidates.contains("你"))
+      XCTAssertTrue(state.candidates.map(\.1).contains("你"))
     }
   }
 
@@ -315,7 +315,7 @@ class KeyHandlerTestsSCPCCHT: XCTestCase {
     print("\(state)")
     // XCTAssertTrue(state is InputState.AssociatedPhrases, "\(state)")
     // if let state = state as? InputState.AssociatedPhrases {
-    // XCTAssertTrue(state.candidates.contains("百五"))
+    // XCTAssertTrue(state.candidates.map(\.1).contains("百五"))
     // }
     mgrPrefs.associatedPhrasesEnabled = enabled
   }

From b825f8a6b2d457e53ff3958ce7ba586171fd6a57 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Tue, 12 Jul 2022 10:31:51 +0800
Subject: [PATCH 12/20] mgrLM // Always put UOM data in default data folder.

---
 .../LangModelRelated/mgrLangModel.swift       | 23 ++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/Source/Modules/LangModelRelated/mgrLangModel.swift b/Source/Modules/LangModelRelated/mgrLangModel.swift
index 7afa7aa8..83ded43d 100644
--- a/Source/Modules/LangModelRelated/mgrLangModel.swift
+++ b/Source/Modules/LangModelRelated/mgrLangModel.swift
@@ -224,39 +224,60 @@ enum mgrLangModel {
 
   // Swift 的 appendingPathComponent 需要藉由 URL 完成，最後再用 .path 轉為路徑。
 
+  /// 使用者語彙辭典資料路徑。
+  /// - Parameter mode: 簡繁體輸入模式。
+  /// - Returns: 資料路徑（URL）。
   static func userPhrasesDataURL(_ mode: InputMode) -> URL {
     let fileName = (mode == InputMode.imeModeCHT) ? "userdata-cht.txt" : "userdata-chs.txt"
     return URL(fileURLWithPath: dataFolderPath(isDefaultFolder: false)).appendingPathComponent(fileName)
   }
 
+  /// 使用者繪文字符號辭典資料路徑。
+  /// - Parameter mode: 簡繁體輸入模式。
+  /// - Returns: 資料路徑（URL）。
   static func userSymbolDataURL(_ mode: InputMode) -> URL {
     let fileName = (mode == InputMode.imeModeCHT) ? "usersymbolphrases-cht.txt" : "usersymbolphrases-chs.txt"
     return URL(fileURLWithPath: dataFolderPath(isDefaultFolder: false)).appendingPathComponent(fileName)
   }
 
+  /// 使用者聯想詞資料路徑。
+  /// - Parameter mode: 簡繁體輸入模式。
+  /// - Returns: 資料路徑（URL）。
   static func userAssociatesDataURL(_ mode: InputMode) -> URL {
     let fileName = (mode == InputMode.imeModeCHT) ? "associatedPhrases-cht.txt" : "associatedPhrases-chs.txt"
     return URL(fileURLWithPath: dataFolderPath(isDefaultFolder: false)).appendingPathComponent(fileName)
   }
 
+  /// 使用者語彙濾除表資料路徑。
+  /// - Parameter mode: 簡繁體輸入模式。
+  /// - Returns: 資料路徑（URL）。
   static func userFilteredDataURL(_ mode: InputMode) -> URL {
     let fileName = (mode == InputMode.imeModeCHT) ? "exclude-phrases-cht.txt" : "exclude-phrases-chs.txt"
     return URL(fileURLWithPath: dataFolderPath(isDefaultFolder: false)).appendingPathComponent(fileName)
   }
 
+  /// 使用者語彙置換表資料路徑。
+  /// - Parameter mode: 簡繁體輸入模式。
+  /// - Returns: 資料路徑（URL）。
   static func userReplacementsDataURL(_ mode: InputMode) -> URL {
     let fileName = (mode == InputMode.imeModeCHT) ? "phrases-replacement-cht.txt" : "phrases-replacement-chs.txt"
     return URL(fileURLWithPath: dataFolderPath(isDefaultFolder: false)).appendingPathComponent(fileName)
   }
 
+  /// 使用者波浪符號選單資料路徑。
+  /// - Returns: 資料路徑（URL）。
   static func userSymbolNodeDataURL() -> URL {
     let fileName = "symbols.dat"
     return URL(fileURLWithPath: dataFolderPath(isDefaultFolder: false)).appendingPathComponent(fileName)
   }
 
+  /// 使用者半衰記憶模組資料的存取頻次特別高，且資料新陳代謝速度快，所以只適合放在預設的使用者資料目錄下。
+  /// 也就是「~/Library/Application Support/vChewing/」目錄下，且不會隨著使用者辭典目錄的改變而改變。
+  /// - Parameter mode: 簡繁體輸入模式。
+  /// - Returns: 資料路徑（URL）。
   static func userOverrideModelDataURL(_ mode: InputMode) -> URL {
     let fileName = (mode == InputMode.imeModeCHT) ? "override-model-data-cht.dat" : "override-model-data-chs.dat"
-    return URL(fileURLWithPath: dataFolderPath(isDefaultFolder: false)).appendingPathComponent(fileName)
+    return URL(fileURLWithPath: dataFolderPath(isDefaultFolder: true)).appendingPathComponent(fileName)
   }
 
   // MARK: - 檢查具體的使用者語彙檔案是否存在

From 5b5e8157b31ba2a3117629ac1feb16f190ecc102 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Tue, 12 Jul 2022 11:11:15 +0800
Subject: [PATCH 13/20] UOM // +clearData().

---
 .../LangModelRelated/SubLMs/lmUserOverride.swift     | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/Source/Modules/LangModelRelated/SubLMs/lmUserOverride.swift b/Source/Modules/LangModelRelated/SubLMs/lmUserOverride.swift
index c5f3b96a..e08003e4 100644
--- a/Source/Modules/LangModelRelated/SubLMs/lmUserOverride.swift
+++ b/Source/Modules/LangModelRelated/SubLMs/lmUserOverride.swift
@@ -286,6 +286,18 @@ extension vChewing.LMUserOverride {
     }
   }
 
+  public func clearData(withURL fileURL: URL) {
+    mutLRUMap = .init()
+    mutLRUList = .init()
+    do {
+      let nullData = "{}"
+      try nullData.write(to: fileURL, atomically: false, encoding: .utf8)
+    } catch {
+      IME.prtDebugIntel("UOM Error: Unable to clear data. Details: \(error)")
+      return
+    }
+  }
+
   public func saveData(toURL fileURL: URL) {
     let encoder = JSONEncoder()
     do {

From 0a5efc3ac91643d5acf8ca27f39ca9812c82f9a5 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Tue, 12 Jul 2022 11:18:39 +0800
Subject: [PATCH 14/20] mgrLM // +clearUserOverrideModelData().

---
 Source/Modules/LangModelRelated/mgrLangModel.swift | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Source/Modules/LangModelRelated/mgrLangModel.swift b/Source/Modules/LangModelRelated/mgrLangModel.swift
index 83ded43d..711f2b45 100644
--- a/Source/Modules/LangModelRelated/mgrLangModel.swift
+++ b/Source/Modules/LangModelRelated/mgrLangModel.swift
@@ -484,4 +484,15 @@ enum mgrLangModel {
         break
     }
   }
+
+  static func clearUserOverrideModelData(_ mode: InputMode = .imeModeNULL) {
+    switch mode {
+      case .imeModeCHS:
+        gUserOverrideModelCHS.clearData(withURL: userOverrideModelDataURL(InputMode.imeModeCHS))
+      case .imeModeCHT:
+        gUserOverrideModelCHT.clearData(withURL: userOverrideModelDataURL(InputMode.imeModeCHT))
+      case .imeModeNULL:
+        break
+    }
+  }
 }

From dfb1a5dd99414d5c4e485202ac3b781d331bf61a Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Tue, 12 Jul 2022 11:18:54 +0800
Subject: [PATCH 15/20] ctlIME_Menu // +clearUOM().

---
 .../ControllerModules/ctlInputMethod_Menu.swift       | 11 +++++++++++
 Source/Resources/Base.lproj/Localizable.strings       |  1 +
 Source/Resources/en.lproj/Localizable.strings         |  1 +
 Source/Resources/ja.lproj/Localizable.strings         |  1 +
 Source/Resources/zh-Hans.lproj/Localizable.strings    |  1 +
 Source/Resources/zh-Hant.lproj/Localizable.strings    |  1 +
 6 files changed, 16 insertions(+)

diff --git a/Source/Modules/ControllerModules/ctlInputMethod_Menu.swift b/Source/Modules/ControllerModules/ctlInputMethod_Menu.swift
index d1bfd7cf..3c1727e1 100644
--- a/Source/Modules/ControllerModules/ctlInputMethod_Menu.swift
+++ b/Source/Modules/ControllerModules/ctlInputMethod_Menu.swift
@@ -143,6 +143,10 @@ extension ctlInputMethod {
       withTitle: NSLocalizedString("Optimize Memorized Phrases", comment: ""),
       action: #selector(removeUnigramsFromUOM(_:)), keyEquivalent: ""
     )
+    menu.addItem(
+      withTitle: NSLocalizedString("Clear Memorized Phrases", comment: ""),
+      action: #selector(clearUOM(_:)), keyEquivalent: ""
+    )
 
     menu.addItem(NSMenuItem.separator())  // ---------------------
 
@@ -362,6 +366,13 @@ extension ctlInputMethod {
     }
   }
 
+  @objc func clearUOM(_: Any?) {
+    mgrLangModel.clearUserOverrideModelData(IME.getInputMode())
+    if NSEvent.modifierFlags.contains(.option) {
+      mgrLangModel.clearUserOverrideModelData(IME.getInputMode(isReversed: true))
+    }
+  }
+
   @objc func showAbout(_: Any?) {
     (NSApp.delegate as? AppDelegate)?.showAbout()
     NSApp.activate(ignoringOtherApps: true)
diff --git a/Source/Resources/Base.lproj/Localizable.strings b/Source/Resources/Base.lproj/Localizable.strings
index c4faf713..e8ca421a 100644
--- a/Source/Resources/Base.lproj/Localizable.strings
+++ b/Source/Resources/Base.lproj/Localizable.strings
@@ -63,6 +63,7 @@
 "Loading CHT Core Dict..." = "Loading CHT Core Dict...";
 "Core Dict loading complete." = "Core Dict loading complete.";
 "Optimize Memorized Phrases" = "Optimize Memorized Phrases";
+"Clear Memorized Phrases" = "Clear Memorized Phrases";
 
 // The followings are the category names used in the Symbol menu.
 "catCommonSymbols" = "CommonSymbols";
diff --git a/Source/Resources/en.lproj/Localizable.strings b/Source/Resources/en.lproj/Localizable.strings
index c4faf713..e8ca421a 100644
--- a/Source/Resources/en.lproj/Localizable.strings
+++ b/Source/Resources/en.lproj/Localizable.strings
@@ -63,6 +63,7 @@
 "Loading CHT Core Dict..." = "Loading CHT Core Dict...";
 "Core Dict loading complete." = "Core Dict loading complete.";
 "Optimize Memorized Phrases" = "Optimize Memorized Phrases";
+"Clear Memorized Phrases" = "Clear Memorized Phrases";
 
 // The followings are the category names used in the Symbol menu.
 "catCommonSymbols" = "CommonSymbols";
diff --git a/Source/Resources/ja.lproj/Localizable.strings b/Source/Resources/ja.lproj/Localizable.strings
index 79a8751b..60618e9b 100644
--- a/Source/Resources/ja.lproj/Localizable.strings
+++ b/Source/Resources/ja.lproj/Localizable.strings
@@ -63,6 +63,7 @@
 "Loading CHT Core Dict..." = "繁体中国語核心辞書読込中…";
 "Core Dict loading complete." = "核心辞書読込完了";
 "Optimize Memorized Phrases" = "臨時記憶資料を整う";
+"Clear Memorized Phrases" = "臨時記憶資料を削除";
 
 // The followings are the category names used in the Symbol menu.
 "catCommonSymbols" = "常用";
diff --git a/Source/Resources/zh-Hans.lproj/Localizable.strings b/Source/Resources/zh-Hans.lproj/Localizable.strings
index 8cb3ee1f..a5ccdf70 100644
--- a/Source/Resources/zh-Hans.lproj/Localizable.strings
+++ b/Source/Resources/zh-Hans.lproj/Localizable.strings
@@ -63,6 +63,7 @@
 "Loading CHT Core Dict..." = "载入繁体中文核心辞典…";
 "Core Dict loading complete." = "核心辞典载入完毕";
 "Optimize Memorized Phrases" = "精简临时记忆语汇资料";
+"Clear Memorized Phrases" = "清除临时记忆语汇资料";
 
 // The followings are the category names used in the Symbol menu.
 "catCommonSymbols" = "常用";
diff --git a/Source/Resources/zh-Hant.lproj/Localizable.strings b/Source/Resources/zh-Hant.lproj/Localizable.strings
index 2f13703c..733e49fa 100644
--- a/Source/Resources/zh-Hant.lproj/Localizable.strings
+++ b/Source/Resources/zh-Hant.lproj/Localizable.strings
@@ -63,6 +63,7 @@
 "Loading CHT Core Dict..." = "載入繁體中文核心辭典…";
 "Core Dict loading complete." = "核心辭典載入完畢";
 "Optimize Memorized Phrases" = "精簡臨時記憶語彙資料";
+"Clear Memorized Phrases" = "清除臨時記憶語彙資料";
 
 // The followings are the category names used in the Symbol menu.
 "catCommonSymbols" = "常用";

From f47824292e33b1d89ef7c610d7236106b0905338 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Tue, 12 Jul 2022 12:08:27 +0800
Subject: [PATCH 16/20] KeyHandler // Optimize punctuationNamePrefix.

---
 .../ControllerModules/KeyHandler_Core.swift      | 15 +++++++++++++++
 .../KeyHandler_HandleCandidate.swift             | 16 +---------------
 .../KeyHandler_HandleInput.swift                 | 15 +--------------
 3 files changed, 17 insertions(+), 29 deletions(-)

diff --git a/Source/Modules/ControllerModules/KeyHandler_Core.swift b/Source/Modules/ControllerModules/KeyHandler_Core.swift
index 51cd3e51..50af2fc9 100644
--- a/Source/Modules/ControllerModules/KeyHandler_Core.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_Core.swift
@@ -413,4 +413,19 @@ class KeyHandler {
     }
     return min(nextPosition, compositorLength)
   }
+
+  /// 生成標點符號索引鍵。
+  /// - Parameter input: 輸入的按鍵訊號。
+  /// - Returns: 生成的標點符號索引鍵。
+  func generatePunctuationNamePrefix(withKeyCondition input: InputSignal) -> String {
+    if mgrPrefs.halfWidthPunctuationEnabled {
+      return "_half_punctuation_"
+    }
+    switch (input.isControlHold, input.isOptionHold) {
+      case (true, true): return "_alt_ctrl_punctuation_"
+      case (true, false): return "_ctrl_punctuation_"
+      case (false, true): return "_alt_punctuation_"
+      case (false, false): return "_punctuation_"
+    }
+  }
 }
diff --git a/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift b/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift
index 5a91344f..5c4ad2db 100644
--- a/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift
@@ -334,22 +334,8 @@ extension KeyHandler {
       /// - 是否是針對當前注音排列/拼音輸入種類專門提供的標點符號。
       /// - 是否是需要摁修飾鍵才可以輸入的那種標點符號。
 
-      var punctuationNamePrefix = ""
-
-      if input.isOptionHold && !input.isControlHold {
-        punctuationNamePrefix = "_alt_punctuation_"
-      } else if input.isControlHold && !input.isOptionHold {
-        punctuationNamePrefix = "_ctrl_punctuation_"
-      } else if input.isControlHold && input.isOptionHold {
-        punctuationNamePrefix = "_alt_ctrl_punctuation_"
-      } else if mgrPrefs.halfWidthPunctuationEnabled {
-        punctuationNamePrefix = "_half_punctuation_"
-      } else {
-        punctuationNamePrefix = "_punctuation_"
-      }
-
+      let punctuationNamePrefix: String = generatePunctuationNamePrefix(withKeyCondition: input)
       let parser = currentMandarinParser
-
       let arrCustomPunctuations: [String] = [
         punctuationNamePrefix, parser, String(format: "%c", CChar(charCode)),
       ]
diff --git a/Source/Modules/ControllerModules/KeyHandler_HandleInput.swift b/Source/Modules/ControllerModules/KeyHandler_HandleInput.swift
index f07cac76..b984167d 100644
--- a/Source/Modules/ControllerModules/KeyHandler_HandleInput.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_HandleInput.swift
@@ -414,20 +414,7 @@ extension KeyHandler {
     /// - 是否是針對當前注音排列/拼音輸入種類專門提供的標點符號。
     /// - 是否是需要摁修飾鍵才可以輸入的那種標點符號。
 
-    var punctuationNamePrefix = ""
-
-    if input.isOptionHold && !input.isControlHold {
-      punctuationNamePrefix = "_alt_punctuation_"
-    } else if input.isControlHold && !input.isOptionHold {
-      punctuationNamePrefix = "_ctrl_punctuation_"
-    } else if input.isControlHold && input.isOptionHold {
-      punctuationNamePrefix = "_alt_ctrl_punctuation_"
-    } else if mgrPrefs.halfWidthPunctuationEnabled {
-      punctuationNamePrefix = "_half_punctuation_"
-    } else {
-      punctuationNamePrefix = "_punctuation_"
-    }
-
+    let punctuationNamePrefix: String = generatePunctuationNamePrefix(withKeyCondition: input)
     let parser = currentMandarinParser
     let arrCustomPunctuations: [String] = [
       punctuationNamePrefix, parser, String(format: "%c", CChar(charCode)),

From 0f38a5ed903d1754e1ba330654ec11cc4d517e86 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Tue, 12 Jul 2022 21:22:57 +0800
Subject: [PATCH 17/20] KeyHandler // Enable Ctrl+Alt+Fwd/Bwd for cursor
 handling.

---
 Source/Modules/ControllerModules/KeyHandler_States.swift | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/Source/Modules/ControllerModules/KeyHandler_States.swift b/Source/Modules/ControllerModules/KeyHandler_States.swift
index 73132538..1c416d92 100644
--- a/Source/Modules/ControllerModules/KeyHandler_States.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_States.swift
@@ -662,6 +662,9 @@ extension KeyHandler {
         stateCallback(state)
       }
     } else if input.isOptionHold {
+      if input.isControlHold {
+        return handleEnd(state: state, stateCallback: stateCallback, errorCallback: errorCallback)
+      }
       // 游標跳轉動作無論怎樣都會執行，但如果出了執行失敗的結果的話則觸發報錯流程。
       if !compositor.jumpCursorBySpan(to: .front) {
         IME.prtDebugIntel("33C3B580")
@@ -727,6 +730,9 @@ extension KeyHandler {
         stateCallback(state)
       }
     } else if input.isOptionHold {
+      if input.isControlHold {
+        return handleHome(state: state, stateCallback: stateCallback, errorCallback: errorCallback)
+      }
       // 游標跳轉動作無論怎樣都會執行，但如果出了執行失敗的結果的話則觸發報錯流程。
       if !compositor.jumpCursorBySpan(to: .rear) {
         IME.prtDebugIntel("8D50DD9E")

From 09cf014dcaea949f9c72efb90634019c1af226ca Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Tue, 12 Jul 2022 11:59:07 +0800
Subject: [PATCH 18/20] Update Data - 20220712

---
 Source/Data | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Source/Data b/Source/Data
index 9301650c..50250d97 160000
--- a/Source/Data
+++ b/Source/Data
@@ -1 +1 @@
-Subproject commit 9301650c6e27b31730e4f060f94c4cab0a28579c
+Subproject commit 50250d970a3481ec7653a71120413708a76224d8

From 66f37fbb438a7402a195f4e2e87a4f4e95a8c3c2 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Tue, 12 Jul 2022 23:25:26 +0800
Subject: [PATCH 19/20] Repo // Remove useless do{} wrappers.

---
 .../KeyHandler_HandleCandidate.swift          |  64 ++---
 .../ControllerModules/KeyHandler_States.swift |   6 +-
 Source/Modules/main.swift                     |  30 +-
 .../CandidateUI/ctlCandidateUniversal.swift   | 272 +++++++++---------
 4 files changed, 170 insertions(+), 202 deletions(-)

diff --git a/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift b/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift
index 5c4ad2db..b3544270 100644
--- a/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift
@@ -154,18 +154,14 @@ extension KeyHandler {
     if input.isLeft {
       switch ctlCandidateCurrent.currentLayout {
         case .horizontal:
-          do {
-            if !ctlCandidateCurrent.highlightPreviousCandidate() {
-              IME.prtDebugIntel("1145148D")
-              errorCallback()
-            }
+          if !ctlCandidateCurrent.highlightPreviousCandidate() {
+            IME.prtDebugIntel("1145148D")
+            errorCallback()
           }
         case .vertical:
-          do {
-            if !ctlCandidateCurrent.showPreviousPage() {
-              IME.prtDebugIntel("1919810D")
-              errorCallback()
-            }
+          if !ctlCandidateCurrent.showPreviousPage() {
+            IME.prtDebugIntel("1919810D")
+            errorCallback()
           }
       }
       return true
@@ -187,18 +183,14 @@ extension KeyHandler {
     if input.isRight {
       switch ctlCandidateCurrent.currentLayout {
         case .horizontal:
-          do {
-            if !ctlCandidateCurrent.highlightNextCandidate() {
-              IME.prtDebugIntel("9B65138D")
-              errorCallback()
-            }
+          if !ctlCandidateCurrent.highlightNextCandidate() {
+            IME.prtDebugIntel("9B65138D")
+            errorCallback()
           }
         case .vertical:
-          do {
-            if !ctlCandidateCurrent.showNextPage() {
-              IME.prtDebugIntel("9244908D")
-              errorCallback()
-            }
+          if !ctlCandidateCurrent.showNextPage() {
+            IME.prtDebugIntel("9244908D")
+            errorCallback()
           }
       }
       return true
@@ -220,18 +212,14 @@ extension KeyHandler {
     if input.isUp {
       switch ctlCandidateCurrent.currentLayout {
         case .horizontal:
-          do {
-            if !ctlCandidateCurrent.showPreviousPage() {
-              IME.prtDebugIntel("9B614524")
-              errorCallback()
-            }
+          if !ctlCandidateCurrent.showPreviousPage() {
+            IME.prtDebugIntel("9B614524")
+            errorCallback()
           }
         case .vertical:
-          do {
-            if !ctlCandidateCurrent.highlightPreviousCandidate() {
-              IME.prtDebugIntel("ASD9908D")
-              errorCallback()
-            }
+          if !ctlCandidateCurrent.highlightPreviousCandidate() {
+            IME.prtDebugIntel("ASD9908D")
+            errorCallback()
           }
       }
       return true
@@ -242,18 +230,14 @@ extension KeyHandler {
     if input.isDown {
       switch ctlCandidateCurrent.currentLayout {
         case .horizontal:
-          do {
-            if !ctlCandidateCurrent.showNextPage() {
-              IME.prtDebugIntel("92B990DD")
-              errorCallback()
-            }
+          if !ctlCandidateCurrent.showNextPage() {
+            IME.prtDebugIntel("92B990DD")
+            errorCallback()
           }
         case .vertical:
-          do {
-            if !ctlCandidateCurrent.highlightNextCandidate() {
-              IME.prtDebugIntel("6B99908D")
-              errorCallback()
-            }
+          if !ctlCandidateCurrent.highlightNextCandidate() {
+            IME.prtDebugIntel("6B99908D")
+            errorCallback()
           }
       }
       return true
diff --git a/Source/Modules/ControllerModules/KeyHandler_States.swift b/Source/Modules/ControllerModules/KeyHandler_States.swift
index 1c416d92..40e2a73d 100644
--- a/Source/Modules/ControllerModules/KeyHandler_States.swift
+++ b/Source/Modules/ControllerModules/KeyHandler_States.swift
@@ -81,10 +81,8 @@ extension KeyHandler {
               case 0:
                 tooltipParameterRef[1] = compositor.readings[compositorCursorIndex]
               default:
-                do {
-                  tooltipParameterRef[0] = compositor.readings[compositorCursorIndex - 1]
-                  tooltipParameterRef[1] = compositor.readings[compositorCursorIndex]
-                }
+                tooltipParameterRef[0] = compositor.readings[compositorCursorIndex - 1]
+                tooltipParameterRef[1] = compositor.readings[compositorCursorIndex]
             }
             /// 注音轉拼音
             for (i, _) in tooltipParameterRef.enumerated() {
diff --git a/Source/Modules/main.swift b/Source/Modules/main.swift
index e6a3a8b8..ec01b966 100644
--- a/Source/Modules/main.swift
+++ b/Source/Modules/main.swift
@@ -32,24 +32,18 @@ let kConnectionName = "vChewing_1_Connection"
 switch max(CommandLine.arguments.count - 1, 0) {
   case 0: break
   case 1, 2:
-    do {
-      switch CommandLine.arguments[1] {
-        case "install":
-          do {
-            if CommandLine.arguments[1] == "install" {
-              let exitCode = IME.registerInputMethod()
-              exit(exitCode)
-            }
-          }
-        case "uninstall":
-          do {
-            if CommandLine.arguments[1] == "uninstall" {
-              let exitCode = IME.uninstall(isSudo: IME.isSudoMode)
-              exit(exitCode)
-            }
-          }
-        default: break
-      }
+    switch CommandLine.arguments[1] {
+      case "install":
+        if CommandLine.arguments[1] == "install" {
+          let exitCode = IME.registerInputMethod()
+          exit(exitCode)
+        }
+      case "uninstall":
+        if CommandLine.arguments[1] == "uninstall" {
+          let exitCode = IME.uninstall(isSudo: IME.isSudoMode)
+          exit(exitCode)
+        }
+      default: break
     }
     exit(0)
   default: exit(0)
diff --git a/Source/UI/CandidateUI/ctlCandidateUniversal.swift b/Source/UI/CandidateUI/ctlCandidateUniversal.swift
index 2fc4dd31..5663fcc8 100644
--- a/Source/UI/CandidateUI/ctlCandidateUniversal.swift
+++ b/Source/UI/CandidateUI/ctlCandidateUniversal.swift
@@ -162,146 +162,142 @@ private class vwrCandidateUniversal: NSView {
 
     switch isVerticalLayout {
       case true:
-        do {
-          var accuHeight: CGFloat = 0
-          for (index, elementHeight) in elementHeights.enumerated() {
-            let currentHeight = elementHeight
-            let rctCandidateArea = NSRect(
-              x: 0.0, y: accuHeight, width: windowWidth, height: candidateTextHeight + cellPadding
-            )
-            let rctLabel = NSRect(
-              x: cellPadding / 2 - 1, y: accuHeight + cellPadding / 2, width: keyLabelWidth,
-              height: keyLabelHeight * 2.0
-            )
-            let rctCandidatePhrase = NSRect(
-              x: cellPadding / 2 - 1 + keyLabelWidth, y: accuHeight + cellPadding / 2 - 1,
-              width: windowWidth - keyLabelWidth, height: candidateTextHeight
-            )
+        var accuHeight: CGFloat = 0
+        for (index, elementHeight) in elementHeights.enumerated() {
+          let currentHeight = elementHeight
+          let rctCandidateArea = NSRect(
+            x: 0.0, y: accuHeight, width: windowWidth, height: candidateTextHeight + cellPadding
+          )
+          let rctLabel = NSRect(
+            x: cellPadding / 2 - 1, y: accuHeight + cellPadding / 2, width: keyLabelWidth,
+            height: keyLabelHeight * 2.0
+          )
+          let rctCandidatePhrase = NSRect(
+            x: cellPadding / 2 - 1 + keyLabelWidth, y: accuHeight + cellPadding / 2 - 1,
+            width: windowWidth - keyLabelWidth, height: candidateTextHeight
+          )
 
-            var activeCandidateIndexAttr = keyLabelAttrDict
-            var activeCandidateAttr = candidateAttrDict
-            if index == highlightedIndex {
-              let colorBlendAmount: CGFloat = IME.isDarkMode() ? 0.25 : 0
-              // The background color of the highlightened candidate
-              switch IME.currentInputMode {
-                case InputMode.imeModeCHS:
-                  NSColor.systemRed.blended(
-                    withFraction: colorBlendAmount,
-                    of: NSColor.controlBackgroundColor
-                  )!
-                  .setFill()
-                case InputMode.imeModeCHT:
-                  NSColor.systemBlue.blended(
-                    withFraction: colorBlendAmount,
-                    of: NSColor.controlBackgroundColor
-                  )!
-                  .setFill()
-                default:
-                  NSColor.alternateSelectedControlColor.setFill()
-              }
-              // Highlightened index text color
-              activeCandidateIndexAttr[.foregroundColor] = NSColor.selectedMenuItemTextColor
-                .withAlphaComponent(0.84)
-              // Highlightened phrase text color
-              activeCandidateAttr[.foregroundColor] = NSColor.selectedMenuItemTextColor
-            } else {
-              NSColor.controlBackgroundColor.setFill()
-            }
+          var activeCandidateIndexAttr = keyLabelAttrDict
+          var activeCandidateAttr = candidateAttrDict
+          if index == highlightedIndex {
+            let colorBlendAmount: CGFloat = IME.isDarkMode() ? 0.25 : 0
+            // The background color of the highlightened candidate
             switch IME.currentInputMode {
               case InputMode.imeModeCHS:
-                if #available(macOS 12.0, *) {
-                  activeCandidateAttr[.languageIdentifier] = "zh-Hans" as AnyObject
-                }
+                NSColor.systemRed.blended(
+                  withFraction: colorBlendAmount,
+                  of: NSColor.controlBackgroundColor
+                )!
+                .setFill()
               case InputMode.imeModeCHT:
-                if #available(macOS 12.0, *) {
-                  activeCandidateAttr[.languageIdentifier] =
-                    (mgrPrefs.shiftJISShinjitaiOutputEnabled || mgrPrefs.chineseConversionEnabled)
-                    ? "ja" as AnyObject : "zh-Hant" as AnyObject
-                }
+                NSColor.systemBlue.blended(
+                  withFraction: colorBlendAmount,
+                  of: NSColor.controlBackgroundColor
+                )!
+                .setFill()
               default:
-                break
+                NSColor.alternateSelectedControlColor.setFill()
             }
-            NSBezierPath.fill(rctCandidateArea)
-            (keyLabels[index] as NSString).draw(
-              in: rctLabel, withAttributes: activeCandidateIndexAttr
-            )
-            (displayedCandidates[index] as NSString).draw(
-              in: rctCandidatePhrase, withAttributes: activeCandidateAttr
-            )
-            accuHeight += currentHeight
+            // Highlightened index text color
+            activeCandidateIndexAttr[.foregroundColor] = NSColor.selectedMenuItemTextColor
+              .withAlphaComponent(0.84)
+            // Highlightened phrase text color
+            activeCandidateAttr[.foregroundColor] = NSColor.selectedMenuItemTextColor
+          } else {
+            NSColor.controlBackgroundColor.setFill()
           }
+          switch IME.currentInputMode {
+            case InputMode.imeModeCHS:
+              if #available(macOS 12.0, *) {
+                activeCandidateAttr[.languageIdentifier] = "zh-Hans" as AnyObject
+              }
+            case InputMode.imeModeCHT:
+              if #available(macOS 12.0, *) {
+                activeCandidateAttr[.languageIdentifier] =
+                  (mgrPrefs.shiftJISShinjitaiOutputEnabled || mgrPrefs.chineseConversionEnabled)
+                  ? "ja" as AnyObject : "zh-Hant" as AnyObject
+              }
+            default:
+              break
+          }
+          NSBezierPath.fill(rctCandidateArea)
+          (keyLabels[index] as NSString).draw(
+            in: rctLabel, withAttributes: activeCandidateIndexAttr
+          )
+          (displayedCandidates[index] as NSString).draw(
+            in: rctCandidatePhrase, withAttributes: activeCandidateAttr
+          )
+          accuHeight += currentHeight
         }
       case false:
-        do {
-          var accuWidth: CGFloat = 0
-          for (index, elementWidth) in elementWidths.enumerated() {
-            let currentWidth = elementWidth
-            let rctCandidateArea = NSRect(
-              x: accuWidth, y: 0.0, width: currentWidth + 1.0,
-              height: candidateTextHeight + cellPadding
-            )
-            let rctLabel = NSRect(
-              x: accuWidth + cellPadding / 2 - 1, y: cellPadding / 2, width: keyLabelWidth,
-              height: keyLabelHeight * 2.0
-            )
-            let rctCandidatePhrase = NSRect(
-              x: accuWidth + keyLabelWidth - 1, y: cellPadding / 2 - 1,
-              width: currentWidth - keyLabelWidth,
-              height: candidateTextHeight
-            )
+        var accuWidth: CGFloat = 0
+        for (index, elementWidth) in elementWidths.enumerated() {
+          let currentWidth = elementWidth
+          let rctCandidateArea = NSRect(
+            x: accuWidth, y: 0.0, width: currentWidth + 1.0,
+            height: candidateTextHeight + cellPadding
+          )
+          let rctLabel = NSRect(
+            x: accuWidth + cellPadding / 2 - 1, y: cellPadding / 2, width: keyLabelWidth,
+            height: keyLabelHeight * 2.0
+          )
+          let rctCandidatePhrase = NSRect(
+            x: accuWidth + keyLabelWidth - 1, y: cellPadding / 2 - 1,
+            width: currentWidth - keyLabelWidth,
+            height: candidateTextHeight
+          )
 
-            var activeCandidateIndexAttr = keyLabelAttrDict
-            var activeCandidateAttr = candidateAttrDict
-            if index == highlightedIndex {
-              let colorBlendAmount: CGFloat = IME.isDarkMode() ? 0.25 : 0
-              // The background color of the highlightened candidate
-              switch IME.currentInputMode {
-                case InputMode.imeModeCHS:
-                  NSColor.systemRed.blended(
-                    withFraction: colorBlendAmount,
-                    of: NSColor.controlBackgroundColor
-                  )!
-                  .setFill()
-                case InputMode.imeModeCHT:
-                  NSColor.systemBlue.blended(
-                    withFraction: colorBlendAmount,
-                    of: NSColor.controlBackgroundColor
-                  )!
-                  .setFill()
-                default:
-                  NSColor.alternateSelectedControlColor.setFill()
-              }
-              // Highlightened index text color
-              activeCandidateIndexAttr[.foregroundColor] = NSColor.selectedMenuItemTextColor
-                .withAlphaComponent(0.84)
-              // Highlightened phrase text color
-              activeCandidateAttr[.foregroundColor] = NSColor.selectedMenuItemTextColor
-            } else {
-              NSColor.controlBackgroundColor.setFill()
-            }
+          var activeCandidateIndexAttr = keyLabelAttrDict
+          var activeCandidateAttr = candidateAttrDict
+          if index == highlightedIndex {
+            let colorBlendAmount: CGFloat = IME.isDarkMode() ? 0.25 : 0
+            // The background color of the highlightened candidate
             switch IME.currentInputMode {
               case InputMode.imeModeCHS:
-                if #available(macOS 12.0, *) {
-                  activeCandidateAttr[.languageIdentifier] = "zh-Hans" as AnyObject
-                }
+                NSColor.systemRed.blended(
+                  withFraction: colorBlendAmount,
+                  of: NSColor.controlBackgroundColor
+                )!
+                .setFill()
               case InputMode.imeModeCHT:
-                if #available(macOS 12.0, *) {
-                  activeCandidateAttr[.languageIdentifier] =
-                    (mgrPrefs.shiftJISShinjitaiOutputEnabled || mgrPrefs.chineseConversionEnabled)
-                    ? "ja" as AnyObject : "zh-Hant" as AnyObject
-                }
+                NSColor.systemBlue.blended(
+                  withFraction: colorBlendAmount,
+                  of: NSColor.controlBackgroundColor
+                )!
+                .setFill()
               default:
-                break
+                NSColor.alternateSelectedControlColor.setFill()
             }
-            NSBezierPath.fill(rctCandidateArea)
-            (keyLabels[index] as NSString).draw(
-              in: rctLabel, withAttributes: activeCandidateIndexAttr
-            )
-            (displayedCandidates[index] as NSString).draw(
-              in: rctCandidatePhrase, withAttributes: activeCandidateAttr
-            )
-            accuWidth += currentWidth + 1.0
+            // Highlightened index text color
+            activeCandidateIndexAttr[.foregroundColor] = NSColor.selectedMenuItemTextColor
+              .withAlphaComponent(0.84)
+            // Highlightened phrase text color
+            activeCandidateAttr[.foregroundColor] = NSColor.selectedMenuItemTextColor
+          } else {
+            NSColor.controlBackgroundColor.setFill()
           }
+          switch IME.currentInputMode {
+            case InputMode.imeModeCHS:
+              if #available(macOS 12.0, *) {
+                activeCandidateAttr[.languageIdentifier] = "zh-Hans" as AnyObject
+              }
+            case InputMode.imeModeCHT:
+              if #available(macOS 12.0, *) {
+                activeCandidateAttr[.languageIdentifier] =
+                  (mgrPrefs.shiftJISShinjitaiOutputEnabled || mgrPrefs.chineseConversionEnabled)
+                  ? "ja" as AnyObject : "zh-Hant" as AnyObject
+              }
+            default:
+              break
+          }
+          NSBezierPath.fill(rctCandidateArea)
+          (keyLabels[index] as NSString).draw(
+            in: rctLabel, withAttributes: activeCandidateIndexAttr
+          )
+          (displayedCandidates[index] as NSString).draw(
+            in: rctCandidatePhrase, withAttributes: activeCandidateAttr
+          )
+          accuWidth += currentWidth + 1.0
         }
     }
   }
@@ -313,28 +309,24 @@ private class vwrCandidateUniversal: NSView {
     }
     switch isVerticalLayout {
       case true:
-        do {
-          var accuHeight: CGFloat = 0.0
-          for (index, elementHeight) in elementHeights.enumerated() {
-            let currentHeight = elementHeight
+        var accuHeight: CGFloat = 0.0
+        for (index, elementHeight) in elementHeights.enumerated() {
+          let currentHeight = elementHeight
 
-            if location.y >= accuHeight, location.y <= accuHeight + currentHeight {
-              return index
-            }
-            accuHeight += currentHeight
+          if location.y >= accuHeight, location.y <= accuHeight + currentHeight {
+            return index
           }
+          accuHeight += currentHeight
         }
       case false:
-        do {
-          var accuWidth: CGFloat = 0.0
-          for (index, elementWidth) in elementWidths.enumerated() {
-            let currentWidth = elementWidth
+        var accuWidth: CGFloat = 0.0
+        for (index, elementWidth) in elementWidths.enumerated() {
+          let currentWidth = elementWidth
 
-            if location.x >= accuWidth, location.x <= accuWidth + currentWidth {
-              return index
-            }
-            accuWidth += currentWidth + 1.0
+          if location.x >= accuWidth, location.x <= accuWidth + currentWidth {
+            return index
           }
+          accuWidth += currentWidth + 1.0
         }
     }
     return NSNotFound

From 4a313947fe21e12a4b038d3536ac2829821e6104 Mon Sep 17 00:00:00 2001
From: ShikiSuen <shikisuen@outlook.com>
Date: Tue, 12 Jul 2022 12:02:12 +0800
Subject: [PATCH 20/20] Bump version to 1.8.0 Build 1980

---
 Update-Info.plist                  |  4 ++--
 vChewing.pkgproj                   |  2 +-
 vChewing.xcodeproj/project.pbxproj | 32 +++++++++++++++---------------
 3 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/Update-Info.plist b/Update-Info.plist
index d22f2875..b25f421b 100644
--- a/Update-Info.plist
+++ b/Update-Info.plist
@@ -3,9 +3,9 @@
 <plist version="1.0">
 <dict>
 	<key>CFBundleShortVersionString</key>
-	<string>1.7.4</string>
+	<string>1.8.0</string>
 	<key>CFBundleVersion</key>
-	<string>1974</string>
+	<string>1980</string>
 	<key>UpdateInfoEndpoint</key>
 	<string>https://gitee.com/vchewing/vChewing-macOS/raw/main/Update-Info.plist</string>
 	<key>UpdateInfoSite</key>
diff --git a/vChewing.pkgproj b/vChewing.pkgproj
index 3a0ba424..810f13ff 100644
--- a/vChewing.pkgproj
+++ b/vChewing.pkgproj
@@ -726,7 +726,7 @@
 				<key>USE_HFS+_COMPRESSION</key>
 				<false/>
 				<key>VERSION</key>
-				<string>1.7.4</string>
+				<string>1.8.0</string>
 			</dict>
 			<key>TYPE</key>
 			<integer>0</integer>
diff --git a/vChewing.xcodeproj/project.pbxproj b/vChewing.xcodeproj/project.pbxproj
index d1a812e9..526ff0ff 100644
--- a/vChewing.xcodeproj/project.pbxproj
+++ b/vChewing.xcodeproj/project.pbxproj
@@ -1365,7 +1365,7 @@
 				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
 				CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 1974;
+				CURRENT_PROJECT_VERSION = 1980;
 				GCC_C_LANGUAGE_STANDARD = gnu11;
 				GCC_DYNAMIC_NO_PIC = NO;
 				GCC_PREPROCESSOR_DEFINITIONS = (
@@ -1375,7 +1375,7 @@
 				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GENERATE_INFOPLIST_FILE = YES;
-				MARKETING_VERSION = 1.7.4;
+				MARKETING_VERSION = 1.8.0;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				PRODUCT_BUNDLE_IDENTIFIER = org.atelierInmu.vChewingTests;
@@ -1404,13 +1404,13 @@
 				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
 				CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 1974;
+				CURRENT_PROJECT_VERSION = 1980;
 				ENABLE_NS_ASSERTIONS = NO;
 				GCC_C_LANGUAGE_STANDARD = gnu11;
 				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GENERATE_INFOPLIST_FILE = YES;
-				MARKETING_VERSION = 1.7.4;
+				MARKETING_VERSION = 1.8.0;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				MTL_FAST_MATH = YES;
 				PRODUCT_BUNDLE_IDENTIFIER = org.atelierInmu.vChewingTests;
@@ -1441,7 +1441,7 @@
 				CODE_SIGN_IDENTITY = "-";
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
-				CURRENT_PROJECT_VERSION = 1974;
+				CURRENT_PROJECT_VERSION = 1980;
 				DEAD_CODE_STRIPPING = YES;
 				GCC_C_LANGUAGE_STANDARD = gnu11;
 				GCC_DYNAMIC_NO_PIC = NO;
@@ -1462,7 +1462,7 @@
 					"$(inherited)",
 					"@executable_path/../Frameworks",
 				);
-				MARKETING_VERSION = 1.7.4;
+				MARKETING_VERSION = 1.8.0;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				PRODUCT_BUNDLE_IDENTIFIER = org.atelierInmu.vChewing.vChewingPhraseEditor;
@@ -1491,7 +1491,7 @@
 				CODE_SIGN_IDENTITY = "-";
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
-				CURRENT_PROJECT_VERSION = 1974;
+				CURRENT_PROJECT_VERSION = 1980;
 				DEAD_CODE_STRIPPING = YES;
 				ENABLE_NS_ASSERTIONS = NO;
 				GCC_C_LANGUAGE_STANDARD = gnu11;
@@ -1508,7 +1508,7 @@
 					"$(inherited)",
 					"@executable_path/../Frameworks",
 				);
-				MARKETING_VERSION = 1.7.4;
+				MARKETING_VERSION = 1.8.0;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				MTL_FAST_MATH = YES;
 				PRODUCT_BUNDLE_IDENTIFIER = org.atelierInmu.vChewing.vChewingPhraseEditor;
@@ -1618,7 +1618,7 @@
 				CODE_SIGN_IDENTITY = "-";
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
-				CURRENT_PROJECT_VERSION = 1974;
+				CURRENT_PROJECT_VERSION = 1980;
 				DEAD_CODE_STRIPPING = YES;
 				DEVELOPMENT_ASSET_PATHS = "";
 				DEVELOPMENT_TEAM = "";
@@ -1649,7 +1649,7 @@
 					"$(inherited)",
 					"@executable_path/../Frameworks",
 				);
-				MARKETING_VERSION = 1.7.4;
+				MARKETING_VERSION = 1.8.0;
 				ONLY_ACTIVE_ARCH = YES;
 				PRODUCT_BUNDLE_IDENTIFIER = org.atelierInmu.inputmethod.vChewing;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -1676,7 +1676,7 @@
 				CODE_SIGN_IDENTITY = "-";
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
-				CURRENT_PROJECT_VERSION = 1974;
+				CURRENT_PROJECT_VERSION = 1980;
 				DEAD_CODE_STRIPPING = YES;
 				DEVELOPMENT_ASSET_PATHS = "";
 				DEVELOPMENT_TEAM = "";
@@ -1701,7 +1701,7 @@
 					"$(inherited)",
 					"@executable_path/../Frameworks",
 				);
-				MARKETING_VERSION = 1.7.4;
+				MARKETING_VERSION = 1.8.0;
 				PRODUCT_BUNDLE_IDENTIFIER = org.atelierInmu.inputmethod.vChewing;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";
@@ -1723,7 +1723,7 @@
 				CODE_SIGN_IDENTITY = "-";
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
-				CURRENT_PROJECT_VERSION = 1974;
+				CURRENT_PROJECT_VERSION = 1980;
 				DEAD_CODE_STRIPPING = YES;
 				DEVELOPMENT_TEAM = "";
 				GCC_C_LANGUAGE_STANDARD = gnu99;
@@ -1744,7 +1744,7 @@
 					"$(inherited)",
 					"@executable_path/../Frameworks",
 				);
-				MARKETING_VERSION = 1.7.4;
+				MARKETING_VERSION = 1.8.0;
 				ONLY_ACTIVE_ARCH = YES;
 				PRODUCT_BUNDLE_IDENTIFIER = "org.atelierInmu.vChewing.${PRODUCT_NAME:rfc1034identifier}";
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -1766,7 +1766,7 @@
 				CODE_SIGN_IDENTITY = "-";
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
-				CURRENT_PROJECT_VERSION = 1974;
+				CURRENT_PROJECT_VERSION = 1980;
 				DEAD_CODE_STRIPPING = YES;
 				DEVELOPMENT_TEAM = "";
 				GCC_C_LANGUAGE_STANDARD = gnu99;
@@ -1781,7 +1781,7 @@
 					"$(inherited)",
 					"@executable_path/../Frameworks",
 				);
-				MARKETING_VERSION = 1.7.4;
+				MARKETING_VERSION = 1.8.0;
 				PRODUCT_BUNDLE_IDENTIFIER = "org.atelierInmu.vChewing.${PRODUCT_NAME:rfc1034identifier}";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";