hex/ios/HEXMobile/TypingInsightsView.swift
Ryan Vogel 4f51dbbc1a
iOS: plainer interface wording (copy pass) (#2345)
* iOS: plainer interface wording (copy pass)

A TestFlight tester on build 121 said the interface reads as machine-written.
This rewrites 84 user-facing strings (80 catalog entries, the two permission
prompts, two keyboard-only errors) in flat, short, Apple-Settings style and
updates every changed zh-Hans value to match.

What changed:
- Notes that explained the mechanism, restated the row title, or reassured
  are cut to the one fact people need (e.g. Hide word suggestions now says
  "Autocorrect still works"; Learn how I type, Record typing logs, the
  Experiments rows, the Languages hint, onboarding notes, intents).
- Removed notes that said nothing: Auto-capitalization, Key pop-ups, and
  the iPad-only "The full keyboard works on iPad too" (its runsOnPad helper
  went with it). Haptics and the dictation bar now say "Needs Full Access"
  only while Full Access is off, instead of "Needs Full Access, which isn't
  on yet" / a note that repeated the requirement while it was on.
- One name per thing: "speech model" and "multilingual model" instead of
  Parakeet V2/Ultra in errors; "Apple's speech recognition" instead of
  Apple Speech / Apple's on-device speech; "No speech heard." for every
  empty recording; "Hex Keyboard" for iOS's name, "the Hex keyboard" in
  prose; US spelling (off-center, key centers).
- Permission prompts drop the sentence that restated "on this iPhone"
  (Info.plist, project.yml, zh-Hans InfoPlist.strings).
- Wording only: no settings keys, layout or behaviour changed. Catalog
  edits are confined to the changed entries; stale entries and the
  unlocalized UIKit strip strings are left as they were.

Verified: built before (8583160e) and after; screenshots of 21 scenes on
iPhone 17 Pro and iPhone SE (3rd gen) iOS 27.2 sims, EN before/after and
zh-Hans after, at default and AX5 text sizes, no truncation. xcodebuild test
on a fresh iPhone 17 Pro sim: TEST SUCCEEDED (DictationControllerTests
updated where they asserted the old wording; README quotes updated).

* iOS: Onboarding's doc comment quotes the new optimizing status

Matches the wording changed in the copy pass; comment only.

* iOS: keep the privacy facts in the copy pass; translate the keyboard strip

Review on #2345: for Hex, "on this iPhone", "never leaves" and "not sent"
are facts people need at that moment, not reassurance.

Restored:
- Microphone prompt: "...Audio never leaves it and is deleted once it's
  transcribed." Speech Recognition prompt keeps "Nothing you say is sent to
  a server." (Info.plist, project.yml, zh-Hans InfoPlist.strings)
- Learn how I type and Record typing logs say "on this iPhone" again.
- Clean up what I say is back to "Drops ums, repeats and corrected words".
- "Allow Speech Recognition. It stays on this iPhone." and "...in Settings.
  It runs on this iPhone." back to the originals.
- On-device put back in the shortest form: Checking on-device speech
  recognition; the Parakeet memory fallback names Apple's on-device speech
  recognition; Adaptive touch learns "on this iPhone"; the Shortcut, Control
  Center and Live Activity descriptions say "on device" / "on-device" (not
  "iPhone": KeyboardBridgeTests forbids Apple platform names in intent
  strings).

Keyboard strip: Undo dictation, Paste, Paste dictation, Code from Messages
(and its VoiceOver hint), Undoes the autocorrection, the Full Access hint
(title, Settings path, spoken path, Open Hex, its hint) and the dictation
bar's Full Access path were plain strings, so Chinese users saw English.
They now go through String(localized:); the keyboard extension already
bundles HEXMobile/Localizable.xcstrings, so no wiring was needed. 10 new
catalog entries with zh-Hans, using the app's terms (粘贴听写, 完全访问).

Verified: the built HEXKeyboard.appex zh-Hans Localizable.strings carries the
new keys; zh screenshots show 撤销听写 in the strip and the translated path
in the dictation bar; scripts/code-shape.py has no hard problems;
xcodebuild test on a fresh iPhone 17 Pro sim: TEST SUCCEEDED.
2026-11-22 03:45:00 -05:00

185 lines
7.4 KiB
Swift
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

import SwiftUI
/// What Learn how I type has gathered so far, with a way to erase it.
struct TypingInsightsView: View {
@State private var snapshot = TypingJournalSnapshot()
@State private var disabledFixes: Set<String> = []
@State private var confirmingDelete = false
var body: some View {
VStack(alignment: .leading, spacing: 10) {
Text(summary)
.font(.system(size: 12))
.foregroundStyle(HexTheme.textMuted)
if !dictationFixes.isEmpty {
section("Dictation fixes Hex learned") {
ForEach(dictationFixes) { fix in
Toggle(isOn: isApplied(fix)) {
HStack {
Text("\(fix.heard) → \(fix.meant)")
.font(.system(size: 13))
.foregroundStyle(HexTheme.textBase)
Spacer()
Text("\(fix.count)×")
.font(.system(size: 12))
.foregroundStyle(HexTheme.textMuted)
}
}
.tint(HexTheme.success)
}
}
}
if !snapshot.dictationOutcomes.isEmpty {
section("Dictation") {
row(String(localized: "Kept as is"), detail: share(of: .kept))
row(String(localized: "Edited"), detail: share(of: .edited))
}
}
if !topFixes.isEmpty {
section("Words you fix most") {
ForEach(topFixes, id: \.label) { fix in
row(fix.label, detail: "\(fix.count)×")
}
}
}
if !missedKeys.isEmpty {
section("Where you tap off-center") {
ForEach(missedKeys, id: \.key) { item in
row(item.key.uppercased(), detail: item.direction)
}
}
}
Button(role: .destructive) {
confirmingDelete = true
} label: {
Text("Delete what Hex learned")
.font(.system(size: 13, weight: .medium))
}
.disabled(snapshot.isEmpty && disabledFixes.isEmpty)
.confirmationDialog("Delete what Hex learned?", isPresented: $confirmingDelete) {
Button("Delete", role: .destructive) {
TypingJournal.delete()
AdaptiveTouchSettings().requestReset()
reload()
}
}
}
.onAppear(perform: reload)
}
private var summary: String {
if snapshot.isEmpty {
return String(localized: "Nothing learned yet")
}
let taps = snapshot.tapCount
let fixes = snapshot.corrections.count
let dictations = snapshot.dictationOutcomes.count
return dictations == 1
? String(localized: "\(taps) taps, \(fixes) typing fixes and 1 dictation learned")
: String(localized: "\(taps) taps, \(fixes) typing fixes and \(dictations) dictations learned")
}
/// Learned fixes, most used first; each can be switched off. With Learn each language
/// separately on, every language's are listed, so a fix only one language learned shows too.
private var dictationFixes: [DictationLearnedFix] {
let learned = TypingJournalSettings().learnsPerLanguage
? snapshot.learnedDictationFixesByLanguage()
: snapshot.learnedDictationFixes
return Array(learned
.sorted { $0.count == $1.count ? $0.id < $1.id : $0.count > $1.count }
.prefix(12))
}
private func isApplied(_ fix: DictationLearnedFix) -> Binding<Bool> {
Binding(
get: { !disabledFixes.contains(fix.id) },
set: { applied in
if applied {
disabledFixes.remove(fix.id)
} else {
disabledFixes.insert(fix.id)
}
TypingJournalSettings().disabledDictationFixes = disabledFixes
}
)
}
private func share(of outcome: DictationOutcome) -> String {
let total = snapshot.dictationOutcomes.count
guard total > 0 else { return "–" }
let percent = (Double(snapshot.count(of: outcome)) / Double(total) * 100).rounded()
return "\(Int(percent))%"
}
private var topFixes: [(label: String, count: Int)] {
var counts: [String: Int] = [:]
for correction in snapshot.corrections where correction.kind != .undone && correction.kind != .keptTyped {
counts["\(correction.typed) → \(correction.final)", default: 0] += 1
}
return counts.sorted { $0.value == $1.value ? $0.key < $1.key : $0.value > $1.value }
.prefix(5)
.map { (label: $0.key, count: $0.value) }
}
private var missedKeys: [(key: String, direction: String)] {
snapshot.keys
.filter { $0.value.count >= 20 }
.map { (key: $0.key, offset: $0.value.meanOffset) }
.filter { hypot($0.offset.dx, $0.offset.dy) >= 0.12 }
.sorted { hypot($0.offset.dx, $0.offset.dy) > hypot($1.offset.dx, $1.offset.dy) }
.prefix(4)
.map { item in
let right = abs(item.offset.dx) < 0.08 ? nil : item.offset.dx > 0
let low = abs(item.offset.dy) < 0.08 ? nil : item.offset.dy > 0
return (key: item.key, direction: Self.direction(low: low, right: right))
}
}
/// "low and right": where taps land from the key's centre, empty when they're centred.
private static func direction(low: Bool?, right: Bool?) -> String {
switch (low, right) {
case (true?, true?): String(localized: "low and right")
case (true?, false?): String(localized: "low and left")
case (false?, true?): String(localized: "high and right")
case (false?, false?): String(localized: "high and left")
case (true?, nil): String(localized: "low")
case (false?, nil): String(localized: "high")
case (nil, true?): String(localized: "right")
case (nil, false?): String(localized: "left")
case (nil, nil): ""
}
}
private func reload() {
snapshot = TypingJournal.load(from: FileManager.default
.containerURL(forSecurityApplicationGroupIdentifier: KeyboardBridge.appGroup)?
.appendingPathComponent(TypingJournal.fileName))
disabledFixes = TypingJournalSettings().disabledDictationFixes
}
private func section<Content: View>(_ title: LocalizedStringKey, @ViewBuilder content: () -> Content) -> some View {
VStack(alignment: .leading, spacing: 4) {
Text(title)
.font(.system(size: 12, weight: .medium))
.foregroundStyle(HexTheme.textMuted)
content()
}
}
private func row(_ title: String, detail: String) -> some View {
HStack {
Text(title)
.font(.system(size: 13))
.foregroundStyle(HexTheme.textBase)
Spacer()
Text(detail)
.font(.system(size: 12))
.foregroundStyle(HexTheme.textMuted)
}
}
}